證書更新方式
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 天)並儲存。
設定後的整體效果:
- 證書到期前,雲端依重簽週期自動完成重簽,產生新證書。
- clmBot 依設定的方式(推送或定時拉取)取得新證書。
- clmBot 對本地證書執行更新:
- 本地證書與雲端最新證書一致時,跳過更新。
- 不一致時,嘗試產生帶時間戳的
.bak備份,依序執行before_script、寫入新證書並執行after_script。備份失敗會記錄錯誤但繼續更新;服務是否完成重載應以指令碼結果和中間件狀態為準。
如需在不更新證書的情況下強制執行一次 after_script(例如偵錯重載指令碼),可以使用 --force-after 參數。