跳到主要内容
HTTPS小程序证书

SSL 数字证书安装实战指南:从 CSR 申请到 Nginx/Apache 配置、排错与验证

SSL 数字证书安装实战指南:从 CSR 申请到 Nginx/Apache 配置、排错与验证 — SSL 数字证书安装实战指南:从 CSR 申请到 Nginx/Apache 配置、排错与验证

一、问题背景与根因:HTTP 站点为什么被浏览器判定“不安全”

Chrome 自 68 版起对所有 http:// 页面在地址栏标注“不安全”,Edge、Firefox 行为一致。根因只有两条:第一,HTTP 是明文传输,链路中任何一跳(公共 Wi-Fi、运营商缓存、企业代理)都能读取并篡改 Cookie、表单和 API 响应;第二,HTTP 没有身份校验,客户端无法确认对端就是真实服务器,中间人可无缝替换页面内容。

现实约束比“体验更好”更硬:微信小程序强制所有网络请求使用 HTTPS,且要求 TLS 版本 ≥ 1.2、证书链完整;iOS 的 ATS 默认拒绝明文 HTTP;HTTP/2 与 HTTP/3 在主流浏览器实现中只跑在 TLS 之上;支付回调、OAuth 回调地址普遍强制 https。换句话说,SSL 证书不是可选项,而是上线前置条件。

同时必须纠正旧文档里几个已经过时的说法:

  • “默认提供有效期为一年的证书”——自 2020-09-01 起,公有 CA 签发的 TLS 服务器证书最长有效期被限制为 398 天;CA/B Forum 已通过 SC-081 分阶段压缩上限:2026 年 3 月起 200 天、2027 年 3 月起 100 天、2029 年 3 月起 47 天。因此必须建立自动续期机制,而不是每年手工换一次。
  • “EV 证书会在地址栏显示公司名称”——Chrome 从 2019 年(77 版)起移除了 EV 证书的绿色地址栏与企业名称展示,EV 现在的价值在于组织身份背书、审计合规和保险条款,不在 UI。
  • “证书到期前手动提交 txt 解析”——DNS-01 验证完全可以脚本化,通过 ACME 客户端或云 DNS API 自动完成,人工加 TXT 记录只是最原始的兜底手段。

另外要区分“域名型 DV”和“企业型 OV/EV”的本质差异:前者只验证域名控制权,后者由 CA 人工核验营业执照、电话回访等主体信息。验证强度不同,签发时长和价格差一个数量级,但浏览器给 DV 和 OV 的锁标识完全一样。

二、证书选型与有效期新规:DV/OV/EV 与单域名/多域名/通配符

选型要分两个维度看,很多故障源于把这两个维度混为一谈。

维度一:域名覆盖范围。单域名证书只保护一个 FQDN,example.com 和 www.example.com 算两个不同域名,这是最常见的踩坑点。多域名证书(SAN 证书)在一张证书里放多个 Subject Alternative Name,默认 3~5 个,可扩展到上百个,适合域名杂乱但主体相同的业务。通配符证书 *.example.com 只覆盖一级子域名,既不包含 example.com 本身,也不包含 a.b.example.com;实践中通常买一张 SAN 证书,把 *.example.com 和 example.com 一起放进去。

维度二:验证等级。DV 只验证域名控制权,自动化签发通常 1~10 分钟;OV 需核验企业主体,人工审核 1~3 个工作日,证书主题中含 O= 字段;EV 核验更严,含 jurisdictionC 等字段。三者加密强度完全相同,差别只在身份信息与审核成本。

有效期新规必须写进运维流程。商业 DV/OV/EV 证书现在最长 398 天,且未来会持续缩短;Let’s Encrypt 免费证书固定 90 天,靠 ACME 自动续期。任何“一年一换”的排班表都已经失效,正确的做法是把续期检查做成定时任务。

Let’s Encrypt 有速率限制:同一注册域名每周最多 50 张证书,同一组精确域名每周最多 5 张。反复调试配置时务必先用 --staging 环境,否则很容易触发 too many certificates already issued 而卡住一整天。

三、申请实操:生成 CSR、完成域名验证、拿到完整证书链

第一步,生成私钥与 CSR。私钥必须在自己的服务器上生成,绝不能把私钥发给任何人(包括服务商)。

