跳到主要内容
SSL 证书付费服务

SSL 证书安装与 HTTPS 配置完整指南:Nginx、Apache、Tomcat、IIS 实操与真实报错排查

SSL 证书安装与 HTTPS 配置完整指南:Nginx、Apache、Tomcat、IIS 实操与真实报错排查 — SSL 证书安装与 HTTPS 配置完整指南:Nginx、Apache、Tomcat、IIS 实操与真实报错排查

问题背景与根因:HTTPS 打不开、页面错乱到底出在哪

很多站点在装完证书后仍会遇到问题,而且这些问题的根因完全不同,必须先分清再动手:

  • 证书已装但浏览器报“不安全”:多数是证书链不完整(漏装中间证书)、证书与域名不匹配(SAN 字段没包含 www 或裸域)、证书已过期,或服务器系统时间不正确。
  • HTTPS 页面能打开,但样式错乱、图片不显示、接口 404:这是典型的混合内容(Mixed Content)。页面 HTML 里仍写死了 http:// 的 js、css、img 地址,浏览器在 https 页面中会拦截这些请求。它不属于证书配置问题,而是模板和数据库里存量 http 链接的问题。
  • 浏览器直接报 ERR_SSL_PROTOCOL_ERROR 或连接被重置:443 端口没有监听、防火墙只放行了 80、Nginx 没编译 http_ssl_module,或者客户端与服务端没有共同支持的协议版本。

先做一次快速定位,用 openssl 直接看服务端到底返回了什么:

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

如果这条命令拿不到证书,说明 TLS 握手在证书环节之前就失败了,问题在协议层或网络层;如果能拿到证书但浏览器报错,问题多半在证书链或域名匹配。再验证证书链是否完整:

openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null

返回 Verify return code: 0 (ok) 表示链完整;返回 21 (unable to verify the first certificate) 就是漏装了中间证书。国内云厂商下发的压缩包里通常同时有 域名.crt 和 域名_chain.crt,只上传前者必然遇到这个问题。

另外需要纠正一个常见的过时认知:早期 Windows Server 2003/2008 的 IIS 7/7.5 不支持 SNI,同一 IP:443 只能绑定一张证书;从 IIS 8(Windows Server 2012)起已支持 SNI 多站点绑定。Apache 自 2.2.12、Nginx 自 0.7.14 起同样支持 SNI,所谓“Apache 只能配一个证书”只对十几年前的版本成立。真正需要独立公网 IP 的场景,只剩下兼容 Windows XP 上 IE6/7 这类极老客户端的需求。

证书申请与 CSR 生成:398 天有效期新规下的选型

按 CA/Browser Forum 现行基线要求,公有信任的 TLS 证书单张最长有效期为 398 天,并且这一上限还会继续缩短。因此“买一张管三年”的做法已经不可行,必须把自动续期纳入运维流程。Let’s Encrypt 签发的 DV 证书有效期固定为 90 天,官方推荐用 ACME 客户端自动续期。

选型建议:个人站与测试环境用 Let’s Encrypt 免费 DV;企业官网、电商用 OV 单域名或通配符,需提交营业执照做组织验证;支付、金融类业务仍普遍要求 OV/EV 以满足合规审计,尽管 EV 证书已不再在地址栏显示绿色公司名。

生成私钥与 CSR,务必带上 SAN,现代浏览器只校验 SAN 不校验 CN:

openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key 
  -out example.com.csr 
  -subj "/C=CN/ST=Beijing/L=Beijing/O=Example Tech/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

把 example.com.csr 的内容提交给 CA,私钥 example.com.key 永远不要外发,权限设为 600:chmod 600 example.com.key。如果不想手工折腾,直接用 certbot 走 ACME,它会自动生成密钥、完成域名校验并改写 Nginx 配置:

yum install -y certbot python3-certbot-nginx    # CentOS/RHEL
apt install -y certbot python3-certbot-nginx    # Debian/Ubuntu
certbot --nginx -d example.com -d www.example.com --agree-tos -m ops@example.com --redirect

证书下发后先在本地校验私钥与证书是否配对、SAN 是否齐全:

openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5   # 两个 md5 必须一致
openssl x509 -in example.com.crt -noout -text | grep -A1 "Subject Alternative Name"

两条 md5 不一致,后面 100% 会报 key values mismatch,不要急着上传。

Nginx 部署 SSL 证书完整实操

先确认 Nginx 编译了 SSL 模块,否则配置文件里写 ssl 指令会直接报 unknown directive "ssl":

nginx -V 2>&1 | tr ' ' 'n' | grep -E 'http_ssl_module|http_v2_module'

