跳到主要内容
HTTPS小程序证书

SSL 证书安装与 HTTPS 部署配置全指南(Nginx/Apache/Tomcat/IIS 实测版)

SSL 证书安装与 HTTPS 部署配置全指南(Nginx/Apache/Tomcat/IIS 实测版) — SSL 证书安装与 HTTPS 部署配置全指南(Nginx/Apache/Tomcat/IIS 实测版)

问题背景:证书“装上了”为什么浏览器仍然报不安全

运维群里最常见的一类求助:证书已经上传到服务器、面板也显示“已部署”,但浏览器地址栏依然写着“不安全”;或者 PC 端正常,Android 客户端和 Java 服务却直接抛异常。HTTPS 从来不是“上传一个 crt 文件”就结束,它由四件套共同决定:私钥、叶子证书、中间证书链、协议与端口配置。任何一环缺失,都会以不同的报错形式暴露出来。

第一类根因是证书链不完整。CA 签发的服务器证书(叶子证书)本身不包含签发它的中间 CA 证书,客户端需要靠中间证书把叶子证书接到系统根证书库里的根 CA。只配了 example.com.crt 而没拼接中间证书时,桌面 Chrome 常常能通过 AIA 扩展自动补链,所以你会觉得“我这能打开”;但 Android 旧版本、Java、curl、Python requests 会直接失败。这类“部分客户端报错”几乎 100% 是链的问题。

第二类根因是私钥与证书不匹配:CSR 在 A 机器生成、证书在 B 机器申请,或者同名文件被覆盖。第三类是协议与端口:TLS 1.0/1.1 自 2020 年起被主流浏览器全面停用,仍启用老协议会直接握手失败;或者服务监听 8443 却用 443 访问;云服务器安全组只放行了 80 没放 443。第四类是域名与混合内容:证书 SAN 里只有 example.com,用户访问 www.example.com 就报 ERR_CERT_COMMON_NAME_INVALID;页面里还引着 http:// 的图片和 JS,锁标变灰甚至被拦截。

先用一条命令定位,看 issuer 与 subject 是否构成完整链:

openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | openssl x509 -noout -subject -issuer -dates

如果输出的 issuer 与 subject 相同(自签证书),或者命令没有任何输出,说明 443 端口根本没跑 TLS 或证书链没配对,先解决这一层再谈优化。

证书类型、有效期规则与选型对比

按验证强度分为 DV、OV、EV;按覆盖范围分为单域名、多域名(SAN)、通配符。三者不是“加密强度”的差别,密码学强度完全一致,差别只在 CA 是否核验了申请者身份。

  • DV(域名验证):只验证域名控制权,通过 DNS TXT、HTTP 文件或管理员邮箱验证,通常 10 分钟内签发,验证记录可在签发后删除。
  • OV(组织验证):额外核验企业名称、地址、电话,需与工商公示信息一致,通常 1–3 个工作日。
  • EV(扩展验证):最严格的主体核验。注意:Chrome 77(2019 年)起已移除 EV 证书的绿色地址栏,“绿栅”效果不复存在,EV 现在的价值是合规背书与责任保险,而不是界面差异。
  • 通配符:*.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com,需要额外加 SAN。

有效期规则是必须更新的常识:自 2020-09-01 起,公有 CA 签发的 TLS 服务器证书最长有效期被限制为 398 天;Let’s Encrypt 免费证书固定 90 天,官方明确要求用 certbot / acme.sh 自动续期。按 CA/B Forum 已通过的 SC-081 计划,2026-03-15 起上限降至 200 天,2027-03-15 降至 100 天,2029-03-15 降至 47 天——“到期前手动续”的运维方式必须彻底废弃。

类型 验证内容 典型签发时长 适用场景
DV 单域名 域名控制权 10 分钟内 个人站、API、测试环境
DV 通配符 域名控制权 10 分钟–1 小时 多子域统一管理
OV 主体工商信息 + 电话回拨 1–3 个工作日 企业官网、B 端 SaaS
EV 严格主体核验 + 法律存续证明 3–7 个工作日 金融、支付、招投标
多域名 SAN 多个 FQDN 合并一张证书 同对应等级 主域 + 品牌域 + 后台域

