Home

Rule-Bot Client 用户文档

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

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

从这里开始

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

下载最新版本 · 返回项目首页

选择安装方式

使用环境	推荐方式
OpenWrt 24.10 或 25.12	安装专用 LuCI 单包
Debian / Ubuntu	安装 .deb 软件包并使用 systemd
其他 Linux（AMD64 / ARM64）	使用 Docker Compose
其他 Linux 架构	使用 Release 中的原生二进制

当前没有 Windows 或 macOS 正式构建。OpenWrt 不要安装通用 Linux 压缩包。

第一次使用的推荐顺序

1. 连接 Mihomo Controller，并确认 Controller 测试成功或日志显示已连接。
2. 先使用「仅本地收集」，产生一次实际命中 MATCH 的连接。
3. 确认本地域名清单出现结果。
4. 如需自动补充直连规则，再填写 Rule-Bot 入口和 Token。

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

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

怎样判断已经成功

• 服务成功：进程或容器正在运行。
• Controller 成功：实例显示已连接，或日志出现 instance=... connected。
• 本地收集成功：产生一次 MATCH 连接后，域名出现在「本地结果」或输出文件。
• Rule-Bot 成功：启用后得到已添加、已存在、GeoSite 已覆盖或策略拒绝等终态。

配置检查命令 --check 不会连接 Mihomo；它只能证明配置和引用文件有效。

使用边界

• 只收集域名，不收集 URL、网页内容、应用名称、访问次数或时间戳。
• 实时日志流没有历史队列。断线期间已经结束的短连接可能无法补回。
• 本地输出不会自动过期。
• 成功写入 GitHub 的域名会进入公开提交历史，之后无法通过关闭客户端或吊销 Token 撤回。

详细边界见隐私说明。

获取帮助

使用问题和功能建议请提交到 GitHub Issues。公开反馈前，移除 Token、Controller 密钥、隐藏入口、私有地址和真实域名清单。

安全漏洞请按安全策略私密报告。