[常见问题解决]某为5G改装通信壳 + Cudy TR 3000 实现通信的问题

问题一：Openwrt 后台不显示 usb0 的情况

第一步：确认路由器是否识别到硬件
首先，我们要确定问题出在哪里：是缺驱动，还是物理连接没通。

在路由器的终端（SSH 或 TTYD 终端）里输入以下命令：

ls /sys/class/net/

• 正常情况：你应该能看到 usb0 或者 eth1（有时候 USB 网卡会被识别为第二个以太网口）。
• 异常情况：只有 eth0、lo、wlan0 等，没有新的接口出现。

查看系统日志，看是否有报错：

dmesg | grep usb

• 如果你看到类似 usb 1-1: new high-speed USB device 或 rndis_host 的字样，说明硬件识别了，但可能缺协议驱动。
• 如果什么都没有，说明物理连接有问题（USB 线材、供电不足或接触不良）。

输出结果如下：

root@GOD:~# dmesg | grep usb
[18366.432196] usb 1-1: new full-speed USB device number 2 using xhci-mtk
[18366.612360] usb 1-1: not running at top speed; connect to a high speed hub
[18370.005461] usb 1-1: USB disconnect, device number 2
[18376.792205] usb 1-1: new high-speed USB device number 3 using xhci-mtk

从这段日志可以看出两个关键问题：

• 硬件已连接，但驱动未加载：

日志显示 new high-speed USB device number 3，说明路由器已经检测到了通信壳的 USB 插入。但是日志在识别出设备后就戛然而止了，没有出现类似 rndis_host 或 usb0: register 的字样。这意味着路由器内核虽然看到了设备，但不知道它是个“网卡”，所以没有创建 usb0 接口。

• 速度警告：

日志中出现 not running at top speed; connect to a high speed hub，虽然最终显示识别为 high-speed (USB 2.0)，但这通常意味着通信壳对供电或信号质量比较敏感，可能需要后续关注供电稳定性。

• 解决方法：安装 USB 网卡驱动

你的路由器固件目前缺少支持通信壳（通常模拟为 RNDIS 网卡）的驱动包。

请在路由器终端（SSH/TTYD）中依次执行以下命令：

1. 更新软件包列表

opkg update
(如果报错提示无法下载，请检查路由器本身是否能通过原有的 WAN 口正常上网。)

2. 安装 RNDIS 驱动核心包

这是让路由器识别“USB共享网络”的关键驱动。

opkg install kmod-usb-net-rndis
注：安装过程中可能会提示安装依赖包（如 kmod-usb-net），输入 y 确认即可。

3. 安装基础 USB 网络支持（以防万一）

如果上一步安装后还不行，尝试安装这个通用包：

opkg install kmod-usb-net-cdc-ether

如果一直下载不了，就需要更换版本（直接跳转到问题三！）

问题二：更新软件包列表提示错误

当提示如下的错误，我们使用下面的方法来进行更改！

root@GOD:~# opkg update
Downloading https://istore.istoreos.com/repo/all/compat/Packages.gz
Failed to send request: Operation not permitted
*** Failed to download the package list from https://istore.istoreos.com/repo/all/compat/Packages.gz

......

Collected errors:
 * opkg_download: Failed to download https://istore.istoreos.com/repo/all/compat/Packages.gz, wget returned 5.
 * opkg_download: Failed to download https://downloads.openwrt.org/releases/23.05-SNAPSHOT/targets/mediatek/filogic/packages/Packages.gz, wget returned 5.
 * opkg_download: Failed to download https://downloads.openwrt.org/releases/23.05-SNAPSHOT/packages/aarch64_cortex-a53/base/Packages.gz, wget returned 5.
 * opkg_download: Failed to download https://downloads.openwrt.org/releases/23.05-SNAPSHOT/packages/aarch64_cortex-a53/luci/Packages.gz, wget returned 5.
 * opkg_download: Failed to download https://downloads.openwrt.org/releases/23.05-SNAPSHOT/packages/aarch64_cortex-a53/packages/Packages.gz, wget returned 5.
 * opkg_download: Failed to download https://downloads.openwrt.org/releases/23.05-SNAPSHOT/packages/aarch64_cortex-a53/routing/Packages.gz, wget returned 5.
 * opkg_download: Failed to download https://downloads.openwrt.org/releases/23.05-SNAPSHOT/packages/aarch64_cortex-a53/telephony/Packages.gz, wget returned 5.
