HTTPS 配置与 SSL 证书安装实战:从 CSR 生成到 Nginx 全链路验证
一、问题背景与根因:证书“装上了”为什么不等于安全
SSL/TLS 位于 TCP/IP 与 HTTP、SMTP 等应用层协议之间,分为记录协议与握手协议两层:记录协议负责数据封装、压缩与加密,握手协议负责身份认证、协商加密套件、交换密钥。它最终提供三件事:认证服务器身份、加密传输内容、保证数据完整性。很多站点把证书文件往服务器一放就以为完事,浏览器却仍报错或显示“不安全”,根因通常集中在以下几类。
- 证书链不完整:只部署了叶子证书,没带中间证书。桌面浏览器可能靠缓存蒙混过关,但 Android、微信、curl、Java 客户端会直接失败。
- 私钥与证书不匹配:CSR 在一台机器生成,证书贴到另一台,或复制时串了文件。
- 域名不匹配:证书 SAN 只写了 example.com,访问 www.example.com 就报 NET::ERR_CERT_COMMON_NAME_INVALID。
- 混合内容:HTTPS 页面里仍引用 http:// 的图片、JS、CSS,浏览器地址栏显示“不安全”或内容被拦截。
- 协议与套件过旧:仍启用 TLS 1.0/1.1 或 RC4、3DES 等弱套件,被现代浏览器拒绝。
- 证书过期:目前公开 CA 签发的 TLS 证书最长有效期被限制为 398 天(Apple、Chrome 等强制),Let’s Encrypt 免费证书为 90 天,忘记续期是最常见的线上故障。
- 反向代理链路断裂:CDN/WAF 回源用 HTTP,且未传 X-Forwarded-Proto,程序仍认为自己在 HTTP 下运行,产生重定向循环。
先做一次体检再动手:openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName,确认主体、签发者、有效期与 SAN 列表;再用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 看服务端实际下发的证书链是否包含中间证书。根因定位清楚,后面的安装才有意义。
二、前置准备:证书类型选择、私钥与 CSR 生成
证书按验证级别分为 DV(域名验证)、OV(组织验证)、EV(扩展验证)。三者加密强度完全相同,差别在身份审核深度、签发时长与赔付条款。注意 EV 证书自 2019 年起主流浏览器已不再显示绿色公司名,只剩证书信息里的组织字段,不要被“EV 更安全”的营销话术误导。
私钥必须在自己的服务器上生成,绝不外传。RSA 2048 位起步,新建站点建议直接上 ECDSA P-256,握手更快:
# RSA 2048 + SAN(一次覆盖主域名和 www)
openssl req -new -newkey rsa:2048 -nodes -keyout /etc/nginx/ssl/example.com.key -out /etc/nginx/ssl/example.com.csr -subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example Ltd/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# 或 ECDSA P-256
openssl ecparam -genkey -name prime256v1 -out /etc/nginx/ssl/example.com.key
openssl req -new -key /etc/nginx/ssl/example.com.key -out /etc/nginx/ssl/example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
chmod 600 /etc/nginx/ssl/example.com.key
chown root:root /etc/nginx/ssl/example.com.key
把 CSR 交给 CA,拿回证书后确认文件齐全:example.com.crt(服务器证书)、ca-bundle.crt(中间证书)、私钥。合并时顺序不能错,服务器证书在前、中间证书在后:
cat example.com.crt ca-bundle.crt > fullchain.pem
openssl verify -CAfile ca-bundle.crt example.com.crt # 应输出 OK
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
如果不想手工折腾,用 ACME 客户端自动签发并续期,Let’s Encrypt 证书有效期 90 天,靠自动化续期而非人工记忆:
apt install certbot python3-certbot-nginx -y
certbot --nginx -d example.com -d www.example.com --agree-tos -m ops@example.com --redirect
certbot renew --dry-run
三、Nginx 完整实操:上传、配置、自检、重载
以 CentOS/Ubuntu 上的 Nginx 1.20+ 为例,证书统一放 /etc/nginx/ssl,权限 600,属主 root。配置文件按站点拆分到 conf.d,避免直接改 nginx.conf。
mkdir -p /etc/nginx/ssl
cp fullchain.pem /etc/nginx/ssl/example.com.fullchain.pem
cp example.com.key /etc/nginx/ssl/example.com.key
chmod 600 /etc/nginx/ssl/example.com.key
cat > /etc/nginx/conf.d/example.com.conf <<'EOF'
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/example.com.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;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com.fullchain.pem;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
add_header X-Content-Type-Options nosniff always;
root /var/www/example;
index index.html;
}
EOF
nginx -t && systemctl reload nginx
几个易错参数:ssl_certificate 必须指向 fullchain(含中间证书),只写叶子证书会导致部分客户端校验失败;ssl_trusted_certificate 用于 OCSP Stapling 校验,同样给完整链;ssl_prefer_server_ciphers off 是把套件选择权交给客户端,配合 TLS 1.3 更合理。若用旧版 Nginx,把 http2 on; 换回 listen 443 ssl http2;,否则会报 unknown directive 'http2'。
重载后立刻自检,不要等用户报障:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
curl -I https://example.com
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep -E 'Protocol|Cipher'
输出中 Protocol 应为 TLSv1.3 或 TLSv1.2,verify return code 应为 0 (ok)。如果是 20 (unable to get local issuer certificate),回到证书链检查。
四、Apache、CDN 与反向代理场景配置示例
Apache 2.4 的配置逻辑相同,但指令名不同。注意 SSLCertificateFile 在 2.4.8 之后可直接放 fullchain,老版本要单独用 SSLCertificateChainFile 指向中间证书。
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
ServerName example.com
DocumentRoot /var/www/example
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# Apache < 2.4.8 才需要:
# SSLCertificateChainFile /etc/httpd/ssl/ca-bundle.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305
SSLHonorCipherOrder off
SSLSessionTickets off
Header always set Strict-Transport-Security 'max-age=31536000; includeSubDomains'
</VirtualHost>
改完执行 apachectl configtest,输出 Syntax OK 再 systemctl reload httpd(Debian/Ubuntu 为 apache2)。
如果前面挂了 CDN、WAF 或 SLB,证书通常上传到云平台,源站可以选择继续用 HTTP 回源,但必须把真实协议传给后端,否则 WordPress、ThinkPHP 等程序会判断当前是 HTTP,不断 301 到 https,形成重定向循环:
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
后端程序也要信任该头,例如 Laravel 在 TrustProxies 中配置,Spring Boot 设置 server.forward-headers-strategy=native。
最后处理混合内容——这也是“配置完 https 页面错乱”的真正原因。浏览器控制台会打印:Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure resource 'http://example.com/a.js'. This request has been blocked. 处理方式:
# WordPress 用 WP-CLI 批量替换(先备份数据库)
wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise --dry-run
wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise
# 临时兜底:加 CSP,把 http 子资源自动升级
add_header Content-Security-Policy 'upgrade-insecure-requests' always;
模板里写死的 http:// 链接、第三方统计代码、旧版编辑器上传的图片都要一并清理,CSP 只是兜底不是根治。
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- HTTPS配置 · SSL证书安装服务(各种服务器)
五、证书类型与部署方式对比
选型先看验证级别和有效期,再看预算。下表按当前主流 CA 规则整理,具体以 CA 官方公告为准。
| 类型/方案 | 验证方式 | 最长有效期 | 信任与成本 | 适用场景 |
|---|---|---|---|---|
| Let’s Encrypt DV | HTTP-01 / DNS-01 域名验证 | 90 天,需自动续期 | 免费,主流浏览器信任 | 个人站、中小企业站、测试环境 |
| 商业 DV | 域名验证 | 398 天 | 数百元/年,含一定赔付 | 不想维护 ACME 的站点 |
| OV | 企业营业执照、电话核验 | 398 天 | 千元级/年 | 电商、SaaS、需展示组织身份 |
| EV | 严格组织审核 | 398 天 | 数千元/年 | 金融、支付;浏览器不再显示绿色标识 |
| 通配符 DV | DNS-01 | 90 天(LE)/398 天(商业) | 免费或付费 | 多子域,只能覆盖一级 *.example.com |
| 自签名证书 | 无 | 自定义 | 免费,但浏览器报 NET::ERR_CERT_AUTHORITY_INVALID | 仅内网测试,禁止用于公网 |
部署方式对比:
| 方式 | 优点 | 缺点 | 续期 |
|---|---|---|---|
| Nginx/Apache 直接部署 | 链路短、可控、无额外费用 | 需自己维护证书和重载 | certbot renew + reload |
| 云负载均衡/SLB | 证书集中管理,后端解耦 | 证书上传有数量限制,回源需配 X-Forwarded-Proto | 控制台或 API 更新 |
| CDN 边缘证书 | 就近卸载 TLS,支持自动签发 | 回源段可能仍是 HTTP,存在被窃听风险 | 平台自动,需监控 |
| Kubernetes Ingress | 声明式,配合 cert-manager 全自动 | Secret 更新后需控制器支持热加载 | cert-manager 自动 |
一个常见误区:免费证书与付费证书在加密算法、密钥长度上没有区别,AES-128-GCM、ChaCha20-Poly1305 该有的都有,差别只在身份验证、赔付、有效期和服务支持。另外 CA/B 论坛已通过分阶段缩短证书有效期的计划,未来会向 47 天演进,把续期自动化做在前面比选哪种证书更重要。
六、常见错误排查(附真实报错)
下面这些报错在工单里出现频率最高,按“报错原文 → 原因 → 命令”逐条对照即可。
| 报错 | 根因 | 处理 |
|---|---|---|
| NET::ERR_CERT_AUTHORITY_INVALID / curl: (60) SSL certificate problem: unable to get local issuer certificate | 缺中间证书或链顺序错误 | 用 fullchain.pem,openssl s_client -showcerts 确认下发两张以上证书 |
| nginx: [emerg] PEM_read_bio_X509_AUX(‘/etc/nginx/ssl/a.crt’) failed (SSL: error:0480006C:PEM routines::no start line) | 文件是 DER 格式、含 BOM 或内容为空 | openssl x509 -inform DER -in a.cer -out a.pem,file a.crt 确认是 PEM |
| nginx: [emerg] SSL_CTX_use_PrivateKey(‘/etc/nginx/ssl/a.key’) failed (SSL: error:0B080074:x509 certificate routines::key values mismatch) | 私钥与证书不配对 | 比对模数:openssl x509 -noout -modulus -in a.crt | md5sum 与 openssl rsa -noout -modulus -in a.key | md5sum 应一致 |
| ERR_SSL_VERSION_OR_CIPHER_MISMATCH | 协议被禁用或套件不匹配,或 443 端口被其他服务占用 | ss -lntp | grep 443,检查 ssl_protocols 是否漏了 TLSv1.2 |
| NET::ERR_CERT_COMMON_NAME_INVALID | SAN 未包含当前域名 | 重新签发含 www 的证书,openssl x509 -noout -ext subjectAltName |
| ERR_CERT_DATE_INVALID | 证书过期或服务器时间偏差 | timedatectl 校时,openssl x509 -checkend 0 -noout -in a.crt |
| Mixed Content … This request has been blocked | 页面内 http:// 资源 | 替换数据库与模板链接,必要时加 CSP upgrade-insecure-requests |
| 重定向次数过多 / ERR_TOO_MANY_REDIRECTS | 反代未传 X-Forwarded-Proto,程序认为仍是 HTTP | 补 proxy_set_header,后端开启信任代理 |
排查顺序建议固定为:先 nginx -t 看配置语法,再 openssl s_client 看服务端实际下发内容,最后看浏览器控制台。三步能把 90% 的问题定位到具体文件或具体请求。另外 Java 客户端报 PKIX path building failed,多半是 JDK 信任库没更新或中间证书缺失,先换 fullchain,再考虑 keytool -import。
七、效果验证与自动化续期监控
配置完成后不要只看浏览器绿锁,做一轮完整验证:
# 1. 协议与套件枚举
nmap --script ssl-enum-ciphers -p 443 example.com
# 2. 强制 TLS 1.2 / 1.3 握手
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null
# 3. 检查 HSTS 与跳转
curl -sI http://example.com | grep -i location
curl -sI https://example.com | grep -i strict-transport-security
# 4. 到期前 30 天预警(返回 0 表示未到期)
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/example.com.fullchain.pem
再配合 SSL Labs(https://www.ssllabs.com/ssltest/analyze.html?d=example.com)拿一份评级,目标 A 及以上。评级掉到 B 通常是开了 TLS 1.0/1.1、用了 SHA-1 签名或没开 OCSP Stapling。
续期必须自动化,Let’s Encrypt 的 90 天有效期决定了人工续期迟早出事:
# 方式一:cron,每天两次随机分钟,避免集中请求
cat > /etc/cron.d/certbot <<'EOF'
15 3,15 * * * root certbot renew --quiet --deploy-hook 'systemctl reload nginx'
EOF
# 方式二:systemd timer
systemctl enable --now certbot.timer
systemctl list-timers | grep certbot
# 验证续期流程(不会真的签发)
certbot renew --dry-run
监控层面至少做两件事:一是证书到期时间采集,Prometheus 用 blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标,剩 21 天告警;二是握手成功率与 TLS 版本分布,Nginx 日志加上 log_format tls '$remote_addr $ssl_protocol $ssl_cipher $request',观察是否还有客户端在用 TLS 1.2 以下版本。若准备提交 HSTS preload 列表,先确认所有子域都支持 HTTPS,且 max-age 至少 31536000、带 includeSubDomains,否则回退非常麻烦。
常见问题
SSL 证书最长有效期是多久?为什么我的证书一年就到期?
目前公开 CA 签发的 TLS 证书最长有效期为 398 天,Apple、Chrome 等均强制执行,超过 398 天的证书会被直接判定不受信任。Let’s Encrypt 免费证书为 90 天。CA/B 论坛已通过分阶段缩短有效期的计划,未来将向 47 天演进,因此务必用 certbot、cert-manager 等工具自动续期,而不是靠日历提醒。
只买证书、不买安装服务,自己配置需要哪些文件?
至少三样:服务器证书(.crt/.pem)、中间证书(ca-bundle)、私钥(.key)。部署时把服务器证书与中间证书按顺序合并成 fullchain.pem,Nginx 的 ssl_certificate 指向它;私钥权限设为 600、属主 root。CSR 只是申请时提交给 CA 的文件,部署阶段不需要。
配置完 HTTPS 后页面样式错乱、图片不显示,是证书问题吗?
不是。这是混合内容(Mixed Content),页面里仍有 http:// 的 JS、CSS、图片被浏览器拦截。打开控制台会看到 “Mixed Content … This request has been blocked”。用 WP-CLI 或 SQL 把数据库里的 http:// 批量替换为 https://,清理模板硬编码链接,再用 CSP 的 upgrade-insecure-requests 兜底。
通配符证书能覆盖多级子域吗?
不能。*.example.com 只覆盖 a.example.com 这一级,不覆盖 a.b.example.com,也不覆盖裸域 example.com。需要多级子域时,要么在 SAN 中逐个列出,要么为每一级单独申请通配符证书。
证书部署后多久生效?需要重启服务器吗?
Nginx 执行 nginx -t 检查通过后 systemctl reload nginx 即可,reload 是平滑加载,不断开现有连接,无需重启服务器。若前置了 CDN,还需要在平台侧更新证书并刷新缓存,否则边缘节点仍在用旧证书,生效时间取决于 CDN 的同步速度。
免费证书和付费证书的加密强度有区别吗?
没有区别。两者都可以使用 RSA 2048/4096 或 ECDSA P-256,支持 TLS 1.2/1.3 与 AES-GCM、ChaCha20-Poly1305 套件。差别在验证级别(DV/OV/EV)、有效期长短、赔付条款和技术支持。对绝大多数网站,自动化续期的 DV 证书已经足够。