跳到主要内容
版本：V2.2.1

服务化部署与升级

将 clmBot 注册为系统服务后，clmBot 服务端可以常驻运行并随系统自启，适合使用云端推送方式的服务器。本页同时介绍配置热加载、运行日志和客户端升级。

注册为系统服务​

前提：已按 快速开始 完成 login 接入。

执行以下命令将 clmBot 服务端注册为系统服务：

./clm-bot-linux-amd64 server --service install -a="0.0.0.0:8862"

注册说明：

  • Linux 上注册为 systemd 服务，Windows 上注册为同名 Windows 服务，均支持开机自启。
  • 服务名为 ssltrus-clm-bot-<节点ID>-<端口>，节点 ID 即接入时分配的 clmBot ID。
  • 服务按安装时指定的配置文件和监听地址运行，工作目录为配置文件所在目录。

如需以当前登录用户（而非系统级）安装服务，可加 --user 参数。

管理服务​

通过 server --service <动作> 管理服务：

./clm-bot-linux-amd64 server --service status    # 查看服务状态
./clm-bot-linux-amd64 server --service start     # 启动服务
./clm-bot-linux-amd64 server --service stop      # 停止服务
./clm-bot-linux-amd64 server --service restart   # 重启服务
./clm-bot-linux-amd64 server --service uninstall # 卸载服务（卸载前自动停止）

配置热加载​

clmBot 服务端默认开启配置热加载（--watch，默认启用）：修改 config.yaml 后会自动重新加载配置，无需重启服务。

如需关闭热加载，可在启动时显式指定 --watch=false。

查看运行日志​

clmBot 运行日志位于配置文件所在目录的 logs/clm-bot.log，控制台输出的内容同样会记录到该文件。

日志文件自动轮转：

  • 单个日志文件最大 30MB。
  • 保留最近 90 天。
  • 最多保留 10 个备份文件。

升级 clmBot​

执行以下命令检查并升级到最新版本：

./clm-bot-linux-amd64 update

执行后 clmBot 会从官方发布源检查当前平台的最新版本：

  • 已是最新版本时，输出当前版本号并跳过。
  • 有新版本时，自动下载并校验文件完整性（SHA-256），替换当前可执行文件。

查看当前客户端版本：

./clm-bot-linux-amd64 --version
注意

升级完成后，如 clmBot 正以系统服务方式运行，请执行 server --service restart 使新版本生效。

Windows 内置命令终端​

在 Windows 服务器上，不带参数直接运行 clmBot 可执行文件会进入内置命令终端。该终端只能执行 clmBot 子命令，输入 help 查看命令，输入 exit 退出，适合受限运维环境中使用。

最后于 更新