Xiaomi AX3000T 刷 OpenWrt 实践记录
[!summary] 结论 Xiaomi AX3000T
RD03+ MiWiFi 稳定版1.0.98可以通过xmir-patcher开启 SSH、备份分区,并刷入 OpenWrt。
本次最终进入 OpenWrt25.12.3,系统使用apk包管理器;OpenClash 通过 SSH 安装,Mihomo 内核因 GitHub 下载缓慢,改为 Mac 下载后手动传入路由器。
设备与资料
设备信息
| 项目 | 信息 |
|---|---|
| 型号 | Xiaomi AX3000T |
| 硬件版本 | RD03 |
| 原厂 ROM | MiWiFi 稳定版 1.0.98 |
| 原厂管理地址 | 192.168.31.1 |
| OpenWrt 临时系统地址 | 192.168.1.1 |
| 工具目录 | ~/dev/xmir-patcher |
| OpenWrt 架构 | aarch64 / arm64 |
参考资料
- OpenWrt 设备页:Xiaomi AX3000T
- 刷机工具:openwrt-xiaomi/xmir-patcher
- OpenClash:vernesong/OpenClash
- Mihomo 内核:MetaCubeX/mihomo
[!warning] 网口识别 虽然 AX3000T 机身接口标注为 WAN/LAN 通用,但刷机时通常会把中间两个口识别为 LAN,旁边两个口识别为 WAN。刷机前建议电脑用网线连接到 LAN 口,避免无线中断导致操作失败。
操作目标
- 使用
xmir-patcher给路由器开启临时 SSH。 - 读取设备信息并做完整备份。
- 安装永久 SSH。
- 通过
xmir-patcher刷入 OpenWrtinitramfs-factory.ubi临时系统。 - 从 OpenWrt 临时系统升级到正式
sysupgrade.bin。 - 安装中文界面。
- 安装 OpenClash。
- 手动安装 Mihomo Meta 内核。
- 导入订阅并验证科学上网。
环境准备
克隆工具仓库:
cd ~/devgit clone https://github.com/openwrt-xiaomi/xmir-patcher.gitcd xmir-patcherchmod +x run.sh首次直接运行时,Python 3.13 环境安装 ssh2-python 失败,主要报错是缺少 cmake:
/bin/sh: cmake: command not foundsubprocess.CalledProcessError: Command 'cmake ../libssh2 ...' returned non-zero exit status 127.处理方式:
brew install cmake openssluv venv --python 3.11source .venv/bin/activate./run.sh[!note] Mac 环境提示 OpenWrt Wiki 的 Linux 命令大多可以在 macOS 终端执行,但要注意
zsh对;、&、?的解析。包含这些字符的 URL 建议用单引号包起来。
如果需要传文件到 OpenWrt,Mac 新版scp默认走 SFTP,OpenWrt 可能没有sftp-server,需要使用scp -O。
xmir-patcher 菜单流程
运行工具:
./run.sh菜单入口:
1 - Set IP-address (current value: 192.168.31.1)2 - Connect to device (install exploit)3 - Read full device info4 - Create full backup5 - Install EN/RU languages6 - Install permanent SSH7 - Install firmware (from directory "firmware")8 - {{{ Other functions }}}9 - [[ Reboot device ]]0 - Exit1. 安装 exploit 并临时开启 SSH
选择:
2 - Connect to device (install exploit)过程中需要输入路由器 Web 管理密码。成功后关键输出:
device_name = RD03rom_version = 1.0.98 releaseCountryCode = CNhackCheck version = 2Exploit "start_binding" detected!Run SSH server on port 22 ...#### SSH server are activated! ####2. 读取完整设备信息
选择:
3 - Read full device info关键设备信息:
Firmware: 1.0.98Channel: releaseBuildTime: Mon, 25 Aug 2025 09:16:58 +0000Hardware: RD03Kernel version: Linux XiaoQiang 5.4.171DISTRIB_TARGET = mediatek/mt7981DISTRIB_ARCH = aarch64_cortex-a53CPU arch: arm64CPU name: mt7981UBoot(2): 2022.04-rc1关键 NVRAM 参数:
flag_boot_rootfs=1flag_boot_success=1flag_boot_type=2flag_flash_permission=1flag_last_success=1flag_ota_reboot=0ipaddr=192.168.10.1serverip=192.168.10.100信息保存位置:
Full device information saved to file full_info.txt3. 创建完整备份
选择:
4 - Create full backup完成后会在 ./backups/ 下生成各分区备份:
backups/mtd0_FULL_DUMP.binbackups/mtd1_BL2.binbackups/mtd2_Nvram.binbackups/mtd3_Bdata.binbackups/mtd4_Factory.binbackups/mtd5_FIP.binbackups/mtd6_crash.binbackups/mtd7_crashlog.binbackups/mtd8_ubi.binbackups/mtd9_ubi1.binbackups/mtd10_overlay.binbackups/mtd11_data.binbackups/mtd12_KF.bin[!important] 备份 刷入 OpenWrt 前先保留
backups/目录,尤其是Factory、Bdata、Nvram、BL2、FIP等分区。后续恢复、校准信息、MAC 地址相关问题可能会用到。
4. 安装永久 SSH
选择:
6 - Install permanent SSH关键输出:
bdata: telnet_en = 0, ssh_en = 0, uart_en = 0CPU arch: arm64Kernel: Linux XiaoQiang 5.4.171Insert patch for bdata partition!Ready! The Permanent SSH patch installed.Patch for bdata result: OK准备 OpenWrt 固件
xmir-patcher 要求把待刷固件放到仓库的 firmware/ 目录:
cd ~/dev/xmir-patchermkdir firmwarels firmwarecat ./firmware/readme.txtreadme.txt 提示:
In this folder, you should put the firmware for flashing.复制下载好的 initramfs factory 固件:
cp /Users/tiam/Downloads/openwrt-25.12.3-mediatek-filogic-xiaomi_mi-router-ax3000t-initramfs-factory.ubi ./firmware/ls firmware确认目录中已有:
openwrt-25.12.3-mediatek-filogic-xiaomi_mi-router-ax3000t-initramfs-factory.ubireadme.txt[!todo] 待补充 需要补上该固件的下载来源和校验值,避免未来复刷时混用错误镜像。
刷入 OpenWrt 临时系统
在 xmir-patcher 菜单中选择:
7 - Install firmware (from directory "firmware")工具识别到设备和固件:
Detect valid SSH server on port 22 (auth OK)device: "RD03"img_write = TrueImage files in directory "firmware/": "firmware/openwrt-25.12.3-mediatek-filogic-xiaomi_mi-router-ax3000t-initramfs-factory.ubi"固件解析结果:
UBI: filetype: b'UBI#'FIT: name = "ARM64 OpenWrt FIT (Flattened Image Tree)"FIT: model = "xiaomi,mi-router-ax3000t"FDT: compatible = ['xiaomi,mi-router-ax3000t', 'mediatek,mt7981']FDT: model = "Xiaomi Mi Router AX3000T"KRN: desc = "ARM64 OpenWrt Linux-6.12.85"KRN: arch = "arm64"刷入过程关键输出:
current flag_boot_rootfs = 1install_method = 400Writing firmware image to addr 0x00600000 ... mtd -e "ubi" write "/tmp/fw_img.bin" "ubi"Run scripts for change NVRAM params...Boot from firmware [0] activated.The firmware has been successfully flashed!Send command "reboot" via SSH/Telnet ...Forced REBOOT activated!临时系统访问
刷入临时系统后访问:
http://192.168.1.1默认登录信息:
- 用户名:
root - 密码:空密码
如果访问 192.168.1.1 时进入中国移动光猫后台,说明光猫和 OpenWrt 临时系统都在 192.168.1.x 网段。处理方式:
- 先拔掉光猫接入路由器的网线。
- 再访问
192.168.1.1,进入 OpenWrt 临时系统。 - 登录后刷入正式系统。
- 修改 OpenWrt 的 LAN 口 IP,避免与光猫冲突。
- 修改完成后再接回光猫网线。
从临时系统升级正式系统
进入 OpenWrt Web 管理界面后,点击:
Go to firmware upgrade然后选择 AX3000T 对应的 sysupgrade.bin 文件。
升级前注意:
- 取消“保留配置”。
- 确认文件是 AX3000T 对应的
sysupgrade.bin。 - 升级过程中不要断电。
- 等待路由器自动重启。
升级完成后重新进入 OpenWrt。
首次配置
- 修改管理员登录密码。
- 修改 LAN 口网段,避免与光猫冲突。
- 重启网络或重启路由器。
- 使用新的管理地址重新进入 OpenWrt。
- 确认可以接回 WAN 口宽带。
[!tip] 网段建议 如果光猫使用
192.168.1.1,OpenWrt LAN 口可以改成192.168.31.1或192.168.50.1。
后续如果 BE6500 做 AP,可给 BE6500 固定为同网段的192.168.31.2或192.168.50.2。
安装中文界面
在 LuCI Web 管理界面中操作:
System → Software → Update Lists更新完成后,在 Filter 中搜索:
luci-i18n-base-zh-cn点击 Install 安装。安装完成后刷新页面,界面会切换为中文。
安装 OpenClash
OpenWrt 25.12.3 已经切换到 apk 包管理器。SSH 登录时系统提示:
OpenWrt recently switched to the "apk" package manager!
OPKG Command APK Equivalentopkg install <pkg> apk add <pkg>opkg remove <pkg> apk del <pkg>opkg update apk update因此本次安装使用 apk 版本。
Web 页面安装尝试
在 LuCI 中进入:
系统 → 软件包尝试在 Filter 中搜索 OpenClash,没有搜到。因此改为 SSH 命令安装。
SSH 安装依赖和 OpenClash
SSH 进入路由器:
ssh root@192.168.31.1安装依赖并下载最新 OpenClash:
apk updateapk add bash dnsmasq-full curl ca-bundle ip-full ruby ruby-yaml kmod-tun kmod-inet-diag unzip kmod-nft-tproxy luci-compat luci luci-basecurl -L --retry 2 https://api.github.com/repos/vernesong/OpenClash/releases/latest -o /tmp/openclash_versiondownload_url=$(cat /tmp/openclash_version | jsonfilter -e '@.assets[*].browser_download_url' | grep '\.apk$')curl -L --retry 2 "$download_url" -o /tmp/openclash.apkapk add -q --force-overwrite --clean-protected --allow-untrusted /tmp/openclash.apk安装完成后刷新 LuCI,左侧菜单应出现:
服务 → OpenClash[!info] iptables 与 nftables OpenWrt 22.03 及以前通常是
iptables,23.05 往后默认nftables/ firewall4。
新系统优先选nftables相关依赖和安装包;旧系统或有旧规则依赖时再考虑iptables。
手动安装 Mihomo Meta 内核
OpenClash 安装成功后,首次进入管理界面会提示安装内核。路由器直接从 GitHub 拉取内核时下载很慢,容易卡在中途。因此改为 Mac 下载内核,再传入 OpenWrt。
1. 确认路由器架构
SSH 中执行:
uname -m本机输出:
aarch64因此需要下载 linux-arm64 版本的 Mihomo 内核。
2. Mac 下载内核
在 Mac 浏览器打开:
下载类似文件:
mihomo-linux-arm64-v1.xx.xx.gz不要下载:
darwinwindowsandroidamd64armv7debrpm
下载后在 Mac 终端中处理:
cd ~/Downloadsgzip -d mihomo-linux-arm64-*.gzmv mihomo-linux-arm64-* clash_meta3. 从 Mac 传到 OpenWrt
Mac 新版 scp 默认走 SFTP,但 OpenWrt 默认可能没有 /usr/libexec/sftp-server。如果直接执行:
scp clash_meta root@192.168.31.1:/tmp/clash_meta可能报错:
ash: /usr/libexec/sftp-server: not foundscp: Connection closed解决方式是加 -O,强制使用旧版 SCP 协议:
scp -O clash_meta root@192.168.31.1:/tmp/clash_meta备用传输方式:
cat clash_meta | ssh root@192.168.31.1 'cat > /tmp/clash_meta'4. 放入 OpenClash 内核目录
SSH 进入 OpenWrt:
ssh root@192.168.31.1移动内核并赋予执行权限:
mkdir -p /etc/openclash/coremv /tmp/clash_meta /etc/openclash/core/clash_metachmod +x /etc/openclash/core/clash_meta/etc/openclash/core/clash_meta -v本次验证输出:
Mihomo Meta v1.19.25 linux arm64 with go1.26.3 Sat May 16 15:16:49 UTC 2026Use tags: with_gvisor出现版本号说明内核已经可执行。
[!note] SSH 连接中断 执行内核校验后出现过:
Read from remote host 192.168.31.1: Connection reset by peerConnection to 192.168.31.1 closed.client_loop: send disconnect: Broken pipe如果内核版本已经正常输出,通常不用紧张,重新 SSH 登录即可。后续重点看 OpenClash 页面能否识别内核并启动服务。
5. 停止 Web 页面里卡住的内核下载
如果 LuCI 页面里 OpenClash 仍卡在下载内核,例如停在 35%,可以 SSH 终止下载进程:
ssh root@192.168.31.1ps | grep -i openclashps | grep -i wgetps | grep -i curlkillall wgetkillall curl如果要更彻底地停止 OpenClash 服务:
/etc/init.d/openclash stop可选清理临时下载文件:
rm -f /tmp/openclash*rm -f /tmp/*clash*之后回到 OpenClash 页面刷新内核状态。
导入订阅与启动
内核安装好后,在 LuCI 进入:
服务 → OpenClash推荐顺序:
- 确认
Meta/Mihomo内核已识别。 - 导入订阅或上传 Clash 配置。
- 先使用
Rule模式。 - 国内站点、微信、支付宝、银行、米家设备优先直连。
- 测试 GitHub、Google、YouTube。
- 测试国内视频、微信图片、语音、支付类 App。
- 确认稳定后再考虑 DNS 去广告。
问题与处理
ssh2-python 安装失败
现象:
Preparing metadata (pyproject.toml) ... error/bin/sh: cmake: command not found处理:
brew install cmake openssl光猫与 OpenWrt 临时系统 IP 冲突
现象:
- 访问
192.168.1.1进入的是中国移动光猫后台。 - OpenWrt 临时系统无法打开或疑似被跳转。
处理:
- 先断开光猫到路由器的网线。
- 登录 OpenWrt 后修改 LAN 口 IP。
- 修改完成再接回光猫。
LuCI 软件包里搜不到 OpenClash
原因:
- OpenClash 不在默认 OpenWrt 软件源里。
- 需要从 OpenClash GitHub Release 下载
.ipk或.apk。
处理:
- 当前 OpenWrt 25.12.3 使用
apk,下载并安装luci-app-openclash_*.apk。 - 如果是较旧 OpenWrt,通常下载
luci-app-openclash_*.ipk。
OpenClash 内核下载缓慢
原因:
- 路由器直接访问 GitHub 慢或不稳定。
处理:
- Mac 下载
mihomo-linux-arm64-*.gz。 - 解压并改名为
clash_meta。 - 使用
scp -O传到/tmp/clash_meta。 - 移动到
/etc/openclash/core/clash_meta。 chmod +x后用clash_meta -v验证。
Mac 使用 scp 传输失败
现象:
ash: /usr/libexec/sftp-server: not foundscp: Connection closed原因:
- Mac 新版
scp默认走 SFTP。 - OpenWrt 默认没有 SFTP 服务端。
处理:
scp -O clash_meta root@192.168.31.1:/tmp/clash_meta结果
- 使用
xmir-patcher开启临时 SSH。 - 读取设备信息。
- 创建完整分区备份。
- 安装永久 SSH。
- 通过
xmir-patcher刷入 OpenWrt 临时系统。 - 通过 LuCI 升级正式 OpenWrt 系统。
- 修改管理员密码。
- 修改 LAN 口网段,避免与光猫冲突。
- 安装中文界面。
- 安装 OpenClash。
- 手动安装 Mihomo Meta 内核。
- 导入订阅后可用。