mihomo（Clash Meta）完全配置指南 2026：配置文件详解 + 规则集 + TUN 模式 + Docker 部署 + 旁路由透明代理

mihomo（前身为 Clash Meta）是目前最活跃的开源代理内核，在原版 Clash 和 Clash Premium 相继停更后，mihomo 成为 2024-2026 年代理工具生态的事实标准内核。Clash Verge Rev、OpenClash、PassWall 等主流客户端均使用 mihomo 内核驱动。

本文聚焦 mihomo 内核层的深度配置，区别于其他前端客户端教程：直接操作 YAML 配置文件，掌握内核能力的上限，适合进阶用户和需要在路由器/服务器上部署的场景。

一、mihomo 与各版本 Clash 的关系#

1
2020  Clash（原版开源）
2
       ├── Clash Premium（官方闭源增强版）← 新增 TUN、Rule Provider、Script 等
3
       └── Clash.Meta / Clash Meta（社区分支，完全开源）
4

5
2023年末
6
  Clash 原版和 Premium 删库 ──→ Clash.Meta 社区接管，改名 mihomo
7

8
2024-2026  mihomo（当前主流）
9
           内置于：Clash Verge Rev、OpenClash、sing-box GUI 等

mihomo vs Clash Premium 核心差异：

功能	Clash Premium（已删库）	mihomo（当前）
TUN 模式	✅	✅ 更完善
Rule Provider	✅	✅
Script 脚本	✅	✅
VLESS Reality	❌	✅
Hysteria2	❌	✅
TUIC v5	❌	✅
开源	❌ 闭源	✅ 完全开源
维护状态	❌ 已删库停更	✅ 活跃维护

二、配置文件完整结构解析#

mihomo 使用 YAML 格式配置文件。以下是一份带完整注释的配置模板，覆盖所有常用字段：

1
# ╔══════════════════════════════════════════════════════════════╗
2
# ║              mihomo 配置文件完整模板（2026版）                ║
3
# ╚══════════════════════════════════════════════════════════════╝
4

5
# ── 一、基础监听端口 ──────────────────────────────────────────
6
port: 7890               # HTTP/HTTPS 代理端口
7
socks-port: 7891         # SOCKS5 代理端口
8
redir-port: 7892         # 透明代理端口（用于旁路由/iptables 重定向）
9
tproxy-port: 7893        # TProxy 透明代理端口（Linux Only，用于 UDP）
10
mixed-port: 7897         # 混合端口（HTTP + SOCKS5 合一，推荐客户端使用）
11

12
# 允许局域网连接（旁路由方案必须开启）
13
allow-lan: true
14
# 绑定地址，* 表示监听所有接口
15
bind-address: "*"
16

17
# ── 二、运行模式 ─────────────────────────────────────────────
18
# rule：规则模式（推荐）| global：全局模式 | direct：直连模式
19
mode: rule
20

21
# 日志级别：info / warning / error / debug / silent
22
log-level: info
23

24
# 是否开启 IPv6 支持（通常建议关闭）
25
ipv6: false
26

27
# ── 三、外部控制 API（用于 UI 面板）────────────────────────
28
external-controller: 0.0.0.0:9090   # API 地址（面板通过此接口控制）
29
external-controller-tls: 0.0.0.0:9443  # HTTPS API（可选）
30
secret: "your-secret-token"          # API 密钥（务必修改！）
31

32
# UI 面板文件目录（将 Yacd/MetaCubeX 前端放这里）
33
external-ui: /path/to/ui
34

35
# ── 四、DNS 配置 ─────────────────────────────────────────────
36
dns:
37
  enable: true
38
  listen: 0.0.0.0:53        # DNS 监听端口（TUN 模式会自动劫持）
39
  ipv6: false
40

41
  # enhanced-mode：fake-ip（推荐）或 redir-host
42
  # fake-ip 模式：为所有域名返回假 IP（198.18.x.x），由 mihomo 解析实际地址
43
  # 优点：DNS 不泄漏，延迟更低，更适合 TUN 模式
44
  enhanced-mode: fake-ip
45
  fake-ip-range: 198.18.0.1/16
46

47
  # 不使用 fake-ip 的域名（本地域名、NAS 等需要真实 IP 的服务）
48
  fake-ip-filter:
49
    - "*.lan"
50
    - "*.local"
51
    - "*.internal"
52
    - "+.stun.*.*"
53
    - "+.stun.*.*.*"
54
    - "localhost.ptlogin2.qq.com"
