跳到主要内容
ssl证书按装

SSL 证书安装部署实战:Nginx/Apache/Tomcat/IIS 与宝塔面板配置指南

SSL 证书安装部署实战:Nginx/Apache/Tomcat/IIS 与宝塔面板配置指南 — SSL 证书安装部署实战:Nginx/Apache/Tomcat/IIS 与宝塔面板配置指南

一、证书装上了为什么还是不安全:四类根因

大量站点在“装完证书”之后依旧弹出红色警告,问题通常不在证书本身,而在证书链、私钥、协议版本、SNI 绑定这四件事上。浏览器握手时会依次校验:域名是否命中 SAN、有效期是否覆盖当前时间、证书链能否回溯到受信任根、服务器是否返回了正确的那张证书。任何一环断裂都会直接报错:

  • NET::ERR_CERT_AUTHORITY_INVALID:最常见,只部署了站点证书,漏掉中间证书。
  • NET::ERR_CERT_COMMON_NAME_INVALID:证书 SAN 列表没有包含访问的域名,例如只签了 example.com 却用 www.example.com 访问。
  • curl: (60) SSL certificate problem: unable to get local issuer certificate:同样是证书链不完整,服务端没有下发中间证书。
  • AH01909: RSA certificate configured for example.com does not include an ID which matches the server name:多域名或 SNI 绑定错位。

时间因素也常被忽略。自 2020 年 9 月起,公开信任的 SSL/TLS 证书最长有效期被限制为 398 天,Let’s Encrypt 免费证书只有 90 天,且业界已明确将继续缩短到 200 天、100 天量级。这意味着“装一次管几年”的做法彻底失效,必须把续期与到期监控纳入自动化。此外 TLS 1.0/1.1 已被主流浏览器标记为不安全,只开这两个协议的站点即使证书完全正确,也会在握手阶段被拒绝。

二、部署前的准备:CSR 生成、链拼接与私钥校验

先在服务器上生成私钥与 CSR(OpenSSL 1.1.1+ 支持 -addext 直接写 SAN):

openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

拿到 CA 返回的文件后,必须先拼出 fullchain,再校验私钥与证书是否匹配。判据是两者的 modulus 指纹一致:

cat example.com.crt intermediate.crt > fullchain.pem
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5   # 两行 md5 必须相同
openssl verify -untrusted intermediate.crt example.com.crt       # 期望输出 OK
openssl x509 -in fullchain.pem -noout -subject -issuer -dates

注意三点:私钥权限必须收紧为 chmod 600 且属主为 root 或 Web 服务账号;证书文件必须是纯 PEM 文本(以 -----BEGIN CERTIFICATE----- 开头),从控制台下载时误存成 HTML 页面是高频事故;ECDSA 证书(P-256)体积更小、握手更快,但需确认客户端兼容性,必要时 RSA 与 ECDSA 双证书并存。

三、Nginx 部署实操与完整配置示例

Nginx 部署只有三步:放文件、改 server 块、平滑重载。先确认模块并收紧权限:

mkdir -p /etc/nginx/ssl && cp fullchain.pem example.com.key /etc/nginx/ssl/
chmod 600 /etc/nginx/ssl/example.com.key
nginx -V 2>&1 | tr ' ' 'n' | grep -i ssl   # 应出现 --with-http_ssl_module

配置示例(80 强制跳 443,仅启用 TLS 1.2/1.3):

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.pem;
    ssl_certificate_key     /etc/nginx/ssl/example.com.key;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;   # OCSP stapling 校验用
    ssl_protocols           TLSv1.2 TLSv1.3;
    ssl_ciphers             ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256: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;
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    location / { root /var/www/html; index index.html; }
}

执行 nginx -t && nginx -s reload 生效。reload 是平滑重载,不断开既有连接,无需重启服务器;nginx -t 报错时立即回滚备份配置,否则 443 会整体不可用。多域名共用一张证书时 server_name 必须写全;泛域名 *.example.com 不覆盖 a.b.example.com 这类多级子域。HSTS 头一旦下发就会被浏览器缓存 max-age 时长,首次上线建议先用 300 秒观察。

四、Apache 部署实操与完整配置示例

