跳到主要内容
ssl证书按装

网站 SSL 证书配置与 HTTPS 部署全流程:Nginx/Apache 实操、小程序 HTTPS 与报错排查

网站 SSL 证书配置与 HTTPS 部署全流程:Nginx/Apache 实操、小程序 HTTPS 与报错排查 — 网站 SSL 证书配置与 HTTPS 部署全流程:Nginx/Apache 实操、小程序 HTTPS 与报错排查

一、证书已安装却仍提示不安全:5 个高频根因

最常见的故障不是“证书没装”,而是“装得不完整”。桌面版 Chrome 启用了 AIA 自动补链,中间证书缺失时会自己回源下载;而 Android/iOS 微信 WebView、微信小程序服务端、Java 客户端(OkHttp 默认严格校验)都不会补链,于是出现“电脑上正常、手机上或小程序里报证书错误”的经典现象。

按发生频率排序,根因如下:

  • 证书链不完整:只部署了站点证书(cert.pem),没带中间 CA。Nginx 的 ssl_certificate 必须指向 fullchain.pem。
  • 域名不匹配:证书 SAN 里只有 example.com,用户访问 www.example.com,或反之。
  • 私钥与证书不配对:重复申请、覆盖文件时把旧私钥和新证书凑在一起。
  • 混合内容(Mixed Content):页面本身是 HTTPS,但图片、JS、CSS 仍用 http:// 引用,浏览器判定为“部分不安全”。
  • 443 未放行或 CDN 回源仍是 HTTP:安全组、iptables、云负载均衡监听器漏配,或 CDN 边缘是 HTTPS、回源却是 80 端口。

另外要记住有效期规则:目前公开信任的 TLS 证书最长有效期为 398 天,Let’s Encrypt 免费证书默认 90 天。忘记续期会直接报 NET::ERR_CERT_DATE_INVALID。上线前用下面两条命令快速体检:

openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem

第一条确认 SAN 覆盖了所有对外域名、到期时间还剩多久;第二条若返回 error 20 at 0 depth lookup: unable to get local issuer certificate,说明证书链不完整,问题基本可以锁定在 fullchain 文件上。

二、申请前准备:CSR 生成、域名验证与证书文件命名

无论选 DV 还是 OV,第一步都是在本机生成密钥对和 CSR,不要把私钥交给任何在线工具。OpenSSL 1.1.1 及以上版本可以一次性把主域名和 www 写进 SAN:

mkdir -p /etc/ssl/private/example.com && cd /etc/ssl/private/example.com
openssl req -new -newkey rsa:2048 -sha256 -nodes 
  -keyout example.com.key 
  -out example.com.csr 
  -subj '/C=CN/ST=Beijing/L=Beijing/O=Example Tech Co.,Ltd/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
chmod 600 example.com.key

参数要点:-nodes 让私钥不加密,否则 Nginx reload 时会卡在交互式密码输入;-addext 写 SAN,主域名和 www 缺一不可,少一个就会在访问对应域名时报 ERR_CERT_COMMON_NAME_INVALID。生成后自检:

openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
# 期望输出:DNS:example.com, DNS:www.example.com

域名验证有三种主流方式:DNS-01 在 DNS 服务商添加 TXT 记录(Let’s Encrypt 使用 _acme-challenge.example.com),可签通配符;HTTP-01 在网站根目录放校验文件,要求 80 端口可公网访问;OV/EV 还需提交营业执照并完成电话或邮箱核验。

免费证书用 certbot 一条命令即可:

apt install -y certbot
certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com 
  --email ops@example.com --agree-tos --no-eff-email

成功后证书落在 /etc/letsencrypt/live/example.com/,四个文件分工明确:cert.pem 站点证书、chain.pem 中间证书、fullchain.pem 两者拼接(Nginx/Apache 用这个)、privkey.pem 私钥。通配符必须走 DNS-01:certbot certonly --manual --preferred-challenges dns -d '*.example.com' -d example.com,注意 *.example.com 不覆盖裸域,必须额外加 -d example.com。

三、Nginx 完整配置示例(可直接执行)

先确认版本,1.25.1 之后推荐 listen 443 ssl; 搭配 http2 on;,旧版本则写 listen 443 ssl http2;:

nginx -v

配置文件 /etc/nginx/conf.d/example.com.conf:

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/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    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;
    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/letsencrypt/live/example.com/chain.pem;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;

    root /var/www/html;
    index index.html index.php;

    location ^~ /.well-known/acme-challenge/ {
        root /var/www/html;
    }

    location / {
        try_files $uri $uri/ =404;
    }
}

几个容易踩的点:ssl_certificate 一定写 fullchain.pem,写 cert.pem 在桌面浏览器可能看不出问题,但小程序必然失败;ssl_trusted_certificate 用于 OCSP Stapling 校验,指向 chain.pem,不写会出现 [warn] 'ssl_stapling' ignored, issuer certificate not found for certificate;TLS 1.0/1.1 已被主流浏览器和微信全部弃用,不要再保留。

生效与自检:

nginx -t
systemctl reload nginx
systemctl enable --now certbot.timer
certbot renew --dry-run

