跳到主要内容
ssl证书按装

全站 HTTPS 实战:SSL 证书申请、安装配置与故障排查完整指南

全站 HTTPS 实战:SSL 证书申请、安装配置与故障排查完整指南 — 全站 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 或 SSLCertificateFile
  • ca-bundle.crt / chain.crt(中间证书)→ Nginx 需要拼接到服务器证书后面,Apache 用 SSLCertificateChainFile
  • example.com.key(私钥)→ ssl_certificate_key
  • example.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 小范围验证,稳定后再逐步加长。

内容审核

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