Home

Rule-Bot Client 用户文档

Rule-Bot Client 收集 Mihomo 最终落入 MATCH 规则的域名。结果可以只保存在本地，也可以交给 Rule-Bot 判断是否需要补充直连规则。

本 Wiki 面向安装和使用 Rule-Bot Client 的用户，内容以最新正式版本为准。

先选择一个部署位置

同一套网络通常只需部署一个 Rule-Bot Client。只要部署位置能够访问各个 Controller，一个客户端就能同时采集多个 Mihomo、OpenClash 或 Nikki 实例的数据；不需要在 OpenWrt 和 Linux 上各安装一份。

有常驻 Linux、NAS 或其他 Docker 设备时，优先部署在那里。只有 OpenWrt 是唯一合适的常驻设备时，才建议使用 OpenWrt 软件包。仅当网络相互隔离，没有任何一个部署位置能够访问全部 Controller 时，才需要多个客户端。

从这里开始

需要做什么	文档
在 Debian、Ubuntu 或 Docker 上部署	Linux 与 Docker
只有 OpenWrt 设备，需要使用 LuCI	OpenWrt 使用指南
了解 JSON 字段、Controller 和 Rule-Bot 设置	配置说明
排查连接、收集和投递问题	故障排查
了解本地保存、外发数据和用户控制	隐私说明

第一次使用的推荐顺序

1. 连接 Mihomo 外部控制器（Controller），确认连接测试成功或日志显示已连接。
2. 先使用「仅本地收集」，产生一次此前未收集、实际命中 MATCH 的有效域名。
3. 确认本地域名清单出现结果；默认刷新间隔为 5 秒。
4. 如需自动补充直连规则，再填写 Rule-Bot 入口和 Token。

Rule-Bot 默认关闭，本地收集不依赖 Rule-Bot。Rule-Bot 收到域名后仍会检查已有规则、GeoSite 和服务端策略，因此不是每个域名都会写入 GitHub。

隐私提醒： Rule-Bot Client 可能观察设备或整个网络访问的域名。OpenWrt 软件包安装后会启用服务并尝试从 OpenClash 开始本地收集。安装前必须确认有权收集这些数据。

下载最新版本 · 项目 README · 问题反馈