如果 Nginx 报 [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),说明私钥和证书不是一对。对 RSA 证书可用 openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5 对比两串 MD5 是否一致。

四、Apache、Tomcat 与虚拟主机面板的配置示例

Apache 2.4.8 及以上版本支持在 SSLCertificateFile 中直接放完整链,所以同样指向 fullchain.pem:

<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.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
    SSLCipherSuite          HIGH:!aNULL:!MD5:!3DES
    Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>

改完执行 apachectl configtest && systemctl reload httpd。若 Apache 版本低于 2.4.8,需要额外用 SSLCertificateChainFile 指定 chain.pem,否则链校验失败。

Tomcat 不接受 PEM 格式的私钥,要先用 OpenSSL 打包成 PKCS12(JKS 已不推荐):

openssl pkcs12 -export 
  -in fullchain.pem -inkey privkey.pem 
  -out /opt/certs/example.p12 
  -name tomcat -passout pass:Changeit2024

然后在 conf/server.xml 里配置 Connector:

<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol'
           SSLEnabled='true' scheme='https' secure='true'>
  <SSLHostConfig>
    <Certificate certificateKeystoreFile='/opt/certs/example.p12'
                 certificateKeystorePassword='Changeit2024'
                 certificateKeystoreType='PKCS12' type='RSA'/>
  </SSLHostConfig>
</Connector>

宝塔、cPanel、WDCP 这类面板更简单:在“SSL”页把 fullchain.pem 的全部内容(从 -----BEGIN CERTIFICATE----- 到最后一个 -----END CERTIFICATE-----,中间证书也要带上)粘进“证书(PEM 格式)”框,privkey.pem 内容粘进“私钥(PEM 格式)”框,保存后开启强制 HTTPS。常见错误是只粘贴了第一段证书,面板不会提示,但链校验失败。

云厂商的 CDN/负载均衡则要把证书上传到证书管理服务,注意“证书链”字段单独填写,且回源协议必须选 HTTPS,否则源站到边缘仍是明文,小程序侧虽然握手成功,但后端日志里仍是 80 端口请求。

五、公众号与小程序 HTTPS 的硬性要求与验证

微信小程序要求所有网络请求走 HTTPS,服务器域名必须是已备案域名、使用 443 端口、不能是 IP 地址、不能带路径。TLS 版本要求 1.2 及以上,证书必须由受信任 CA 签发,自签名和内网 CA 一律不行。公众号网页授权、JS-SDK 签名页面同样要求 HTTPS,否则 wx.config 会直接报 invalid signature。

最常见的小程序报错是 request:fail ssl hand shake error,它几乎总是三个原因之一:证书链不完整、TLS 版本过低、SNI 未正确配置。用下面这条命令模拟小程序的握手过程:

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

关注输出末尾的 Verify return code: 0 (ok) 与 Protocol : TLSv1.2 或 TLSv1.3。如果出现 Verify return code: 21 (unable to verify the first certificate),就是缺中间证书;出现 alert handshake failure,通常是服务端禁用了 TLS 1.2 或加密套件不兼容。

还要检查微信公众平台“开发管理 → 服务器域名”里配置的 request 合法域名,必须是 https://api.example.com 这种形式,末尾不能加斜杠和路径,每月修改次数有限,改前先确认证书稳定。另外小程序不会跟随 301 跳转,如果接口域名做了 80→443 的强制跳转,请确保代码里写的已经是 https 地址,否则会多一次跳转甚至超时。

公众号网页里如果嵌了第三方 iframe 或引用了 http 图片,Chrome 和微信内置浏览器都会拦截并提示“此页面包含不安全内容”,排查时打开开发者工具,Filter 输入 Mixed Content 逐条替换即可。

六、证书类型与部署方式对比表

选型先看验证等级,再看域名覆盖范围。EV 证书自 2019 年起主流浏览器已不再显示绿色地址栏,视觉上的“身份标识”优势消失,除金融、政务有明确合规要求外,OV 已经够用。

证书类型 验证方式 典型签发时长 有效期 参考价格 适用场景
DV 单域名 DNS/HTTP 验证 1-10 分钟 90 天(免费)/398 天 0-200 元 测试环境、个人博客、内部 API
DV 通配符 DNS-01 TXT 10 分钟内 90 天/398 天 0-1500 元 多子域名、SaaS 租户
OV 单域名 企业资质核验 1-3 个工作日 398 天 1000-3000 元 企业官网、电商、支付回调
OV 通配符 企业资质核验 1-3 个工作日 398 天 3000-8000 元 多业务线统一域名
EV 严格人工审核 3-7 个工作日 398 天 3000 元以上 金融、政务有合规要求

部署方式对比:

部署方式 操作复杂度 续期方式 注意事项
Nginx/Apache 直接部署 中 certbot.timer 自动续期 必须用 fullchain.pem
Tomcat / Java 应用 较高 转 PKCS12 后重启 JKS 已不推荐,用 PKCS12
宝塔等面板 低 面板内自动续签 粘贴内容须含中间证书
CDN / 负载均衡卸载 低 云平台自动轮换 回源协议必须选 HTTPS

