跳到主要内容
ssl证书按装

HTTPS 证书配置与 SSL 安装完整指南:从 CSR 生成到 Nginx/Apache 落地与报错排查

HTTPS 证书配置与 SSL 安装完整指南:从 CSR 生成到 Nginx/Apache 落地与报错排查 — HTTPS 证书配置与 SSL 安装完整指南:从 CSR 生成到 Nginx/Apache 落地与报错排查

一、问题背景:HTTPS 配置失败的 5 类真实根因

很多站长购买的所谓“HTTPS 配置 / SSL 证书安装服务”,本质上只包含“把已有证书文件写进 Web 服务器配置”这一步,订单里并不含证书本身,用户需要自行购买或下载证书。因此上线后常见的失败往往来自下面 5 类根因:

  • 证书链不完整:只部署了域名证书(example.com.crt),漏掉中间证书。桌面 Chrome 可能正常,但 Android、Java 客户端、微信内置浏览器会直接报 unable to get local issuer certificate。
  • 域名不匹配:证书 SAN 字段只写了 example.com,没写 www.example.com,访问 www 时浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID。
  • 私钥与证书不配对:CSR 生成过多次,上传了旧私钥,Nginx 直接启动失败。
  • 端口与回源未打通:443 未放行,或套了 CDN 但回源协议仍是 HTTP,源站证书形同虚设。
  • 混合内容(Mixed Content):证书完全正确,但页面里硬编码了 http:// 的图片、JS、CSS,浏览器拦截后页面错乱——这不是配置问题,是程序调用了 http 造成的。

还要注意有效期规则:按 CA/Browser Forum 要求,当前公开信任的 TLS 证书最长有效期 398 天,Let’s Encrypt 免费证书为 90 天。CA/B 已通过决议,从 2026 年 3 月起将逐步缩短至 200 天、100 天,最终 47 天,所以“装完就不管”的做法必然导致某天突然过期、全站报警。搜索引擎也已全面优先抓取、收录并展示 HTTPS 结果,HTTPS 同时能防止站点被镜像、广告被植入,因此配置正确只是起点,长期可维护才是关键。

二、动手前的准备:生成私钥、CSR 与证书链

如果证书由服务商代配,你需要交付的是私钥 + CSR + 已签发的证书文件,而不是让对方“帮你申请”。以下命令在 OpenSSL 1.1.1+ 环境可直接执行(CentOS 7 自带 1.0.2 不支持 -addext,需先升级):

mkdir -p /etc/ssl/example.com && cd /etc/ssl/example.com
# 1. 生成 2048 位 RSA 私钥(也可用 ecparam -name prime256v1 -genkey)
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
# 2. 生成 CSR,同时写入 SAN(关键:一次覆盖主域名和 www)
openssl req -new -key example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# 3. 检查 CSR 内容是否正确
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'

拿到 CA 签发的证书后,必须校验三件事:私钥与证书是否配对、证书链顺序、文件权限。

# 两边模数一致说明配对
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5
# 拼接完整链:站点证书 → 中间证书(根证书不要放进来)
cat example.com.crt intermediate.crt > fullchain.pem
# 验证链路
openssl verify -CAfile chain.pem -untrusted intermediate.crt example.com.crt

私钥权限务必 600 且属主为 root,fullchain.pem 可为 644。若使用通配符证书 *.example.com,注意它只覆盖一级子域,a.b.example.com 不在范围内,需要单独签发。多域名站点建议把所有域名塞进同一张 SAN 证书,减少后续维护成本。

三、Nginx 部署 SSL 证书:完整配置与 80 强制跳转

