2572 字
13 分钟
Xiaomi AX3000T 刷 OpenWrt 实践记录

Xiaomi AX3000T 刷 OpenWrt 实践记录#

[!summary] 结论 Xiaomi AX3000T RD03 + MiWiFi 稳定版 1.0.98 可以通过 xmir-patcher 开启 SSH、备份分区,并刷入 OpenWrt。
本次最终进入 OpenWrt 25.12.3,系统使用 apk 包管理器;OpenClash 通过 SSH 安装,Mihomo 内核因 GitHub 下载缓慢,改为 Mac 下载后手动传入路由器。

设备与资料#

设备信息#

项目信息
型号Xiaomi AX3000T
硬件版本RD03
原厂 ROMMiWiFi 稳定版 1.0.98
原厂管理地址192.168.31.1
OpenWrt 临时系统地址192.168.1.1
工具目录~/dev/xmir-patcher
OpenWrt 架构aarch64 / arm64

参考资料#

[!warning] 网口识别 虽然 AX3000T 机身接口标注为 WAN/LAN 通用,但刷机时通常会把中间两个口识别为 LAN,旁边两个口识别为 WAN。刷机前建议电脑用网线连接到 LAN 口,避免无线中断导致操作失败。

操作目标#

  1. 使用 xmir-patcher 给路由器开启临时 SSH。
  2. 读取设备信息并做完整备份。
  3. 安装永久 SSH。
  4. 通过 xmir-patcher 刷入 OpenWrt initramfs-factory.ubi 临时系统。
  5. 从 OpenWrt 临时系统升级到正式 sysupgrade.bin。
  6. 安装中文界面。
  7. 安装 OpenClash。
  8. 手动安装 Mihomo Meta 内核。
  9. 导入订阅并验证科学上网。

环境准备#

克隆工具仓库:

Terminal window
cd ~/dev
git clone https://github.com/openwrt-xiaomi/xmir-patcher.git
cd xmir-patcher
chmod +x run.sh

首次直接运行时,Python 3.13 环境安装 ssh2-python 失败,主要报错是缺少 cmake:

/bin/sh: cmake: command not found
subprocess.CalledProcessError: Command 'cmake ../libssh2 ...' returned non-zero exit status 127.

处理方式:

Terminal window
brew install cmake openssl
uv venv --python 3.11
source .venv/bin/activate
./run.sh

[!note] Mac 环境提示 OpenWrt Wiki 的 Linux 命令大多可以在 macOS 终端执行,但要注意 zsh 对 ;、&、? 的解析。包含这些字符的 URL 建议用单引号包起来。
如果需要传文件到 OpenWrt,Mac 新版 scp 默认走 SFTP,OpenWrt 可能没有 sftp-server,需要使用 scp -O。

xmir-patcher 菜单流程#

运行工具:

Terminal window
./run.sh

菜单入口:

1 - Set IP-address (current value: 192.168.31.1)
2 - Connect to device (install exploit)
3 - Read full device info
4 - Create full backup
5 - Install EN/RU languages
6 - Install permanent SSH
7 - Install firmware (from directory "firmware")
8 - {{{ Other functions }}}
9 - [[ Reboot device ]]
0 - Exit

1. 安装 exploit 并临时开启 SSH#

选择:

2 - Connect to device (install exploit)

过程中需要输入路由器 Web 管理密码。成功后关键输出:

device_name = RD03
rom_version = 1.0.98 release
CountryCode = CN
hackCheck version = 2
Exploit "start_binding" detected!
Run SSH server on port 22 ...
#### SSH server are activated! ####

2. 读取完整设备信息#

选择:

3 - Read full device info

关键设备信息:

Firmware: 1.0.98
Channel: release
BuildTime: Mon, 25 Aug 2025 09:16:58 +0000
Hardware: RD03
Kernel version: Linux XiaoQiang 5.4.171
DISTRIB_TARGET = mediatek/mt7981
DISTRIB_ARCH = aarch64_cortex-a53
CPU arch: arm64
CPU name: mt7981
UBoot(2): 2022.04-rc1