55
    - "dns.msftncsi.com"
56

57
  # 用于引导解析 DoH/DoT 服务器域名的 DNS（必须是 IP，不走规则）
58
  default-nameserver:
59
    - 119.29.29.29      # 腾讯 DNSPod（国内快速）
60
    - 223.5.5.5         # 阿里 DNS
61

62
  # 主 DNS 服务器（推荐 DoH 防运营商劫持）
63
  nameserver:
64
    - https://doh.pub/dns-query                    # 腾讯 DoH
65
    - https://dns.alidns.com/dns-query             # 阿里 DoH
66

67
  # 非中国域名使用海外 DNS（走代理解析）
68
  fallback:
69
    - https://1.1.1.1/dns-query                    # Cloudflare DoH
70
    - https://8.8.8.8/dns-query                    # Google DoH
71
    - tls://1.1.1.1:853                            # Cloudflare DoT
72

73
  # fallback 过滤规则：判断为国内 IP 或国内域名时用 nameserver，否则用 fallback
74
  fallback-filter:
75
    geoip: true
76
    geoip-code: CN
77
    ipcidr:
78
      - 240.0.0.0/4
79
    domain:
80
      - "+.google.com"
81
      - "+.facebook.com"
82
      - "+.youtube.com"
83

84
# ── 五、TUN 模式 ─────────────────────────────────────────────
85
tun:
86
  enable: true
87
  stack: mixed          # mixed（推荐）| system | gvisor
88
  dns-hijack:
89
    - "any:53"          # 劫持所有 DNS 请求
90
    - "tcp://any:53"
91
  auto-route: true      # 自动添加路由表
92
  auto-redirect: true   # 自动重定向（macOS/Linux）
93
  auto-detect-interface: true  # 自动检测出口网卡
94

95
# ── 六、代理节点（proxies）───────────────────────────────────
96
proxies:
97
  # 也可以为空，全部通过 proxy-providers 拉取
98
  - name: "手动节点示例"
99
    type: vless
100
    server: example.com
101
    port: 443
102
    uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
103
    network: ws
104
    tls: true
105
    ws-opts:
106
      path: /path
107

108
# ── 七、代理提供者（Proxy Providers）────────────────────────
109
proxy-providers:
110
  # 从机场订阅链接动态拉取节点
111
  MyAirport:
112
    type: http
113
    url: "https://你的机场订阅链接"
114
    interval: 3600           # 每小时自动更新
115
    path: ./providers/airport.yaml
116
    health-check:
117
      enable: true
118
      url: https://www.gstatic.com/generate_204
119
      interval: 300           # 每 5 分钟测速
120

121
# ── 八、代理组（proxy-groups）──────────────────────────────
122
proxy-groups:
123
  # 主选择组：手动选择或自动选最快
124
  - name: "🚀 节点选择"
125
    type: select
126
    use:
127
      - MyAirport        # 使用 proxy-provider 中的节点
128
    proxies:
129
      - "♻️ 自动选择"
130
      - DIRECT
131

132
  # 自动测速选最快节点
133
  - name: "♻️ 自动选择"
134
    type: url-test
135
    use:
136
      - MyAirport
137
    url: https://www.gstatic.com/generate_204
138
    interval: 300
139
    tolerance: 50          # 延迟差距超 50ms 才切换（防抖动）
140

141
  # 流媒体专用组（手动指定解锁节点）
142
  - name: "🎬 流媒体"
143
    type: select
144
    use:
145
      - MyAirport
146
    filter: "港|日|新|美|HK|JP|SG|US"   # 过滤节点名称
147

148
  # AI 服务专用组
149
  - name: "🤖 AI 服务"
150
    type: select
151
    proxies:
152
      - "🚀 节点选择"
153
    use:
154
      - MyAirport
155
    filter: "美|日|US|JP"
156

157
  # 兜底策略：没有匹配规则时走此组
158
  - name: "🐟 漏网之鱼"
159
    type: select
160
    proxies:
161
      - "🚀 节点选择"
162
      - DIRECT
163

164
# ── 九、规则提供者（Rule Providers）────────────────────────
165
rule-providers:
166
  # Loyalsoldier 维护的高质量规则集
167
  reject:
168
    type: http
169
    behavior: domain
170
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/reject.txt"
171
    path: ./ruleset/reject.yaml
172
    interval: 86400
173

174
  icloud:
175
    type: http
176
    behavior: domain
177
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/icloud.txt"
178
    path: ./ruleset/icloud.yaml
