Blog / Netizen

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 手机共享:用数据线连接手机,借用手机的移动网络。
  • 多网络自动切换:同时接入多种网络时,按优先级选择可用的那个;一个断开,自动切到下一个。

上网设置:有线 WAN、中继和 USB 共享

Wi-Fi

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

Wi-Fi 设置:主网络、访客网络和分享二维码

设备管理

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

设备管理:设备列表、实时网速和流量

VPN

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

VPN:WireGuard 配置和按设备分流

广告过滤

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

广告过滤: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。

开始之前

  1. 确认闪存是 256MB 版:看包装盒或机身标签。
  2. 查看序列号(SN)的前 4 位:2543、2544 及之后的新批次更换了闪存,只能使用 2025-11-18 及之后的 OpenWrt 过渡固件。
  3. 不要先升级原厂固件:有用户把原厂固件升级到 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 过渡固件

  1. 用网线连接电脑和路由器的 LAN 口。
  2. 打开 http://192.168.10.1,登录原厂管理页面。
  3. 在“固件升级”中上传过渡固件。原厂页面会一直显示“升级中”,无需理会,等待约 2 分钟。
  4. 打开 http://192.168.1.1,出现 OpenWrt 页面即表示成功。过渡固件默认关闭 Wi-Fi,此时只能使用有线连接。

第 2 步:备份分区

路由器中存有本机独有的无线校准数据和 MAC 地址,丢失后无法从其他地方恢复。这一步不能跳过。

在电脑终端中登录路由器:

Bash
ssh [email protected]

在路由器上执行:

Bash
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

回到电脑上,把备份复制到本地:

Bash
mkdir -p ~/tr3000-backup && scp -O '[email protected]:/tmp/bak/*' ~/tr3000-backup/

再将备份另存一份到网盘或 U 盘。

第 3 步:刷入 Supa Cudy

  1. 校验下载的固件,确认与 sha256sums 中的值一致。
  2. 在 http://192.168.1.1 打开“系统 → 备份/刷写固件”,选择 Supa Cudy 固件,点击“刷写镜像”。
  3. 在确认页中取消勾选“保留配置”,然后确认刷写。
  4. 等待约 3 分钟。首次启动所需时间较长。

救砖

  • 能进入系统,但设置出错:在“系统维护”页恢复出厂设置。

  • 无法进入系统:使用 Cudy 原厂的 TFTP 恢复(按住 Reset 键通电)刷回原厂固件,再从第 1 步重新开始。

  • 完全没有反应:通过 USB 转 TTL 串口救砖。

详细步骤见刷机文档中的“救砖”一节。刷完后建议按文档中的“刷完后的检查”逐项确认一遍。

快速上手

首次登录

  1. 连接名为“SupaCudy”的无密码 Wi-Fi,或用网线连接 LAN 口。
  2. 打开 http://192.168.200.1,用户名 root,密码 supacudy。
  3. 按设置向导选择语言,设置新的管理密码(不能沿用出厂密码),以及 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 项目均无关联,也未获得其认可。相关名称和商标归各自所有者。

首图来源:OpenWrt Wiki · Cudy TR3000