跳至主要内容

服務化部署與升級

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