全站 HTTPS 实战:SSL 证书申请、安装配置与故障排查完整指南
一、为什么证书装了还是报错:问题背景与根因
很多站点把 443 端口打开、证书文件往里一放,就以为“全站 HTTPS”完成了,结果浏览器仍然弹出“您的连接不是私密连接”,或者只有 PC 正常,Android App 和 Java 客户端全部握手失败。这类问题几乎都不是“证书没买对”,而是部署环节的细节错了。
最常见的六类根因:
- 证书链不完整:只部署了服务器证书,没带中间证书(Intermediate CA)。桌面 Chrome 会自动补链所以看着正常,而 Android 7 以下、Java、Go、微信小程序等严格校验证书链的客户端直接报错。
- 域名不匹配:证书只签了
example.com,用户访问www.example.com就报NET::ERR_CERT_COMMON_NAME_INVALID。SAN(Subject Alternative Name)字段必须覆盖所有要用的域名。 - 私钥与证书不匹配:多次申请后把旧私钥和新证书配在一起,Nginx 直接启动失败。
- 证书过期:公有 CA 签发的 TLS 证书最长有效期已被限制为 398 天(2020 年 9 月起生效),Let’s Encrypt 免费证书更是只有 90 天,靠手工续期必然出事。
- 协议与加密套件过旧:仍开启 TLS 1.0/1.1,或套件只留 RSA 密钥交换,现代浏览器拒绝握手。
- 混合内容:页面本身是 HTTPS,但里面还引用了
http://的图片、JS、CSS,浏览器地址栏仍显示“不安全”。
动手前先用两条命令确认现状,别猜:
# 查看服务端实际下发的证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 查看证书链是否完整(返回 0 且 verify OK 才算合格)
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
如果第二条命令出现 verify error:num=21:unable to verify the first certificate,基本可以确定是缺中间证书。
二、申请前的准备:私钥、CSR 与域名验证方式
CSR(Certificate Signing Request,证书签名请求)是向 CA 申请证书时提交的文件,它由私钥推导而来,包含公钥和主体信息。正确的顺序是:先生成私钥,再生成 CSR,最后提交 CA。私钥必须在自己的服务器上生成,任何情况下都不要把私钥发给第三方。
# 1. 生成 2048 位 RSA 私钥(ECDSA P-256 更轻量,兼容性略差)
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
# 2. 生成 CSR,并把 www 一起写进 SAN(OpenSSL 1.1.1+ 支持 -addext)
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# 3. 核对 CSR 里的 SAN 是否正确
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
注意 CN 字段在现代浏览器里已经不再作为域名匹配依据,真正生效的是 SAN,务必把裸域名和 www 都写进去;通配符证书 *.example.com 不覆盖 example.com 本身,需要额外添加。
域名验证(DCV)有四种方式:
- HTTP-01:CA 访问
http://example.com/.well-known/acme-challenge/xxx校验文件,必须 80 端口可访问且不被跳转拦截。 - DNS-01:添加一条 TXT 记录,是唯一支持通配符证书的方式,也可用于内网或无公网 80 端口的场景。
- 文件验证:商业证书常用,把指定文件放到网站根目录。
- 邮箱验证:向 whois 或 admin@ 邮箱发确认邮件,OV/EV 证书还需人工审核企业资质。
签发下来后,先用一条命令确认私钥和证书是一对(两个 MD5 必须一致):
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
三、SSL 证书申请实操:acme.sh、certbot 与商业证书
免费证书推荐 acme.sh,纯 Shell 实现,支持 80 多种 DNS 服务商 API,能自动续期并自动重载 Nginx。
# 安装(会写入 crontab 做每日检查)
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
# 方式 A:webroot 验证,签发多域名证书
acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html
# 方式 B:DNS API 验证,签发通配符证书(以阿里云 DNS 为例)
export Ali_Key="LTAI5t******"
export Ali_Secret="******"
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
# 安装证书到指定路径,并在续期成功后自动 reload
acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
注意这里用的是 --fullchain-file 而不是 --cert-file,前者包含中间证书,这是避免“链不完整”的关键。Let’s Encrypt 证书有效期为 90 天,acme.sh 默认在到期前 30 天自动续期,用 acme.sh --list 可以查看下次续期时间。
用 certbot 的话:
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
--agree-tos -m admin@example.com --no-eff-email
# 演练续期,确认 cron 里跑得通
certbot renew --dry-run
购买商业证书(OV/EV)的流程略有不同:提交上一步生成的 CSR,CA 做域名验证加组织审核(OV 通常 1–3 个工作日),然后下载证书压缩包。压缩包里通常有四个文件,对应关系必须搞清:
example.com.crt(服务器证书)→ 配到ssl_certificate或SSLCertificateFileca-bundle.crt/chain.crt(中间证书)→ Nginx 需要拼接到服务器证书后面,Apache 用SSLCertificateChainFileexample.com.key(私钥)→ssl_certificate_keyexample.com.pfx(仅 IIS/Tomcat 用)→ 导入时需输入导出密码
拼接命令:cat example.com.crt ca-bundle.crt > example.com.fullchain.pem,顺序不能反,否则部分客户端会解析失败。
四、Nginx、Apache、IIS 安装配置示例
Nginx(1.25+ 推荐用 listen 443 ssl; 加 http2 on;,旧版本写 listen 443 ssl http2;):
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-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;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com.chain.pem;
add_header Strict-Transport-Security "max-age=31536000" always;
}
Apache 2.4:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/ca-bundle.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
</VirtualHost>
Apache 2.4.8 之后可以把服务器证书和中间证书拼在一个文件里,直接写进 SSLCertificateFile,SSLCertificateChainFile 已标记废弃。
Windows IIS:开始菜单运行 mmc → 添加“证书”管理单元 → 计算机账户 → 个人 → 导入 .pfx;中间证书导入到“中间证书颁发机构”;IIS 管理器 → 站点 → 绑定 → 添加 https,端口 443,勾选 SNI,选择证书。若使用通配符证书,多站点共用同一证书时必须勾选 SNI,否则后绑定的站点会覆盖前面的证书。
改完配置先做语法检查再重载,避免把线上打挂:
nginx -t && nginx -s reload
apachectl configtest && systemctl reload httpd
五、全站 HTTPS 强制跳转与 HSTS 配置
证书装好只是第一步,还要保证所有 HTTP 请求都被 301 到 HTTPS,并且页面内不再出现 http 资源。Nginx 里单独加一个 80 端口的 server 块,比在业务 server 里写 if 判断更高效(也避开了 if is evil 的坑):
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
HSTS 告诉浏览器“以后访问这个域名一律用 HTTPS”,可有效抵御 SSL 剥离攻击。但它是单向开关,一旦下发 preload 并被写进浏览器内置列表,回退成本极高。建议分阶段:先 max-age=300 观察一周,再逐步加长到 31536000,最后才考虑 preload。
# 第一阶段:短周期观察
add_header Strict-Transport-Security "max-age=300" always;
# 稳定后:一年 + 子域名
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
混合内容排查是“全站加密”最容易被忽略的一环。用一条命令扫出页面里残留的 http 资源:
curl -s https://example.com | grep -o 'src="http://[^"]*"' | sort -u
常见来源是数据库里存的旧图片地址、富文本编辑器粘贴的外链、以及硬编码的 CDN 域名。批量替换后可临时下发 CSP 强制升级:
add_header Content-Security-Policy "upgrade-insecure-requests" always;
另外别忘了 cookie:给会话 cookie 加上 Secure 和 HttpOnly 属性。PHP 可在 php.ini 中设置 session.cookie_secure = 1,Java 在 web.xml 里加 <cookie-config><secure>true</secure></cookie-config>,否则明文通道下 cookie 仍可能被窃取。
六、证书类型与部署方式对比
选型前先明确两点:证书要覆盖几个域名、客户端是否强制要求组织信息。下表是当前主流方案的横向对比(有效期为公有 CA 上限,实际以 CA 政策为准):
| 类型 | 验证方式 | 典型有效期 | 浏览器地址栏 | 适用场景 |
|---|---|---|---|---|
| DV 单域名 | 域名验证 | 398 天 | 锁标志 | 个人站、测试环境 |
| DV 通配符 | DNS 验证 | 398 天 | 锁标志 | 同一主域下多个子域 |
| OV 企业型 | 域名 + 组织审核 | 398 天 | 锁标志(可查看企业名) | 企业官网、电商 |
| EV 增强型 | 严格组织与法律存在审核 | 398 天 | 锁标志(主流浏览器已不显示绿色地址栏) | 金融、政企 |
| Let’s Encrypt | HTTP-01 / DNS-01 | 90 天(自动续期) | 锁标志 | 中小站点、API、内部服务 |
部署位置同样需要权衡:
| 部署方式 | 证书放在哪 | 优点 | 局限 |
|---|---|---|---|
| 源站 Nginx/Apache | 服务器本地文件 | 成本低、完全可控 | 需自行续期并 reload |
| 云负载均衡 SLB/ALB | 云控制台上传 | 卸载 TLS、支持多证书 SNI | 私钥托管在云上 |
| CDN 边缘节点 | CDN 控制台 | 就近握手、支持 HTTP/3 | 回源段需另配证书或走 HTTP |
| Kubernetes Ingress | Secret(tls 类型) | 与 cert-manager 集成可全自动 | 需维护 Ingress Controller |
一个常见误区:用了 CDN 就以为源站不用证书。如果 CDN 回源协议设为 HTTPS,源站同样需要一张有效证书(可以是自签或 Let’s Encrypt),否则回源握手失败,用户看到 502。反之若回源走 HTTP,则“全站加密”只加密到边缘节点,源站到 CDN 这段仍是明文,合规场景下不可接受。
七、常见错误排查:真实报错与对应解法
下面这些报错都是部署现场高频出现的,按现象对号入座即可。
1. 浏览器:NET::ERR_CERT_COMMON_NAME_INVALID
证书的 SAN 不包含当前访问的域名。用 openssl x509 -noout -text | grep -A1 "Subject Alternative Name" 核对,缺 www 就重新签发,不要指望让用户“忽略警告”。
2. 浏览器:NET::ERR_CERT_AUTHORITY_INVALID / curl:curl: (60) SSL certificate problem: unable to get local issuer certificate
证书链不完整或用了自签名证书。检查 ssl_certificate 指向的是不是 fullchain 文件,再用 openssl s_client -showcerts 数一下返回了几张证书,正常应为 2–3 张。
3. Nginx 启动失败:
nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed
(SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
私钥与证书不匹配。用第二节的 modulus 比对命令确认,重新把配套的 key 和 crt 放到一起,别用上次申请残留的私钥。
4. Nginx 启动失败:PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line)
文件格式不对或内容为空。可能是把 .pfx/.der 直接改了后缀,需要用 openssl pkcs12 -in cert.pfx -nodes -out cert.pem 转换;也可能是 cat 拼接时把私钥混进了证书文件。
5. Apache:AH02565: Certificate and private key example.com:443:0 from ... do not match
同问题 3,这是 Apache 侧的等价报错。
6. 浏览器:ERR_SSL_VERSION_OR_CIPHER_MISMATCH
协议或套件不兼容,也可能是同一 IP 上多站点未启用 SNI 导致下发了错误的默认证书。检查 ssl_protocols 是否误删了 TLSv1.2,以及 443 端口是否配置了 default_server 兜底。
7. Java/Go 客户端:PKIX path building failed / x509: certificate signed by unknown authority
服务端缺中间证书的典型表现,桌面浏览器会自动补链所以不易发现。补齐 fullchain 即可。
8. certificate has expired 或 certificate is not yet valid
前者是忘了续期,后者多半是服务器时间不同步,执行 timedatectl set-ntp true 或 chronyc makestep 校准 NTP。
八、效果验证与到期监控
配置完成后按四层验证,任何一层不通过都不算完工。
第一层:协议与证书链。
# 应输出 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>/dev/null | grep "Verify return code"
# 确认只允许 TLS 1.2/1.3,下面两条应当握手失败
openssl s_client -connect example.com:443 -tls1_1 </dev/null
openssl s_client -connect example.com:443 -tls1 </dev/null
第二层:HTTP 层跳转与响应头。
curl -sI http://example.com | head -n 3 # 期望 301 且 Location 为 https
curl -sI https://example.com | grep -i strict # 期望看到 Strict-Transport-Security
第三层:混合内容。打开 Chrome DevTools → Console,若有 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 提示,说明还有 http 资源未替换。
第四层:第三方评级。用 SSL Labs(https://www.ssllabs.com/ssltest/)跑一次完整测试,目标 A 及以上;重点看 “Certificate Paths” 是否显示 “Chain issues: None”。
最后是监控。证书过期是最低级也最致命的事故,用一条命令就能拿到到期时间,接进 Zabbix/Prometheus 的文本采集:
echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null
| openssl x509 -noout -enddate
# notAfter=Mar 18 12:00:00 2026 GMT
自动续期侧要确认三件事:acme.sh --list 或 systemctl list-timers | grep certbot 能看到续期任务;--reloadcmd 确实生效(可以改一次配置看 Nginx worker 是否重启);续期后证书文件 mtime 是否更新。三者缺一,就可能出现“续期成功了但线上还是旧证书”的经典故障。
常见问题
公有 CA 签发的 TLS 证书单张最长有效期为 398 天(自 2020 年 9 月 1 日起强制执行),Let’s Encrypt 免费证书固定 90 天。因此必须配置自动续期,acme.sh 和 certbot 都能通过 cron 或 systemd timer 自动完成并重载 Web 服务。
不行。缺中间证书时桌面浏览器常会自动补链看似正常,但 Android 旧版本、Java、Go、小程序等严格校验的客户端会直接握手失败,报 unable to get local issuer certificate 或 PKIX path building failed。Nginx 应使用包含中间证书的 fullchain 文件。
*.example.com 只匹配一级子域,如 www.example.com、api.example.com,不匹配裸域 example.com,也不匹配 a.b.example.com。实际部署时通常需要同时申请 example.com 和 *.example.com,或购买多域名证书把两者写进 SAN。
多数是混合内容:页面本身走 HTTPS,但图片、JS、CSS、iframe 仍引用 http:// 地址。用浏览器 DevTools 的 Console 或 curl 抓取页面源码过滤 http:// 即可定位,替换为 https 或相对协议后即可消除警告。
取决于回源协议。若 CDN 回源设置为 HTTPS,源站必须有有效证书(可用 Let’s Encrypt 或自签并在 CDN 侧信任),否则回源握手失败返回 502。若回源走 HTTP,则源站到 CDN 这段是明文,不满足全链路加密要求。
可以取消下发,但已访问过的浏览器会在 max-age 有效期内继续强制 HTTPS,用户无法点击“继续访问”。若已提交 preload 列表,需向浏览器厂商申请移除,周期长达数月。建议先用 max-age=300 小范围验证,稳定后再逐步加长。