2.2.1 CPU 架构检查#

1
root@XiaoQiang:~# uname -a
2
Linux XiaoQiang 5.4.171 #0 SMP Tue Nov 21 06:41:54 2023 aarch64 GNU/Linux
3
root@XiaoQiang:~# cat /proc/cpuinfo
4
processor       : 0
5
model name      : ARMv8 Processor rev 4 (v8l)
6
BogoMIPS        : 26.00
7
Features        : fp asimd evtstrm aes pmull sha1 sha2 crc32 cpuid
8
CPU implementer : 0x41
9
CPU architecture: 8
10
CPU variant     : 0x0
11
CPU part        : 0xd03
12
CPU revision    : 4
13

14
processor       : 1
15
model name      : ARMv8 Processor rev 4 (v8l)
16
BogoMIPS        : 26.00
17
Features        : fp asimd evtstrm aes pmull sha1 sha2 crc32 cpuid
18
CPU implementer : 0x41
19
CPU architecture: 8
20
CPU variant     : 0x0
21
CPU part        : 0xd03
22
CPU revision    : 4

从上面的输出结果可以看到，AX3000T 搭载的处理器属于主流的 ARM Cortex-A53 架构，并且系统运行在 64 位模式下。这意味着，后续我们在为路由器下载任何第三方软件（如 ZeroTier、Mihomo 等）的二进制执行文件时，必须认准 ARM64 或 aarch64 这两个关键后缀，千万别错下成常规 PC 的 x86 或者是老旧路由器的 MIPS 版本。

2.2.2 存储空间检查#

1
root@XiaoQiang:~# df -h
2
Filesystem                Size      Used Available Use% Mounted on
3
/dev/root                18.3M     18.3M         0 100% /
4
tmpfs                   119.5M    708.0K    118.8M   1% /tmp
5
ubi1:cfg                 24.3M    672.0K     22.4M   3% /data
6
ubi1:cfg                 24.3M    672.0K     22.4M   3% /userdisk
7
/dev/root                18.3M     18.3M         0 100% /userdisk/data
8
ubi1:cfg                 24.3M    672.0K     22.4M   3% /etc/config
9
ubi1:cfg                 24.3M    672.0K     22.4M   3% /etc/datacenterconfig
10
ubi1:cfg                 24.3M    672.0K     22.4M   3% /etc/smartcontroller
11
ubi1:cfg                 24.3M    672.0K     22.4M   3% /etc/parentalctl
12
ubi1:cfg                 24.3M    672.0K     22.4M   3% /etc/smartvpn
13
ubi1:cfg                 24.3M    672.0K     22.4M   3% /etc/ppp
14
ubi1:cfg                 24.3M    672.0K     22.4M   3% /etc/crontabs
15
ubi1:cfg                 24.3M    672.0K     22.4M   3% /etc/mipctl
16
tmpfs                   512.0K         0    512.0K   0% /dev

这是最重要的一步，也直接决定了我们后续的魔改方案。

从上面检查结果中可以看出，小米固件对存储空间的切分非常抠门。路由器的根目录 / 是一块被 100% 占满且只读的 ROM，而留给用户唯一可写的物理持久化存储空间，是挂载在 /data（或 /userdisk）的分区，剩余容量仅有可怜的 22.4MB ！

这就确立了我们的折腾策略：对于体积经过压缩后的 ZeroTier 等较小的、需要长期稳定运行的软件二进制文件，我们勉强能将其塞进 /data 实现本地持久化；但对于后续体积稍微大一点的软件，比如动辄二三十兆的 Mihomo，Flash 肯定是吃不消的。好在系统划分了一块 118.8MB 的 /tmp 内存盘 tmpfs，后续我们就得好好利用这块读写极快且不占闪存寿命的“风水宝地”，通过脚本热加载的形式让大软件在内存中跑。

2.2.3 TUN 检查#

1
root@XiaoQiang:~# ls -l /dev/net/tun
2
crw-------    1 root     root       10, 200 Jan  1  1970 /dev/net/tun
3

4
root@XiaoQiang:~# lsmod | grep tun
5
ip_tunnel              24576  2 ip_gre,sit
6
ip6_tunnel             36864  1 ip6_gre
7
ip6_udp_tunnel         16384  1 l2tp_core
8
tunnel4                16384  1 sit
9
tunnel6                16384  1 ip6_tunnel
10
udp_tunnel             16384  1 l2tp_core