root@GOD:~# 

本质上是 iStoreOS/ImmortalWrt 这类固件，对 HTTPS 出站做了限制，导致 opkg update / wget 全部报：

Failed to send request: Operation not permitted
wget returned 4 / 5

所以 opkg 根本拿不到仓库列表，自然就提示：Unknown package kmod-usb-net-rndis

你要先解决“不能连 HTTPS 仓库”的问题，才能在线装驱动。

清华 TUNA 提供了 OpenWrt 软件仓库镜像，官方帮助是这么做的：

# 备份原配置

cp /etc/opkg/distfeeds.conf /etc/opkg/distfeeds.conf.bak

# 把 downloads.openwrt.org 替换为清华镜像

sed -i 's|http://downloads.openwrt.org|https://mirrors.tuna.tsinghua.edu.cn/openwrt|g' /etc/opkg/distfeeds.conf

# 再执行一次 opkg update

opkg update

问题三：Openwrt 23.05-SNAPSHOT 快照版本升级

在我们的提示 Openwrt 23.05-SNAPSHOT 快照版本下下载所需要的软件包时，如下的错误，我们使用下面的方法来进行更改！

root@GOD:~# opkg update
Downloading https://istore.istoreos.com/repo/all/compat/Packages.gz
Updated list of available packages in /var/opkg-lists/istore_compat
Downloading https://istore.istoreos.com/repo/all/compat/Packages.sig
Signature check passed.
Downloading https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05-SNAPSHOT/targets/mediatek/filogic/packages/Packages.gz
*** Failed to download the package list from https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05-SNAPSHOT/targets/mediatek/filogic/packages/Packages.gz

......

Collected errors:
 * opkg_download: Failed to download https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05-SNAPSHOT/targets/mediatek/filogic/packages/Packages.gz, wget returned 8.
 * opkg_download: Failed to download https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05-SNAPSHOT/packages/aarch64_cortex-a53/base/Packages.gz, wget returned 8.
 * opkg_download: Failed to download https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05-SNAPSHOT/packages/aarch64_cortex-a53/luci/Packages.gz, wget returned 8.
 * opkg_download: Failed to download https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05-SNAPSHOT/packages/aarch64_cortex-a53/packages/Packages.gz, wget returned 8.
 * opkg_download: Failed to download https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05-SNAPSHOT/packages/aarch64_cortex-a53/routing/Packages.gz, wget returned 8.
 * opkg_download: Failed to download https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05-SNAPSHOT/packages/aarch64_cortex-a53/telephony/Packages.gz, wget returned 8.

根本原因是：

• 清华镜像上 根本没有 23.05-SNAPSHOT 这个目录，所以所有类似的请求都会 404，wget 返回 8，这就是你现在看到的一堆 Failed to download … wget returned 8。
• 官方 OpenWrt 和清华镜像现在都只保留正式版本目录：23.05.0、23.05.1、…、23.05.6 以及 packages-23.05，没有 23.05-SNAPSHOT。
• 你的 iStoreOS/ImmortalWrt 固件里的 distfeeds.conf 还在用旧的 23.05-SNAPSHOT 路径，所以一更新就崩。

下面给你一个尽量不改配置、直接升级的思路，假设你现在用的是 iStoreOS / ImmortalWrt 的 mediatek/filogic 设备（比如 RAX3000M、AX6000 等）。

一、先确认你现在的设备型号
在路由器 SSH 里执行：

cat /tmp/sysinfo/board_name

如果输出类似：

root@GOD:/tmp# cat /tmp/sysinfo/board_name
cudy,tr3000-v1

现在先确认你现在的系统是不是已经刷过 OpenWrt 类固件，再决定怎么“升级”。

请依次在 SSH 里执行下面两条命令，把输出贴出来：

cat /etc/openwrt_release

ubus call system board

有了这个我就能判断：

• 你现在是 Cudy 原厂系统、还是第三方 OpenWrt / ImmortalWrt / iStoreOS；
• 能不能直接用 sysupgrade 升级到 23.05.5。

不过，无论现在是什么系统，你最终的目标很明确：