预算敏感、域名数量多的项目优先选 Let’s Encrypt 通配符 + 自动续期;需要向客户出示企业身份证明、走招投标或支付通道审核的,选 OV。注意通配符只覆盖一级子域,*.example.com 不包含 a.b.example.com,也不包含裸域。

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

1. curl: (60) SSL certificate problem: unable to get local issuer certificate
客户端拿不到中间证书。修复:把 ssl_certificate 改为 fullchain.pem,或在 Apache 中补 SSLCertificateChainFile。

2. NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN
域名不在 SAN 列表内。检查 openssl x509 -in cert.pem -noout -ext subjectAltName,缺 www 就重新签发,不要靠 301 跳转绕过,证书校验发生在跳转之前。

3. 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 cert.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5,两串不一致就重新下载匹配的私钥。

4. curl: (7) Failed to connect to example.com port 443: Connection refused
端口没监听或被拦截。依次检查 ss -lntp | grep 443、firewall-cmd --list-ports、云厂商安全组入方向规则。

5. SSL_ERROR_NO_CYPHER_OVERLAP
客户端与服务端没有共同协议或套件,多见于老版本 Android/IE,或服务端只开了 TLS 1.3。确认 ssl_protocols TLSv1.2 TLSv1.3; 且套件包含 ECDHE-RSA 系列。

6. 控制台 Mixed Content: The page at https://... was loaded over HTTPS, but requested an insecure resource http://...
页面内资源仍走 HTTP。可加 add_header Content-Security-Policy 'upgrade-insecure-requests'; 临时兜底,但根因是把模板里的 http:// 全部替换为 // 或 https://。

7. request:fail ssl hand shake error(微信小程序)
优先查链完整性,其次查域名是否在公众平台白名单、是否备案、TLS 是否 ≥1.2。

排查顺序建议固定为:证书链 → 域名匹配 → 私钥配对 → 端口与防火墙 → 协议套件 → 页面混合内容。按这个顺序走,绝大多数 HTTPS 故障能在十分钟内定位。

八、效果验证:五条命令确认 HTTPS 真正可用

配置完成后不要只看浏览器地址栏的小锁,逐条执行下面五条命令:

# 1. 证书主体、有效期、SAN
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -subject -dates -ext subjectAltName

# 2. 完整握手与链校验
openssl s_client -connect example.com:443 -servername example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null | grep -E 'Verify return code|Protocol'

# 3. HTTP 跳转是否正确
curl -I http://example.com

# 4. 线上实际证书与到期时间
echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null | openssl x509 -noout -enddate

# 5. SSL Labs 评级
curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done' | jq -r '.endpoints[].grade'

期望结果:第 1 条 SAN 覆盖全部对外域名;第 2 条输出 Verify return code: 0 (ok) 与 Protocol : TLSv1.3;第 3 条返回 301 Moved Permanently 且 Location 为 https 地址;第 4 条剩余天数大于 30;第 5 条评级为 A 或 A+。

续期验证同样重要,Let’s Encrypt 证书只有 90 天:

systemctl list-timers | grep certbot
certbot renew --dry-run

如果 --dry-run 失败,多半是 HTTP-01 验证用的 80 端口被 301 重定向到 HTTPS。需要在 Nginx 中为 /.well-known/acme-challenge/ 单独放行,并把这段 location 放在 301 规则之前。最后用手机 4G 网络(不要连公司 Wi-Fi)打开小程序和公众号页面各测一次,因为部分企业网络存在 SSL 中间人代理,会掩盖证书链问题。

常见问题

加密强度没有区别,都是同等级的 TLS 加密。差别在验证等级、有效期、赔付承诺和技术支持。免费 DV 只验证域名控制权,有效期 90 天需自动续期;OV 需核验企业身份,有效期最长 398 天,出问题有责任赔付条款。


只覆盖一级。*.example.com 能匹配 api.example.com、www.example.com,但不匹配 example.com 本身,也不匹配 a.b.example.com。签发时必须把裸域额外加进 SAN,多级子域要么单独签发,要么拆成 *.b.example.com。


桌面 Chrome 支持 AIA 自动补链,缺中间证书时会自行下载;iOS/Android 微信 WebView 和微信小程序服务端不会补链,直接握手失败。把 ssl_certificate 指向 fullchain.pem(站点证书加中间证书)即可解决。


必须。微信小程序要求所有网络请求使用 HTTPS,域名须已完成 ICP 备案,端口固定 443,不能使用 IP 地址,也不能在域名后带路径。TLS 版本需 1.2 及以上,自签名证书不受信任。


可以。Let’s Encrypt 允许在剩余 30 天内续期,certbot renew 只对 30 天内到期的证书生效,重复执行不会浪费配额。建议配置 systemd timer 或 cron 每天执行 certbot renew –quiet,并加重载钩子自动 reload Nginx。


通常 1-3 个工作日。需提交营业执照、完成企业电话核验和域名管理邮箱确认。若企业信息在 CA 数据库中有记录,可能几小时内完成;新注册公司或信息变更时会更久,建议在旧证书到期前 15 天启动申请。

内容审核

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