Zerotier 的运行强依赖 Linux 内核的虚拟网络设备（TUN/TAP）模块 ，之前博主没在 AC2350 上装成功，有一个重要原因就是官方内核彻底阉割了 TUN 支持。但从上方的查询结果来看，设备节点 /dev/net/tun 完好无损地存在着，并且通过 lsmod 可以看到内核已经内置并加载了大量相关的 tunnel 隧道模块。

没有想到小米这次竟然这么大方，没对底层的 TUN 动刀子，这把对于折腾玩家来说简直是“天胡开局”了！

3.5.1 创建 Moon 节点#

WARNING

这一步请在正式接入你的目标网络环境（如家中网络）后再做，因为涉及到了公网 IP。

首先查找公网 IPv6 地址。进入路由器管理页面，在首页“路由状态”点击“互联网状态”，复制“WAN IPv6地址”备用。

WARNING

地址后面可能会有/64 /128这类后缀，复制时不要把后缀复制进去！

然后回到 SSH，输入命令，提取公钥并生成基础 moon.json 模板。

1
/data/zerotier-idtool initmoon /data/zerotier/identity.public >> /data/zerotier/moon.json

然后在 MobaXterm 左侧的文件浏览器中，进入 /data/zerotier/ 目录。找到 moon.json 文件，直接双击它，MobaXterm 会调用内置的文本编辑器打开。向下滚动寻找 roots 数组。需要修改其中的 stableEndpoints 字段。本身是空的，需要先输入一对英文引号，在其中输入刚才复制的 IPv6 地址，后面加一个端口号 /9993，如下图。

然后保存。出现覆盖或写入提示选择“是”。

签名并生效配置：回到 MobaXterm 的 SSH 终端中，依次执行以下命令，并重启服务：

1
# 利用修改好的 json 编译生成签名文件 (000000xxxx.moon)
2
/data/zerotier-idtool genmoon /data/zerotier/moon.json
3

4
# 创建 Moon 存放目录并移入
5
mkdir -p /data/zerotier/moons.d
6
mv 000000*.moon /data/zerotier/moons.d/
7

8
# 杀掉进程并重启，使其加载 Moon 配置
9
killall zerotier-one
10
/data/zerotier-one -d /data/zerotier

至此，这台 AX3000T 就已经是一台合格的 IPv6 Moon 节点了。

3.5.2 为其他设备添加 Moon 节点#

首先获取这台路由器的Zerotier ID。在终端输入：

1
/data/zerotier-cli -D/data/zerotier info

执行后，终端会返回类似这样的一行信息：

1
200 info a1b2c3d4e5 1.14.2 ONLINE

中间那串 10 位由字母和数字组成的字符串（例如示例中的 a1b2c3d4e5），就是这台路由器的 ZeroTier ID。

后续你只需要在其它运行 ZeroTier 客户端的电脑/服务器终端中，执行 zerotier-cli orbit <这台路由器的ZeroTier ID> <这台路由器的ZeroTier ID>，就可以享受到它的辅助打洞加速服务了。

3.6.1 持久化运行的原理#

这台 AX3000T 虽然底层是 OpenWrt，但小米对其进行了严格的“防篡改”魔改。它就像是网吧里装了“还原卡”的电脑，或者我们极客常玩的 Windows PE —— 每次开机时，系统都会从只读的底层模板中，将 /etc/init.d/、/etc/rc.local 甚至 /etc/firewall.user 等这些通常用来做开机自启的核心目录强制覆盖清空。这意味着，传统的 OpenWrt 驻留自启教程在这里统统失效。

那么，我们刚开始使用的 xmir-patcher 是怎么做到让 SSH 服务永久存活的呢？

博主顺藤摸瓜，扒开了 xmir-patcher 的源码，终于发现了它实现持久化的核心机密 —— 利用 OpenWrt 底层的 UCI (Unified Configuration Interface) 机制，进行“防火墙生命周期注入”。

简单来说，就是“借鸡生蛋”：

1. 避开重置区。我们不碰那些开机会被还原的文件，而是将我们写好的启动脚本（比如 start_zt.sh）安全地存放在唯一不会被清空的物理分区 /data 下。

2. 利用 UCI 规则。小米系统虽然会还原脚本文件，但它会保留核心的 UCI 配置文件（写入 NVRAM 闪存） 。我们通过 UCI 命令，在系统的防火墙配置中强行插入一条 include 指令。

3. 当路由器开机、拨号成功、网络接口初始化完毕时，系统会自动重载防火墙。此时，防火墙就会读取到我们通过 UCI 注入的规则，顺着路径来到 /data 目录，把我们的脚本拉起来。

