Debian 软件包

📦 使用 Debian 软件包

🧭 页面导航： Linux 部署方式 · 配置说明 · 故障排查 · Wiki 首页

本页适用于 Debian、Ubuntu 及其他能够安装 .deb 软件包、并使用 systemd 管理后台服务的系统。支持 amd64、arm64 和 armhf。

开始前，准备 Mihomo 控制接口地址和可选密钥，并把 Mihomo 日志级别设为 info 或更详细。不了解这些信息时，先阅读配置说明：Mihomo 控制接口是什么。

📌 本页导航： 下载并校验 · 编辑配置 · 启动验证 · 更新 · 卸载

1. 下载并校验

从最新正式版本页面下载与系统架构匹配的 .deb 文件及同一版本的 checksums.txt。checksums.txt 用来确认下载文件完整且没有被替换。

以下示例使用当前 amd64 软件包；其他架构需要替换为页面中显示的精确文件名：

package='rule-bot-client_0.2.0_amd64.deb'
awk -v file="./$package" '$2 == file { print }' checksums.txt | sha256sum -c -

确认目标 .deb 显示 OK 后再安装：

sudo apt install "./$package"

ARM64 或 ARMHF 设备需要把命令中的 amd64 换成实际下载的软件包架构。安装过程会创建专用的 rule-bot-client 系统用户，注册后台服务，并把示例配置写入 /etc/rule-bot-client/config.json。

2. 编辑并检查配置

sudo editor /etc/rule-bot-client/config.json
sudo -u rule-bot-client \
  /usr/bin/rule-bot-client --config /etc/rule-bot-client/config.json --check

至少需要修改 instances 列表中的 url 和 secret：

• url 是 Mihomo 控制接口地址；
• secret 是 Mihomo 控制接口密钥。Mihomo 没有设置密钥时，可以删除该字段。

只有需要发送给 Rule-Bot 时，才把 rule_bot.enabled 改为 true，并填写真实提交地址和访问令牌。

--check 只验证配置内容、凭据和 HTTPS 证书文件，不测试 Mihomo 网络连接。出现 configuration is valid 表示配置可以读取，可以继续启动服务。

3. 启动并验证

sudo systemctl enable --now rule-bot-client
sudo systemctl status rule-bot-client --no-pager
sudo journalctl -u rule-bot-client -n 100 --no-pager

日志出现 instance=... connected 表示对应监听目标已经连接。然后访问一个此前未收集的域名，并在 Mihomo 管理面板或日志中确认它最终由兜底规则 MATCH 处理。

等待最长一个刷新间隔，再检查本地域名清单：

sudo cat /var/lib/rule-bot-client/domains.txt

4. 更新

下载并校验新版本 .deb 后，再次安装新文件：

sudo apt install ./新版本文件名.deb

配置文件属于软件包保留配置。如果软件包管理器提示配置差异，先查看差异，再决定保留现有配置还是使用新版示例。

当前 Debian 软件包不会在更新后自动重启已经运行的服务。安装完成后，检查配置并手工重启：

sudo -u rule-bot-client \
  /usr/bin/rule-bot-client --config /etc/rule-bot-client/config.json --check
sudo systemctl restart rule-bot-client
sudo systemctl status rule-bot-client --no-pager

查看版本

/usr/bin/rule-bot-client --version

输出包含版本、源码提交和构建时间。

停用或卸载

卸载前，先停止并禁用后台服务：

sudo systemctl disable --now rule-bot-client
sudo apt remove rule-bot-client

卸载软件包不保证删除配置和域名数据。需要删除 /etc/rule-bot-client 或 /var/lib/rule-bot-client 时，先检查并备份内容，再单独处理。