第一步:生成 CSR 与私钥(RSA / ECDSA)

私钥必须在最终部署的服务器上生成,不要用第三方在线工具生成,否则等于私钥已泄露。RSA 2048 位是兼容性最好的选择;ECDSA P-256 性能更好、握手更快,但对极老的 Windows Server 2003 / Android 4.x 客户端不友好。

# RSA 2048 + SAN 扩展(一条命令生成私钥和 CSR)
openssl req -new -newkey rsa:2048 -sha256 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech Co., Ltd./CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'

# ECDSA P-256
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -sha256 -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech Co., Ltd./CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'

提交前务必自检 CSR 的 SAN 是否包含 www 与所有业务子域;OV/EV 的 O、C、ST、L 必须与营业执照逐字一致,否则 CA 会退回重提,白白多等几天:

openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
openssl req -in example.com.csr -noout -verify

拿到证书后先确认私钥与证书是一对,再上传服务器:

openssl x509 -noout -modulus -in example.com.crt | openssl sha256
openssl rsa  -noout -modulus -in example.com.key | openssl sha256   # 两行输出必须一致
chmod 600 example.com.key && chown root:root example.com.key

ECDSA 证书不能用 modulus 比对,改用公钥指纹:openssl x509 -in example.com.crt -noout -pubkey | openssl sha256 与 openssl pkey -in example.com.key -pubout | openssl sha256 对比结果。

第二步:Nginx 部署 HTTPS 完整实操

先把叶子证书与中间证书按顺序拼接成 fullchain。顺序错了(中间证书在前)同样报链错误;且绝对不要把根证书放进 fullchain,部分客户端会因此判定链无效:

cat example.com.crt intermediate.crt > fullchain.crt
cp fullchain.crt intermediate.crt example.com.key /etc/nginx/ssl/
chmod 600 /etc/nginx/ssl/example.com.key

站点配置(80 强制跳转 + 443 现代 TLS 参数):

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/nginx/ssl/fullchain.crt;
    ssl_certificate_key /etc/nginx/ssl/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:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    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/nginx/ssl/intermediate.crt;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

    location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; }
}

校验并热加载:nginx -t && systemctl reload nginx。后端是 Tomcat/Node 时反向代理到 http 没问题,但页面内所有静态资源必须用 https 或协议相对地址,否则触发混合内容拦截。HSTS 建议先用 max-age=300 灰度一天,确认全站(含子域)HTTPS 可用后再改成一年,否则回滚代价极高。

第三步:Apache、Tomcat、IIS 配置示例

Apache(httpd-ssl.conf / vhost):

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/example.com.crt
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

Apache 2.4.8 起 SSLCertificateChainFile 已废弃并打印 AH02559 警告,此时把中间证书直接追加到 SSLCertificateFile 指向的文件末尾即可。修改后执行 apachectl configtest && systemctl reload httpd。

Tomcat(server.xml):

<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true"
           keystoreFile="/opt/tomcat/conf/example.jks" keystorePass="changeit"
           clientAuth="false" sslProtocol="TLS"
           sslEnabledProtocols="TLSv1.2,TLSv1.3" />

由 PEM 转 JKS(以 PKCS12 为中间格式,JDK 8 及以上通用):

openssl pkcs12 -export -in fullchain.crt -inkey example.com.key 
  -out example.p12 -name tomcat -passout pass:changeit
keytool -importkeystore -srckeystore example.p12 -srcstoretype PKCS12 
  -destkeystore example.jks -deststoretype JKS -deststorepass changeit

IIS:导入 .pfx 时必须包含私钥与全部中间证书(导出时勾选“包含所有证书”),站点绑定 443 并勾选“需要服务器名称指示(SNI)”;续期推荐 win-acme,导入后执行 iisreset。三者共同点是:证书路径、密码、端口任一处写错,表现都是“服务起不来”而不是“证书报错”,排错时先看服务日志再看浏览器。

