跳至主要内容

快速開始

本頁引導您在 15 分鐘內完成 clmBot 的部署,並跑通一次完整的證書更新流程。

開始之前,請確認:

  • 已開通 sslTrus CaaS 服務,並能登入管理後台。
  • 目標伺服器可以出站存取雲端服務。
  • 擁有伺服器的管理員權限(用於安裝和初始化 clmBot)。

第 1 步:產生 AccessKey / AccessSecret​

登入管理後台,進入 sslTrus CaaS 服務 -> 產品詳情 -> SSL 證書詳情,點擊 生成AK/SK 取得 AccessKey(AK)和 AccessSecret(SK)。

注意

請妥善保存 AccessKey 和 AccessSecret。不要將 AccessSecret 提交到 Git 倉庫、寫入公開腳本或傳送到不受信任的第三方系統;如懷疑洩漏,請在管理後台重新產生。

第 2 步:下載 clmBot 並上傳到伺服器​

從 clmBot 發佈頁下載對應系統版本的程式:

下載 clmBot

根據伺服器的作業系統和架構選擇對應版本(如 clm-bot-linux-amd64),上傳到伺服器。建議為其建立獨立的安裝目錄,例如 /opt/clm-bot。

mkdir -p /opt/clm-bot && cd /opt/clm-bot
chmod 755 clm-bot-linux-amd64

第 3 步:登入接入​

在安裝目錄執行 login 指令完成接入:

./clm-bot-linux-amd64 login

按提示先選擇雲端地址序號(或直接輸入雲端地址),然後依次輸入 AccessKey 和 AccessSecret。

登入成功後,clmBot 會在安裝目錄產生 config.yaml 設定檔,儲存接入資訊。

第 4 步:在管理後台啟動節點​

登入管理後台,進入 clmBot 節點列表,可以看到新增了一筆 clmBot 節點。點擊節點右側的 是否允許接入 開關,將該節點啟動。

資訊

新接入的節點預設為停用狀態,只有在後台啟動後,clmBot 才能正常從雲端取得證書。

第 5 步:探索伺服器上的證書​

執行證書探索指令,自動掃描伺服器上已部署的證書及其存放路徑:

./clm-bot-linux-amd64 discover-certificate

命令執行後,會以表格形式列出找到的證書資訊(來源、類型、頒發者、路徑、網域等)。輸入要上傳的證書序號確認新增到後台管理:

  • all:全部上傳
  • none:不上傳
  • 1,3-5:按序號選擇,支援區間寫法

上傳成功後,這些證書會作為安裝點出現在管理後台,clmBot 會在目前目錄的 config.yaml 中為每個安裝點產生對應的設定。

資訊

自動產生的設定中,每個安裝點帶有 before_script、after_script 欄位,其中 after_script 是證書更新後執行的重載腳本,需要根據實際環境確認是否可用。欄位含義請參閱 設定參考。

第 6 步:完成第一次證書更新​

在管理後台為證書設定自動重簽週期後(參閱 證書更新方式),可以手動觸發一次更新以驗證整個流程:

./clm-bot-linux-amd64 update-certificate

執行後 clmBot 會檢查雲端是否有更新的證書:

  • 本地證書已是最新:輸出提示並跳過。
  • 雲端存在新證書:嘗試生成 .bak 備份,寫入新證書,並按配置執行 after_script。備份失敗會記錄錯誤但繼續更新;服務是否完成重載應以腳本結果和中間件狀態為準。

下一步​