跳到主要内容
ssl证书按装

HTTPS 配置与 SSL 证书安装实战:从 CSR 生成到 Nginx 全链路验证

HTTPS 配置与 SSL 证书安装实战:从 CSR 生成到 Nginx 全链路验证 — 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 只是兜底不是根治。

五、证书类型与部署方式对比

选型先看验证级别和有效期,再看预算。下表按当前主流 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 证书已经足够。

内容审核

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