自动化 SSL 证书管理工具使用指南

autossl 工具使用介绍

工具简介

autossl 是一款时代互联推出的自动化 SSL 证书管理工具,能够帮助您轻松管理 SSL 证书,提供两大核心功能,证书的申请签发与部署。该工具设计简洁,命令行界面友好,适合各类服务器环境使用。支持windows、linux系统使用。

1. 将证书加入 autossl 管理

添加证书前,您需要先获取证书令牌。证书令牌可以在时代互联的证书管理控制台中获取。 执行 autossl add 命令,按照提示输入令牌即可。

2. 申请证书

使用 autossl 签发证书时,支持文件验证和 DNS 验证两种方式。支持时代互联、阿里云、百度云、华为云、AWS Route 53、Cloudflare、CloudNS DNS、火山引擎DNS、腾讯云等众多DNS服务商。 首次申请证书时,需要按照提示添加申请验证配置。

3. 部署证书

使用 autossl 部署证书时,支持将证书部署到本地文件,也支持将证书部署到宝塔面板、云服务器、CDN等云服务厂商的接口。 首次部署证书时,需要按照提示添加部署配置。

4. 自动续签证书和部署

autossl 支持自动续签证书和部署,您可以设置定时任务,在证书过期前自动申请并部署新的证书。

主要功能

autossl 提供了以下核心功能:

  • 添加证书:使用证书令牌添加新的 SSL 证书配置
  • 查看证书:查看证书的详细信息
  • 删除证书:删除不需要的证书配置
  • 列出证书:查看所有管理的证书列表
  • 申请证书:申请签发证书
  • 部署证书:将证书部署到目标服务器
  • 续签证书:自动完成证书的申请和部署过程
  • 版本信息:查看工具版本

安装方法

  1. 下载 autossl 工具到您的服务器:下载链接
  2. 解压下载的压缩包:unzip autossl.zip
  3. 赋予执行权限:chmod +x autossl
  4. 将工具移动到系统 PATH 目录中,方便全局使用:mv autossl /usr/local/bin/

使用指南

1. 查看帮助信息

当您首次使用 autossl 工具时,可以通过以下命令查看基本帮助信息:

autossl help

输出示例:

用法: autossl COMMAND [选项]

自动化SSL证书管理工具

命令:
  add      使用令牌添加证书
  show     查看证书详情
  delete   删除证书配置
  list     列出所有管理的证书
  apply    申请证书
  deploy   部署证书
  renew    续签证书
  help     打印此帮助消息
  version  打印版本信息

运行 'autossl COMMAND -help' 查看命令的详细信息。

### 2. 添加证书

要添加新的 SSL 证书配置,使用 `add` 命令:

```bash
autossl add

执行后,系统会提示您输入证书令牌,输入后按回车键即可完成添加。

3. 查看证书详情

要查看某个证书的详细信息,使用 show 命令并指定证书 ID:

autossl show ID

其中 ID 是证书的唯一标识符,可以通过 list 命令查看获取。

4. 删除证书配置

要删除不需要的证书配置,使用 delete 命令:

autossl delete ID

5. 列出所有证书

要查看所有已管理的证书列表,使用 list 命令:

autossl list

6. 申请证书

要申请新的 SSL 证书,使用 apply 命令:

autossl apply ID [选项]

选项说明:

  • -reset:重置验证配置
  • -force:强制申请证书,无论证书是否过期

如果证书有效期大于 30 天,默认不会重新申请,需要使用 -force 选项强制申请。

您也可以使用 all 代替具体的证书 ID,批量申请所有证书:

autossl apply all

7. 部署证书

要将证书部署到目标服务器,使用 deploy 命令:

autossl deploy ID

同样,您可以使用 all 批量部署所有证书:

autossl deploy all

8. 续签证书

续签证书是一个组合操作,包括申请新证书和部署证书两个步骤:

autossl renew ID

您也可以使用 all 批量续签所有证书:

autossl renew all

9. 查看版本信息

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

autossl version

操作示例

示例 1:添加新证书

$ autossl add
请输入证书令牌:
your-certificate-token
# 系统会显示添加成功的证书信息

示例 2:申请证书

# 申请指定 ID 的证书
$ autossl apply 1

# 强制申请证书(即使未过期)
$ autossl apply 1 -force

# 重置验证配置并申请证书
$ autossl apply 1 -reset

示例 3:续签证书

# 续签指定 ID 的证书
$ autossl renew 1

# 批量续签所有证书
$ autossl renew all

注意事项

  1. 证书令牌是添加和管理证书的重要标识,请妥善保管
  2. 申请证书时,确保您的域名解析和服务器配置正确,以通过域名验证
  3. 定期使用 renew 命令续签即将过期的证书,避免证书过期影响服务
  4. 对于批量操作,系统会自动跳过未配置的证书,并显示相应的提示信息
  5. autossl 会在工作目录生成 data 和 logs 目录,分别用于存储证书配置和运行日志。请确保有足够的权限来创建和写入这些目录。

总结

autossl 工具是一款功能全面、操作简单的 SSL 证书管理工具,通过命令行界面提供了证书全生命周期的管理功能。它不仅支持单个证书的管理,还支持批量操作,大大提高了证书管理的效率。


希望本文对您使用 autossl 工具有所帮助。如果您在使用过程中遇到任何问题,欢迎查阅工具的帮助文档或联系技术支持