关键 NVRAM 参数:

flag_boot_rootfs=1
flag_boot_success=1
flag_boot_type=2
flag_flash_permission=1
flag_last_success=1
flag_ota_reboot=0
ipaddr=192.168.10.1
serverip=192.168.10.100

信息保存位置:

Full device information saved to file full_info.txt

3. 创建完整备份#

选择:

4 - Create full backup

完成后会在 ./backups/ 下生成各分区备份:

backups/mtd0_FULL_DUMP.bin
backups/mtd1_BL2.bin
backups/mtd2_Nvram.bin
backups/mtd3_Bdata.bin
backups/mtd4_Factory.bin
backups/mtd5_FIP.bin
backups/mtd6_crash.bin
backups/mtd7_crashlog.bin
backups/mtd8_ubi.bin
backups/mtd9_ubi1.bin
backups/mtd10_overlay.bin
backups/mtd11_data.bin
backups/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 = 0
CPU arch: arm64
Kernel: Linux XiaoQiang 5.4.171
Insert patch for bdata partition!
Ready! The Permanent SSH patch installed.
Patch for bdata result: OK

准备 OpenWrt 固件#

xmir-patcher 要求把待刷固件放到仓库的 firmware/ 目录:

Terminal window
cd ~/dev/xmir-patcher
mkdir firmware
ls firmware
cat ./firmware/readme.txt

readme.txt 提示:

In this folder, you should put the firmware for flashing.

复制下载好的 initramfs factory 固件:

Terminal window
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.ubi
readme.txt

[!todo] 待补充 需要补上该固件的下载来源和校验值,避免未来复刷时混用错误镜像。

刷入 OpenWrt 临时系统#

在 xmir-patcher 菜单中选择:

7 - Install firmware (from directory "firmware")

工具识别到设备和固件:

Detect valid SSH server on port 22 (auth OK)
device: "RD03"
img_write = True
Image 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 = 1
install_method = 400
Writing 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 网段。处理方式:

  1. 先拔掉光猫接入路由器的网线。
  2. 再访问 192.168.1.1,进入 OpenWrt 临时系统。
  3. 登录后刷入正式系统。
  4. 修改 OpenWrt 的 LAN 口 IP,避免与光猫冲突。
  5. 修改完成后再接回光猫网线。

从临时系统升级正式系统#

进入 OpenWrt Web 管理界面后,点击:

Go to firmware upgrade

然后选择 AX3000T 对应的 sysupgrade.bin 文件。

升级前注意:

  • 取消“保留配置”。
  • 确认文件是 AX3000T 对应的 sysupgrade.bin。
  • 升级过程中不要断电。
  • 等待路由器自动重启。

升级完成后重新进入 OpenWrt。

首次配置#

  1. 修改管理员登录密码。
  2. 修改 LAN 口网段,避免与光猫冲突。
  3. 重启网络或重启路由器。
  4. 使用新的管理地址重新进入 OpenWrt。
  5. 确认可以接回 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 Equivalent
opkg install <pkg> apk add <pkg>
opkg remove <pkg> apk del <pkg>
opkg update apk update

因此本次安装使用 apk 版本。

Web 页面安装尝试#

在 LuCI 中进入:

系统 → 软件包

尝试在 Filter 中搜索 OpenClash,没有搜到。因此改为 SSH 命令安装。

SSH 安装依赖和 OpenClash#

SSH 进入路由器:

Terminal window
ssh root@192.168.31.1

安装依赖并下载最新 OpenClash:

Terminal window
apk update
apk 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-base
curl -L --retry 2 https://api.github.com/repos/vernesong/OpenClash/releases/latest -o /tmp/openclash_version
download_url=$(cat /tmp/openclash_version | jsonfilter -e '@.assets[*].browser_download_url' | grep '\.apk$')
curl -L --retry 2 "$download_url" -o /tmp/openclash.apk
apk 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 中执行:

