Supa Cudy:一个更好用的 Cudy TR3000 固件

Supa Cudy 是基于 OpenWrt 24.10 的 Cudy TR3000 固件,提供简洁易用的管理页面,同时保留 LuCI。
Cudy TR3000 是一台巴掌大的 Wi-Fi 6 旅行路由器,有一个 2.5G WAN 口、一个千兆 LAN 口和 USB 3.0,用 USB-C 供电。Supa Cudy 把连酒店 Wi-Fi、挂 VPN、管理连接的设备这些常用操作做成了几步就能完成的页面,手机和电脑上都能用。需要更细的设置时,原版 LuCI 随时可以进入。
- 适用设备:Cudy TR3000 v1(256MB 闪存)。128MB 版不支持。
- 当前版本:v0.5.0(2026-11-07)
- 基于:OpenWrt 24.10.8
- 源代码:github.com/supacode-org/supa-cudy,Apache-2.0
功能
上网
- 有线 WAN:自动获取、静态 IP、PPPoE。
- 中继:连上酒店、咖啡店的 Wi-Fi,把网络分给自己的设备;支持公司和学校的企业级 Wi-Fi。连过的网络会被记住,断开时自动换到附近其他已保存的网络。
- USB 手机共享:用数据线连接手机,借用手机的移动网络。
- 多网络自动切换:同时接入多种网络时,按优先级选择可用的那个;一个断开,自动切到下一个。

Wi-Fi
- 双频设置:2.4G 和 5G 分开设置,也可以双频合一,只用一个名称。
- 访客 Wi-Fi:与主网络隔离。
- 二维码分享:生成二维码,对方用手机扫一下就能连接。

设备管理
- 设备列表:查看所有已连接的设备、实时网速和流量用量。
- 单设备控制:改名、限速、一键禁止上网、固定 IP。
- 家长控制:在指定时间段(比如睡觉时间)禁止所选设备上网。

VPN
- WireGuard 和 OpenVPN:导入服务商提供的配置文件即可使用。
- 按需分流:所有设备都走 VPN,或者只让指定的设备、网站走 VPN。
- 无 VPN 时禁止上网:VPN 断开后拦截所有流量,防止流量改走普通线路。

广告过滤
- 内置 AdGuard Home:网络中的所有设备都能过滤广告和跟踪器。
- 规则管理:拦截列表和自定义规则都在同一个页面里修改。

