HTTPS 配置与 SSL 证书部署全流程:申请、安装、配置、排错与验证
本文面向需要把网站、API 或 VPN 服务从 HTTP 切换到 HTTPS 的运维与开发人员,覆盖从 CSR 生成、证书申请、Nginx/Apache/IIS 三端配置,到真实报错排查与上线验证的完整链路。文中所有命令均可直接执行。
问题背景与根因:HTTPS 故障九成不在证书本身
绝大多数 HTTPS 故障并不是“证书买错了”,而是部署环节的三类问题:证书链不完整、私钥与证书不匹配、协议与配置不兼容。浏览器给出的提示往往具有误导性,例如 Chrome 显示 NET::ERR_CERT_AUTHORITY_INVALID,很多人第一反应是“证书是假的”,实际上大多数情况是服务器只下发了叶证书(leaf certificate),没有把中间证书(intermediate CA)一起下发。桌面浏览器有 AIA 补全机制,可能“看起来正常”,但 Android、微信内置浏览器、Java 客户端、curl、Python requests 会直接握手失败。
第二类根因是时间与域名。TLS 校验包含 notBefore/notAfter 和 SAN 列表:服务器时间偏差越过证书有效期边界、或证书只签了 example.com 而用户访问 www.example.com,都会触发 SSL_ERROR_BAD_CERT_DOMAIN。第三类是协议层:主流浏览器已彻底移除 TLS 1.0/1.1 支持,仍只开 TLS 1.0 的老服务器会直接握手失败;SHA-1 签名证书也已被全面 distrust,必须换成 SHA-256 及以上。
还有一个必须修正的过时认知:公有 CA 签发的证书最长有效期已被 CA/Browser Forum 限制为 398 天(2020 年 9 月起生效),Let’s Encrypt 免费证书固定 90 天。后续收紧方案已落地:2026 年 3 月起降至 200 天,2027 年 3 月起 100 天,2029 年 3 月起 47 天。这意味着“一年一续、人工换证书”的运维模式必然失效,自动化续期不再是可选项。
动手前先用一条命令看清服务器到底发了什么:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "^ *[si]:"
输出中若只出现一个 s:(subject)而缺少指向中间 CA 的 i:(issuer)记录,基本可判定为证书链不完整。下面按“准备 → 申请 → 配置 → 选型 → 排错 → 验证”的顺序展开。
前置准备:域名、时间与 CSR 生成
开工前先确认三件事,任何一项出问题都会让后面的步骤全部白做。第一,域名解析必须已生效,且 A/AAAA 记录指向即将部署的服务器;第二,80 与 443 端口对公网可达(HTTP-01 验证需要 80,DNS-01 不需要);第三,服务器时间必须准确,NTP 偏差超过几分钟就可能导致 ACME 验证失败或证书被判为“尚未生效”。
date -u
timedatectl set-ntp true
dig +short example.com A
ss -lntp | grep -E ':80|:443'
接着生成私钥与 CSR。推荐 2048 位 RSA(兼容性最好)或 P-256 ECDSA(性能更好、握手更快):
openssl version
openssl req -new -newkey rsa:2048 -sha256 -nodes -keyout example.com.key -out example.com.csr -subj "/C=CN/ST=Shanghai/L=Shanghai/O=Example Co Ltd/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
chmod 600 example.com.key
若使用 ECDSA:
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr -subj "/C=CN/ST=Shanghai/O=Example Co Ltd/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
注意 -addext 需要 OpenSSL 1.1.1 及以上版本;1.0.2 环境需改用 -config 配合 [req_ext] 段声明 SAN。生成后必须校验 CSR 是否真的带上了 SAN,因为现代浏览器已完全忽略 CN 字段,只认 SAN:
openssl req -in example.com.csr -noout -verify
openssl req -in example.com.csr -noout -text | grep -A2 "Subject Alternative Name"
安全边界要划清楚:.key 私钥绝不外传,权限 600、属主为运行 Web 服务的账号;.csr 只含公钥和主体信息,可以安全提交给 CA。生产环境建议为每台服务器、每个域名单独生成密钥,避免一份私钥到处复制导致泄露后无法定位影响面。
证书申请:ACME 自动签发与商业 CA 流程
免费路线首选 ACME 协议,Let’s Encrypt、ZeroSSL、Google Trust Services 都兼容。以 acme.sh 为例,它不依赖 root、支持 DNS API、自动安装 cron 续期:
curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com -w /var/www/html --keylength ec-256
~/.acme.sh/acme.sh --install-cert -d example.com --ecc --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem --reloadcmd "nginx -s reload"
Certbot 路线同样成熟,适合已经用包管理器统一运维的环境:
apt install -y certbot
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --deploy-hook "systemctl reload nginx"
需要泛域名 *.example.com 时,只能用 DNS-01 验证,必须配置 DNS 服务商的 API 凭据:
export Ali_Key="your-key"
export Ali_Secret="your-secret"
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d "*.example.com"
商业 CA 路线则是把上一步的 CSR 提交给 CA,走 DV(域名验证)、OV(组织验证)、EV(扩展验证)流程,签发后你会拿到两个文件:服务器证书 example.com.crt 和中间证书 intermediate.crt(有时叫 ca-bundle)。必须自行拼接成链文件,顺序是“叶证书在前、中间证书在后”:
cat example.com.crt intermediate.crt > example.com.fullchain.pem
openssl crl2pkcs7 -nocrl -certfile example.com.fullchain.pem | openssl pkcs7 -print_certs -noout
签发前建议先检查 CAA 记录,如果域名的 CAA 里没有对应 CA,签发会被直接拒绝:dig CAA example.com +short。另外,根证书不要拼进 fullchain,多余的自签根会让部分客户端报“无法验证证书链”。
配置示例:Nginx、Apache、IIS 三套可直接落地的配置
Nginx 是当前最主流的部署方式,关键点是 ssl_certificate 必须指向 fullchain 而非单张叶证书,同时开启 OCSP Stapling 与 HSTS:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on;
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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384: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;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
location / { root /var/www/html; index index.html; }
}
注意 http2 on; 需要 Nginx 1.25.1 及以上;旧版本请改用 listen 443 ssl http2;,两种写法不能同时出现,否则会报 duplicate listen options。
Apache 的关键差异是:2.4.8 及以上版本可直接把链写进 SSLCertificateFile,不再需要 SSLCertificateChainFile(该指令在 2.4.8 起被废弃):
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
DocumentRoot /var/www/html
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
SSLSessionTickets off
Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
</VirtualHost>
IIS 只接受 PFX/P12 格式,先在 Linux 侧打包,再导入 Windows 证书存储。需要说明的是,原文提到的 IIS 6.0–8.0 已随 Windows Server 2003/2008 停止支持,生产环境应使用 IIS 8.5(Server 2012 R2)及以上或 IIS 10:
openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in example.com.fullchain.pem -passout pass:ChangeMe123
Import-PfxCertificate -FilePath C:sslexample.com.pfx -CertStoreLocation Cert:LocalMachineMy -Password (ConvertTo-SecureString -String "ChangeMe123" -AsPlainText -Force)
New-WebBinding -Name "Default Web Site" -Protocol https -Port 443 -HostHeader example.com -SslFlags 1
netsh http show sslcert hostnameport=example.com:443
-SslFlags 1 表示启用 SNI,同一 IP 上绑定多个证书时必须开启,否则只能有一个站点使用 443。
对比表格:证书类型、有效期与部署方式选型
选型时最常被问的三个问题:买 DV 还是 OV/EV、一次能买多久、不同服务器配置差在哪。下面三张表可直接对照决策。
| 验证等级 | 验证内容 | 典型签发时长 | 浏览器展示 | 适用场景 |
|---|---|---|---|---|
| DV 域名验证 | 仅验证域名控制权(HTTP-01 / DNS-01) | 1–10 分钟 | 锁标志,无主体信息 | 博客、API、内部系统、CDN 回源 |
| OV 组织验证 | 核验工商登记信息 + 域名归属 | 1–3 个工作日 | 锁标志,点开可见组织名 | 企业官网、SaaS 门户、B 端系统 |
| EV 扩展验证 | 人工法务核验 + 电话回访 | 3–7 个工作日 | 锁标志(绿色地址栏已被主流浏览器取消) | 金融、支付、强合规场景 |
| 证书来源 | 单次有效期 | 续期方式 | 备注 |
|---|---|---|---|
| 公有 CA(DV/OV/EV) | 最长 398 天 | 手动或 ACME | 2026-03 起 200 天,2027-03 起 100 天,2029-03 起 47 天 |
| Let’s Encrypt | 90 天 | ACME 自动 | 建议 30 天前开始重试,支持 –dry-run 演练 |
| 自签名证书 | 自定义 | 手动 | 仅限内网/测试,公有客户端一律不信任 |
| 配置项 | Nginx | Apache | IIS |
|---|---|---|---|
| 证书文件格式 | PEM,fullchain 与 key 分开 | PEM,可合并 | PFX / P12 |
| 链证书位置 | ssl_certificate 指向 fullchain | SSLCertificateFile(2.4.8+) | PFX 内已包含 |
| 协议开关 | ssl_protocols | SSLProtocol | Schannel 注册表 / IIS 面板 |
| 热加载 | nginx -t && nginx -s reload | apachectl configtest && apachectl graceful | 重启站点或 netsh http update |
| SNI 支持 | 默认支持 | 2.2.12+ 默认支持 | 绑定需勾选 SNI(SslFlags 1) |
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
一句话结论:面向公网的中小站点用 DV + ACME 自动续期即可,加密强度与付费证书完全一致;需要向用户展示企业主体、或采购流程要求合同与赔付条款的,再考虑 OV/EV。EV 证书已不再带来绿色地址栏,不要为“视觉差异”付溢价。
常见错误排查:8 个真实报错与修复方法
1. nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
私钥与证书不配对,通常是续期后只换了证书没换私钥。用模数比对确认:openssl x509 -noout -modulus -in example.com.fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5 的结果必须一致。
2. curl: (60) SSL certificate problem: unable to get local issuer certificate,浏览器 NET::ERR_CERT_AUTHORITY_INVALID
证书链不完整。解决:拼接 fullchain 并让 Nginx 的 ssl_certificate 指向它;Apache 确认 SSLCertificateFile 指向含链的 PEM。
3. NET::ERR_CERT_COMMON_NAME_INVALID / no alternative certificate subject name matches target host name
SAN 里没有当前访问的域名(常见于漏签 www 或子域)。只能重新签发,无法通过配置补救。
4. nginx: [warn] “ssl_stapling” ignored, issuer certificate not found 或 Apache AH02217: ssl_stapling_init_cert: can’t retrieve issuer certificate!
开启了 OCSP Stapling 但没指定 ssl_trusted_certificate,或该文件缺中间证书。补上完整链文件即可,注意它与 ssl_certificate 是两个独立指令。
5. nginx: [emerg] bind() to 0.0.0.0:443 failed (98: Address already in use)
443 被占用,多为旧进程未退或 httpd 与 nginx 同时监听。执行 ss -lntp | grep :443 定位 PID 后 kill -9 或调整配置。
6. curl: (60) SSL certificate problem: certificate has expired,但后台显示证书尚未到期
先查服务器时间 date -u,再看实际下发的证书日期 openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates。常见于只 reload 未成功、或前置 CDN 仍是旧证书。
7. 浏览器控制台 Mixed Content: The page at ‘https://…’ was loaded over HTTPS, but requested an insecure resource ‘http://…’
页面内引用了 http 资源。全站替换为 https 或协议相对路径,并加 Content-Security-Policy: upgrade-insecure-requests 兜底。
8. SSL_ERROR_NO_CYPHER_OVERLAP
客户端与服务端的协议/套件无交集,典型是只保留 TLS 1.2+ 而客户端仍是老旧 Java 6 或 WinXP。若业务必须兼容,需单独降级策略;否则升级客户端。
效果验证:命令行验证、评分工具与到期监控
配置改完不要只看浏览器。第一步用 openssl s_client 做严格校验,-verify_return_error 会在链验证失败时直接报错而不是静默通过:
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
第二步验证跳转与协议版本:
curl -sI http://example.com | grep -i location
curl -sSI https://example.com | head -n 5
openssl s_client -connect example.com:443 -tls1_1 </dev/null 2>&1 | grep -iE "handshake failure|alert|no protocols"
第三条命令必须失败(输出 alert 或 handshake failure),说明 TLS 1.1 已被正确禁用。第三步跑评分工具做全面体检:
git clone --depth 1 https://github.com/drwetter/testssl.sh.git
./testssl.sh/testssl.sh --fast https://example.com
重点看三项:证书链是否完整(Chain of Trust 全绿)、是否支持 TLS 1.3、是否启用了 HSTS 与 OCSP Stapling。线上环境还可以用 SSL Labs 做外部视角复核,注意评分受 CDN 与 WAF 影响。
第四步,也是长期最重要的一步:到期监控。证书有效期正在持续缩短,任何人工日历提醒都不可靠,务必落地自动续期 + 到期告警双保险。一个可直接放进 crontab 的检查脚本:
#!/bin/bash
END=$(openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ "$DAYS" -lt 15 ] && echo "WARN: certificate expires in $DAYS days"
最后做一次续期演练,确认自动化链路真的能跑通而不是等 90 天后才发现权限不对:certbot renew --dry-run,或 ~/.acme.sh/acme.sh --cron --home ~/.acme.sh。演练通过后再执行 nginx -t && nginx -s reload 完成零停机切换。
常见问题
公有 CA 签发的证书最长 398 天(2020 年 9 月起 CA/Browser Forum 规定),Let’s Encrypt 固定 90 天。后续将继续缩短:2026 年 3 月起 200 天,2027 年 3 月起 100 天,2029 年 3 月起 47 天,因此必须实现自动续期。
没有差别,两者使用相同的 TLS 协议与加密算法,浏览器信任等级也一致。差异在于验证等级(DV 不核验企业身份)、有效期长短、赔付保障、技术支持,以及是否支持泛域名和多域名 SAN。需要展示企业主体时再选 OV/EV。
按顺序查四项:证书链是否完整(用 openssl s_client 看是否返回两张以上证书)、SAN 是否包含当前访问域名、服务器时间是否准确、页面是否混用 http 资源。九成以上是证书链不全或混合内容导致,改配置即可修复。
把服务器证书与中间证书按“叶证书在前、中间证书在后”拼接:cat example.com.crt intermediate.crt > fullchain.pem,Nginx 的 ssl_certificate 指向该文件,Apache 2.4.8+ 直接写进 SSLCertificateFile。根证书不要拼接,多余的根证书会导致部分客户端验证失败。
泛域名 *.example.com 覆盖同一主域下所有二级子域,但不含 example.com 本身,也不覆盖 a.b.example.com 这类多级子域,需要额外加 SAN。域名跨主域或数量固定时用多域名 SAN 证书;子域数量多且动态变化时优先泛域名配合 DNS-01 自动续期。
新证书与私钥就位后先执行 nginx -t 或 apachectl configtest 校验语法,再执行 nginx -s reload 或 apachectl graceful 热加载,已有连接不会中断。acme.sh 用 –reloadcmd、certbot 用 –deploy-hook 把 reload 自动化。IIS 需更新绑定或重启站点。