这个逻辑非常精妙！它不仅完全不怕小米的官方 OTA 升级，而且 Timing 很合适——对于 ZeroTier 或代理软件来说，等底层网络和防火墙就绪后再启动，能最大程度避免断网或死锁报错。

因此，这个做法就作为我们后续持久化自己安装的软件的标准做法了。后续无论是开启本节的 ZeroTier，还是后面我们要试验的任何软件（如缓存跑 Mihomo），我们都将严格遵循这个固化逻辑。

3.6.2 编写 ZeroTier 启动脚本#

我们遵循上节的研究结果，在 /data 下单独建一个 ZeroTier 启动脚本。

1. 在 MobaXterm 左侧进入 /data 目录。
2. 右键点击空白处，选择 “New empty file” (新建空文件)，命名为 start_zt.sh。
3. 双击打开 start_zt.sh，将以下代码粘贴进去：

1
#!/bin/sh
2

3
# 等待 10 秒，确保系统的底层网络（网卡、TUN模块）已经初始化完毕
4
sleep 10
5

6
# 检查进程是否存在，避免防火墙重载时重复启动产生僵尸进程
7
if ! pgrep -f "/data/zerotier-one" > /dev/null; then
8
    # 强制后台运行，并指定配置文件目录
9
    /data/zerotier-one -d /data/zerotier
10

11
    # 顺手往系统日志里写一条记录，方便以后排错
12
    logger -t "ZeroTier-Patcher" "ZeroTier initialized from /data"
13
else
14
    logger -t "ZeroTier-Patcher" "ZeroTier is already running"
15
fi

4. 重要的一步：如下图，编辑完后，一定要在上方的“格式”菜单中选择 Linux / Unix，以免造成换行符冲突。之后所有用 MobaXterm 直接创建的脚本文件都需这样操作！

保存并关闭文件。在终端中执行命令，赋予它可执行权限：

1
chmod +x /data/start_zt.sh

3.6.3 添加防火墙规则#

在终端中运行下面几行代码：

1
# 1. 新建一个名为 zerotier 的防火墙脚本包含规则
2
uci set firewall.zerotier=include
3

4
# 2. 指定类型为 shell 脚本
5
uci set firewall.zerotier.type='script'
6

7
# 3. 指向我们刚才写好的自启脚本路径
8
uci set firewall.zerotier.path='/data/start_zt.sh'
9

10
# 4. 启用该规则
11
uci set firewall.zerotier.enabled='1'
12

13
# 5. 提交并保存修改到闪存（这一步极其关键，确保重启不丢失）
14
uci commit firewall

完成后执行cat /etc/config/firewall，如图，可见末尾增加了zerotier配置，添加成功。

3.6.4 重启验证#

持久化配置完成后，最稳妥的验证方式就是直接拔电源或软重启。可以在终端输入：

1
reboot

等待路由器重启完成，再次用 MobaXterm 连接上 SSH，执行以下命令：

1
# 检查进程是否自动拉起
2
ps -w | grep zerotier
3

4
# 检查网络是否正常打通
5
/data/zerotier-cli -D/data/zerotier listpeers

如果进程存在，且节点列表正常输出，类似于下面，恭喜你！ZeroTier 成功部署！它现在已经像原厂服务一样扎根在这台 AX3000T 里了。

1
root@XiaoQiang:~# ps -w | grep zerotier
2
 2185 root     30684 S    /data/zerotier-one -d /data/zerotier
3
10406 root      1464 S    grep zerotier
4
root@XiaoQiang:~# /data/zerotier-cli -D/data/zerotier listpeers
5
200 listpeers <ztaddr> <path> <latency> <version> <role>
6
200 listpeers 68bea79acf 35.209.29.203/34689;6247;6247 247 1.16.2 LEAF
7
200 listpeers 778cde7190 103.195.103.66/9993;7634;67386 254 - PLANET
8
200 listpeers cafe04eba9 84.17.53.155/9993;2634;37366 183 - PLANET
9
200 listpeers cafe80ed74 185.152.67.145/9993;7634;40215 194 - PLANET
10
200 listpeers cafefd6717 79.127.159.187/9993;7634;67420 219 - PLANET

IMPORTANT

在本章的所有操作中，你可能已经注意到，我们执行 ZeroTier 相关的 CLI 命令（如 join、listpeers、info 等）时，都带上了 -D/data/zerotier 参数。这至关重要！

小米路由器的原厂系统默认会将程序配置写入内存盘 /var/lib/zerotier-one，这会导致一旦路由器重启，你辛苦配置好的网络节点和身份认证信息瞬间“灰飞烟灭”。通过显式添加 -D/data/zerotier 参数，我们是在强制告诉 ZeroTier 程序：请去我的 /data 闪存分区读取和写入配置。