没有输出说明需要重新编译并加上 --with-http_ssl_module(以及 --with-http_v2_module)。接着放置证书文件,推荐把站点证书与中间证书合并成一个 fullchain 文件,从根上避免漏装链:

mkdir -p /etc/nginx/ssl
cat example.com.crt intermediate.crt > /etc/nginx/ssl/example.com.fullchain.crt
cp example.com.key /etc/nginx/ssl/example.com.key
chmod 600 /etc/nginx/ssl/example.com.key
chown root:root /etc/nginx/ssl/*

核心配置可直接替换到站点的 server 块中:

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/example.com.fullchain.crt;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;

    ssl_protocols       TLSv1.2 TLSv1.3;   # TLSv1.0/1.1 已由 RFC 8996 废弃
    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/example.com.fullchain.crt;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    # location 段落按业务补充
}

三个易错点:ssl_certificate 必须指向合并后的 fullchain,用单张站点证书会让部分 Android 与 Java 客户端报 unable to get local issuer certificate;ssl_stapling 依赖 ssl_trusted_certificate 指向含中间证书的文件,否则 error.log 会反复刷 ssl_stapling_init_cert: can't retrieve issuer certificate;HSTS 头一旦下发就会被浏览器缓存,先在测试域名上用较短的 max-age 验证。改完务必先测语法再平滑重载,不要直接 restart 打断在线连接:

nginx -t && nginx -s reload

Apache、Tomcat 与 IIS 多站点配置示例

Apache 2.4.x:先用 httpd -M | grep ssl 确认 mod_ssl 已加载。2.4.8 起 SSLCertificateFile 可以直接指向 fullchain,不再需要单独的 SSLCertificateChainFile(该指令在 2.4.8+ 已废弃)。

<VirtualHost *:443>
    ServerName example.com
    DocumentRoot /var/www/html
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/example.com.fullchain.crt
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    SSLProtocol             -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite          ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
    SSLHonorCipherOrder     off
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

多站点 HTTPS 只要写多个 <VirtualHost *:443>,各自配置 ServerName 即可,Apache 2.2.12+ 通过 SNI 区分证书,无需独立 IP。

Tomcat 8.5/9:从 8.5 起支持直接读取 PEM,不必再转 JKS:

<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           maxThreads="200" SSLEnabled="true" scheme="https" secure="true">
  <SSLHostConfig>
    <Certificate certificateFile="/opt/tomcat/conf/example.com.fullchain.crt"
                 certificateKeyFile="/opt/tomcat/conf/example.com.key"
                 type="RSA" />
  </SSLHostConfig>
</Connector>

若拿到的是 JKS,可用 keytool -importkeystore -srckeystore old.jks -destkeystore new.p12 -deststoretype PKCS12 转换。

Windows IIS:先把 crt 与 key 合成 pfx,再在 IIS 管理器 → 服务器证书 → 导入,站点绑定新增 https/443,并勾选“需要服务器名称指示”。IIS 8(Windows Server 2012)及以上才支持 SNI 多站点绑定;IIS 7.5 及更早版本同一 IP:443 只能绑一张证书,需要额外公网 IP 或升级系统。Windows Server 2003/2008 早已停止支持,不应再作为生产环境使用。

openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in example.com.fullchain.crt -passout pass:YourPwd

HTTP 强制跳转 HTTPS 与混合内容修复

证书装好只是第一步,还要把 80 端口的流量导到 443,否则用户从搜索引擎点进来仍是 http。Nginx 推荐用独立的 80 server 块,便于单独放行 ACME 校验路径:

server {
    listen 80;
    server_name example.com www.example.com;
    location /.well-known/acme-challenge/ { root /var/www/certbot; }
    location / { return 301 https://$host$request_uri; }
}

Apache 可用 Redirect permanent / https://example.com/,或 RewriteRule ^(.*)$ https://%{HTTP_HOST}$1 [R=301,L]。务必用 301 而非 302,避免搜索引擎反复抓取 http 版本。

跳转配完最常见的两个坑:

  1. ERR_TOO_MANY_REDIRECTS:站点跑在 Nginx 反代或 CDN 后面,后端看到的协议始终是 http,于是又跳一次。解决办法是在 443 的 server 块里加 proxy_set_header X-Forwarded-Proto $scheme;,并让程序按该请求头判断协议;CDN 侧则确认回源协议设置为 HTTPS 或“跟随”。
  2. 页面错乱、样式丢失:浏览器控制台会明确报 Mixed Content: The page at https://example.com/ was loaded over HTTPS, but requested an insecure element http://example.com/static/app.js. This request has been blocked. 这属于代码层问题,不是证书配置问题。批量排查命令:
curl -s https://example.com/ | grep -oE 'http://[a-zA-Z0-9./_-]+' | sort -u | head -20

修复手段:模板里改用协议相对地址 //example.com/static/app.js 或直接写 https;数据库存量内容批量替换,例如 UPDATE posts SET content = REPLACE(content,'http://example.com','https://example.com');;再叠加响应头 Content-Security-Policy: upgrade-insecure-requests 作为兜底。

服务器环境与证书类型对比表

选型前先对照自己的环境,避免买了通配符才发现旧系统只能绑一个站点。下表按实际运维场景整理,SNI 列表示是否支持同一 IP:443 绑定多张证书。

环境 SNI 多站点 推荐证书格式 关键配置项 备注
Nginx 0.7.14+ 支持 fullchain.crt + key ssl_certificate HTTP/2 需 1.9.5+,1.25.1+ 用 http2 on
Apache 2.2.12+ 支持 fullchain.crt + key SSLCertificateFile 2.4.8+ 废弃 SSLCertificateChainFile
Tomcat 8.5+ 支持 PEM 或 PKCS12 SSLHostConfig 8.5 之前需转 JKS
IIS 8 / Win2012+ 支持 PFX 绑定处勾选 SNI 需系统时间与 CA 根证书正常
IIS 7.5 / Win2008 不支持 PFX 单 IP 单证书 系统已停止支持,建议升级
IIS 6 / Win2003 不支持 PFX 单 IP 单证书 已停止支持,不建议生产使用

证书类型与有效期对照:

证书类型 最长有效期 验证方式 典型场景
Let’s Encrypt DV 90 天 HTTP-01 / DNS-01 自动 中小站点、API、测试环境
DV 单域名 398 天 文件或 DNS 解析 个人博客、单站点
DV 通配符 398 天 必须 DNS-01 多子域,仅覆盖一级
OV 单域名 / 通配符 398 天 组织信息核验 企业官网、电商
EV 398 天 严格组织核验 金融、支付合规场景

关键结论:398 天是公开信任证书的上限,且后续还会缩短,任何“一次配置、多年不管”的方案都会在某个凌晨突然过期;通配符证书 *.example.com 只覆盖一级子域,不覆盖裸域 example.com,也不覆盖 a.b.example.com,申请时必须把裸域额外写进 SAN。

常见错误排查:真实报错与对应解法

以下报错均可在 error.log、浏览器控制台或 curl 输出中原样搜到,按关键字对号入座即可。

报错信息 根因 解决
nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 证书与私钥不配对 用 modulus md5 比对后重新下发配对文件
curl: (60) SSL certificate problem: unable to get local issuer certificate 缺中间证书 拼接 fullchain.crt
NET::ERR_CERT_COMMON_NAME_INVALID SAN 不含该域名 重新签发并补齐 SAN
ERR_SSL_PROTOCOL_ERROR / SSL_ERROR_RX_RECORD_TOO_LONG 用 https 访问了 http 端口 确认 443 监听与防火墙放行
SSL_ERROR_NO_CYPHER_OVERLAP 协议或套件无交集 服务端保留 TLSv1.2 兼容老客户端
nginx: [emerg] unknown directive “ssl” 未编译 http_ssl_module 重编译加 –with-http_ssl_module
AH02217: ssl_stapling_init_cert: can’t retrieve issuer certificate! OCSP 缺少 issuer 链 ssl_trusted_certificate 指向 fullchain
java.io.IOException: Keystore was tampered with, or password was incorrect JKS 密码错或格式不符 用 keytool 重新转 PKCS12
ERR_TOO_MANY_REDIRECTS 反代/CDN 下协议判断错误 传 X-Forwarded-Proto 并让程序识别

排查顺序建议固定为四步:先 nginx -t 或 httpd -t 排除语法问题;再 ss -lntp | grep 443 确认端口监听;然后用 openssl s_client 看服务端实际下发的证书链;最后才看浏览器控制台。多数“证书装不上”的问题,实际卡在第二步或第三步。若 ACME 校验一直失败,检查 80 端口的 /.well-known/acme-challenge/ 是否被站点的伪静态 rewrite 规则拦截,这是证书续期失败最常见的原因。

效果验证、自动化续期与到期监控

配置完成后逐项验证,不要只看浏览器是否显示小锁:

# 1. 状态码与跳转链路
curl -I http://example.com          # 应返回 301 且 Location 指向 https
curl -I https://example.com         # 应返回 200

# 2. 协议版本与 HTTP/2
curl -I --http2 https://example.com
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null

# 3. 证书剩余天数
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 
  | openssl x509 -noout -enddate

续期必须自动化。Let’s Encrypt 的 90 天有效期决定了手工续期迟早出事,certbot 自带的 systemd timer 或 cron 均可,先做一次演练确认不会因 80 端口校验失败而中断:

certbot renew --dry-run
# 生产环境定时任务(每天 03:00 尝试,仅在临近到期时真正续期)
0 3 * * * certbot renew --quiet --deploy-hook "nginx -s reload"

监控层面建议两条腿走路:一是用 blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标做告警,剩余 21 天触发;二是纯脚本方案,把剩余天数写进监控系统:

DAYS=$(( ( $(date -d "$(openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 | openssl x509 -noout -enddate | cut -d= -f2)" +%s) - $(date +%s) ) / 86400 ))
echo "example.com 证书剩余 ${DAYS} 天"

最后做一次整体质量验收:用 SSL Labs 或 testssl.sh 扫描,目标评级 A 及以上,确认未启用 TLSv1.0/1.1、未使用 SHA-1 签名与 RSA 1024 位密钥、HSTS 头正常下发。若使用 CDN,还要分别在 CDN 边缘节点和源站各测一遍,因为两边证书是独立的两张。

常见问题

只上传域名证书,不上传中间证书可以吗?

不行。服务端只下发站点证书时,浏览器和大部分移动端、Java 客户端无法把证书链补全到受信任根,会报 unable to get local issuer certificate 或直接显示证书无效。正确做法是把站点证书与 CA 提供的中间证书按顺序拼成一个 fullchain 文件(站点证书在前、中间证书在后),Nginx 的 ssl_certificate、Apache 2.4.8+ 的 SSLCertificateFile、IIS 的 pfx 都指向这个合并文件。可以用 openssl s_client -connect 域名:443 -verify_return_error 验证,返回 Verify return code: 0 (ok) 才算完整。

证书最长有效期 398 天,到期后必须重新申请吗?

公开信任的 TLS 证书单张最长 398 天,到期后必须换新证书,不能续期延长同一张证书。实际操作中是重新签发一张新证书替换旧文件,域名验证流程与首次申请一致。Let’s Encrypt 更短,只有 90 天,官方明确要求自动化续期。建议在到期前 30 天完成续签,并用 certbot renew --dry-run 或监控脚本确认续期链路可用,避免因 80 端口校验路径被拦截导致续期静默失败。

HTTPS 配好后页面样式错乱,是证书没装好吗?

不是。证书只负责传输层加密,不影响页面内容渲染。样式错乱几乎都是混合内容导致:页面里仍存在 http:// 的 js、css、图片或接口地址,浏览器在 https 页面中会拦截这些请求,控制台会打印 Mixed Content ... This request has been blocked.。处理方式是修改程序模板与数据库里的存量 http 链接,改用协议相对地址或 https 绝对地址,必要时加 Content-Security-Policy: upgrade-insecure-requests 兜底。这类问题需要联系程序开发商处理,重新安装证书无效。

一台服务器能放多个 HTTPS 站点吗?需要独立 IP 吗?

现代环境不需要独立 IP。Nginx 0.7.14+、Apache 2.2.12+、Tomcat 8.5+、IIS 8(Windows Server 2012)及以上均支持 SNI,同一 IP:443 可以按域名绑定不同证书。只有 IIS 7.5/6 等老版本不支持 SNI,才需要为每个站点分配独立公网 IP 或升级系统。注意 SNI 依赖客户端在握手时发送域名,Windows XP 上的 IE6/7 等极老客户端不支持,若有此类兼容需求需单独评估。

通配符证书 *.example.com 能覆盖哪些域名?

只覆盖一级子域,例如 a.example.com、b.example.com;不覆盖裸域 example.com,也不覆盖多级子域 a.b.example.com。因此申请通配符证书时,务必把裸域一起写进 SAN 字段,签发后可用 openssl x509 -in cert.crt -noout -text | grep -A1 "Subject Alternative Name" 核对。通配符证书只能通过 DNS-01 方式验证,需要能够添加 TXT 解析记录,纯文件验证无法签发。

免费证书和付费证书的加密强度有区别吗?

加密强度没有区别。免费 DV 与付费 OV/EV 在密钥长度、支持的 TLS 协议版本、加密套件上完全一致,浏览器地址栏的小锁也一样。差别在于身份验证深度、有效期、赔付条款和技术支持:DV 只验证域名控制权,OV/EV 需核验企业主体信息,出现证书问题时付费证书通常有厂商 SLA 支持。对绝大多数站点而言,Let’s Encrypt 配合自动续期已完全够用,选付费证书的主要动因是合规审计要求与企业形象。

内容审核

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