Linux 与 Docker

Linux 部署方式

Wiki 首页 · OpenWrt 使用指南 · 配置说明 · 故障排查 · 隐私说明

Linux 版本没有 Web 管理页面，需要编辑 JSON 配置文件。JSON 是一种有固定括号、引号和字段名称的文本格式；修改时需要保留这些符号。

Debian 软件包、Docker Compose 和原生二进制是三种互相替代的部署方式，只需选择一种。

部署建议： 同一套网络通常只需部署一个 Rule-Bot Client，不要再在 OpenWrt 上重复安装。只要这台 Linux 设备能够访问各个 Mihomo 控制接口，就可以在同一份配置中添加多个监听目标。只有网络相互隔离、单一部署位置无法访问全部控制接口时，才需要多个客户端。

有合适的常驻 Linux、NAS 或其他能够运行 Docker 的设备时，优先使用 Linux 方案。OpenWrt 软件包不属于 OpenWrt 官方软件源，固件升级后可能需要重新安装，因此更适合作为只有路由器可用时的部署方式。

先选择一种方式

当前环境	推荐文档	说明
Debian、Ubuntu 等使用 systemd 的系统	Debian 软件包	安装步骤最少；支持 amd64、arm64、armhf
已安装 Docker 的 Linux 或 NAS	Docker Compose 部署	便于统一启动和更新；支持 linux/amd64、linux/arm64
Docker 不可用，或设备使用其他架构	Linux 原生二进制	需要手工创建用户和后台服务，适合有 Linux 管理经验的用户

不要同时执行多份指南。Debian 或 Ubuntu 用户优先选择 .deb 软件包；只有对应软件包不支持当前系统时，才考虑原生二进制。

开始前需要知道

Mihomo 控制接口

Mihomo 控制接口是 Mihomo 自带的 HTTP 管理接口，配置项通常叫 external-controller，不是需要另外安装的程序。

安装前需要确认：

• 这台 Linux 设备能够访问 Mihomo 控制接口；
• 已知道控制接口地址，例如 http://127.0.0.1:9090；
• Mihomo 设置了 secret 时，已准备对应的控制接口密钥；
• Mihomo 日志级别为 info 或更详细。

不知道如何查找地址和密钥时，阅读配置说明：Mihomo 控制接口是什么。

Rule-Bot 是可选功能

Rule-Bot 用来进一步检查域名是否需要补充规则。本地收集不依赖 Rule-Bot。首次安装时保持 rule_bot.enabled=false，先确认 Mihomo 连接和本地域名清单正常。

安装后怎样确认成功

无论选择哪种部署方式，都按以下顺序检查：

1. 确认后台服务或容器正在运行。
2. 确认日志出现 instance=... connected。这表示对应监听目标已经连接 Mihomo。
3. 访问一个此前未收集的域名，并在 Mihomo 管理面板或日志中确认它最终由兜底规则 MATCH 处理。
4. 等待最长一个刷新间隔，然后检查本地域名清单是否出现新行。

所有连接都命中 MATCH 前面的其他规则时，没有新增域名是正常现象。配置字段和多控制接口示例见配置说明；启动或收集异常见故障排查。