把 TR3000 v1 刷成 OpenWrt 23.05.5（内核 5.15.167），这样就能直接在线装 kmod-usb-net-rndis 了。

root@GOD:~# cat /etc/openwrt_release
DISTRIB_ID='OpenWrt'
DISTRIB_RELEASE='23.05-SNAPSHOT'
DISTRIB_REVISION='r24150-55af6e1af0'
DISTRIB_TARGET='mediatek/filogic'
DISTRIB_ARCH='aarch64_cortex-a53'
DISTRIB_DESCRIPTION='OpenWrt 23.05-SNAPSHOT r24150-55af6e1af0'
DISTRIB_TAINTS='no-all'

root@GOD:~# ubus call system board
{
	"kernel": "5.15.173",
	"hostname": "GOD",
	"system": "ARMv8 Processor rev 4",
	"model": "Cudy TR3000 v1",
	"board_name": "cudy,tr3000-v1",
	"rootfs_type": "squashfs",
	"release": {
		"distribution": "OpenWrt",
		"version": "23.05-SNAPSHOT",
		"revision": "r24150-55af6e1af0",
		"target": "mediatek/filogic",
		"description": "OpenWrt 23.05-SNAPSHOT r24150-55af6e1af0"
	}
}
root@GOD:~# 

现在就可以直接刷入 OpenWrt 23.05.6 正式版 固件。刷完后，内核会变成 5.15.189，软件源和内核完美匹配，驱动就能直接装了。

一、下载正确的固件
你的设备是 Cudy TR3000 v1，请下载官方正式版固件。

推荐下载地址（清华镜像源，速度快）：

(如果链接无法下载，可以去 OpenWrt 官网下载，路径相同)

也可以直接使用下面的命令在命令行中依次执行下载！

cd /tmp

wget https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05.6/targets/mediatek/filogic/openwrt-23.05.6-mediatek-filogic-cudy_tr3000-v1-squashfs-sysupgrade.bin

二、刷机步骤（命令行方式）
因为你现在的系统是只读文件系统导致之前报错，用命令行刷机是最干净、最彻底的方式，可以覆盖掉之前所有的问题。

1. 上传固件
   使用 WinSCP 或者路由器后台的文件上传功能，把刚才下载的 .bin 文件上传到路由器的 /tmp 目录。
2. 执行刷机命令
   在 SSH 终端输入以下命令（注意：这会清除旧配置，让系统焕然一新，建议执行）：

cd /tmp

sysupgrade -n -F openwrt-23.05.6-mediatek-filogic-cudy_tr3000-v1-squashfs-sysupgrade.bin

参数解释：

-n：不保留旧配置（强烈推荐，因为你是跨版本升级，旧配置可能会有冲突）。
-F：强制刷写（因为从快照版刷到正式版，系统可能会提示版本校验失败，强制即可）。

3. 等待重启
   路由器会闪烁一阵灯，然后自动重启。这期间不要断电。

现在就升级好了！

版本汉化

刚才下载的 OpenWrt 23.05.6 官方原版固件，默认是纯英文的，且默认没有预装中文语言包。

要变成中文界面，你需要在刷机完成后，连接互联网，通过以下步骤安装中文包。

前提条件：

• 路由器的 WAN 口已连接光猫/上级路由，能够正常上网（因为要下载语言包）。
• 路由器已经刷入 23.05.6 并重启完成。

方法一：命令行安装（推荐，最快）

• SSH 登录到路由器。
• 执行以下命令更新软件列表并安装中文包：

opkg update

opkg install luci-i18n-base-zh-cn

(如果想把防火墙、DDNS 等其他菜单也汉化，可以再装一个全功能包：opkg install luci-i18n-firewall-zh-cn，通常装第一个 base 包就够了)

安装完成后，刷新浏览器页面，界面就会变成中文。
方法二：后台页面安装（图形化）

1. 浏览器进入路由器后台（通常是 192.168.1.1）。
2. 点击顶部菜单的 System（系统） -> Software（软件）。
3. 点击 Update lists（更新列表）按钮（这一步必须成功，如果报错说明没网）。
4. 在搜索框输入：luci-i18n-base-zh-cn。
5. 找到搜索结果，点击 Install（安装）。
6. 安装完毕，刷新页面即可。