Let's Encrypt 证书申请及配置
简介
Let's Encrypt —— 是一个由非营利性组织 互联网安全研究小组(ISRG)提供的免费、自动化和开放的证书颁发机构(CA),简单的说,就是为网站提供免费的 SSL/TLS 证书。
签发工具
Let's Encrypt 生成证书的工具很多,certbot 是官方推荐的签发工具,也可以通过在线服务申请,例如:
在线一站式服务管理方便,但可能需要绑定业务,个人用户还是推荐通过工具生成证书。
这里推荐 acme.sh,它不仅有详细的中文文档,操作更为方便,还支持 Docker。
acme.sh
以 root 用户为例
在线安装
curl https://get.acme.sh | sh
安装过程:
-
home
目录下生成.acme.sh
文件夹,查看文件夹内容:ls ~/.acme.sh/
; -
自动添加 bash alias:
# ~/.bashrc 添加: . "/root/.acme.sh/acme.sh.env" # acme.sh.env 内容: # alias acme.sh="/root/.acme.sh/acme.sh"
-
自动添加定时任务(时间随机):
# 每天凌晨检查证书的有效期,如有需要,自动续签。 30 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null
相关命令
# 查看帮助
acme.sh -h
# 查看列表
acme.sh --list
# 卸载 acme.sh
# 编辑 ~/.bashrc,删除 acme.sh alias
acme.sh --uninstall
脚本更新
自动更新:acme.sh --upgrade --auto-upgrade
手动更新:acme.sh --upgrade
关闭更新:acme.sh --upgrade --auto-upgrade 0
证书申请
验证域名所有权验证方式:HTTP 和 DNS
- HTTP:在网站的根目录下添加一个文件
- DNS:在域名上添加一条 txt 解析记录
HTTP
acme.sh 会自动生成验证文件,并放到站点的根目录,然后自动完成验证,最后自动删除文件。
- -d:同
--domain
,域名 - -w:同
--webroot
,站点根目录
acme.sh --issue -d mydomain.com -d www.mydomain.com -w /websvr/mydomain.com/
Nginx:自动从配置中获取站点的根目录
acme.sh --issue -d mydomain.com --nginx
注:根据中国大陆工信部的规定,所有托管在中国大陆服务器上的网站均需要备案。
—— 站点如未备案,80 端口处于禁用状态,acme.sh 无法使用 HTTP 验证域名所有权。
DNS
优势:不需要服务器与公网 ip,只要配置 DNS 解析即可。
不足:必须配置 Automatic DNS API 才可以自动续签。
# https://github.com/Neilpang/acme.sh/wiki/dns-manual-mode
# 注:DNS 不支持自动续签
# 步骤:
# 1. 生成相应的解析记录
# 2. 域名解析中添加生成的 txt 记录
# 3. 等待解析其生效
acme.sh --issue --dns -d mydomain.com --yes-I-know-dns-manual-mode-enough-go-ahead-please
# 查询域名 txt 记录
nslookup -type=txt _acme-challenge.mydomain.com
# 解析生效后,重新生成证书(注:确实是 renew)
acme.sh --renew -d mydomain.com --yes-I-know-dns-manual-mode-enough-go-ahead-please
DNS API(推荐)
根据域名服务商,选择对应的 DNS API。
阿里云:控制台
创建 Accesskey
# 获取到 Key 和 Secret 后,设置环境变量
export Ali_Key="123"
export Ali_Secret="abc"
# 生产证书
acme.sh --issue --dns dns_ali -d mydomain.com -d www.mydomain.com
DNSPod:控制台(注:非腾讯云控制台)
创建 API Token
# 获取到 ID 和 Key 后,设置环境变量
export DP_Id="123"
export DP_Key="abc"
# 生产证书
acme.sh --issue --dns dns_dp -d mydomain.com -d www.mydomain.com
通配符证书
Wildcard 证书,目前只支持 DNS-01
验证方式。
# 阿里 DNS API
acme.sh --issue --dns dns_ali -d mydomain.com -d *.mydomain.com
证书配置
生成的证书都在 home
目录下: ~/.acme.sh/
导出证书
使用 --install-cert
命令
- -d:域名
- –key-file:私钥位置
- –fullchain-file:证书位置
- –reloadcmd:重载命令
acme.sh --install-cert -d mydomain.com \
--key-file /websvr/ssl/mydomain.key \
--fullchain-file /websvr/ssl/fullchain.cer \
--reloadcmd "docker exec -t nginx nginx -s reload"
Nginx 配置
server {
listen 80;
server_name mydomain.com;
# 重定向到 https
rewrite ^(.*)$ https://$host$1 permanent;
}
server {
listen 443;
server_name mydomain.com;
root /websvr/www/mydomain.com;
index index.html index.htm;
access_log /dev/null;
error_log /websvr/log/nginx/mydomain.com.error.log warn;
# SSL 配置
ssl on;
ssl_certificate /websvr/ssl/fullchain.cer; # 证书文件
ssl_certificate_key /websvr/ssl/mydomain.key; # 私钥文件
ssl_session_timeout 5m; # 会话缓存过期时间
ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # 开启 SSL 支持
ssl_prefer_server_ciphers on; # 设置协商加密算法时,优先使用服务端的加密套件
}
重启 Nginx 服务:
docker exec -t nginx nginx -s reload
SSL 检测
更新证书
定时任务会自动更新
强制续签证书:acme.sh --renew -d mydomain.com --force