HTTPS/SSL 证书安装配置完整指南:从生成 CSR 到 Nginx/Apache/Tomcat/IIS 上线
一、问题背景与根因:HTTP 明文传输的三类真实损失
HTTP 协议本身不做加密,请求头、Cookie、登录表单、接口返回值全部以明文经过链路。在今天的公共网络环境里,至少存在三类可直接观测的损失:
- 流量劫持:运营商或公共 Wi-Fi 在响应正文中插入广告脚本和跳转代码,用户看到的页面已经不是你提供的页面。
- 数据篡改:下载的 APK、JS 文件被替换,或支付回调中的金额被改写。
- 监听窃取:Cookie、Session ID 被嗅探后直接登录用户账号。
除安全之外还有两个现实动因:Chrome、Edge、Safari 对含密码框或支付表单的 HTTP 页面直接标注“不安全”;Google 自 2014 年起把 HTTPS 作为排名信号,百度也明确对 HTTPS 站点加权。
站点迁到 HTTPS 之后仍然出问题,根因几乎都落在四类:证书链不完整(只部署了站点证书,没带中间证书)、域名覆盖不全(SAN 里缺 www 或某个子域)、证书过期(手工续期漏了一次)、混合内容(主文档是 https,页面里还有 http 的图片/JS/CSS)。
上线前先用两条命令确认现状,避免盲目排查:
curl -sI http://example.com | head -n 5
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep -E "subject=|issuer=|Verify return code"
第一条看是否已返回 301/308;第二条看服务端是否已吐出证书、证书链是否验证通过(Verify return code: 0 (ok))。若报 connect: Connection refused 或 no peer certificate available,说明 443 未监听或未配置证书,属于配置缺失而非证书问题。
二、证书选型与有效期:DV/OV/EV 与 398 天硬规则
SSL/TLS 证书必须由浏览器信任的 CA 签发。按验证强度分三档,选型只看“谁需要为站点身份背书”:
| 类型 | 验证内容 | 典型签发时长 | 有效期上限 | 适用场景 |
|---|---|---|---|---|
| DV SSL | 仅验证域名控制权(HTTP 文件 / DNS TXT) | 分钟级 | 398 天(Let’s Encrypt 固定 90 天) | 个人站、博客、APP 后端、内部系统 |
| OV SSL | 域名控制权 + 企业工商信息核验 | 1-3 个工作日 | 398 天 | 企业官网、电商、SaaS |
| EV SSL | 严格企业核验 + 电话回访 | 3-7 个工作日 | 398 天 | 金融、支付、政务(Chrome 77 起已取消绿色地址栏,别再拿它当卖点) |
有效期是最容易出错的部分。按 CA/Browser Forum 现行基线要求,2020 年 9 月 1 日起签发的公开信任 TLS 证书最长有效期 398 天;Let’s Encrypt 免费证书固定 90 天,2025 年起还提供有效期仅 6 天的 shortlived 配置(需显式选择)。TrustAsia 等厂商的免费 DV 单域名证书同样受 398 天上限约束,不存在“永久免费永久有效”。行业已排定下一轮缩短:2026 年 3 月 15 日起上限降至 200 天,2027 年 3 月 15 日起降至 100 天——这意味着手工续期彻底不可行。
另外两个高频误区:通配符证书 *.example.com 只覆盖一级子域(a.example.com 可以,a.b.example.com 不行),且不覆盖 example.com 裸域,申请时必须把裸域一并写进 SAN;自签证书不能用于对外站点,浏览器一律报 NET::ERR_CERT_AUTHORITY_INVALID。
格式对照:.pem/.crt 为 Base64 文本(Nginx/Apache 用),.pfx/.p12 为二进制(IIS/Tomcat 用),.jks 为 Java keystore。拿到证书先确认链是否完整:
grep -c "BEGIN CERTIFICATE" fullchain.pem # 正常为 2 或 3
openssl x509 -noout -subject -issuer -dates -in fullchain.pem
输出 1 说明只有站点证书、缺中间证书,这就是后面 ERR_CERT_AUTHORITY_INVALID 的直接来源。
三、实操第一步:生成私钥与 CSR(可直接执行)
CSR(Certificate Signing Request)把公钥和域名信息打包后交给 CA,私钥必须自己保管,永远不要上传。以下命令在 Linux 上可直接复制执行:
mkdir -p /etc/ssl/example.com && cd /etc/ssl/example.com
# 1) 生成 2048 位 RSA 私钥
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
# 2) 生成 CSR,SAN 必须写全所有域名
openssl req -new -sha256 -key 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,DNS:api.example.com"
# 3) 自检 SAN 是否正确写入
openssl req -in example.com.csr -noout -text | grep -A2 "Subject Alternative Name"
要点:
- CN 已不是主标识。Chrome 58 之后只认 SAN 扩展,CN 里写了域名但 SAN 里没有,浏览器照样报
NET::ERR_CERT_COMMON_NAME_INVALID。 - 想用 ECDSA(握手更快、证书更小)可换成
openssl ecparam -genkey -name prime256v1 -out example.com.key,但要确认老客户端兼容性;稳妥做法是 RSA 2048 起步,或部署 RSA + ECDSA 双证书。 - CSR 与私钥必须配对,否则后续一定报
key values mismatch。校验命令:
openssl req -noout -modulus -in example.com.csr | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5 # 两行 md5 必须一致
把 example.com.csr 的全部内容(含 -----BEGIN CERTIFICATE REQUEST----- 到 -----END-----)提交给 CA;私钥留在服务器上,权限 600、属主 root,任何情况下都不要通过邮件或工单发送。
四、实操第二步:免费证书签发与自动续期(acme.sh / certbot)
免费 DV 证书走 ACME 协议,两个主流客户端二选一。acme.sh 更轻量且自带 cron 续期:
# 安装(写入 ~/.acme.sh 并注册 cron)
curl https://get.acme.sh | sh -s email=ops@example.com
# 默认 CA 切换到 Let's Encrypt
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
# 方式 A:HTTP-01 文件验证(网站 80 端口可公网访问)
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html
# 方式 B:DNS-01(泛域名必须用这个)
export Ali_Key="LTAIxxxx"; export Ali_Secret="xxxx"
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d "*.example.com"
# 安装证书并绑定重载命令,续期后自动生效
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.pem
--reloadcmd "systemctl reload nginx"
certbot 路线:
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --dry-run
certbot renew --deploy-hook "systemctl reload nginx"
三个必须注意的点:
- 先用 –dry-run / –staging 演练。Let’s Encrypt 有速率限制:每个注册域名每周 50 张、同一组域名每周 5 张,超限直接报
too many certificates already issued,只能等一周。 - HTTP-01 要求
http://example.com/.well-known/acme-challenge/能从公网访问。如果 Nginx 把location /.well-known/也 301 到 https,或做了全站拦截,验证必失败。 - DNS-01 走 TXT 记录,是唯一能签泛域名的路径,也不需要暴露 80 端口,内网或纯反代场景优先选它。
五、配置示例:Nginx / Apache / Tomcat / IIS 四套可套用模板
Nginx(注意 ssl_certificate 必须指向 fullchain,不是单张站点证书):
server {
listen 80;
server_name example.com www.example.com;
location ^~ /.well-known/acme-challenge/ { root /var/www/html; }
location / { 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_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;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
root /var/www/html;
}
Apache:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# Apache 2.4.8+ 用 fullchain 时无需再配 SSLCertificateChainFile
SSLProtocol -all +TLSv1.2 +TLSv1.3
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Tomcat(PEM 转 PKCS12 后在 server.xml 引用):
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-certfile chain.pem -name tomcat -out example.com.p12
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" scheme="https" secure="true" maxThreads="200">
<SSLHostConfig>
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.com.p12"
certificateKeystorePassword="changeit" certificateKeystoreType="PKCS12"
type="RSA" />
</SSLHostConfig>
</Connector>
IIS:用 certutil -importPFX example.com.pfx 或图形界面把 PFX 导入“个人”存储;CA 提供的中间证书必须单独导入“中间证书颁发机构”存储,否则链不完整;站点绑定 https/443 并勾选“需要服务器名称指示(SNI)”。配置完成后统一执行 nginx -t 或 apachectl configtest 再 reload,不要直接重启生产进程。
六、四种服务器配置对比:文件格式、链处理与热加载
| 对比项 | Nginx | Apache | Tomcat | IIS |
|---|---|---|---|---|
| 证书文件格式 | PEM(fullchain.pem) | PEM(fullchain.pem) | PKCS12 / JKS | PFX |
| 中间证书处理 | 拼接到 fullchain.pem 末尾 | 2.4.8+ 直接用 fullchain;旧版用 SSLCertificateChainFile | 打包进 keystore,或用 -certfile 一并导出 | 单独导入“中间证书颁发机构”存储 |
| 443 监听 | listen 443 ssl; |
<VirtualHost *:443> + SSLEngine on |
Connector port="443" SSLEnabled="true" |
站点绑定 https/443 + SNI |
| 强制跳转 | return 301 https://$host$request_uri; |
Redirect permanent / https://example.com/ |
web.xml 中 <transport-guarantee>CONFIDENTIAL |
URL Rewrite 模块规则 |
| 热加载 | systemctl reload nginx |
apachectl graceful |
需重启 JVM 进程 | 重启站点(避免 iisreset 全量重启) |
| OCSP Stapling | ssl_stapling on; |
SSLUseStapling on |
不支持 | 不支持 |
两个补充结论:第一,Let’s Encrypt 已于 2025 年停止提供 OCSP 响应、改用 CRL,对 LE 证书开启 ssl_stapling 没有意义,注释掉即可,否则日志里会出现 ssl_stapling ignored, issuer certificate not found。第二,私钥文件权限要同时满足“进程可读”和“其他用户不可读”:Nginx worker 以 nginx/www-data 运行时,常见做法是 chown root:nginx example.com.key && chmod 640,而不是简单 600,否则 reload 后握手直接 500。
七、常见错误排查:从真实报错反推根因
按报错信息对号入座,比逐项巡检快得多:
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)—— 证书与私钥不匹配。按第三节的 md5 校验确认配对关系,重新下载 key,不要手工拼接。- 浏览器
NET::ERR_CERT_AUTHORITY_INVALID,或curl: (60) SSL certificate problem: unable to get local issuer certificate—— 缺中间证书。用grep -c "BEGIN CERTIFICATE" fullchain.pem确认,把 CA 提供的 chain 拼到站点证书后面。 NET::ERR_CERT_COMMON_NAME_INVALID/SSL_ERROR_BAD_CERT_DOMAIN—— 访问的域名不在 SAN 里,改配置无效,只能重新签发。- acme.sh 报
Verify error:Invalid response from http://example.com/.well-known/acme-challenge/xxxx: 404—— webroot 路径写错,或伪静态规则吃掉了请求。临时放行location ^~ /.well-known/acme-challenge/ { root /var/www/html; }。 too many certificates already issued for exact set of domains—— 触发速率限制(同一组域名每周 5 张)。等满 168 小时,或先用--staging调试。ERR_SSL_PROTOCOL_ERROR/SSL_ERROR_RX_RECORD_TOO_LONG—— 443 端口上跑的不是 TLS,常见于 CDN 回源指到了 http 后端,或 Tomcat 仍是明文 Connector。nginx: [emerg] bind() to 0.0.0.0:443 failed (98: Address already in use)—— 端口被占,用ss -lntp | grep :443定位进程。- 控制台
Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 'http://...'—— 用curl -s https://example.com | grep -o 'http://[^"]*'抓出资源,全量改相对协议,过渡期可加Content-Security-Policy: upgrade-insecure-requests。
排查顺序建议固定为:先看 443 是否监听 → 再看证书是否过期 → 再看链是否完整 → 最后看域名是否匹配。四步能覆盖 90% 以上的线上故障。
八、效果验证与续期监控:把过期风险降到零
配置完成后必须做机器验证,不能只看浏览器小锁图标:
# 1) 跳转与响应
curl -sI http://example.com | head -n 3 # 期望 301,Location 指向 https
curl -sI https://example.com | head -n 5
# 2) 证书链完整性(关键看 Verify return code: 0)
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
# 3) 有效期与 SAN
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 4) 协议版本探测
openssl s_client -connect example.com:443 -tls1_1 </dev/null # 期望握手失败
openssl s_client -connect example.com:443 -tls1_3 </dev/null # 期望成功
续期监控:~/.acme.sh/acme.sh --list 可查看所有证书的到期时间,cron 默认每天执行一次;再用一段脚本做独立告警,避免 cron 失效后无人知晓:
end=$(openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
echo "$end"
[ $(date -d "$end" +%s) -lt $(date -d "+15 days" +%s) ] && echo "WARN: 证书 15 天内到期"
建议在到期前 30/15/7 天各触发一次告警。验收标准建议写死:SSL Labs 评级 A 及以上、Verify return code 为 0、TLS 1.0/1.1 握手失败、HTTP 全量 301、页面无 Mixed Content 告警。reload 是平滑的,旧连接不会中断,可以放心放进续期钩子。
常见问题
免费证书(Let’s Encrypt、TrustAsia DV)只验证域名控制权,有效期 90 天或最长 398 天,无人工客服和资金赔付保障;付费 OV/EV 需核验企业真实性,提供更高保修额度与技术支持。个人站、博客、内部系统用免费 DV 完全够用。
按 CA/Browser Forum 基线要求,2020 年 9 月 1 日起签发的公开信任 TLS 证书最长 398 天,Let’s Encrypt 固定 90 天。2026 年 3 月 15 日起上限降至 200 天,2027 年 3 月 15 日起降至 100 天,必须做自动续期。
九成是证书链不完整:服务器只发了站点证书,没带中间证书,浏览器无法回溯到根 CA。把 CA 提供的中间证书拼到站点证书后面生成 fullchain.pem;IIS 则需把中间证书单独导入“中间证书颁发机构”存储。
取决于产品类型。单域名证书只保护一个 FQDN;多域名 SAN 证书通常支持 5 到 100 个域名;通配符 *.example.com 覆盖该域下所有一级子域但不含裸域。Let’s Encrypt 单张证书最多可含 100 个 SAN。
永久迁移用 301 或 308。308 会保留原请求方法,POST 不会退化成 GET;301 在部分老客户端会把 POST 变成 GET。不要用 302,搜索引擎不传递权重,且每次访问都多一次往返。
优先启用 TLS 1.3(握手降至 1-RTT)、开启会话复用 ssl_session_cache shared:SSL:10m、启用 HTTP/2 或 HTTP/3、证书改用 ECDSA 算法。若后端是 Tomcat,还要确认已开启 NIO 连接器并关闭不必要的加密套件。