背景
之前尝试过基于 OpenWrt + OpenClash 搭建旁路由，但 OpenWrt 系统本身较为臃肿，且 OpenClash 配置复杂，稳定性一般。后来也关注过 Sing-box，虽然功能新颖但变动较快，稳定性有待验证。因此，决定基于 OpenClash 的核心 Mihomo，手动搭建一套精简、高效的旁路由方案。
特别是在 Vibe Coding 等 AI 辅助开发模式下，AI 需要自动全局代理，以避免手动解决 npm 包安装、Docker 镜像拉取以及调用大语言模型 API 时的连通性问题。手动开发时可能偶尔需要代理，但 AI 自动开发时对网络连通性要求极高，一个稳定可靠的旁路由方案能极大提升开发效率。
采用 Docker + Macvlan + Mihomo + TUN 的组合，相较于在 OpenWrt 上再搭建服务，具有以下优势：
- 更轻量：无需完整的 OpenWrt 系统，仅需 Docker 容器运行 Mihomo。
- 启动更快：容器化部署，启动和重启速度显著提升。
- 更稳定：Mihomo 作为 Clash 核心，经过多年发展，稳定性有保障。
架构图
flowchart LR
subgraph Terminal[终端设备]
T1[电脑/手机]
end
subgraph Host[宿主机]
subgraph Docker[Docker]
M[Mihomo容器]
end
end
subgraph Network[网络出口]
Direct[直连]
Proxy[代理]
end
T1 -->|设置网关为 192.168.1.11| M
M --> Rule[规则引擎]
Rule -->|中国域名/IP| Direct
Rule -->|其他| Proxy
Direct --> Internet[互联网]
Proxy --> Internet
准备工作
- 一台支持 Docker 的 Linux 主机（物理机或虚拟机均可）
- 确保系统支持 macvlan 网络驱动（通常 Linux 内核 3.9+ 都支持）
- 准备配置文件
config.yaml（下文提供模板）
创建 Macvlan 网络
首先，需要创建一个 macvlan 网络，让容器能够获得独立的局域网 IP。假设你的主机网卡为 eth0，网段为 192.168.1.0/24，网关为 192.168.1.1。
执行以下命令创建 macvlan 网络：
1 | docker network create -d macvlan \ |
注意：请根据你的实际网络环境修改 --subnet、--gateway 和 -o parent 参数。
macvlan 网络限制（可选）：默认情况下，宿主机与 macvlan 容器之间无法直接通信。如果宿主机也需要使用旁路由代理，需要额外创建一个 macvlan shim 网络：
1 | # 创建宿主机使用的 macvlan 接口 |
这样宿主机就可以通过 192.168.1.10 访问容器的 192.168.1.11 了。如果宿主机不需要代理，可以跳过此步骤。
准备配置文件
创建一个目录用于存放配置文件，例如 /root/mihomo。在该目录下创建 config.yaml 文件。以下是一个精简的配置模板（示例配置），包含 proxy-providers 示例，请替换为自己的配置信息。
1 | # Mihomo Minimal Transparent Proxy Config |
重要提示
- 将上述配置中的代理信息（
server、port、password等）替换为你自己的。 - 如果使用
proxy-providers，请确保url指向有效的订阅链接。 - 根据需要调整
tun、dns、rules等配置。 - 更多配置选项请参考 Mihomo 官方文档：
启动容器
使用以下命令启动 Mihomo 容器：
1 | docker run -d \ |
注意：
--ip参数指定容器的 IP 地址，请确保该 IP 在你的局域网网段内且未被占用。-v参数将主机上的配置文件映射到容器内，请确保路径正确。--network macnet使用之前创建的 macvlan 网络。
配置说明
- Macvlan 网络：使容器获得独立 IP，如同物理设备接入局域网。
- TUN 模式：启用 TUN 接口实现透明代理，对应用透明。
- DNS 劫持：通过
dns-hijack劫持 DNS 查询，防止 DNS 泄露。 - 规则分流：采用“中国站点与中国IP走直连，否则走代理”的策略。具体规则：局域网IP直连、中国域名直连（GeoSite）、中国IP直连（GeoIP）、Tailscale域名直连，其他所有流量走代理组。
- 代理组：配置一个名为 DEFAULT 的 select 代理组，包含 SS1 代理。规则中的 MATCH,DEFAULT 将所有未匹配的流量导向此代理组，实现代理功能。
- 客户端配置：需要在要使用旁路由的机器上手动配置静态IP和DNS服务器地址，将它们都设置为 Mihomo 容器的IP地址（如 192.168.1.11），以确保流量正确通过旁路由。
- Windows：网络设置 → 更改适配器选项 → 右键以太网/WiFi → 属性 → IPv4 → 手动设置IP和DNS
- macOS：系统偏好设置 → 网络 → 高级 → TCP/IP → 手动配置 → DNS → 添加 192.168.1.11
- Linux：
nmcli或编辑/etc/resolv.conf，添加nameserver 192.168.1.11
- 安全性建议：
- 配置文件权限：
chmod 600 /root/mihomo/config.yaml - 防火墙设置：确保 Mihomo 端口（7890、7892、7893、9090）不被外部访问
- 定期更新：定期更新镜像以获取安全补丁
- 日志监控：定期检查日志，发现异常访问
- 配置文件权限：
- 性能调优：
- MTU 调整：在 config.yaml 的 tun 部分调整 MTU 值（通常 1500 或 1400）
- 连接数限制：根据服务器性能调整
max-concurrent参数 - 缓存优化：启用
store-selected和store-fake-ip以提升性能 - DNS 缓存：调整 DNS 缓存时间以减少查询次数
验证配置
配置完成后，需要验证旁路由是否工作正常。
基础测试
检查容器状态：
1
docker ps | grep mihomo
测试 DNS 解析：
1
nslookup google.com 192.168.1.11
测试网络连通性：
1
2
3
4
5# 从客户端 ping 网关
ping 192.168.1.11
# 从客户端测试代理
curl -x socks5://192.168.1.11:7890 https://httpbin.org/ip
流量测试
国内网站直连测试：
1
curl -I https://www.baidu.com
国外网站代理测试：
1
curl -I https://www.google.com
查看 Mihomo 日志确认分流：
1
docker logs mihomo -f | grep -E "DIRECT|REJECT|匹配"
性能测试
速度测试：
1
2
3# 使用 speedtest-cli 测试
pip install speedtest-cli
speedtest-cli --server 12345 # 替换为实际服务器ID延迟测试：
1
ping -c 10 192.168.1.11
故障排查
常见问题
容器无法启动：
- 检查配置文件语法：
docker logs mihomo - 确认 macvlan 网络已创建：
docker network ls - 检查 IP 地址冲突：
ping 192.168.1.11
- 检查配置文件语法：
客户端无法上网：
- 确认客户端网关和 DNS 都设置为
192.168.1.11 - 检查 Mihomo 日志：
docker logs mihomo -f - 测试 DNS 解析：
nslookup google.com 192.168.1.11
- 确认客户端网关和 DNS 都设置为
速度慢或不稳定：
- 检查代理服务器状态
- 调整 MTU 值（在 config.yaml 的 tun 部分修改）
- 查看容器资源使用：
docker stats mihomo
日志查看
1 | # 查看实时日志 |
配置验证
1 | # 检查容器状态 |
维护
容器管理
重启容器：
1
docker restart mihomo
停止容器：
1
docker stop mihomo
删除容器：
1
docker rm -f mihomo
配置更新
修改配置文件：
1
2
3
4
5# 编辑配置文件
vim /root/mihomo/config.yaml
# 重启容器使配置生效
docker restart mihomo配置热重载（如果支持）：
1
2# 通过 API 重载配置
curl -X PUT http://127.0.0.1:9090/configs -d '{"path":"/root/.config/mihomo/config.yaml"}'
镜像更新
拉取最新镜像：
1
docker pull metacubex/mihomo:latest
重建容器：
1
2
3
4
5
6
7
8
9
10
11
12# 停止并删除旧容器
docker stop mihomo
docker rm mihomo
# 使用新镜像重新创建容器
docker run -d \
--name mihomo \
--restart always \
--network macnet \
--ip 192.168.1.11 \
-v /root/mihomo/config.yaml:/root/.config/mihomo/config.yaml \
metacubex/mihomo:latest
备份与恢复
备份配置：
1
2
3
4
5# 备份配置文件
cp /root/mihomo/config.yaml /root/mihomo/config.yaml.backup
# 备份容器
docker export mihomo > mihomo-backup.tar恢复配置：
1
2
3
4
5# 恢复配置文件
cp /root/mihomo/config.yaml.backup /root/mihomo/config.yaml
# 重启容器
docker restart mihomo
总结
通过 Docker + Macvlan + Mihomo + TUN 的组合，我们搭建了一个轻量、稳定且高效的旁路由方案。相比传统的 OpenWrt 方案，它更加精简，启动更快，维护也更简单。只需将终端设备的网关指向旁路由的 IP（如 192.168.1.11），即可享受全局代理服务。