179
    interval: 86400
180

181
  apple:
182
    type: http
183
    behavior: domain
184
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/apple.txt"
185
    path: ./ruleset/apple.yaml
186
    interval: 86400
187

188
  google:
189
    type: http
190
    behavior: domain
191
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/google.txt"
192
    path: ./ruleset/google.yaml
193
    interval: 86400
194

195
  proxy:
196
    type: http
197
    behavior: domain
198
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/proxy.txt"
199
    path: ./ruleset/proxy.yaml
200
    interval: 86400
201

202
  direct:
203
    type: http
204
    behavior: domain
205
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/direct.txt"
206
    path: ./ruleset/direct.yaml
207
    interval: 86400
208

209
  private:
210
    type: http
211
    behavior: domain
212
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/private.txt"
213
    path: ./ruleset/private.yaml
214
    interval: 86400
215

216
  gfw:
217
    type: http
218
    behavior: domain
219
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/gfw.txt"
220
    path: ./ruleset/gfw.yaml
221
    interval: 86400
222

223
  cncidr:
224
    type: http
225
    behavior: ipcidr
226
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/cncidr.txt"
227
    path: ./ruleset/cncidr.yaml
228
    interval: 86400
229

230
  lancidr:
231
    type: http
232
    behavior: ipcidr
233
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/lancidr.txt"
234
    path: ./ruleset/lancidr.yaml
235
    interval: 86400
236

237
# ── 十、分流规则（rules）────────────────────────────────────
238
rules:
239
  # 广告域名：直接拒绝
240
  - RULE-SET,reject,REJECT
241

242
  # 私有/局域网：直连
243
  - RULE-SET,private,DIRECT
244
  - RULE-SET,lancidr,DIRECT,no-resolve
245

246
  # iCloud 直连（国内 CDN 加速）
247
  - RULE-SET,icloud,DIRECT
248

249
  # Apple 服务：可根据需要改为 DIRECT 或代理
250
  - RULE-SET,apple,DIRECT
251

252
  # AI 服务：走 AI 专用组
253
  - DOMAIN-SUFFIX,openai.com,🤖 AI 服务
254
  - DOMAIN-SUFFIX,anthropic.com,🤖 AI 服务
255
  - DOMAIN-SUFFIX,gemini.google.com,🤖 AI 服务
256

257
  # 流媒体：走流媒体组
258
  - DOMAIN-SUFFIX,netflix.com,🎬 流媒体
259
  - DOMAIN-SUFFIX,nflxvideo.net,🎬 流媒体
260
  - DOMAIN-SUFFIX,disney.com,🎬 流媒体
261
  - DOMAIN-SUFFIX,hbo.com,🎬 流媒体
262

263
  # Google 服务：走代理
264
  - RULE-SET,google,🚀 节点选择
265

266
  # 被墙域名：走代理
267
  - RULE-SET,proxy,🚀 节点选择
268
  - RULE-SET,gfw,🚀 节点选择
269

270
  # 国内域名和 IP：直连
271
  - RULE-SET,direct,DIRECT
272
  - RULE-SET,cncidr,DIRECT,no-resolve
273

274
  # GeoIP 判断
275
  - GEOIP,LAN,DIRECT
276
  - GEOIP,CN,DIRECT
277

278
  # 兜底：未匹配的走漏网之鱼组
279
  - MATCH,🐟 漏网之鱼

三、proxy-groups 进阶配置#

3.1 fallback（故障切换组）#

1
proxy-groups:
2
  # 故障切换：主节点不可用时自动切换到备用节点
3
  - name: "🛡️ 故障切换"
4
    type: fallback
5
    use:
6
      - MyAirport
7
    url: https://www.gstatic.com/generate_204
8
    interval: 60         # 每 60 秒检测一次
9
    lazy: false          # 启动时立即检测（不延迟）

3.2 load-balance（负载均衡组）#

1
proxy-groups:
2
  # 负载均衡：多个节点同时使用，分散流量
3
  - name: "⚖️ 负载均衡"
4
    type: load-balance
5
    use:
6
      - MyAirport
7
    url: https://www.gstatic.com/generate_204
8
    interval: 300
9
    # strategy: consistent-hashing  # 同一域名固定打同一节点（默认）
10
    strategy: round-robin           # 轮询分配（适合无状态请求）

3.3 filter 过滤节点#

1
proxy-groups:
2
  # 只使用机场中的香港节点
