背景:
最近本站的ssl证书又过期了需要更新,于是趁此机会研究下Certbot自动续期,实现ssl证书自动更新;
环境:
操作系统:ubuntu 22.04 LTS
步骤记录:
1.安装certbot(使用apt安装)
使用以下命令安装
1 2
| sudo apt-get update sudo apt-get install certbot
|
2.插件选择
目前certbot常用的自动续期方式有两种,一种是使用certbot-nginx插件的方式,一种是使用dns服务商插件的方式;第一种方式不支持泛域名,如果需要申请支持泛域名的ssl证书的话,只能选择第二种方式;
3.nginx插件方式(不支持泛域名)
3.1 安装nginx插件
1
| sudo apt install certbot python3-certbot-nginx
|
打开nginx.conf,在你的站点配置中添加ACME挑战路径处理模块
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63
| server { listen 80; server_name demo.cyanfish.site;
location ^~ /.well-known/acme-challenge/ { default_type "text/plain"; root /var/www/letsencrypt; }
location / { return 301 https://$host$request_uri; } }
server { listen 443 ssl http2; server_name demo.cyanfish.site; ssl_certificate /etc/letsencrypt/live/cyanfish.site/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/cyanfish.site/privkey.pem; ssl_session_timeout 5m; ssl_session_cache shared:SSL:10m; ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4; ssl_protocols TLSv1.2 TLSv1.3; ssl_prefer_server_ciphers on;
error_page 500 502 503 504 /50x.html; location = /50x.html { root /var/www/errors; }
add_header X-Frame-Options "SAMEORIGIN"; add_header X-XSS-Protection "1; mode=block"; add_header Cache-Control "public, max-age=3600";
location / { proxy_pass http://localhost:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; }
access_log /var/log/nginx/cyanfish_access.log; error_log /var/log/nginx/cyanfish_error.log; }
server { listen 8000; server_name localhost; charset utf-8;
root /var/www/demoSite; index index.html;
location / { try_files $uri $uri/ /index.html; } }
|
3.2 运行命令申请ssl证书
1
| certbot --nginx -d your.site -d your.another.site
|
成功的响应:

4.dns插件申请(支持泛域名)
4.1 安装腾讯云dnspod插件( 参考插件github官网 )
1
| sudo pip install git+https://github.com/tengattack/certbot-dns-dnspod.git
|
4.2 创建密钥配置文件目录
1 2
| mkdir -p /etc/letsencrypt/dnspod cd /etc/letsencrypt/dnspod
|
4.3 去dnspod创建certbot操作需要的APIid和密钥
步骤 1:登录 DNSPod 管理后台
访问 DNSPod 官网 并登录你的账户。
步骤 2:进入 API Token 管理页面
- 登录后,点击右上角头像,选择 安全设置。
- 在左侧导航栏中,找到并点击 API Token。
步骤 3:创建新的 API Token
- 点击 创建 API Token 按钮。
- 在弹出的对话框中,输入 Token 名称(例如:
certbot
),用于标识这个 Token 的用途。
- 阅读并勾选 同意 API Token 使用条款,然后点击 创建。
4.4 使用编辑器创建一个配置文件,我这里使用的vim编辑器,将上一步申请的密钥和id填入其中
1 2
| dns_dnspod_api_id = 12345 dns_dnspod_api_token = 1234567890abcdef1234567890abcdef
|
4.5 执行命令申请证书
-d example.com -d “*.example.com” 表示申请一个证书同时包含根域名和泛域名
1
| sudo certbot certonly -a dns-dnspod --dns-dnspod-credentials /etc/letsencrypt/dnspod/dnspod.ini -d example.com -d "*.example.com"
|
4.6 等待控制台输出,成功的响应如下:

4.7 修改nginx配置,将申请的证书配置进去,以下是我的一个子站点的配置以供参考
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57
| server { listen 80; server_name demo.cyanfish.site;
return 301 https://$host$request_uri; }
server { listen 443 ssl http2; server_name demo.cyanfish.site; ssl_certificate /etc/letsencrypt/live/cyanfish.site/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/cyanfish.site/privkey.pem; ssl_session_timeout 5m; ssl_session_cache shared:SSL:10m; ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4; ssl_protocols TLSv1.2 TLSv1.3; ssl_prefer_server_ciphers on;
error_page 500 502 503 504 /50x.html; location = /50x.html { root /var/www/errors; }
add_header X-Frame-Options "SAMEORIGIN"; add_header X-XSS-Protection "1; mode=block"; add_header Cache-Control "public, max-age=3600";
location / { proxy_pass http://localhost:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; }
access_log /var/log/nginx/cyanfish_access.log; error_log /var/log/nginx/cyanfish_error.log;
}
server { listen 8000; server_name localhost; charset utf-8;
root /var/www/demoSite; index index.html;
location / { try_files $uri $uri/ /index.html; } }
|
4.8 重启nginx
1
| sudo systemctl reload nginx
|
5.CDN配置
如果使用了cdn,需要在cdn中配置我们生成的ssl证书,将刚刚生成的两个文件中的内容复制到ssl证书配置的文本框里点击保存应用即可;

参考文章:
https://lesofn.com/archives/certbot_certificate