SSL 证书配置与 Nginx HTTPS 部署指南
大约 4 分钟
SSL 证书配置与 Nginx HTTPS 部署指南
适用场景:阿里云 ECS(Debian / Ubuntu)+ nginx + VuePress 静态站 现状:本站已使用 Let's Encrypt + certbot 自动续期,取代了早期手工申请的阿里云免费证书(3 个月,需手动重签)
最后更新:2026-11-20
0. 两种方案怎么选
| 方案 | 有效期 | 续期 | 适用 |
|---|---|---|---|
| Let's Encrypt + certbot(推荐) | 90 天 | 自动(certbot.timer) | 有 80 端口、能跑 certbot 的服务器 |
| 阿里云免费证书 | 3 个月 | 手动申请 + 手动替换 | 无法使用 ACME、或需要特定品牌证书 |
下面先说推荐方案,再说阿里云证书的手动流程。
一、方案 A:Let's Encrypt 自动续期
1.1 前提检查
# 域名必须解析到本机
dig +short www.ouyangss.site # 应返回服务器公网 IP
# 80 端口必须对外开放(安全组放行 TCP 80),且没有被别的服务占用
ss -tlnp | grep ':80 '1.2 安装
sudo apt update
sudo apt install -y certbot python3-certbot-nginx1.3 关键前置:强制 IPv4
阿里云服务器通常只有 IPv4 出口,但 acme-v02.api.letsencrypt.org 会优先解析出 IPv6,导致每个 ACME 请求都干等超时,报:
requests.exceptions.ReadTimeout: HTTPSConnectionPool(host='acme-v02.api.letsencrypt.org',
port=443): Read timed out. (read timeout=45)修法(一次性):
echo 'precedence ::ffff:0:0/96 100' | sudo tee -a /etc/gai.conf
getent ahosts acme-v02.api.letsencrypt.org | head -3 # 确认输出 IPv4这条同样适用于
apt、git clone等一切走国际线路的命令。
1.4 签发
sudo certbot --nginx -d ouyangss.site -d www.ouyangss.site \
--non-interactive --agree-tos --register-unsafely-without-email --redirect参数说明:
| 参数 | 作用 |
|---|---|
--nginx | 用 nginx 插件做 HTTP-01 验证,并自动改写站点配置 |
-d | 证书覆盖的域名,可写多个 |
--redirect | 自动加 80 → 443 的 301 跳转 |
--non-interactive --agree-tos | 无人值守 |
--register-unsafely-without-email | 不注册邮箱(不接收到期提醒,靠自动续期兜底);想收提醒就换 -m 你的邮箱 |
成功后证书在:
/etc/letsencrypt/live/ouyangss.site/fullchain.pem # 证书链
/etc/letsencrypt/live/ouyangss.site/privkey.pem # 私钥certbot 会往站点配置里插入 SSL 相关行,并带上 # managed by Certbot 注释,不要删除这些注释。
1.5 验证
sudo nginx -t && sudo systemctl reload nginx
curl -I https://www.ouyangss.site/ # 200
curl -I http://www.ouyangss.site/ # 301 -> https
echo | openssl s_client -servername www.ouyangss.site -connect 127.0.0.1:443 2>/dev/null \
| openssl x509 -noout -subject -dates1.6 自动续期
systemctl list-timers certbot.timer # 下次续期时间
systemctl status certbot.timer --no-pager
sudo certbot certificates # 证书与到期时间
sudo certbot renew --dry-run # 演练(不真正签发)certbot.timer每天运行两次,到期前 30 天内自动续期并 reload nginx- 国际线路慢时,
--dry-run可能跑十几分钟,属正常现象,别中断 - 服务器需要重启后仍生效:
systemctl is-enabled certbot.timer应为enabled
1.7 常见报错
| 报错 | 原因 | 处理 |
|---|---|---|
Read timed out | IPv6 优先 | 按 1.3 配置 gai.conf |
Could not bind TCP port 80 | 80 被占用 | ss -tlnp | grep :80 找占用进程 |
Timeout during connect (likely firewall) | 安全组未放行 80 | 控制台放行 TCP 80,或备案未通过被拦截 |
too many failed authorizations | 频繁失败触发限流 | 等待 1 小时后重试,先排除前两类原因 |
二、方案 B:阿里云免费证书(手动)
有效 3 个月,到期需重新申请、重新上传、重新 reload。除非有特殊需求,否则建议用方案 A。
2.1 申请与下载
阿里云控制台 → 数字证书管理服务 → 免费证书 → 申请 → 下载 Nginx 格式(得到 .pem 与 .key 两个文件)。
2.2 上传到服务器
sudo mkdir -p /etc/nginx/ssl本地执行:
scp your_certificate.pem root@39.97.254.3:/etc/nginx/ssl/
scp your_private_key.key root@39.97.254.3:/etc/nginx/ssl/2.3 站点配置
# HTTP 跳转 HTTPS
server {
listen 80;
server_name www.ouyangss.site ouyangss.site;
return 301 https://$host$request_uri;
}
# HTTPS 主配置
server {
listen 443 ssl;
server_name www.ouyangss.site ouyangss.site;
ssl_certificate /etc/nginx/ssl/你的证书.pem;
ssl_certificate_key /etc/nginx/ssl/你的私钥.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
root /var/www/my-docs/dist;
index index.html;
location / {
try_files $uri $uri/ $uri.html /index.html;
}
}2.4 生效
sudo ln -sfn /etc/nginx/sites-available/my-docs /etc/nginx/sites-enabled/my-docs
sudo nginx -t
sudo systemctl reload nginx2.5 到期维护
免费证书到期前需重新走 2.1~2.4。建议在日历或监控里设两个提前提醒(到期前 14 天、7 天)。若长期使用,还是切回方案 A。
三、混用与切换注意事项
- 两套证书不要同时配置:同一
server块里只能有一套ssl_certificate - 从方案 B 切到方案 A:直接跑 1.4 的
certbot --nginx,certbot 会覆盖证书路径;确认旧的手工ssl_certificate行已被替换 - 切换后清理旧文件:
/etc/nginx/ssl/*.pem|*.key可保留作备份,但别让配置再引用它们 - 改完配置永远先
nginx -t再reload,避免把站点打挂
四、排查速查表
| 问题 | 检查点 |
|---|---|
| 浏览器提示证书无效 | 证书与域名是否匹配、是否过期、是否缺少中间证书(用 fullchain.pem) |
| HTTPS 打不开但 HTTP 正常 | 安全组 443、ss -tlnp | grep :443、nginx -t |
cannot load certificate | 文件路径、文件权限(私钥建议 600)、SELinux |
| 访问域名跳转异常 | return 301 是否写对、是否有多个 server 块抢占 server_name |
| 静态页刷新 404 | try_files 缺少 $uri.html /index.html |
| 续期成功但站点仍旧证书 | renew 后未 reload nginx;检查 renew_hook 或 certbot 插件是否负责 reload |
鄂公网安备42011102006488号