3
  - name: "🇭🇰 香港节点"
4
    type: url-test
5
    use:
6
      - MyAirport
7
    filter: "(?i)港|HK|Hong Kong"   # 正则匹配节点名称
8
    url: https://www.gstatic.com/generate_204
9
    interval: 300
10
    tolerance: 30
11

12
  # 排除某些节点（如排除试用/免费节点）
13
  - name: "🚀 精选节点"
14
    type: select
15
    use:
16
      - MyAirport
17
    filter: "^(?!.*(?:试用|FREE|free)).*$"   # 排除含"试用"和"FREE"的节点

四、TUN 模式详细配置与验证#

4.1 TUN stack 模式对比#

Stack	说明	适用平台	推荐场景
`mixed`	TCP 走 system，UDP 走 gvisor	全平台	推荐，通用性最好
`system`	全部走系统网络栈	Linux/macOS	追求性能
`gvisor`	全部走用户态网络栈	全平台	兼容性最佳，性能略低
`lwip`	轻量级实现（实验性）	嵌入式	路由器资源受限场景

4.2 完整 TUN 配置#

1
tun:
2
  enable: true
3
  stack: mixed
4

5
  # DNS 劫持：拦截所有 DNS 请求，防止 DNS 泄漏
6
  dns-hijack:
7
    - "any:53"
8
    - "tcp://any:53"
9

10
  # 自动路由：向系统路由表添加规则
11
  auto-route: true
12

13
  # 自动重定向（macOS/iOS 透明代理，Linux 不需要）
14
  auto-redirect: true
15

16
  # 严格路由：防止流量绕过 TUN
17
  # strict-route: true   # 开启后某些 LAN 功能可能受影响，按需启用
18

19
  # 自动检测出口网卡
20
  auto-detect-interface: true
21

22
  # 以下为 Linux 旁路由场景配置（TUN 接口名称）
23
  # device: utun0    # macOS 默认 utun0，Linux 默认 tun0
24

25
  # 排除特定 IP 不走 TUN（如直连本地服务）
26
  # exclude-package: []  # Android 专用，排除特定 App

4.3 验证 TUN 是否生效#

1
# 方法1：访问 IP 检测网站，查看 IP 是否变为代理 IP
2
curl https://ip.sb
3

4
# 方法2：ping 测试（TUN 模式下 ping 也走代理）
5
ping -c 3 8.8.8.8
6
# 若 TTL 值与直连不同，说明走了 TUN
7

8
# 方法3：DNS 泄漏检测
9
# 访问 https://dnsleaktest.com → Extended Test
10
# 所有 DNS 服务器应为代理节点的 DNS，不应出现运营商 DNS
11

12
# 方法4：查看 TUN 网卡
13
ip addr show   # Linux：查看是否有 tun0 接口
14
ifconfig       # macOS：查看是否有 utun 开头的接口

五、Docker 部署 mihomo + UI 面板#

5.1 目录结构准备#

1
mkdir -p /opt/mihomo/{config,ui}
2
cd /opt/mihomo

5.2 下载 UI 面板（MetaCubeX）#

1
# 下载 MetaCubeX-UI（功能最完整）
2
wget -O /tmp/metacubexd.tar.gz \
3
  https://github.com/metacubex/metacubexd/releases/latest/download/compressed-dist.tgz
4
tar -xzf /tmp/metacubexd.tar.gz -C /opt/mihomo/ui/
5

6
# 或者使用更轻量的 Yacd-meta
7
wget -O /tmp/yacd-meta.tar.gz \
8
  https://github.com/metacubex/yacd/releases/latest/download/yacd.tar.xz
9
tar -xJf /tmp/yacd-meta.tar.gz -C /opt/mihomo/ui/

5.3 配置文件#

在 /opt/mihomo/config/config.yaml 写入配置（参考第二节模板），重点注意：

1
# Docker 部署时监听 0.0.0.0 而非 127.0.0.1
2
external-controller: 0.0.0.0:9090
3
secret: "your-strong-secret"
4

5
# UI 文件路径（映射到容器内路径）
6
external-ui: /ui

5.4 Docker Compose 部署#

1
version: "3.8"
2

3
services:
4
  mihomo:
5
    image: metacubex/mihomo:latest     # 官方镜像
6
    container_name: mihomo
7
    restart: unless-stopped
8

9
    # 网络：host 模式允许 TUN/透明代理（推荐）
10
    # 注意：host 模式下容器直接使用宿主机网络栈
11
    network_mode: host