面板环境部署与多环境对比

宝塔面板:网站 → 设置 → SSL → 其他证书,PEM 框粘贴 fullchain.crt 全文(必须含中间证书),私钥框粘贴 example.com.key,保存后打开“强制 HTTPS”。粘贴最容易丢的是换行和 -----END CERTIFICATE----- 结尾行,保存时报“证书格式错误”基本都是这个原因。phpStudy 在 vhosts.conf 中手写 ssl 指令或用面板 SSL 模块;WDCP 在“网站管理 → SSL”上传 crt 与 key,老版本面板不支持 TLS 1.3,需升级或改用源码编译的 Nginx。

环境 关键配置项 证书文件要求 生效命令 常见坑
Nginx ssl_certificate / ssl_certificate_key fullchain(叶子+中间) nginx -t && systemctl reload nginx 只放叶子证书、漏配 http2
Apache SSLCertificateFile / ChainFile 2.4.8+ 可合并到 File apachectl configtest && reload mod_ssl 未启用、指令废弃
Tomcat Connector port=443 / keystoreFile JKS 或 PKCS12 systemctl restart tomcat 密码错、端口被占用
IIS 站点绑定 443 + SNI PFX 含私钥与链 iisreset 导入时未含中间证书
宝塔 面板 SSL → 其他证书 PEM 含完整链 面板自动 reload 粘贴丢换行/结尾行
phpStudy / WDCP vhost 或面板 SSL crt + key 分开 重启 Web 服务 面板版本旧不支持 TLS 1.3

无论哪个环境,验收标准一致:443 可握手、80 返回 301、证书链完整、TLS 1.0/1.1 已关闭。面板只是把配置文件包了一层,出问题时仍要回到 nginx -t 和 openssl s_client 这两条命令上看真实输出。

常见错误排查(真实报错对照)

下面这些报错在工单里出现频率最高,按“报错原文 → 根因 → 修复”对照处理:

  • curl: (60) SSL certificate problem: unable to get local issuer certificate:链不完整。把 intermediate.crt 拼进 fullchain 后重载;自建 CA 场景需把根证书装进系统信任库(update-ca-certificates)。
  • nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥与证书不是一对,用前面的 modulus/pubkey 命令比对后重新签发。
  • 浏览器 NET::ERR_CERT_AUTHORITY_INVALID、微信内置浏览器提示“证书无效”:链不全或用了自签证书,安卓与微信对链的校验比桌面 Chrome 严格得多。
  • NET::ERR_CERT_COMMON_NAME_INVALID:证书 SAN 不含当前访问域名,最常见是漏了 www。
  • SSL_ERROR_RX_RECORD_TOO_LONG:用 https:// 访问了 HTTP 端口,或反向代理把 HTTPS 请求转到 http 后端却没带 X-Forwarded-Proto。
  • Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure element 'http://example.com/a.js':改相对路径,或加 Content-Security-Policy: upgrade-insecure-requests。
  • AH02559: The SSLCertificateChainFile directive is deprecated:Apache 2.4.8+ 把中间证书合并进 SSLCertificateFile。
  • nginx: [warn] "ssl_stapling" ignored, issuer certificate not found for certificate:补上 ssl_trusted_certificate 指向中间证书。
  • java.io.IOException: No Certificate file specified or invalid file format(Tomcat):keystoreFile 路径错,或把 PEM 直接当 JKS 用。
  • NET::ERR_CERT_DATE_INVALID:客户端时间偏差,服务器执行 chronyc makestep 或 ntpd -gq 校时。

排查顺序固定:先 ss -lntp | grep 443 确认监听,再 openssl s_client -connect IP:443 -servername example.com 确认握手与链,最后才看应用日志,避免在错误的方向上翻半天日志。

效果验证与自动化续期