其他
- 加密 DNS
- 远程访问:通过 Tailscale,在外面也能连回家里的网络。
- 常用工具:端口转发、DDNS、定时开关 Wi-Fi、定时重启。
- 统一的管理密码:网页、SSH 和 AdGuard Home 共用一个密码。
- 登录保护:连续输错 3 次的设备会被暂时挡在管理页面外。
- WAN 访问控制:控制能否从外网访问管理页面。
- 系统:温度显示、CPU 限制、定时任务、固件升级。
- 救援模式:设置出错、连不上路由器时,会临时开启一个救援 Wi-Fi,用来连回去修改。
- 界面:中文和英文,浅色和深色主题,手机和电脑都能用。
现状
Supa Cudy 可以刷机使用,但仍在快速开发中,接口和默认值可能还会变化。每次提交都会运行单元、界面、软件包和整机模拟器测试。
v0.5.0 起项目由 SupaCudy 更名为 Supa Cudy,仓库迁移到 supacode-org/supa-cudy。这次更名没有功能变化,软件包名、配置、出厂登录信息和 Wi-Fi 名称都保持不变,已经刷了旧版本的设备可以照常使用。
支持的设备
| 设备 | 构建配置 | OpenWrt |
|---|---|---|
| Cudy TR3000 v1(256MB 闪存) | cudy-tr3000-256mb-v1 |
24.10.8 |
128MB 闪存的版本不支持,两者的固件不能混刷。
安装
刷写第三方固件有变砖和失去保修的风险。开始之前,请完整阅读下面的步骤和刷机文档。
安装分三步:先从原厂固件刷入 OpenWrt 过渡固件,再备份分区,最后刷入 Supa Cudy。
开始之前
- 确认闪存是 256MB 版:看包装盒或机身标签。
- 查看序列号(SN)的前 4 位:2543、2544 及之后的新批次更换了闪存,只能使用 2025-11-18 及之后的 OpenWrt 过渡固件。
- 不要先升级原厂固件:有用户把原厂固件升级到 2.5.21 后再刷过渡固件,导致变砖。保持现有版本,直接进行下面的步骤。
刷机过程中电脑通常无法上网,请先把以下文件下载到本地:
| 文件 | 下载位置 |
|---|---|
TR3000 256MB 原厂固件(另存一份并改名为 recovery.bin,救砖时使用) |
Cudy 官网下载中心,TR3000-256MB 1.0 页面 |
256MB 版 OpenWrt 过渡固件 cudy_tr3000-256mb-v1-sysupgrade.bin |
Cudy 官网“OpenWrt Software Download”页面,“TR3000 256 MB Flash V1”文件夹 |
Supa Cudy 固件 openwrt-24.10.8-supacudy-mediatek-filogic-cudy_tr3000-256mb-v1-squashfs-sysupgrade.bin 和 sha256sums |
GitHub Releases |
另外需要一根网线和一个 5V 3A 的 USB-C 电源。刷机全程使用有线连接,不要断电。
第 1 步:刷入 OpenWrt 过渡固件
- 用网线连接电脑和路由器的 LAN 口。
- 打开 http://192.168.10.1,登录原厂管理页面。
- 在“固件升级”中上传过渡固件。原厂页面会一直显示“升级中”,无需理会,等待约 2 分钟。
- 打开 http://192.168.1.1,出现 OpenWrt 页面即表示成功。过渡固件默认关闭 Wi-Fi,此时只能使用有线连接。
第 2 步:备份分区
路由器中存有本机独有的无线校准数据和 MAC 地址,丢失后无法从其他地方恢复。这一步不能跳过。
在电脑终端中登录路由器:
ssh [email protected]
在路由器上执行:
mkdir -p /tmp/bak
for n in $(sed -n 's/^\(mtd[0-9]*\):.*/\1/p' /proc/mtd); do cat /dev/$n > /tmp/bak/$n.bin; done
cat /proc/mtd > /tmp/bak/mtd-layout.txt
回到电脑上,把备份复制到本地:
mkdir -p ~/tr3000-backup && scp -O '[email protected]:/tmp/bak/*' ~/tr3000-backup/
再将备份另存一份到网盘或 U 盘。
第 3 步:刷入 Supa Cudy
- 校验下载的固件,确认与
sha256sums中的值一致。 - 在 http://192.168.1.1 打开“系统 → 备份/刷写固件”,选择 Supa Cudy 固件,点击“刷写镜像”。
- 在确认页中取消勾选“保留配置”,然后确认刷写。
- 等待约 3 分钟。首次启动所需时间较长。
救砖
-
能进入系统,但设置出错:在“系统维护”页恢复出厂设置。
-
无法进入系统:使用 Cudy 原厂的 TFTP 恢复(按住 Reset 键通电)刷回原厂固件,再从第 1 步重新开始。
-
完全没有反应:通过 USB 转 TTL 串口救砖。
详细步骤见刷机文档中的“救砖”一节。刷完后建议按文档中的“刷完后的检查”逐项确认一遍。
快速上手
首次登录
- 连接名为“SupaCudy”的无密码 Wi-Fi,或用网线连接 LAN 口。
- 打开 http://192.168.200.1,用户名
root,密码supacudy。 - 按设置向导选择语言,设置新的管理密码(不能沿用出厂密码),以及 Wi-Fi 名称和密码、上网方式和时区。
完成后进入概览页,可以看到网络连接状态和设备信息:

常用操作
| 场景 | 操作 |
|---|---|
| 在酒店连接 Wi-Fi | 互联网 → 中继 → 加入 Wi-Fi 网络,选择酒店的网络并输入密码 |
| 使用 VPN | VPN → 添加 WireGuard(或 OpenVPN)配置,粘贴或导入服务商提供的配置文件,打开连接 |
| 使用手机流量 | 用数据线连接手机。安卓打开“USB 网络共享”;iPhone 打开“个人热点”,并在弹窗中点击“信任” |
| 分享 Wi-Fi 给朋友 | 在 Wi-Fi 页开启访客 Wi-Fi,用二维码分享,对方用手机相机扫描即可连接 |
| 升级固件 | 在“系统维护”页上传新版本的固件文件 |
| 进行更细的设置 | 侧边栏左下角(手机上在“更多”中)进入原版 LuCI,或直接打开 http://192.168.200.1/cgi-bin/luci/ |
反馈
遇到问题或有功能建议,请在 GitHub Issues 中提交。
许可证与声明
Supa Cudy 以 Apache-2.0 协议开源。固件中的 OpenWrt 及其软件包遵循各自的许可证。
- 刷写第三方固件存在风险,请在操作前自行备份重要数据。因使用本项目造成的任何后果,包括但不限于数据丢失、设备损坏或无法启动、失去保修,均由使用者自行承担。
- 本项目仅供技术交流和学习使用,禁止用于任何违法用途。使用者须遵守所在地的法律法规,包括无线电管理、网络安全和数据保护等方面的规定。
- Supa Cudy 是独立的社区项目,与 Cudy、GL.iNet 及 OpenWrt 项目均无关联,也未获得其认可。相关名称和商标归各自所有者。