mkdir -p /etc/ssl/private/example.com && cd /etc/ssl/private/example.com
# RSA 2048 是底线,条件允许直接用 ECDSA P-256,握手更快
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key 
  -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co., Ltd./CN=example.com'
chmod 600 example.com.key

ECDSA 方案:openssl ecparam -genkey -name prime256v1 -noout -out example.com.key,再执行 openssl req -new -key example.com.key -out example.com.csr -subj '/CN=example.com'。不要使用 1024 位密钥,Chrome 会直接报 ERR_CERT_WEAK_KEY。

校验 CSR 内容是否正确(尤其确认 CN 拼写与 SAN 是否已包含):

openssl req -in example.com.csr -noout -verify
openssl req -in example.com.csr -noout -subject -text | head -20

第二步,域名验证。DV 证书常用 DNS-01:CA 给出形如 _dnsauth.example.com 的 TXT 记录值,添加后从多个递归解析器确认已生效(TTL 建议设 60):

dig +short TXT _dnsauth.example.com @8.8.8.8
dig +short TXT _dnsauth.example.com @1.1.1.1
dig +short TXT _dnsauth.example.com @223.5.5.5

若使用 HTTP-01 文件验证,把 CA 提供的文件放到站点根目录的 /.well-known/pki-validation/ 下,自检必须返回 200 且内容逐字节一致,不允许 301 跳转、不允许 BOM、不允许 CDN 缓存旧内容:

curl -s http://example.com/.well-known/pki-validation/xxxx.txt

第三步,下载证书包并识别文件。商业 CA 通常给三个文件:domain.crt(服务器/叶子证书)、ca_bundle.crt(中间证书)、root.crt(根证书)。部署时要拼接 fullchain,顺序不能反:

cat domain.crt ca_bundle.crt > fullchain.crt
openssl x509 -in fullchain.crt -noout -subject -issuer -dates

根证书不要拼进 fullchain,服务器不需要也不应该发送根证书,那只会增加握手体积。

四、Nginx 部署:可执行的完整配置与加固参数

先把文件放到固定路径,例如 /etc/nginx/ssl/example.com/ 下的 fullchain.crt 与 example.com.key,属主设为 root,私钥权限 600。然后写入完整 server 块:

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

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    add_header X-Content-Type-Options nosniff always;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto https;
    }
}

几个必须解释的参数:ssl_protocols 只保留 TLSv1.2/1.3,TLS 1.0 与 1.1 已于 RFC 8996 中被正式弃用,开启只会拖低 SSL Labs 评级;ssl_prefer_server_ciphers off 是为了让客户端(现代浏览器)选择更优的 AEAD 套件;ssl_session_tickets off 牺牲少量性能换取前向安全性。

关于 OCSP Stapling:Let’s Encrypt 已于 2025 年停止提供 OCSP 响应,使用 LE 证书时 ssl_stapling on 不会产生实际效果,可以删除;若使用仍在提供 OCSP 的商业 CA,则需同时配置 ssl_stapling_verify on、ssl_trusted_certificate 指向 fullchain,并配置可用的 resolver,否则日志会刷 ssl_stapling ignored, issuer certificate not found。

最后执行校验与重载,注意 nginx -t 通过只是语法正确,不代表证书能被浏览器接受:

nginx -t && systemctl reload nginx

五、Apache、Tomcat、IIS 部署配置示例

Apache 2.4:2.4.8 之后 SSLCertificateChainFile 已废弃,直接把 fullchain 交给 SSLCertificateFile 即可。

<VirtualHost *:80>
  ServerName example.com
  Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
  ServerName example.com
  SSLEngine on
  SSLCertificateFile    /etc/httpd/ssl/example.com/fullchain.crt
  SSLCertificateKeyFile /etc/httpd/ssl/example.com/example.com.key
  SSLProtocol -all +TLSv1.2 +TLSv1.3
  SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305
  Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>

配置后执行 apachectl configtest && systemctl reload httpd。

Tomcat 9/10:Tomcat 不能直接读 PEM,需要先合成 PKCS12:

openssl pkcs12 -export -in fullchain.crt -inkey example.com.key 
  -certfile ca_bundle.crt -out example.com.p12 -name tomcat -passout pass:changeit
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol'
           maxThreads='200' SSLEnabled='true' scheme='https' secure='true'>
  <SSLHostConfig protocols='TLSv1.2,TLSv1.3'>
    <Certificate certificateKeystoreFile='/opt/tomcat/conf/example.com.p12'
                 certificateKeystoreType='PKCS12'
                 certificateKeystorePassword='changeit' />
  </SSLHostConfig>