记住这个“护身符”，它就是确保你的 ZeroTier 异地组网能够跨越重启、跨越断电，永久“钉”在路由器里的核心参数。

4.1.1 问题#

在搞定了 ZeroTier 之后，博主的极客 DNA 彻底按捺不住了。既然底层的 TUN 模块健在，我们要把硬路由软化 ，那不跑个透明网关简直暴殄天物啊！但当我们把目光转向 Mihomo 时，现实泼了一盆冷水。

Mihomo 作为一个功能极其强大的代理核心，它的官方原生 ARM64 二进制文件体积通常在 25MB 左右！即便我们像之前处理 ZeroTier 那样，用 UPX 进行极限压缩，最后的体积也只能勉强压到 8MB 上下。

大家不要忘了，我们这台路由器的 /data 分区总共只有可怜的 22.4MB。如果直接把 8MB 的核心文件塞进去，不仅浪费了极其宝贵的存储空间，而且 Mihomo 在运行过程中还需要下载动辄十几兆的路由规则库（GeoSite.dat、GeoIP.dat），这会让 /data 分区瞬间爆满，甚至导致路由器死机。

还有闪存寿命。Mihomo 运行时会频繁读写缓存数据（如 cache.db）和更新订阅节点。如果把它的工作目录设在物理闪存上，路由器的 Flash 颗粒可能在几个月内就会因为过度擦写而寿终正寝。

4.1.2 总体思路#

对此，我们的思路就是：把118.8MB 的 /tmp 内存盘利用起来，让 Mihomo 实现开机热加载。 具体来说：

1. 在本地的 /data 分区中，我们只保留几 KB 大小的 config.yaml 配置文件。
2. 编写一个自启脚本，在路由器开机并连上网络后，直接通过国内的加速镜像站，从 GitHub 拉取指定版本的 Mihomo 二进制压缩包（.gz格式）以及最新的国内 IP/站点数据库。
3. 脚本在 /tmp 内存盘中开辟一块专属空间，自动解压下载好的核心文件，并将配置和数据库都放入其中。Mihomo 的启动和后续的所有高频读写，都将完全在这个内存沙盒中进行。

这种方案不仅实现了对路由器物理闪存的 0 损耗，而且每次开机路由器都会自动获取最新的核心和规则库，真正做到了“无盘热加载、热启动”。

4.1.3 管理面板#

既然核心都在内存里跑了，为了节省空间，我们就不要把庞大的 管理面板 MetacubeXD 塞进路由器了。

Mihomo 本身提供了一个强大的外部控制 API。我们只需要在配置文件中暴露出 9090 端口，然后在局域网内的任何一台电脑或者 NAS 上部署 MetacubeXD 面板，输入路由器的 IP 和 9090 端口，就能实现对 Mihomo 节点和规则的可视化管理了。

4.2.1 热加载脚本编写#

在 /data 目录下新建 start_clash.sh，把格式改为Linux / Unix ，写入以下代码：

1
#!/bin/sh
2

3
# ================= 辅助监控函数 =================
4
log_info() {
5
    logger -t "Mihomo-Patcher" "$1"
6
    echo ">>> [INFO] $1"
7
}
8
log_err() {
9
    logger -t "Mihomo-Patcher" "$1"
10
    echo "!!! [ERROR] $1"
11
}
12
# ================================================
13

14
# 1. 防重入检测
15
if pgrep -f "/tmp/clash/mihomo" > /dev/null; then
16
    log_info "Mihomo is already running, skipping boot."
17
    exit 0
18
fi
19

20
log_info "Starting Mihomo network boot sequence (v1.19.27) in BACKGROUND..."
21