把 fullchain.pem 与 example.com.key 放到 /etc/ssl/example.com/,然后新增或修改站点配置。下面这份配置可直接用,注意按实际路径改 root 与 PHP-FPM socket:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    http2 on;                      # nginx 1.25.1+;旧版本写 listen 443 ssl http2;
    server_name example.com www.example.com;

    ssl_certificate     /etc/ssl/example.com/fullchain.pem;
    ssl_certificate_key /etc/ssl/example.com/example.com.key;

    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 /etc/ssl/example.com/chain.pem;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    add_header X-Content-Type-Options nosniff always;

    root /var/www/example.com;
    index index.php index.html;

    location ~ .php$ {
        include fastcgi_params;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

几个易踩点:http2 on; 在 1.25.1 之前不合法,会导致 nginx: [emerg] unknown directive;ssl_stapling 依赖 ssl_trusted_certificate 指向中间证书,否则 error.log 会刷 [warn] 'ssl_stapling' ignored, issuer certificate not found;HSTS 建议先用 max-age=300 试跑一周,确认全站无 HTTP 依赖后再拉满一年,否则回滚极其痛苦。改完执行校验并平滑重载:

nginx -t && systemctl reload nginx

四、Apache 与 Tomcat 的证书安装要点

Apache 2.4.8 之后不再需要 SSLCertificateChainFile,把中间证书拼进 SSLCertificateFile 即可,否则会出现 AH02572: Failed to configure at least one certificate and key:

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile    /etc/ssl/example.com/fullchain.pem
    SSLCertificateKeyFile /etc/ssl/example.com/example.com.key
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
    Header always set Strict-Transport-Security 'max-age=31536000'
    DocumentRoot /var/www/example.com
</VirtualHost>

Tomcat 走 JSSE,不能直接读 PEM,需要先转 PKCS12 或 JKS:

openssl pkcs12 -export 
  -in fullchain.pem -inkey example.com.key 
  -out example.com.p12 -name tomcat 
  -CAfile chain.pem -caname root
# server.xml
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol'
           SSLEnabled='true' scheme='https' secure='true'
           keystoreFile='/etc/ssl/example.com/example.com.p12'
           keystoreType='PKCS12' keystorePass='你的密码'
           sslProtocol='TLS' sslEnabledProtocols='TLSv1.2,TLSv1.3'/>

改完执行 apachectl configtest 或重启 Tomcat。若 Tomcat 前面还有 Nginx,只在最外层做 TLS 终止,内层回源用 HTTP 可以,但必须用安全组/防火墙限制 8080 只允许本机访问,否则等于没加密。另外 Tomcat 默认 8443 端口不要直接暴露公网,建议由 Nginx 反代到 8080,证书只维护一份。

五、证书类型与部署方式对比

选证书前先明确两件事:验证等级(DV/OV/EV)和覆盖范围(单域名/SAN 多域名/通配符)。对绝大多数网站,DV 证书已足够,加密强度与 OV/EV 完全相同,差别只在身份核验深度。

类型 验证内容 签发时长 浏览器展示 适用场景
DV 域名验证 DNS/文件/邮箱验证域名归属 10 分钟~2 小时 锁标志 博客、展示站、内部系统
OV 组织验证 额外核验企业工商信息 1~3 个工作日 锁标志,可查企业名 企业官网、电商
EV 扩展验证 严格人工审核 3~7 个工作日 现代浏览器已不再显示绿色地址栏 金融、支付
通配符 *.example.com 域名验证 10 分钟~1 天 锁标志 子域多、只覆盖一级子域

再对比获取方式,这直接决定你的运维成本:

项目 Let’s Encrypt 商业 DV 商业 OV/EV
最长有效期 90 天 398 天 398 天
续期方式 ACME 全自动 手动或脚本 手动 + 人工复核
价格 免费 数十~数百元/年 数千元/年
故障赔付 无 有 有
多域名 单证书最多 100 个 SAN 需购买 SAN 额度 需购买 SAN 额度

需要提醒的是,域名解析到中国大陆机房仍需完成 ICP 备案,备案与 HTTPS 是两件独立的事,备案未通过时即使证书配置完美,80/443 一样会被拦截。

六、常见报错排查:从 curl 60 到 ERR_SSL_PROTOCOL_ERROR

下面这张表覆盖了 90% 以上的现场故障,先按报错对号入座,再用命令定位:

真实报错 根因 处理
curl: (60) SSL certificate problem: unable to get local issuer certificate 缺中间证书,或本机 CA 库过期 重拼 fullchain;CentOS 7 执行 update-ca-trust
NET::ERR_CERT_COMMON_NAME_INVALID SAN 不含当前访问域名 重签证书,补 www 或其他域名
NET::ERR_CERT_DATE_INVALID 证书过期或客户端时间错误 openssl x509 -enddate -noout -in fullchain.pem
ERR_SSL_PROTOCOL_ERROR 443 被纯 HTTP 服务占用,或协议版本不匹配 ss -lntp | grep ':443' 查占用
nginx: [emerg] cannot load certificate ... BIO_new_file() failed 路径错误、权限不足或文件不存在 检查 SELinux 上下文与 chmod 600
AH02572: Failed to configure at least one certificate and key 证书与私钥不匹配 比对 modulus 是否一致
# 查看服务端真实下发的证书与到期时间
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates
# 查看 443 端口被谁占用
ss -lntp | grep ':443'
# 查看最近的握手错误
tail -n 50 /var/log/nginx/error.log

排查顺序建议固定为:域名解析 → 端口监听 → 证书链完整性 → 域名匹配 → 协议版本。按这个顺序走,基本不会绕弯。

七、HTTPS 页面错乱:混合内容定位与修复

证书配置正确、地址栏出现锁标志,但页面样式丢失、图片裂开,99% 是混合内容。Chrome DevTools 的 Console 会给出一行非常明确的提示:

Mixed Content: The page at 'https://www.example.com/' was loaded over HTTPS,
but requested an insecure element 'http://www.example.com/static/logo.png'.
This request has been blocked.

修复分三步走。第一步,全站搜索硬编码地址:

grep -rn 'http://www.example.com' /var/www/example.com 
  --include='*.php' --include='*.html' --include='*.js' | head -50

第二步,批量替换数据库中的绝对路径。WordPress 用 WP-CLI 最稳妥:

wp search-replace 'http://www.example.com' 'https://www.example.com' --all-tables --precise
# 或直接 SQL
UPDATE wp_posts SET post_content = REPLACE(post_content,'http://www.example.com','https://www.example.com');

第三步,加 CSP 兜底,让浏览器自动把同站 http 请求升级为 https:

add_header Content-Security-Policy 'upgrade-insecure-requests' always;

注意 upgrade-insecure-requests 只对同站资源有效,第三方 http 资源(地图、统计脚本、字体)仍会被拦截,必须换成对方提供的 https 地址,不支持的就只能移除或做本地反向代理。最后再强调一次:这类问题不是“证书装错了”,服务商改配置无法解决,必须改程序输出。

八、效果验证与自动续期

配置完成后不要只看浏览器锁标志,用命令行做客观验证:

# 1. 是否 301 跳转
curl -sI http://example.com | head -3
# 2. HSTS 是否生效
curl -sI https://example.com | grep -i strict-transport-security
# 3. 是否已禁用 TLS 1.1(应握手失败)
openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 4. 证书链是否完整(应输出 Verify return code: 0 (ok))
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code'

浏览器侧可看 Chrome 开发者工具的 Security 面板,或用 Qualys SSL Labs 评级,目标 A 及以上。Let’s Encrypt 用户务必开启自动续期并先做演练:

certbot renew --dry-run
# crontab -e
0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'

商业证书在 398 天到期前 30 天重签。建议把到期时间接入监控,例如 Prometheus blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标,提前 15 天告警。证书到期导致的全站不可用,是性价比最低的事故。

常见问题

需要。这类订单通常只包含把证书文件配置到 Nginx 或 Apache 的人工服务,不含证书本身。你需要自行在 CA 或云厂商处购买、申请证书,拿到 fullchain.pem 与私钥后再交付配置。下单前务必确认套餐是“含证书”还是“仅安装”。

通常不是。这属于混合内容问题:页面里硬编码了 http:// 的图片、JS、CSS,浏览器在 HTTPS 页面中会拦截这些请求。需要在程序、数据库或模板中把地址改成 https,或在响应头加 Content-Security-Policy: upgrade-insecure-requests 兜底。

可以。在生成 CSR 时把两个域名都写进 subjectAltName(SAN)字段即可,主流 CA 对同一张证书内的额外域名通常免费或少量收费。只写 CN 不写 SAN 的证书,现代浏览器会直接判定为无效。

按 CA/Browser Forum 规定,当前公开信任的 TLS 证书最长 398 天;Let’s Encrypt 免费证书为 90 天,建议用 ACME 自动续期。自签名证书可任意设置有效期,但不会被浏览器信任,仅适合内网测试。

不能。*.example.com 只匹配一级子域,如 www.example.com、api.example.com;a.b.example.com 属于二级子域,需要单独签发或另购通配符。规划域名结构时就要考虑这一点,避免后期反复补证书。

内容审核

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