12

13
    # 权限：TUN 模式需要 NET_ADMIN
14
    cap_add:
15
      - NET_ADMIN
16

17
    volumes:
18
      - ./config:/root/.config/mihomo    # 配置文件目录
19
      - ./ui:/ui                          # UI 面板文件
20
      - /etc/localtime:/etc/localtime:ro  # 同步时区
21

22
    # 如果不用 host 模式，使用 bridge 并暴露端口
23
    # ports:
24
    #   - "7897:7897"    # mixed port
25
    #   - "9090:9090"    # API
26
    #   - "7893:7893"    # redir-port
27

28
    devices:
29
      - /dev/net/tun:/dev/net/tun     # TUN 设备访问（不用 TUN 可去掉）

1
# 启动
2
docker compose up -d
3

4
# 查看日志
5
docker logs -f mihomo
6

7
# 重载配置（不重启容器）
8
curl -X PUT http://127.0.0.1:9090/configs \
9
     -H "Authorization: Bearer your-strong-secret" \
10
     -H "Content-Type: application/json" \
11
     -d '{"path":"/root/.config/mihomo/config.yaml"}'

5.5 访问 UI 面板#

启动后访问：http://服务器IP:9090/ui

在面板中可以：

实时查看所有节点延迟
手动切换代理组
查看实时连接列表
修改运行模式（规则/全局/直连）

六、旁路由透明代理方案#

旁路由是指将一台 Linux 设备（树莓派、软路由、NAS、虚拟机）接入家庭网络，由它承担代理功能，其他设备只需将默认网关指向旁路由即可自动走代理，无需每台设备单独配置。

6.1 网络拓架构#

1
互联网
2
  ↓
3
主路由（运营商光猫 / 家用路由器）
4
  ↓ 192.168.1.1
5
  ├── 旁路由（mihomo + Linux）192.168.1.2
6
  │    ↑ 将网关/DNS 指向 192.168.1.2 的设备通过此处代理
7
  ├── 电脑 192.168.1.100  ← 网关改为 192.168.1.2
8
  ├── 手机 192.168.1.101  ← 网关改为 192.168.1.2
9
  └── 其他设备...

6.2 mihomo 透明代理配置#

1
# 旁路由专用配置（在原配置基础上修改）
2

3
# 开启局域网访问
4
allow-lan: true
5
bind-address: "*"
6

7
# 透明代理端口
8
redir-port: 7892      # TCP 重定向
9
tproxy-port: 7893     # UDP TProxy（Linux Only）
10

11
# TUN 在旁路由方案中通常不需要（用 iptables 替代）
12
# tun:
13
#   enable: false
14

15
# DNS 必须开启（旁路由承担 DNS 解析）
16
dns:
17
  enable: true
18
  listen: 0.0.0.0:53
19
  enhanced-mode: fake-ip
20
  # ... 其余 DNS 配置同上

6.3 iptables 规则（Linux 旁路由核心）#

1
#!/bin/bash
2
# 旁路由透明代理 iptables 规则
3

4
# mihomo 代理用户（避免代理流量死循环）
5
MIHOMO_UID=1000   # mihomo 进程运行的 UID
6

7
# ── TCP 透明代理 ──────────────────────────────────────────────
8
# 创建自定义链
9
iptables -t nat -N MIHOMO
10

11
# 跳过本机流量和已被代理的流量
12
iptables -t nat -A MIHOMO -d 0.0.0.0/8 -j RETURN
13
iptables -t nat -A MIHOMO -d 10.0.0.0/8 -j RETURN
14
iptables -t nat -A MIHOMO -d 127.0.0.0/8 -j RETURN
15
iptables -t nat -A MIHOMO -d 169.254.0.0/16 -j RETURN
16
iptables -t nat -A MIHOMO -d 172.16.0.0/12 -j RETURN
17
iptables -t nat -A MIHOMO -d 192.168.0.0/16 -j RETURN
18
iptables -t nat -A MIHOMO -d 224.0.0.0/4 -j RETURN
19
iptables -t nat -A MIHOMO -d 240.0.0.0/4 -j RETURN
20

21
# 将其余 TCP 流量重定向到 mihomo 的 redir-port
22
iptables -t nat -A MIHOMO -p tcp -j REDIRECT --to-port 7892
23

24
# 对来自局域网的流量应用规则
25
iptables -t nat -A PREROUTING -p tcp -j MIHOMO
26

