跳到主要内容
ssl证书按装

SSL 证书安装与 HTTPS 网站搬家完整指南:从 CSR 签发、Nginx/宝塔配置到真实报错排查

SSL 证书安装与 HTTPS 网站搬家完整指南:从 CSR 签发、Nginx/宝塔配置到真实报错排查 — 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 管理能力,以及对超长有效期的需求。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。