Let's Encrypt SSL 泛域名证书申请和配置

手动 DNS 方式

这种方式需要手动在域名上添加一条 TXT 解析记录，验证域名所有权。这种方式的好处是, 你不需要任何服务器，不需要任何公网 IP，只需要 DNS 的解析记录即可完成验证。

执行以下命令进行手动 DNS 验证：

acme.sh --issue -d example.com -d "*.example.com" --dns \
--yes-I-know-dns-manual-mode-enough-go-ahead-please

到 DNS 解析中，新增一条 TXT 记录，域名前缀为 _acme-challenge，记录值为终端输出的 TXT value 的值。然后再次执行：

acme.sh --renew -d example.com -d "*.example.com" \
--yes-I-know-dns-manual-mode-enough-go-ahead-please

注意：这种方式的坏处是，如果不同时配置 DNS API，将无法自动更新证书，每次都需要手动再次重新解析验证域名所有权。

DNS API 方式

自动 DNS 验证方式需要使用域名解析服务商的 DNS API，像腾讯云（DNSPos）和阿里云都提供 DNS API 功能。

如果你用的是腾讯云 DNSPod，在右上角头像下拉中选择“API 密钥”，点击“DNSPos Token”创建密钥：

如果你用的是阿里云，在右上角头像下拉中选择“AccessKey 管理”，创建密钥：

创建好密钥后，使用如下命令把它们的 Id 和 Token 或 Secret 放到环境变量中：

# 腾讯云
export DP_Id="YourId"
export DP_Key="YourToken"
# 阿里云
export Ali_Key="YourAccessKeyId"
export Ali_Secret="YourAccessKeySecret"

再通过下面命令生成证书：

# 腾讯云
acme.sh --issue --dns dns_dp -d example.com -d *.example.com
# 阿里云
acme.sh --issue --dns dns_ali -d example.com -d *.example.com

注意：这里第一个域名为顶级域名，后面一个为泛域名。这种方式将自动为你的域名添加一条 TXT 解析，验证成功后，这条解析记录会被删除，对你来说是无感的。

证书生成成功后，默认保存在 ~/.acme.sh// 目录中。请不要直接使用 ~/.acme.sh/ 目录下的文件，这里面的文件都是内部使用的，而且目录结构可能会变化，我们需要把证书复制到需要用的地方去。

安装证书

在 ~/.acme.sh// 目录生成的证书文件中，我们主要需要用到两个文件：fullchain.cer 和 .key。下面以 Nginx 为例，来看看如何安装证书。

1) 创建通用 SSL 配置文件

在 /etc/ginx/ 目录下，创建一个为名 ssl-options.conf 的 SSL 通用配置文件，内容参考如下：

ssl_protocols               TLSv1.2 TLSv1.3;
ssl_ciphers                 ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers   off;
ssl_session_cache           shared:le_nginx_SSL:10m;
ssl_session_timeout         1200m;
ssl_session_tickets         on;
ssl_stapling                on;

参数说明：

2) 生成 dhparam.pem

OpenSSL 的 dhparam 用于生成和管理 dh 文件。dh(Diffie-Hellman) 是著名的密钥交换协议，它可以保证通信双方安全地交换密钥。

使用如下命令生成一个 dhparam.pem 文件：

openssl dhparam -out /etc/nginx/dhparam.pem 2048

3) 为 Nginx 站点配置证书

先为网站的证书创建一个存放目录：

mkdir -p /etc/nginx/cert/example.com

目录中的文件我们后面通过脚本复制进来，这里先不管。

打开对应的 Nginx 站点配置文件，例如：/etc/nginx/conf.d/.conf，参考编辑其内容如下：

# /etc/nginx/conf.d/example.com.conf
server {
    listen              80;
    server_name         example.com www.example.com;
    return              301 https://$host$request_uri;
}
server {
    listen              443 ssl;
    server_name         example.com www.example.com;
    server_tokens       off; # 禁止在响应报文中包含Nginx版本信息
    ssl_certificate     /etc/nginx/cert/example.com/fullchain.cer;
    ssl_certificate_key /etc/nginx/cert/example.com/example.com.key;
    include             /etc/nginx/ssl-options.conf;
    ssl_dhparam         /etc/nginx/dhparam.pem;
    if ($host != 'example.com' ) {
        return          301 https://example.com$request_uri;
    }
    location / {
        proxy_pass          http://127.0.0.1:3000;
        proxy_http_version  1.1;
        proxy_set_header    Upgrade $http_upgrade;
        proxy_set_header    Connection keep-alive;
        proxy_set_header    Host $host;
        proxy_cache_bypass  $http_upgrade;
        proxy_set_header    X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header    X-Forwarded-Proto $scheme;
    }
}

4) 安装和自动更新证书

不要直接复制证书到目标目录，正确的方式是使用 -install-cert 命令安装。在命令中指定目标位置，证书文件会被复制到相应的位置。并且，可以指定 reloadcmd 命令，当证书更新以后，reloadcmd 命令会被自动调用，让新的配置生效。

执行如下安装命令完成证书安装：

acme.sh --install-cert -d example.com \
--key-file       /etc/nginx/cert/example.com/example.com.key \
--fullchain-file /etc/nginx/cert/example.com/fullchain.cer \
--reloadcmd      "systemctl force-reload nginx"

这里指定的所有参数都会被自动记录下来，并在将来证书自动更新以后, 被再次自动调用。证书在到期之前会自动更新，你无需任何操作。

更新 acme.sh

目前由于 acme 协议和 Let's Encrypt CA 都在频繁的更新，因此 acme.sh 也经常更新以保持同步。

手动升级 acme.sh 到最新版：

acme.sh --upgrade

如果你不想手动升级，可以开启自动升级：

acme.sh --upgrade --auto-upgrade

你也可以随时关闭自动更新：

acme.sh --upgrade --auto-upgrade 0

参考

acme.sh 官方文档：
https://github.com/acmesh-official/acme.sh/wiki