netssl 工具使用介紹

工具簡介

netssl 是一款時代互聯推出的自動化 SSL 證書管理工具,能夠幫助您輕鬆管理 SSL 證書,提供兩大核心功能,證書的申請簽發與部署。該工具設計簡潔,命令列介面友好,適合各類伺服器環境使用。支援windows、linux系統使用。

1. 將證書加入 autossl 管理

新增證書前,您需要先獲取證書令牌。證書令牌可以在時代互聯的證書管理控制台中獲取。

執行 netssl add 命令,按照提示輸入令牌即可。

2. 申請證書

使用 netssl 簽發證書時,支援檔案驗證和 DNS 驗證兩種方式。支援時代互聯、阿里雲、百度雲、華為雲、AWS Route 53、Cloudflare、CloudNS DNS、火山引擎DNS、騰訊雲等眾多DNS服務商。

首次申請證書時,需要按照提示新增申請驗證配置。

3. 部署證書

使用 netssl 部署證書時,支援將證書部署到本機檔案,也支援將證書部署到寶塔面板、雲伺服器、CDN等雲服務廠商的介面。

首次部署證書時,需要按照提示新增部署配置。

4. 自動續簽證書和部署

netssl 支援自動續簽證書和部署,您可以設定定時任務,在證書過期前自動申請並部署新的證書。

主要功能

netssl 提供了以下核心功能:

  • 新增證書:使用證書令牌新增新的 SSL 證書配置

  • 查看證書:查看證書的詳細資訊

  • 刪除證書:刪除不需要的證書配置

  • 列出證書:查看所有管理的證書清單

  • 申請證書:申請簽發證書

  • 部署證書:將證書部署到目標伺服器

  • 續簽證書:自動完成證書的申請和部署過程

  • 版本資訊:查看工具版本

安裝方法

  1. 下載 netssl 工具到您的伺服器:netssl-linux netssl-win

  2. 解壓下載的壓縮包:unzip autossl.zip

  3. 賦予執行權限:chmod +x autossl

  4. 將工具移動到系統 PATH 目錄中,方便全域使用:mv autossl /usr/local/bin/

## 使用指南

1. 查看幫助資訊

當您首次使用 netssl 工具時,可以通過以下命令查看基本幫助資訊:

netssl help

輸出示例:

用法: netssl COMMAND [選項]

自動化SSL證書管理工具

命令:
  add      使用令牌新增證書
  show     查看證書詳情
  delete   刪除證書配置
  list     列出所有管理的證書
  apply    申請證書
  deploy   部署證書
  renew    續簽證書
  help     列印此幫助訊息
  version  列印版本資訊

運行 'netssl COMMAND -help' 查看命令的詳細資訊。

2. 新增證書

要新增新的 SSL 證書配置,使用 add 命令:

netssl add

執行後,系統會提示您輸入證書令牌,輸入後按回車鍵即可完成新增。

3. 查看證書詳情

要查看某個證書的詳細資訊,使用 show 命令並指定證書 ID:

netssl show ID

其中 ID 是證書的唯一標識符,可以通過 list 命令查看獲取。

4. 刪除證書配置

要刪除不需要的證書配置,使用 delete 命令:

netssl delete ID

5. 列出所有證書

要查看所有已管理的證書清單,使用 list 命令:

netssl list

6. 申請證書

要申請新的 SSL 證書,使用 apply 命令:

netssl apply ID [選項]

選項說明:

  • -reset:重置驗證配置

  • -force:強制申請證書,無論證書是否過期

如果證書有效期大於 30 天,預設不會重新申請,需要使用 -force 選項強制申請。

您也可以使用 all 代替具體的證書 ID,批量申請所有證書:

netssl apply all

7. 部署證書

要將證書部署到目標伺服器,使用 deploy 命令:

netssl deploy ID

同樣,您可以使用 all 批量部署所有證書:

netssl deploy all

8. 續簽證書

續簽證書是一個組合操作,包括申請新證書和部署證書兩個步驟:

netssl renew ID

您也可以使用 all 批量續簽所有證書:

netssl renew all

9. 查看版本資訊

要查看 autossl 工具的版本資訊,使用 version 命令:

netssl version

操作示例

示例 1:新增新證書

$ netssl add
請輸入證書令牌:
your-certificate-token
# 系統會顯示新增成功的證書資訊

示例 2:申請證書

# 申請指定 ID 的證書
$ netssl apply 1

# 強制申請證書(即使未過期)
$ netssl apply 1 -force

# 重置驗證配置並申請證書
$ netssl apply 1 -reset

示例 3:續簽證書

# 續簽指定 ID 的證書
$ netssl renew 1

# 批量續簽所有證書
$ netssl renew all

注意事項

  1. 證書令牌是新增和管理證書的重要標識,請妥善保管

  2. 申請證書時,確保您的域名解析和伺服器配置正確,以通過域名驗證

  3. 定期使用 `renew` 命令續簽即將過期的證書,避免證書過期影響服務

  4. 對於批量操作,系統會自動跳過未配置的證書,並顯示相應的提示資訊

  5. netssl 會在工作目錄生成 data 和 logs 目錄,分別用於存儲證書配置和運行日誌。請確保有足夠的權限來建立和寫入這些目錄。

總結

netssl 工具是一款功能全面、操作簡單的 SSL 證書管理工具,通過命令列介面提供了證書全生命週期的管理功能。它不僅支援單個證書的管理,還支援批量操作,大大提高了證書管理的效率。

---

希望本文對您使用 netssl 工具有所幫助。如果您在使用過程中遇到任何問題,歡迎查閱工具的幫助文檔或聯繫技術支援。