22
# =======================================================
23
# 核心架构：将所有耗时操作放入子 Shell 并强制后台运行 (&)
24
# =======================================================
25
(
26
    # 2. 构建内存沙盒
27
    log_info "Creating tmpfs sandbox (/tmp/clash)..."
28
    mkdir -p /tmp/clash
29

30
    # 3. 核心逻辑：死等网络连通 (循环 ping 阿里 DNS)
31
    log_info "Checking network connectivity..."
32
    MAX_WAIT=30
33
    WAIT_CNT=0
34
    while ! ping -c 1 -W 1 223.5.5.5 > /dev/null 2>&1; do
35
        WAIT_CNT=$((WAIT_CNT+1))
36
        if [ "$WAIT_CNT" -ge "$MAX_WAIT" ]; then
37
            log_err "Network timeout! Boot aborted."
38
            exit 1
39
        fi
40
        sleep 2
41
    done
42

43
    log_info "Network is UP. Downloading payloads..."
44

45
    # 4. 利用加速节点拉取官方压缩包与 Geo 数据库
46
    CORE_URL="https://ghproxy.net/https://github.com/MetaCubeX/mihomo/releases/download/v1.19.27/mihomo-linux-arm64-v1.19.27.gz"
47
    GEOSITE_URL="https://ghproxy.net/https://github.com/MetaCubeX/meta-rules-dat/releases/download/latest/geosite.dat"
48
    GEOIP_URL="https://ghproxy.net/https://github.com/MetaCubeX/meta-rules-dat/releases/download/latest/geoip.dat"
49

50
    # 4.1 下载并解压核心程序
51
    if curl -L -k -f -s -o /tmp/clash/mihomo.gz "$CORE_URL"; then
52
        log_info "Core downloaded. Extracting gzip payload..."
53
        gzip -d /tmp/clash/mihomo.gz
54
        chmod +x /tmp/clash/mihomo
55
    else
56
        log_err "Core download failed!"
57
        exit 1
58
    fi
59

60
    # 4.2 提前下载 Geo 规则，打破死锁
61
    log_info "Downloading GeoSite and GeoIP databases..."
62
    curl -L -k -s -o /tmp/clash/GeoSite.dat "$GEOSITE_URL"
63
    curl -L -k -s -o /tmp/clash/GeoIP.dat "$GEOIP_URL"
64
    log_info "Geo databases downloaded."
65

66
    # 5. 复制本地固化的配置文件
67
    log_info "Copying config.yaml to tmpfs..."
68
    cp /data/clash/config.yaml /tmp/clash/config.yaml
69

70
    # 6. 点火运行
71
    log_info "Ignition! Starting Mihomo..."
72
    /tmp/clash/mihomo -d /tmp/clash > /tmp/clash/mihomo.log 2>&1 &
73

74
    # 7. 防火墙开门（为面板控制 API 放行 9090 端口）
75
    log_info "Opening firewall port 9090 for Dashboard..."
76
    iptables -I INPUT -p tcp --dport 9090 -j ACCEPT
77

78
    log_info "Boot sequence finished gracefully."
79
) &
80

81
# 脚本主进程瞬间退出，交还防火墙控制权
82
exit 0

这段脚本看似很长，但处处都是“心机”：

• 全量后台异步化 ( ... ) &：这是解决断网阻塞的核心。耗时的网络检测和下载全被塞进了一个子 Shell 中并在后台运行，脚本的主进程瞬间就能走到最后的 exit 0 并把控制权交还给系统防火墙，家里其他设备的网络不会卡顿。
• 自带解压与打破死锁：利用国内的 GitHub 镜像源 ghproxy.net 不仅拉取了 .gz 核心文件，还直接通过系统自带的 gzip -d 命令原地解压，省去了电脑端转换的麻烦；同时，在启动核心前提前拉取了 Geo 数据库，规避了启动时的断网死锁。
• 全链路日志探针：利用 log_info 函数将运行状态同时输出到终端和系统日志中，不仅方便排错，还将 Mihomo 自身的运行日志重定向到了 /tmp/clash/mihomo.log，随时可以 troubleshooting。
• 动态放行：为了防止小米苛刻的自带防火墙拦截面板访问，脚本在启动核心后，利用 iptables 强行给 9090 控制端口开了一个绿灯。

保存这段脚本后，可以直接在 SSH 中敲入 /data/dtart_clash.sh 先试运行看看效果，如果没什么问题，Mihomo 成功加载，那就 OK 啦！

4.2.2 UCI命令持久化#

脚本准备就绪后，我们又要回到熟悉的持久化环节了。这里的做法和我们在第三章中对 ZeroTier 所做的完全一致，依然是利用 OpenWrt 底层的 UCI 机制，把我们的热加载脚本作为一条“防火墙规则”注入到系统启动生命周期中。

在终端依次粘贴并执行以下 5 条命令：

1
# 1. 新建名为 mihomo 的防火墙自定义规则
2
uci set firewall.mihomo=include
3

4
# 2. 声明规则类型为 shell 脚本
5
uci set firewall.mihomo.type='script'
6

7
# 3. 指定脚本的绝对路径
8
uci set firewall.mihomo.path='/data/start_clash.sh'
9

10
# 4. 启用该规则
11
uci set firewall.mihomo.enabled='1'
12

13
# 5. 提交保存到闪存（极其关键，确保重启后规则不丢失）
14
uci commit firewall

大功告成！现在就可以重启路由器看效果了。