跳到主要内容
ssl证书按装

SSL证书服务实战指南:选型、ACME签发、Nginx/Apache部署与排错

SSL证书服务实战指南:选型、ACME签发、Nginx/Apache部署与排错 — SSL证书服务实战指南:选型、ACME签发、Nginx/Apache部署与排错

问题背景与根因:HTTP 明文与证书链失效

HTTP 以明文传输,链路中任一代理、Wi-Fi 或 DNS 劫持点都可能窃取 Cookie、表单和接口令牌。HTTPS 通过 TLS 握手在客户端与服务器之间建立加密通道,SSL 证书解决的是“身份可信 + 密钥协商 + 完整性校验”三件事。生产环境常见故障并非“没买证书”,而是证书过期、SAN 不匹配、中间证书缺失、私钥与证书不配对、协议过旧。公开信任 TLS 证书最长有效期已缩短为 398 天,Let’s Encrypt 为 90 天,因此自动续期是必选项。先做一次线上探测:

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

输出中重点看 Verify return code 是否为 0、证书链是否包含中间 CA、Subject Alternative Name 是否覆盖实际访问域名。若浏览器报 NET::ERR_CERT_DATE_INVALID、SSL_ERROR_BAD_CERT_DOMAIN,分别指向过期和名称不匹配;若 curl 报 unable to get local issuer certificate,多半是未部署 fullchain 完整链。

证书类型与关键事实:DV/OV/EV、RSA/ECC/SM2

DV 只验证域名控制权,签发快,适合测试、API、内部工具;OV 验证组织真实身份,证书主题含 O、C 等信息,适合企业官网和对外业务;EV 执行更严格的组织扩展验证,但现代 Chrome、Edge、Firefox 已不再在地址栏展示 EV 公司名,只在证书详情或部分平台可见组织信息,采购时不要承诺“地址栏显示公司名”。加密算法方面,RSA 兼容性最好,ECC 握手更快、证书更小,SM2 属于国密体系,需要国密 CA、国密浏览器或网关配合,国际主流浏览器信任有限。产品能力上可支持通配符、多域名和公网 IP SAN,多域名产品常见上限为 100 个域名,但通配符 *.example.com 只匹配一级子域,不匹配 a.b.example.com。公网 IP 证书必须由明确支持 IP SAN 的 CA 签发,Let’s Encrypt 对 IP 证书的支持以其官方公告为准,生产环境优先使用域名。关键合规事实:自 2020-09-01 起公开信任 TLS 证书最长有效期 398 天,Let’s Encrypt 90 天,建议在剩余 30 天前完成续期并演练回滚。

完整实操一:生成私钥、CSR 与 SAN 扩展

CSR 只包含公钥和主题信息,私钥绝不能上传给任何服务商。以下命令在 Linux/macOS 可直接执行,OpenSSL 需 1.1.1 及以上以支持 -addext:

openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
chmod 600 example.com.key
openssl req -new -key example.com.key -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co., Ltd./CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com,IP:203.0.113.10'
openssl req -in example.com.csr -noout -text

通配符证书把 SAN 写成 DNS:*.example.com,DNS:example.com;多域名把多个 DNS 项用逗号分隔。ECC 私钥可用 openssl ecparam -genkey -name prime256v1 -out example.com.key 生成,再执行同一条 req 命令。提交 CA 前用最后一条命令核对 Subject、SAN 和公钥算法,避免签发后才发现漏域名。若 CA 要求上传 CSR,只传 .csr;若要求 DNS 验证,按 CA 给出的 TXT 记录名和值配置,等待 TTL 生效后再点验证。签发完成后会得到站点证书、中间证书和 fullchain,Nginx 应使用 fullchain.pem,Apache 2.4.8+ 也将 fullchain 放入 SSLCertificateFile。

完整实操二:ACME 自动签发与续期

以 Let’s Encrypt 为例,Ubuntu/Debian 安装 certbot 与 Nginx 插件,RHEL 系使用 dnf。Webroot 模式要求 80 端口可访问,且站点根目录存在 .well-known/acme-challenge 路径:

sudo apt update && sudo apt install -y certbot python3-certbot-nginx
sudo certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --email admin@example.com --agree-tos --no-eff-email --deploy-hook 'systemctl reload nginx'
sudo certbot certificates
sudo certbot renew --dry-run

签发后证书位于 /etc/letsencrypt/live/example.com/,其中 cert.pem 是站点证书,chain.pem 是中间链,fullchain.pem 是站点证书加中间链,privkey.pem 是私钥。certbot 会安装 systemd timer 或 cron 自动续期,可用 systemctl list-timers | grep certbot 检查。续期后必须重载 Web 服务,–deploy-hook 就是为此设置;不要只续期不重载。若使用 DNS-01 通配符,需配置对应 DNS 插件,并注意 TXT 记录传播时间。生产上建议保留最近一次可用证书备份,续期失败时先回滚配置再排查。

