跳至主要内容

證書更新方式

clmBot 支援兩種證書更新方式,可依伺服器網路環境分別選擇:

更新方式工作模式連接埠要求適用場景
雲端推送管理後台發起推送,clmBot 服務端接收並更新需開放 8862/tcp 入站連接埠網路策略允許、希望更新即時生效
定時拉取由 crontab 或 Windows 計劃任務定時執行 clmBot 並檢查更新無需開放入站連接埠無法開放入站連接埠的伺服器(推薦預設方式)

兩種方式互不衝突,同一批伺服器中可以部分使用推送、部分使用定時拉取。

方式一:雲端推送​

在伺服器上啟動 clmBot 服務端​

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

-a 指定監聽位址與連接埠,預設為 0.0.0.0:8862。啟動後 clmBot 將作為伺服器端常駐執行,等待雲端推送。

注意
  • 需要在伺服器防火牆與雲安全群組中開放 8862/tcp 入站連接埠。
  • clmBot 伺服器端對雲端推送連線啟用雙向 TLS 驗證,僅接受已完成接入啟動的節點推送證書。

如不希望開放入站連接埠,請使用方式二:定時拉取。

資訊

clmBot 伺服器端需要保持執行才能接收推送。生產環境建議將其註冊為系統服務並設定開機自啟,參見 服務化部署與升級。

在管理後台推送證書​

登入管理後台,進入安裝點列表,找到目標安裝點並點擊 推送證書,確認後系統將最新的證書推送到伺服器並自動完成更新。

方式二:定時拉取​

定時拉取模式無需開放入站連接埠,是推薦的預設方式。clmBot 不包含週期排程器,需要由 crontab、Windows 工作排程器或現有排程系統定時執行更新指令。

Linux:設定 crontab​

將 clmBot 更新指令加入 crontab:

crontab -e

scheduled-check: cron: "0 3 * * *" timezone: "Asia/Shanghai" action: "check-and-renew" notify: true description: "每天凌晨 3 點執行證書更新檢查"

0 3 * * * cd /opt/clm-bot && ./clm-bot-linux-amd64 update-certificate >> update.log 2>&1
注意
  • 命令中必須先 cd 到 clmBot 安裝目錄再執行,因為 clmBot 預設從目前目錄讀取 config.yaml。
  • 也可以不切換目錄,透過 -c 參數指定設定檔路徑:./clm-bot-linux-amd64 -c /opt/clm-bot/config.yaml update-certificate。
  • 請將路徑替換為實際安裝目錄。

執行輸出會追加到 update.log,同時 clmBot 會在設定檔所在目錄的 logs/clm-bot.log 中記錄執行日誌。

Windows:設定計劃任務​

在 Windows 伺服器上建立計劃任務,定時執行:

cd /d C:\clm-bot && clm-bot-windows-amd64.exe update-certificate >> update.log 2>&1

创建完成后,可以右鍵點擊任務選擇執行以進行驗證,接著在安裝目錄下查看日誌確認執行結果。

證書自動重簽與更新​

clmBot 更新的證書來自雲端的自動重簽。登入管理後台,進入 SSL 證書詳情頁,在自動重簽設定中選擇或輸入重簽週期(如 30 天)並儲存。

設定後的整體效果:

  1. 證書到期前,雲端依重簽週期自動完成重簽,產生新證書。
  2. clmBot 依設定的方式(推送或定時拉取)取得新證書。
  3. clmBot 對本地證書執行更新:
  • 本地證書與雲端最新證書一致時,跳過更新。
  • 不一致時,嘗試產生帶時間戳的 .bak 備份,依序執行 before_script、寫入新證書並執行 after_script。備份失敗會記錄錯誤但繼續更新;服務是否完成重載應以指令碼結果和中間件狀態為準。
提示

如需在不更新證書的情況下強制執行一次 after_script(例如偵錯重載指令碼),可以使用 --force-after 參數。