简介
Let's Encrypt —— 是一个由非营利性组织 互联网安全研究小组(ISRG)提供的免费、自动化和开放的证书颁发机构(CA),简单的说,就是为网站提供免费的 SSL/TLS 证书。
签发工具
Let's Encrypt 生成证书的工具很多,certbot 是官方推荐的签发工具,也可以通过在线服务申请,例如:
在线一站式服务管理方便,但可能需要绑定业务,个人用户还是推荐通过工具生成证书。
这里推荐 acme.sh,它不仅有详细的中文文档,操作更为方便,还支持 Docker。
配合ClOUD FLARE
如果开了cloud flare解析,请务必选择FULL,否则会导致无限301重定向
acme.sh
以 root 用户为例
在线安装
curl https://get.acme.sh | sh
如果报错:Please update your account with an email address first
则果断卸载acme
./acme.sh --uninstall
然后重新安装:
curl https://get.acme.sh | sh -s email=xxxx@xx.com
安装过程:
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