关键在于acme协议深度嵌入服务生命周期:dns验证解耦端口依赖,--install-cert精准落证至nginx加载路径,--reloadcmd原子化热重载,实现申请—验证—部署—续期全链路自动闭环。

要让 Nginx 真正实现证书“申请—验证—部署—续期”全链路自动闭环,关键不是堆工具,而是把 ACME 协议能力深度嵌入服务生命周期。核心在于:验证方式与部署路径必须解耦于人工干预,且重载动作需原子化触发。
选对验证方式,避开端口冲突
泛域名证书(*.example.com)强制要求 DNS 验证,不能用 HTTP-01。如果你的 80 端口已被 Nginx 占用,HTTP 验证会失败或需临时停服——这违背“闭环”初衷。DNS 验证则完全绕开端口依赖,通过 API 自动添加/删除 _acme-challenge TXT 记录,全程后台静默完成。
- 主流云厂商(阿里云、腾讯云、Cloudflare、DNSPod)均被 acme.sh 原生支持
- 只需提前配置好 API 密钥(SecretId/SecretKey 或 Token),一行命令即可调用
- 执行
acme.sh --issue -d example.com -d '*.example.com' --dns dns_ali,工具自动完成查记录、设记录、等生效、删记录全流程
证书落地路径必须与 Nginx 加载路径严格一致
很多自动化失败,根源在于证书文件“申请到了,却没放对地方”。Nginx 不会主动扫描目录,它只认 ssl_certificate 和 ssl_certificate_key 指向的绝对路径。因此部署环节必须精准写入,且确保权限可读。
- 使用
--install-cert而非手动复制,避免路径错位或权限丢失 - 指定完整路径,例如:
acme.sh --install-cert -d example.com \<br> --cert-file /etc/nginx/ssl/example.com/cert.pem \<br> --key-file /etc/nginx/ssl/example.com/key.pem \<br> --fullchain-file /etc/nginx/ssl/example.com/fullchain.pem \<br> --reloadcmd "nginx -s reload"
-
--reloadcmd是闭环最后一环:证书更新后立即重载 Nginx,不重启进程,零连接中断
让续期真正无人值守
acme.sh 默认每天凌晨 00:00–06:00 随机时间检测证书剩余有效期,低于 60 天即触发续签。但仅靠 cron 不够稳健——你需要确认三点:
- 脚本执行环境变量完整(特别是 DNS API 密钥已加载,推荐写入
~/.bashrc并在 crontab 中显式调用bash -c) - 续签后
--reloadcmd成功执行(可在命令末尾加&& echo "reloaded at $(date)" >> /var/log/acme-renew.log日志验证) - Nginx 配置中未硬编码旧证书路径(如误写成
/root/.acme.sh/...,该路径随版本升级可能变更)
进阶:用原生 ngx_http_acme_module 替代外部客户端
NGINX 官方推出的 ngx_http_acme_module 正在改变游戏规则。它把 ACME 客户端直接编译进 Nginx,所有操作通过 location 指令和内置指令驱动,不再依赖外部 shell 脚本或定时任务。
- 证书管理成为 Nginx 配置的一部分,符合 IaC(Infrastructure as Code)原则
- HTTP-01 挑战由 Nginx 自身响应,无需额外反向代理或挑战目录配置
- 自动续期由模块内建逻辑控制,失败时可通过
error_log直接定位,无需排查 cron 权限或环境变量 - 当前稳定版已支持 Let's Encrypt,适合对稳定性与审计性要求更高的生产环境