配置示例:Nginx 与 Apache 启用 TLS

Nginx 推荐 80 跳转 443,只启用 TLSv1.2/TLSv1.3,并部署 fullchain。示例中 ssl_trusted_certificate 用于 OCSP stapling:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    server_name example.com www.example.com;
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_stapling on;
    ssl_stapling_verify on;
    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    root /var/www/html;
    location / { try_files $uri $uri/ =404; }
}

Apache 2.4 示例:

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    Header always set Strict-Transport-Security 'max-age=31536000; includeSubDomains'
</VirtualHost>

修改后先执行 nginx -t && systemctl reload nginx 或 apachectl configtest && systemctl reload apache2。HSTS 首次上线建议先用较短 max-age 灰度,确认全站 HTTPS 和子域可用后再加 includeSubDomains,避免把自己锁死。

对比表格:证书类型、有效期与适用场景

类型 验证内容 签发周期 有效期 适用场景 注意事项
DV 域名控制权 分钟级 398 天内 测试、API、内部工具 不展示组织信息
OV 组织+域名 1-5 工作日 398 天内 企业官网、对外业务 证书含 O/C 信息
EV 扩展组织验证 3-7 工作日 398 天内 金融、品牌站 主流浏览器地址栏不展示公司名
Let’s Encrypt 域名控制权 分钟级 90 天 自动化站点 必须自动续期
SM2 国密 CA 体系 依 CA 依 CA 政企国密改造 需国密浏览器/网关

选型时先看信任链和自动化能力,再看品牌。多域名最多 100 个、通配符只覆盖一级、公网 IP 需 IP SAN,这些限制要在下单前写进采购清单。RSA 2048 位仍是兼容基线,ECC P-256 适合移动端和 API 网关,SM2 仅在有国密合规要求时启用双证书体系。

常见错误排查:真实报错与定位命令

  • 浏览器 NET::ERR_CERT_DATE_INVALID 或 curl: (60) SSL certificate problem: certificate has expired:检查系统时间和证书到期日,执行 openssl x509 -in fullchain.pem -noout -dates。
  • curl: (60) SSL: no alternative certificate subject name matches target host name ‘www.example.com’:SAN 漏域名,执行 openssl x509 -in fullchain.pem -noout -ext subjectAltName,重新签发并覆盖 www 与裸域。
  • curl: (60) SSL certificate problem: unable to get local issuer certificate:未部署中间链,Nginx 改用 fullchain.pem,Apache 的 SSLCertificateFile 也指向 fullchain.pem。
  • Nginx 报 [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥与证书不匹配,核对 ssl_certificate 和 ssl_certificate_key 是否来自同一次签发。
  • certbot 报 Problem binding to port 80: Could not bind to IPv4 or IPv6:80 被占用,执行 ss -lntp | grep ‘:80’ 找到进程,或改用 DNS-01 验证。

排查顺序建议:先看证书到期时间和 SAN,再看链是否完整,最后看私钥匹配与协议版本。不要用关闭证书校验的方式“解决”问题,那只是掩盖风险。

效果验证:从命令行到浏览器

部署后不要只看浏览器小锁。执行以下命令验证证书主题、签发者、有效期、SAN 和 TLS 版本:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
curl -I https://example.com
curl --tlsv1.2 -I https://example.com
curl -sI https://example.com | grep -i strict-transport-security
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt /etc/letsencrypt/live/example.com/fullchain.pem

期望结果是 Verify return code: 0、证书未过期、SAN 覆盖实际域名、HTTP 返回 200/301 且无证书告警、HSTS 头存在。再用浏览器开发者工具 Security 面板确认协议为 TLS 1.2/1.3、连接安全。对外站点可再用 SSL Labs 做一次评级,重点看证书链、协议支持和密钥交换。最后把 certbot renew –dry-run 加入发布前检查,确保 90 天或 398 天到期前自动续期链路真实可用。

常见问题

公开信任 TLS 证书最长 398 天,Let’s Encrypt 为 90 天。建议剩余 30 天前自动续期,并用 certbot renew –dry-run 验证续期和重载钩子是否生效。


*.example.com 只匹配一级子域,如 www.example.com,不匹配 a.b.example.com。需要多级子域时,应单独添加 SAN 或分别签发证书。


现代 Chrome、Edge、Firefox 已取消 EV 地址栏公司名展示,只在证书详情或部分平台可见组织信息。采购时不要以地址栏显示公司名作为承诺。


Nginx 和 Apache 2.4.8+ 都应部署 fullchain.pem,即站点证书加中间证书;根证书通常不需部署。用 openssl s_client -showcerts 检查链是否完整。


可以,但必须由明确支持 IP SAN 的 CA 签发,且部分 ACME 客户端和 CA 有限制。生产环境优先用域名,IP 证书仅用于无法使用域名的设备或网关。

内容审核

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