密码学与证书 / 系统课时
申请证书前需要停止 Nginx 吗
申请证书前需要停止 Nginx 吗
申请证书前是否要停止 Nginx,取决于 Certbot 使用的认证方式,而不是“申请证书”这个动作本身。本篇对比 Standalone、Webroot 与 Nginx 插件,并给出上线前的判断方法。
学习目标
- 根据 Certbot 认证方式判断是否需要停止 Nginx
- 在执行 Standalone 前检查 Nginx 与 80 端口状态
- 为不能接受停机的站点选择合适的 HTTP-01 认证方式
先根据认证方式判断
三种常见方式对 Nginx 的要求不同:
| 认证方式 | 通常是否停止 Nginx | 原因 |
|---|---|---|
| Standalone | Nginx 占用 80 端口时通常需要 | Certbot 要启动临时 HTTP 服务并绑定 80 端口 |
| Webroot | 不需要 | Certbot 把挑战文件写入站点目录,由正在运行的 Nginx 对外提供 |
| Nginx 插件 | 不需要 | Certbot 借助现有 Nginx 完成认证,可按操作需要调整并重新加载配置 |
因此,“申请证书前先停止 Nginx”并不是通用步骤。只有认证方式要求 Certbot 自己监听一个已被 Nginx 占用的端口时,才需要释放该端口。
先检查 Nginx 和 80 端口
在决定是否停服务前,可以同时检查 Nginx 状态和 80 端口监听者:
sudo systemctl is-active nginx
sudo ss -ltnpH 'sport = :80'预期输出(Nginx 正常运行并监听 80 端口时):
active
LISTEN 0 511 0.0.0.0:80 0.0.0.0:* users:(("nginx",pid=<ID>,fd=<ID>))<ID> 为动态值。如果第一行是 active,并且监听记录确认 Nginx 占用了 80 端口,那么直接运行 Standalone 通常会产生端口绑定冲突。反过来,如果使用 Webroot 或 Nginx 插件,这正是预期状态,不应为了申请证书而先把 Nginx 停掉。
Standalone 的停机边界
Standalone 的典型调用形式是 certbot certonly --standalone -d <HOST>。这里的 <HOST> 应替换为实际申请证书的域名。若 Nginx 正在监听 80 端口,操作顺序应是先确认业务允许短暂中断,再停止 Nginx、验证端口已经释放、运行 Certbot,最后恢复 Nginx。
短暂停止 Nginx 还会让正常 HTTP 请求在验证期间无法由它处理。因此,高流量站点、API 网关或有严格可用性要求的服务器,一般不应把手工停启 Nginx 作为日常证书续期方案。
不想停止 Nginx 时如何选择
如果站点已经由 Nginx 正常提供 HTTP 服务,Webroot 往往适合“让现有服务继续跑”的场景。其典型调用形式为 certbot certonly --webroot -w <PATH> -d <HOST>,Certbot 会把 HTTP-01 挑战内容放到指定 Webroot 下,再由 Nginx 响应外部验证请求。使用前要确认 /.well-known/acme-challenge/ 没有被错误重写、鉴权或代理规则拦截。
如果希望 Certbot 直接理解并管理 Nginx 配置,可以使用 Nginx 插件,例如 certbot --nginx -d <HOST>。这种方式通常不要求停止 Nginx,但 Certbot 可能为了完成验证或安装证书而检查、修改并重新加载 Nginx 配置,因此正式环境仍应先保证原配置可以通过语法检查。
无论使用 Webroot 还是 Nginx 插件,HTTP-01 都仍要求公网能够通过 80 端口访问相应域名。它们解决的是“谁来响应验证请求”的问题,而不是绕过 HTTP-01 的公网端口要求。如果服务器不能开放 80 端口,应重新评估 DNS-01 等认证方式。
判断是否停止 Nginx 时,先确定认证器,再检查端口,而不要把“停 Nginx”写成所有证书申请流程的固定前置步骤。