部署完必须用命令行验证,而不是“我这儿能打开”就算完:

# 1. 证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 2. 链完整性:输出的证书张数应为 2 或 3(叶子 + 中间,可选根)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE'

# 3. 强制 TLS 1.2 / 1.3 握手
curl -sSI --tlsv1.2 https://example.com | head -3
curl -sSI --tlsv1.3 https://example.com | head -3

# 4. HTTP 是否 301 跳转
curl -sI http://example.com | grep -iE 'HTTP/|location'

# 5. OCSP Stapling 状态
openssl s_client -connect example.com:443 -servername example.com -status /dev/null | grep -i 'OCSP Response Status'

把到期检查写成脚本挂到 cron 上,比任何“到期提醒表格”都可靠:

#!/bin/bash
DOMAIN=example.com
END=$(echo | openssl s_client -servername $DOMAIN -connect $DOMAIN:443 2>/dev/null 
      | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ "$LEFT" -lt 20 ] && echo "WARN: $DOMAIN 证书剩余 ${LEFT} 天" | mail -s "SSL 到期告警" ops@example.com

自动续期:Let’s Encrypt 用 certbot renew --dry-run 先演练,再写 0 3 * * * root certbot renew -q --deploy-hook 'systemctl reload nginx';acme.sh 用 acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/fullchain.crt --reloadcmd 'systemctl reload nginx',DNS 方式签发要保留 --cron 任务。最后用 SSL Labs 跑一次,目标 A/A+:TLS 1.3 可握手、HSTS 生效、无 RC4/3DES、OCSP Stapling 正常。

常见问题

证书安装后浏览器仍显示“不安全”怎么办?

按三步定位:第一步 openssl s_client -connect 域名:443 -servername 域名 -showcerts 看链是否完整(应输出 2 张以上证书);第二步检查页面是否有 http:// 资源被引用(F12 Console 会打印 Mixed Content);第三步检查证书 SAN 是否覆盖当前访问的域名(含 www)。90% 的情况是只部署了叶子证书没拼中间证书。

一张证书能同时用于 example.com 和 www.example.com 吗?

可以,但必须申请时把两个域名都写进 SAN(多域名/含 www 的单域名证书)。只写了 example.com 的证书访问 www 会报 NET::ERR_CERT_COMMON_NAME_INVALID。通配符 *.example.com 同样不覆盖裸域 example.com,需要单独加一条 SAN。

免费证书和付费 DV 证书有区别吗?

加密强度没有区别,都是同样的 TLS 握手与算法。差别在有效期与保障:Let’s Encrypt 固定 90 天,必须自动化续期;付费 DV 最长 398 天(2026-03-15 起降为 200 天),通常带一定的签发错误赔付。OV/EV 才是身份核验层面的差异。

证书最长有效期到底是多久?

公有可信 CA 签发的 TLS 服务器证书当前上限为 398 天(2020-09-01 起生效),Let’s Encrypt 为 90 天。按 CA/B Forum SC-081 计划,2026-03-15 起降至 200 天、2027-03-15 降至 100 天、2029-03-15 降至 47 天,因此必须用 certbot/acme.sh 等工具做自动续期,不要再依赖人工台账。

内网或本地开发环境能用公网证书吗?

不能。公网 CA 无法为 192.168.x.x、localhost、.local 等域名签发证书。内网推荐两条路:用内部 CA(如 step-ca、mkcert)签发并把根证书下发到客户端信任库;或者用真实公网域名 + DNS-01 验证签发 Let’s Encrypt 证书,再通过内网 DNS 解析到私网 IP。

更换证书后需要重启服务器吗?

不需要重启操作系统,但要让 Web 服务重新加载配置:Nginx 用 systemctl reload nginx(平滑重载,不断连接),Apache 用 systemctl reload httpd,Tomcat 修改 server.xml 后必须 restart,IIS 导入证书后重新绑定即可,必要时 iisreset。重载后务必用 openssl s_client 复核生效的是新证书序列号。

内容审核

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