</Connector>

IIS:导入 PFX 到“本地计算机 → 个人”存储,再绑定 443 并勾选 SNI(SslFlags 1):

Import-PfxCertificate -FilePath C:certexample.com.pfx `
  -CertStoreLocation Cert:LocalMachineMy `
  -Password (ConvertTo-SecureString -String 'yourpass' -AsPlainText -Force)
New-WebBinding -Name 'Default Web Site' -Protocol https -Port 443 `
  -HostHeader example.com -SslFlags 1

同一台 IIS 上部署多个站点时,必须为每个绑定启用 SNI,否则第二个站点会报证书域名不匹配。Tomcat 若报 JSSE 相关握手失败,先确认 JDK 版本支持 TLS 1.3(JDK 8u261+ / JDK 11+)。

六、方案对比:证书类型、覆盖范围与部署格式

下表用于快速决策,价格与审核时长以实际 CA 报价为准,但验证强度与浏览器表现的规律是稳定的。

类型 验证内容 签发时长 证书主题字段 浏览器表现 适用场景
DV 域名控制权(DNS/HTTP) 1~10 分钟 仅 CN + SAN 锁标识,与 OV 一致 个人站、API、内部服务、小程序后端
OV 域名 + 企业主体人工核验 1~3 工作日 含 O、C、ST 等 锁标识,无额外 UI B2B 门户、需要向审计方证明主体身份
EV 更严格的法人核验 3~7 工作日 含 jurisdictionC 等 Chrome 77+ 已无绿条 受监管行业强制要求的场景
覆盖范围 典型写法 是否覆盖 example.com 是否覆盖 a.b.example.com 备注
单域名 example.com 是 否 www 需另加或改用 SAN
多域名 SAN example.com + www + api 是 否 默认 3~5 个名字,可扩容
通配符 *.example.com 否 否 只覆盖一级子域名
部署格式 文件形态 适用服务端 注意点
PEM(fullchain) .crt/.pem 文本 Nginx、Apache、HAProxy 叶子证书在前,中间证书在后
PKCS12 .p12/.pfx 二进制 Tomcat、IIS、Java 应用 需同时提供导出密码
JKS .jks 二进制 老版本 Tomcat JDK 9+ 建议改用 PKCS12
DER .cer 二进制 部分设备、旧版 Windows 需先转换为 PEM 才能给 Nginx 用

结论很直接:绝大多数业务选 DV 即可,浏览器给 DV、OV、EV 的安全标识完全相同;真正决定用户体验的是证书链是否完整、TLS 版本是否够新、是否配置了 HTTP→HTTPS 跳转与 HSTS。

七、常见错误排查:真实报错与修复命令

1. curl: (60) SSL certificate problem: unable to get local issuer certificate
根因是服务器只发送了叶子证书,缺中间证书。检查链上证书数量,正常应为 2~3 张:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

修复:cat domain.crt ca_bundle.crt > fullchain.crt 后重载服务。注意顺序,反了同样报错。

2. nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
证书与私钥不配对,常见于重签后只替换了其中一个文件。用公钥指纹比对:

openssl x509 -noout -pubkey -in fullchain.crt | openssl md5
openssl pkey -pubout -in example.com.key | openssl md5

两个 md5 必须一致,不一致就是拿错了文件。

3. NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN
证书里没有当前访问的域名,通常是漏了 www,或用通配符去覆盖二级域名。查 SAN 列表:

openssl x509 -in fullchain.crt -noout -text | grep -A1 'Subject Alternative Name'

4. AH01909: server certificate does NOT include an ID which matches the server name
Apache 的 ServerName 与证书域名不一致,或多站点未启用 SNI(Apache 2.4 默认开启,但若显式配置了 SSLStrictSNIVHostCheck on 需留意)。

5. curl: (35) error:0A00018E:SSL routines::ca md too weak
证书链中某张证书使用了 SHA-1 签名,OpenSSL 3.x 默认拒绝。必须向 CA 索要 SHA-256 证书链,无法通过客户端配置“绕过”来解决生产问题。

6. NET::ERR_CERT_DATE_INVALID
证书过期或服务器系统时钟漂移。分别检查:

date -u
openssl x509 -in fullchain.crt -noout -dates

7. 浏览器控制台 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure element 'http://...'
页面里硬编码了 http 资源。改相对协议或全站 https,并加 Content-Security-Policy: upgrade-insecure-requests 作为兜底。

八、效果验证与自动续期:让证书不再“到期事故”

部署完成不等于成功,必须从外部验证。下面四条命令覆盖 90% 的验收场景:

# 1) 证书主体、签发者、有效期、SAN
openssl s_client -connect example.com:443 -servername example.com </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 </dev/null 2>/dev/null | head -20

# 3) HTTP 是否 301 到 HTTPS
curl -sI http://example.com | grep -i '^location'

# 4) 实际协商的协议版本与套件
nmap --script ssl-enum-ciphers -p 443 example.com

期望结果:协议列表只出现 TLSv1.2 与 TLSv1.3;证书链完整;Verify return code 为 0;HTTP 请求返回 301 Moved Permanently 且 Location 指向 https。再配合 SSL Labs 跑一次完整评级,目标 A 及以上。

自动续期是这套流程里最容易欠债的部分。Let’s Encrypt 用 certbot,申请时就把重载钩子挂上:

certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com 
  --deploy-hook 'systemctl reload nginx'
certbot renew --dry-run
systemctl list-timers | grep certbot

--dry-run 必须返回成功,否则说明 90 天后的自动续期会失败。certbot 安装包自带 systemd timer,默认每天运行两次,无需再写 crontab。

商业证书没有 ACME 自动续期,用监控脚本兜底,检查剩余有效期是否少于 30 天:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -checkend 2592000 && echo 'OK' || echo 'ALERT: 证书将在 30 天内过期'

-checkend 2592000 返回 0 表示剩余有效期超过 30 天。把这个命令接入 Zabbix/Prometheus blackbox_exporter 的自定义探针,比任何人工排班表都可靠。

常见问题

一张通配符证书能同时覆盖 example.com 和 a.b.example.com 吗?

不能。通配符 *.example.com 只匹配一级子域名,且不包含裸域 example.com。要同时覆盖裸域和一级子域名,需在 SAN 中同时写入 example.com 与 *.example.com;二级子域名 a.b.example.com 必须单独列出。

证书装好了,浏览器仍提示“不安全”是什么原因?

按顺序排查四件事:一是页面里混入了 http 资源导致 Mixed Content;二是证书链不完整,openssl s_client -showcerts 只看到一张证书;三是访问的域名不在 SAN 列表中(常见于漏配 www);四是服务器时间与证书有效期不匹配。用开发者工具 Security 面板可以直接看到是哪一类问题。

Let’s Encrypt 免费证书和付费 DV 证书有安全差异吗?

加密强度没有差异,都是 2048 位 RSA 或 P-256 ECDSA,都能触发浏览器锁标识。差别在于:Let’s Encrypt 有效期 90 天、依赖自动续期、无人工客服与商业赔付条款;付费 DV 有效期最长 398 天、通常附带保险与技术支持。技术选型看的是自动化能力,不是价格。

换服务器或换 IP 地址需要重新签发证书吗?

不需要。证书绑定的是域名和公钥,与 IP 无关。只要把私钥和 fullchain 一起迁移到新服务器并配置相同域名即可。但要注意:私钥迁移过程必须走加密通道,迁移完成后确认旧服务器已下线,避免同一私钥在多处泄露。

证书有效期现在是多久,为什么和以前说的“一年”不一样?

公有 CA 签发的 TLS 服务器证书自 2020-09-01 起上限为 398 天,已不再是 365+ 的“一年期”。CA/B Forum 的 SC-081 已确定继续压缩:2026 年 3 月起 200 天,2027 年 3 月起 100 天,2029 年 3 月起 47 天。Let’s Encrypt 固定 90 天。因此“每年手工换一次证书”的运维方式必须改为自动续期。

私钥文件泄露了怎么办?

立即向 CA 申请吊销(revoke)该证书并重新签发新密钥对,不要试图复用旧私钥。同时检查是否已部署 OCSP Stapling 或 CRL,让客户端能及时感知吊销状态;并在证书透明度日志(crt.sh)中确认旧证书已标记为 revoked。吊销后到浏览器缓存失效之间存在窗口期,敏感业务应同时轮换相关 API 凭据。

内容审核

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