Apache 需要先启用 mod_ssl,再配置 443 虚拟主机。注意版本差异:2.4.8 之前必须用 SSLCertificateChainFile 单独指定中间证书;2.4.8 及以后可以把站点证书与中间证书合并进 SSLCertificateFile。

# Debian/Ubuntu
apt install -y apache2 && a2enmod ssl headers && a2ensite default-ssl
# RHEL/CentOS
yum install -y mod_ssl
<VirtualHost *:443>
    ServerName example.com
    DocumentRoot /var/www/html
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    # Apache < 2.4.8 才需要下面这行
    # SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
    SSLProtocol             -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite          HIGH:!aNULL:!MD5:!3DES
    SSLHonorCipherOrder     off
    Header always set Strict-Transport-Security "max-age=31536000"
    <Directory "/var/www/html">
        Require all granted
    </Directory>
</VirtualHost>

生效命令:apachectl configtest && apachectl -k graceful(CentOS 为 httpd -t 与 systemctl reload httpd)。若同时存在 80 端口虚拟主机,用 Redirect permanent / https://example.com/ 做跳转。启用 OCSP stapling 时若日志出现 AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate!,说明未配置 SSLCertificateChainFile,补齐后重载即可。

五、Tomcat、IIS 与面板(宝塔/PhpStudy/WDCP)部署要点

Tomcat:8.5.28+ 与 9.x 支持直接读取 PEM;更通用的做法是转成 PKCS12:

openssl pkcs12 -export -in fullchain.pem -inkey example.com.key 
  -out example.com.p12 -name tomcat -passout pass:changeit
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true">
  <SSLHostConfig protocols="TLSv1.2,TLSv1.3">
    <Certificate certificateKeystoreFile="conf/example.com.p12"
                 certificateKeystoreType="PKCS12"
                 certificateKeystorePassword="changeit" />
  </SSLHostConfig>
</Connector>

IIS:把 .pfx 导入“个人”存储区,中间证书导入“中间证书颁发机构”,站点绑定 443 时务必勾选“需要服务器名称指示”(SNI),否则同 IP 多站点会串证。命令行核验:netsh http show sslcert。

宝塔面板:网站 → SSL → Let’s Encrypt 或粘贴证书,证书落地路径为 /www/server/panel/vhost/cert/域名/fullchain.pem 与 privkey.pem,保存后面板自动执行 nginx -s reload,再打开“强制 HTTPS”。PhpStudy 在“网站 → SSL”中粘贴 PEM 与 KEY 后重启 Apache/Nginx;WDCP 需在站点 SSL 页填写证书内容并确认 vhost 中已生成 ssl_certificate 指令。面板部署后仍要手工验证证书链是否完整。

六、各服务部署方式对比表

服务 证书文件要求 关键配置项 生效命令
Nginx fullchain.pem(站点+中间)+ key ssl_certificate / ssl_certificate_key / ssl_protocols nginx -t && nginx -s reload
Apache 2.4.8+ 可合并为单个 SSLCertificateFile SSLEngine on / SSLProtocol apachectl -k graceful
Apache < 2.4.8 站点证书与中间证书必须分离 SSLCertificateChainFile apachectl -k graceful
Tomcat 8.5.28+ PKCS12 / JKS,或 PEM 三件套 Connector + SSLHostConfig systemctl restart tomcat
IIS .pfx(PKCS12,含私钥与链) 443 绑定 + 勾选 SNI 通常即时生效
宝塔/PhpStudy/WDCP 面板粘贴 PEM + KEY 面板 SSL 开关 + 强制 HTTPS 面板自动 reload

选型建议:单机高并发优先 Nginx(握手性能与 OCSP stapling 支持最好);遗留 PHP 项目继续用 Apache;Java 栈必须走 Tomcat 的 PKCS12;Windows 生态用 IIS 并注意 SNI;面板适合运维人力有限的场景,但要额外补上到期监控,因为面板通知常被忽略。无论哪种方案,证书文件统一放 /etc/ssl 或面板 cert 目录、权限 600、纳入配置管理,是避免“证书换了但没生效”的基本功。

七、常见错误排查(含真实报错)