27
# 对本机发出的流量（mihomo 进程除外）也应用代理
28
iptables -t nat -A OUTPUT -p tcp \
29
  ! -m owner --uid-owner $MIHOMO_UID \
30
  -j MIHOMO
31

32
# ── UDP 透明代理（TProxy）────────────────────────────────────
33
# 需要内核支持 ip_tables、xt_TPROXY、xt_mark
34

35
ip rule add fwmark 1 table 100
36
ip route add local default dev lo table 100
37

38
# UDP TProxy 规则
39
iptables -t mangle -N MIHOMO_UDP
40

41
iptables -t mangle -A MIHOMO_UDP -d 0.0.0.0/8 -j RETURN
42
iptables -t mangle -A MIHOMO_UDP -d 10.0.0.0/8 -j RETURN
43
iptables -t mangle -A MIHOMO_UDP -d 127.0.0.0/8 -j RETURN
44
iptables -t mangle -A MIHOMO_UDP -d 169.254.0.0/16 -j RETURN
45
iptables -t mangle -A MIHOMO_UDP -d 172.16.0.0/12 -j RETURN
46
iptables -t mangle -A MIHOMO_UDP -d 192.168.0.0/16 -j RETURN
47
iptables -t mangle -A MIHOMO_UDP -d 224.0.0.0/4 -j RETURN
48
iptables -t mangle -A MIHOMO_UDP -d 240.0.0.0/4 -j RETURN
49

50
iptables -t mangle -A MIHOMO_UDP -p udp -j TPROXY \
51
  --on-port 7893 --tproxy-mark 0x1/0x1
52

53
iptables -t mangle -A PREROUTING -p udp -j MIHOMO_UDP
54

55
echo "透明代理规则已应用"

1
# 赋予执行权限并运行
2
chmod +x /opt/mihomo/iptables.sh
3
bash /opt/mihomo/iptables.sh
4

5
# 设置开机自动运行（systemd）
6
cat > /etc/systemd/system/mihomo-iptables.service << 'EOF'
7
[Unit]
8
Description=mihomo iptables rules
9
After=network.target
10

11
[Service]
12
Type=oneshot
13
ExecStart=/opt/mihomo/iptables.sh
14
RemainAfterExit=yes
15

16
[Install]
17
WantedBy=multi-user.target
18
EOF
19

20
systemctl enable mihomo-iptables

6.4 客户端设置#

其他设备要走旁路由代理，只需修改网关和 DNS 为旁路由 IP：

设置项	原值	改为
默认网关	192.168.1.1（主路由）	192.168.1.2（旁路由）
DNS 服务器	192.168.1.1	192.168.1.2

💡 如果不想逐台设备配置，可以在主路由的 DHCP 设置中将默认网关和 DNS 统一改为旁路由 IP，让所有设备自动走旁路由。

七、常见问题排查#

问题	可能原因	解决方法
规则集下载失败	规则集 URL 无法访问（需要代理）	在 mihomo 未启动时先挂 VPN 下载，或使用国内镜像
TUN 模式开启后网络全断	路由冲突	检查 `auto-route` 和系统路由表；重启 mihomo
DNS 泄漏（dnsleaktest 显示运营商 DNS）	fake-ip 未生效	确认 `enhanced-mode: fake-ip`；确认 DNS 监听在 53 端口
旁路由：局域网设备无法上网	iptables 规则未加载	运行 iptables 脚本；检查 `allow-lan: true`
proxy-provider 节点不更新	缓存问题	在 UI 面板手动刷新，或删除 `./providers/` 目录中的缓存文件
某些 App 不走代理	该 App 使用了 DNS over HTTPS 绕过系统 DNS	开启 TUN 模式；或在规则中添加该 App 的 DoH 域名强制走代理
`secret` 验证失败，API 不可访问	Authorization Header 格式错误	正确格式：`Authorization: Bearer your-secret`

八、与主流客户端的关系#

客户端	内核	定位	推荐场景
Clash Verge Rev	mihomo	GUI 桌面客户端	Windows/macOS 日常使用
OpenClash	mihomo	OpenWrt 插件	主路由集成
PassWall / SSR+	多内核	OpenWrt 插件	旧版路由器
sing-box	独立内核	跨平台	新一代替代方案
本文方案	mihomo 裸核	纯后端服务	Docker/旁路由/服务器

相关文章：

免责声明：本文仅为技术学习参考，请在当地法律法规允许的范围内合理使用。所有配置均在测试环境下验证，生产使用前请结合实际情况调整参数。