跳至主要内容

服務化部署與升級

將 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 退出，適合受限維運環境中使用。

最後於 更新