报错信息 原因 处理
nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:…key values mismatch) 私钥与证书不匹配 用 modulus md5 比对,重新配对
nginx: [emerg] PEM_read_bio_X509_AUX(…) no start line: Expecting: TRUSTED CERTIFICATE 证书文件被存成 HTML 或含多余字符 重新导出纯 PEM
nginx: [emerg] unknown directive “ssl_certificate” 未编译 ngx_http_ssl_module 重装带 ssl 模块的包
curl: (60) unable to get local issuer certificate 缺中间证书 改用 fullchain.pem
SSL_ERROR_RX_RECORD_TOO_LONG 用 https 访问了 80 端口 检查跳转与端口映射
curl: (35) error:0A00010B:SSL routines::wrong version number 反代后端仍是 HTTP 修正 upstream 协议
java.io.IOException: Invalid keystore format JKS/PKCS12 类型不符 显式指定 certificateKeystoreType
Problem binding to port 80: Could not bind to IPv4 or IPv6 80 被占用,certbot 无法验证 改用 webroot 或 DNS-01

排查顺序建议固定为:① nginx -t / apachectl configtest 看语法;② ss -lntp | grep 443 看端口是否监听;③ openssl s_client 看实际下发的证书;④ 浏览器开发者工具看是否 Mixed Content。还有一个隐蔽坑:系统时间偏差会导致 certificate is not yet valid,用 timedatectl status 或 chronyc tracking 确认 NTP 同步正常。

八、效果验证与自动续期

部署完成后必须用命令行做闭环验证,而不是只看浏览器绿锁:

# 1) 看服务端实际下发的证书与 SAN
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 2) 校验证书链,期望 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>&1 | grep "Verify return code"
# 3) 确认 TLS 1.1 已被拒绝(应 handshake failure)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# 4) 确认 301 跳转与 HSTS 头
curl -sI http://example.com | head -n 3
curl -sI https://example.com | grep -i strict-transport-security

续期方面,Let’s Encrypt 用 certbot 加 deploy hook 实现“续期即重载”:certbot renew --dry-run 先演练,通过后写入计划任务 0 3 * * * certbot renew --quiet --deploy-hook "systemctl reload nginx"。再补一条到期监控,提前 30 天告警:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -checkend 2592000 && echo "证书 30 天内有效" || echo "即将过期,请续期"

最终验收建议跑一遍 SSL Labs 评级,目标 A 及以上:TLS 1.2/1.3、前向保密套件、HSTS、OCSP stapling 全部就位即可达标。注意 HSTS 的 includeSubDomains 与 preload 一旦生效难以回退,务必先在测试域名验证。

常见问题

按 CA/B 论坛规则与主流浏览器要求,2020 年 9 月起公开信任的 SSL/TLS 证书最长有效期为 398 天,Let’s Encrypt 免费证书为 90 天且支持自动续期。业界已确定继续缩短,因此必须配置自动续期与到期监控,不能依赖手工更换。


不需要。Nginx 用 nginx -s reload,Apache 用 apachectl -k graceful,都是平滑重载,不会断开现有连接;Tomcat 修改 Connector 后一般需 restart。重载前务必执行 nginx -t 或 apachectl configtest,避免语法错误导致 443 全部不可用。


可以。通过 SAN 扩展,单张证书能包含多个域名,或用 *.example.com 泛域名证书覆盖同级子域。但泛域名不覆盖 a.b.example.com 这类多级子域,部分证书产品也不支持同时签发主域与泛域名,下单时需勾选确认。


先看控制台是否 Mixed Content(HTTPS 页面加载 HTTP 资源),可用 CSP 的 upgrade-insecure-requests 修正;再检查是否缺中间证书、SAN 是否漏域名、系统时间是否偏差。用 openssl s_client -connect 域名:443 -servername 域名 确认 Verify return code 是否为 0。


执行 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,输出中应包含站点证书及至少一张中间证书;再用 openssl verify -untrusted chain.pem cert.pem 验证返回 OK。若只返回站点证书,浏览器会报 ERR_CERT_AUTHORITY_INVALID。


加密强度没有差别,都走同等 TLS 握手。差异在有效期(90 天 vs 398 天)、保障额度、签发类型(DV/OV/EV)、多域名与泛域名支持、审核流程与技术支持。生产环境用 Let's Encrypt 配合自动续期完全可行,但需自建到期监控。

内容审核

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