Terminal window
uname -m

本机输出:

aarch64

因此需要下载 linux-arm64 版本的 Mihomo 内核。

2. Mac 下载内核#

在 Mac 浏览器打开:

下载类似文件:

mihomo-linux-arm64-v1.xx.xx.gz

不要下载:

  • darwin
  • windows
  • android
  • amd64
  • armv7
  • deb
  • rpm

下载后在 Mac 终端中处理:

Terminal window
cd ~/Downloads
gzip -d mihomo-linux-arm64-*.gz
mv mihomo-linux-arm64-* clash_meta

3. 从 Mac 传到 OpenWrt#

Mac 新版 scp 默认走 SFTP,但 OpenWrt 默认可能没有 /usr/libexec/sftp-server。如果直接执行:

Terminal window
scp clash_meta root@192.168.31.1:/tmp/clash_meta

可能报错:

ash: /usr/libexec/sftp-server: not found
scp: Connection closed

解决方式是加 -O,强制使用旧版 SCP 协议:

Terminal window
scp -O clash_meta root@192.168.31.1:/tmp/clash_meta

备用传输方式:

Terminal window
cat clash_meta | ssh root@192.168.31.1 'cat > /tmp/clash_meta'

4. 放入 OpenClash 内核目录#

SSH 进入 OpenWrt:

Terminal window
ssh root@192.168.31.1

移动内核并赋予执行权限:

Terminal window
mkdir -p /etc/openclash/core
mv /tmp/clash_meta /etc/openclash/core/clash_meta
chmod +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 2026
Use tags: with_gvisor

出现版本号说明内核已经可执行。

[!note] SSH 连接中断 执行内核校验后出现过:

Read from remote host 192.168.31.1: Connection reset by peer
Connection to 192.168.31.1 closed.
client_loop: send disconnect: Broken pipe

如果内核版本已经正常输出,通常不用紧张,重新 SSH 登录即可。后续重点看 OpenClash 页面能否识别内核并启动服务。

5. 停止 Web 页面里卡住的内核下载#

如果 LuCI 页面里 OpenClash 仍卡在下载内核,例如停在 35%,可以 SSH 终止下载进程:

Terminal window
ssh root@192.168.31.1
ps | grep -i openclash
ps | grep -i wget
ps | grep -i curl
killall wget
killall curl

如果要更彻底地停止 OpenClash 服务:

Terminal window
/etc/init.d/openclash stop

可选清理临时下载文件:

Terminal window
rm -f /tmp/openclash*
rm -f /tmp/*clash*

之后回到 OpenClash 页面刷新内核状态。

导入订阅与启动#

内核安装好后,在 LuCI 进入:

服务 → OpenClash

推荐顺序:

  1. 确认 Meta / Mihomo 内核已识别。
  2. 导入订阅或上传 Clash 配置。
  3. 先使用 Rule 模式。
  4. 国内站点、微信、支付宝、银行、米家设备优先直连。
  5. 测试 GitHub、Google、YouTube。
  6. 测试国内视频、微信图片、语音、支付类 App。
  7. 确认稳定后再考虑 DNS 去广告。

问题与处理#

ssh2-python 安装失败#

现象:

Preparing metadata (pyproject.toml) ... error
/bin/sh: cmake: command not found

处理:

Terminal window
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 found
scp: Connection closed

原因:

  • Mac 新版 scp 默认走 SFTP。
  • OpenWrt 默认没有 SFTP 服务端。

处理:

Terminal window
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 内核。
  • 导入订阅后可用。
Xiaomi AX3000T 刷 OpenWrt 实践记录
https://blog.tiamix.cn/posts/xiaomi-ax3000t-刷-openwrt-实践记录/
作者
Tiam
发布于
2026-05-19
许可协议
CC BY-NC-SA 4.0