SSL 证书安装与 HTTPS 网站搬家完整指南:从 CSR 签发、Nginx/宝塔配置到真实报错排查
问题背景与根因:网站搬家后 HTTPS 为什么会“掉证书”
把站点从虚拟主机迁到云服务器、从旧服务器搬到新服务器、或从老版本宝塔换到新版本宝塔后,最常见的现象是:http:// 访问正常,https:// 直接报错。Chrome 提示 NET::ERR_CERT_DATE_INVALID 或 ERR_CERT_COMMON_NAME_INVALID,命令行 curl -I https://example.com 返回 curl: (60) SSL certificate problem: unable to get local issuer certificate。排查下来绝大多数不是证书坏了,而是迁移时漏了东西,根因集中在四类:
1)只搬了网站目录,没搬证书和私钥。证书通常不在 /www/wwwroot 里,而在 /etc/letsencrypt/live/example.com/ 或 /www/server/panel/vhost/cert/example.com/,打包时被忽略,新服务器 Nginx 的 ssl_certificate 指向空路径。
2)证书链不完整。只部署了叶子证书 domain.crt 而没有拼中间证书,桌面 Chrome 可能靠 AIA 补拉还能显示锁,但 Android WebView、Java 客户端、微信小程序服务端校验会直接失败,报 unable to get local issuer certificate。
3)SNI 与默认站点错配。新服务器 443 端口上没有对应 server_name,请求落到 default_server,返回的是别的域名的证书,浏览器报 ERR_CERT_COMMON_NAME_INVALID。
4)续期任务没迁移。Let’s Encrypt 证书有效期只有 90 天,旧的 cron / systemd timer 留在老机器上,新机器 90 天后集体过期。同时必须更新认知:公开信任 TLS 证书最长有效期自 2020-09-01 起为 398 天,2026-03-15 起缩短为 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天,“一年一换”的人工习惯已经不可行。
先定位现状再动手:
grep -rn 'ssl_certificate' /etc/nginx/ /www/server/panel/vhost/nginx/ 2>/dev/null
openssl x509 -noout -subject -issuer -dates -in /www/server/panel/vhost/cert/example.com/fullchain.pem
迁移前的资产盘点:证书、私钥、CSR 与 DNS 预检
HTTPS 站点搬家不是复制一个网站目录就完事,必须盘清五类资产,缺一样都会在上线后炸出来:
① 完整证书链 fullchain.pem(叶子证书 + 中间证书);② 私钥 privkey.pem,权限必须是 600,属主 root;③ ACME 账户与续期配置,即 /etc/letsencrypt/accounts、renewal/、renewal-hooks/,宝塔则对应 /www/server/panel/vhost/cert/ 与面板计划任务;④ Web 服务器站点配置(server 块、伪静态、跳转规则);⑤ DNS 记录与 TTL。
备份时最容易踩的坑:/etc/letsencrypt/live/ 下的 pem 全是软链接,指向 ../../archive/。直接 tar -czf 打包,恢复出来全是断链。正确做法是加 -h 跟随软链接:
tar -czhf ssl-backup-$(date +%F).tar.gz /etc/letsencrypt /etc/nginx/conf.d /www/server/panel/vhost/cert
ls -l /etc/letsencrypt/live/example.com/
chmod 600 /etc/letsencrypt/live/example.com/privkey.pem
chown root:root /etc/letsencrypt/live/example.com/privkey.pem
DNS 预检必须做,尤其是 AAAA 记录。很多人只改了 A 记录,忘了旧的 IPv6 地址还指向老服务器,ACME http-01 校验会随机走到旧机器上失败:
dig +short A example.com
dig +short AAAA example.com
dig +short CNAME www.example.com
建议在切换前 24 小时把域名 TTL 从 3600 临时调到 300,切换失败可快速回滚。同时在新服务器上确认 80 和 443 都放行:ss -lntp | grep -E ':80|:443'、firewall-cmd --permanent --add-service=https && firewall-cmd --reload,云厂商安全组要单独再开一次,这是最常被忘记的一层。
完整实操:生成 CSR、签发证书与链完整性校验
如果是新签发(不是迁移已有证书),按下面顺序执行,每条命令都可以直接复制。注意 CN 字段已被主流浏览器忽略,所有域名必须写进 SAN:
# 1) 生成私钥:ECDSA P-256 握手更快,老客户端兼容性优先则用 RSA 2048
openssl ecparam -genkey -name prime256v1 -out example.com.key
# openssl genrsa -out example.com.key 2048
# 2) 生成 CSR,域名全部放进 SAN
openssl req -new -key example.com.key -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# 3) 核对 CSR 里的 SAN 是否齐全
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
# 4) 拿到证书后拼接完整链并验证
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
证书与私钥是否配对,是最容易配错的一步。RSA 用 modulus 比对,ECDSA 没有 modulus,改用公钥比对:
# RSA
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECDSA
openssl x509 -pubkey -noout -in example.com.crt | openssl md5
openssl pkey -pubout -in example.com.key | openssl md5
用 Let’s Encrypt 签发时,务必先 --dry-run 演练,避免真实请求触发限流:
certbot certonly --webroot -w /www/wwwroot/example.com -d example.com -d www.example.com --dry-run
certbot certonly --webroot -w /www/wwwroot/example.com -d example.com -d www.example.com
签发成功后证书在 /etc/letsencrypt/live/example.com/,其中 fullchain.pem 用于 ssl_certificate,privkey.pem 用于 ssl_certificate_key,chain.pem 用于 OCSP Stapling。有效期 90 天,必须配合自动续期,不能手工记日子。
配置示例:Nginx 与 Apache 的 HTTPS 站点及强制跳转
Nginx 推荐双 server 块写法:80 端口只保留 ACME 校验目录,其余全部 301 跳 HTTPS。注意 http2 on; 是 Nginx 1.25.1+ 的新语法,旧版本写 listen 443 ssl http2;。
server {
listen 80;
server_name example.com www.example.com;
location /.well-known/acme-challenge/ { root /www/wwwroot/example.com; }
location / { return 301 https://$host$request_uri; }
}
server {
listen 443 ssl;
http2 on;
server_name example.com www.example.com;
root /www/wwwroot/example.com;
index index.php index.html;
ssl_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;
ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;
add_header Strict-Transport-Security 'max-age=31536000' always;
}
TLSv1.0/1.1 已被 Chrome 98+ 等主流浏览器弃用,不要再为了“兼容老设备”打开。HSTS 一定要最后一步再开,先确认全站没有混合内容,否则浏览器会把错误缓存一年,回滚非常麻烦。
Apache 2.4.8 之后 SSLCertificateChainFile 已废弃,直接指向 fullchain 即可:
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
改完必须先测语法再重载:nginx -t && systemctl reload nginx 或 apachectl configtest && systemctl reload httpd。直接 restart 会在配置错误时把整站打挂。
宝塔面板实操:SSL 安装、网站搬家与服务器环境配置
宝塔环境下搬家有固定套路,按顺序做可以避开 90% 的坑。
第一步,老服务器打包。网站文件与数据库分开处理,数据库导出必须加 --single-transaction,否则大表导出会锁表:
tar -czf site.tar.gz -C /www/wwwroot/example.com .
mysqldump -uroot -p --single-transaction --routines --triggers example_db > example_db.sql
第二步,新服务器建站。面板 → 网站 → 添加站点,填域名、选 PHP 版本(与原站一致,PHP 版本不一致是搬家后白屏的头号原因)、建同名数据库。上传解压到 /www/wwwroot/example.com 后执行 chown -R www:www /www/wwwroot/example.com,再导入 SQL、修改 wp-config.php 或 .env 里的数据库账号密码。
第三步,域名替换。WordPress 站不要直接写 UPDATE,序列化数据长度会错乱导致页面错位,用 WP-CLI 先演练:
wp search-replace 'old.com' 'new.com' --all-tables --precise --dry-run --allow-root
wp search-replace 'old.com' 'new.com' --all-tables --precise --allow-root
第四步,装证书。网站 → 设置 → SSL → Let’s Encrypt,勾选 www 子域名,验证方式选文件验证直接申请;已有证书则选“其他证书”,把 fullchain.pem 粘到证书框、privkey.pem 粘到私钥框,顺序和内容都不能错(不要把 CSR 当私钥粘进去)。宝塔落盘路径为 /www/server/panel/vhost/cert/example.com/。
第五步,开强制 HTTPS 前先验证。执行 curl -sI https://example.com | head -1 确认返回 200,再打开面板的“强制 HTTPS”开关,否则会把自己锁在 301 循环里。最后配置续期:面板 → 计划任务 → 添加 Shell 脚本任务,或用 crontab -l | grep -i ssl 确认已有自动续签任务。
提醒一点:宝塔的“面板 SSL”和“站点 SSL”是两套完全独立的证书,面板证书过期不影响网站,网站证书过期也不影响面板登录,排查时别搞混。
证书方案对比与有效期规则:398 天之后怎么选
选型前先看有效期规则的时间线,这直接决定你必须做自动化:
| 生效日期 | 公开信任证书最长有效期 | 说明 |
|---|---|---|
| 2020-09-01 起 | 398 天 | 现行规则,商业 CA 与 DV/OV/EV 通用 |
| 2026-03-15 起 | 200 天 | CA/B Forum SC-081 第一阶段 |
| 2027-03-15 起 | 100 天 | 第二阶段 |
| 2029-03-15 起 | 47 天 | 最终阶段,手工续期彻底不可行 |
再看方案对比。Let’s Encrypt 证书有效期固定 90 天,并已提供 6 天有效期的短期证书 profile(可选),配合 ACME 全自动续期几乎零运维成本:
| 方案 | 验证方式 | 有效期 | 浏览器信任 | 自动续期 | 适用场景 |
|---|---|---|---|---|---|
| Let’s Encrypt DV | http-01 / dns-01 | 90 天 | 是 | ACME 全自动 | 个人站、API、博客、测试环境 |
| 商业 DV | 域名验证 | 最长 398 天(逐步缩短) | 是 | 需 API 或脚本 | 需要商业支持与赔付承诺 |
| OV / EV | 企业实名核验 | 同上 | 是 | 部分支持 | 金融、政企、电商收单 |
| 通配符 *.example.com | 必须 dns-01 | 90 天 / 商业同规则 | 是 | DNS API 自动 | 多子域,注意只覆盖一级 |
| 自签名 | 无 | 自定义 | 否 | — | 内网、开发调试 |
选型结论很直接:对绝大多数站点,Let’s Encrypt + 自动续期是性价比最高的方案;需要企业实名信息展示或商业赔付时再上 OV/EV。通配符证书要特别注意 *.example.com 只覆盖一级子域,a.b.example.com 不在其中,需要单独加 SAN。
常见错误排查:8 个真实报错与对应修复命令
1. nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):证书与私钥不配对,多发生在批量搬家时把 A 域名的 key 配给了 B 域名。用上一节的公钥 md5 比对命令定位,重新配对即可。
2. curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书。把 ssl_certificate 指向 fullchain.pem,然后数一下链上有几张证书:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE',正常应 ≥2。
3. curl: (60) SSL: no alternative certificate subject name matches target host name 'www.example.com':SAN 里没有 www。重新签发时务必带上 -d www.example.com。
4. 浏览器 NET::ERR_CERT_DATE_INVALID:证书过期或服务器时间漂移。先 date -R 看时间,再 timedatectl set-ntp true 校时。
5. nginx: [emerg] cannot load certificate "...": PEM_read_bio_X509_AUX() failed:文件格式错,常见于把 .pfx/.cer 直接改后缀,或粘贴时带入了多余文本。用 openssl x509 -in x.pem -noout -text 验证能否解析。
6. Problem binding to port 80: Could not bind to IPv4 or IPv6.:80 被 Nginx 占用导致 certbot 独立模式失败。改用 --webroot 或 --nginx 插件,不要停站硬签。
7. DNS problem: NXDOMAIN looking up A for example.com 或 Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404:解析未生效或 webroot 路径不对。检查 dig +short A example.com 与 80 端口 server 块里 .well-known 的 location 是否放行。
8. too many failed authorizations recently:Let’s Encrypt 限流(同一账户 + 主机名每小时 5 次失败)。等 1 小时,并改用 staging 环境调试:certbot certonly --webroot -w /www/wwwroot/example.com -d example.com --server https://acme-staging-v02.api.letsencrypt.org/directory。
另外两类高频问题:ERR_SSL_VERSION_OR_CIPHER_MISMATCH 通常是只开了 TLSv1.3 而客户端过旧,或证书配到了 80 端口;页面样式错乱并伴随 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 'http://...' 则是数据库里硬编码了 http://,用 wp search-replace 批量替换,或临时加 add_header Content-Security-Policy 'upgrade-insecure-requests' always;。
效果验证:从上手 curl 到 SSL Labs 的上线检查清单
配置完成后必须逐项验证,不能只看浏览器有没有小锁。下面这套命令可以直接复制成脚本执行:
# 1) 状态码、协议版本、HSTS 头
curl -sSI https://example.com | egrep -i 'HTTP/|strict-transport|server'
# 2) 证书主体、签发者、起止时间
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
# 3) 剩余有效期是否大于 30 天(返回 0 表示未过期)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -checkend 2592000
# 4) 证书链张数
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 5) HTTP 是否 301 跳 HTTPS
curl -sSI http://example.com | head -1
# 6) 协议与加密套件枚举
nmap --script ssl-enum-ciphers -p 443 example.com
| 检查项 | 期望结果 | 验证命令 |
|---|---|---|
| HTTPS 可访问 | HTTP/2 200 | curl -sI https://example.com |
| HTTP 强制跳转 | 301 Moved Permanently | curl -sI http://example.com |
| 证书链完整 | ≥2 张证书 | s_client -showcerts |
| 剩余有效期 | >30 天 | x509 -checkend 2592000 |
| 协议版本 | 仅 TLSv1.2 / TLSv1.3 | nmap ssl-enum-ciphers |
| 综合评级 | SSL Labs A 及以上 | ssllabs.com/ssltest |
最后做一次全站混合内容扫描:打开 Chrome DevTools → Console,刷新首页与关键内页,搜索 Mixed Content;再用 curl -s https://example.com | grep -o 'http://[^"]*' | head -20 找出残留的 http 资源。全部通过后再开启 HSTS 并提交 HSTS Preload(可选,提交后难以回滚,谨慎操作)。对于多站点服务器,建议加一条批量到期监控:for d in example.com www.example.com; do echo | openssl s_client -connect $d:443 -servername $d 2>/dev/null | openssl x509 -noout -enddate; done,把结果接入告警,比任何人工巡检都可靠。
常见问题
公开信任的 TLS 证书最长有效期为 398 天,这是 2020 年 9 月 1 日起执行的规则。按 CA/B Forum 决议,2026-03-15 起缩短至 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。Let’s Encrypt 固定为 90 天,必须自动化续期。
不可以。必须同时迁移完整证书链 fullchain.pem 和私钥 privkey.pem,两者必须配对,私钥权限设为 600、属主 root。还要迁移续期配置(如 /etc/letsencrypt/renewal),否则 90 天后证书会集体过期。
可以。签发时把两个域名都写进 SAN 即可,例如 certbot 加两个 -d 参数。注意通配符 *.example.com 只覆盖一级子域,a.b.example.com 需要单独加入 SAN 或另签证书。
先用 curl -sI https://example.com 确认 443 能返回 200、证书链完整,再开跳转。若已打不开,直接改回 Nginx 配置里的 301 规则并 nginx -t && systemctl reload nginx 回滚;HSTS 头要最后加,避免错误被浏览器缓存。
DV 类型没有区别,都显示正常锁标志,HTTPS 加密强度也一致。差异在于商业支持、赔付承诺、OV/EV 的企业实名信息、OCSP 响应与 API 管理能力,以及对超长有效期的需求。