cPanel 安装 SSL 证书完整教程:CSR 生成、证书上传与 HTTPS 验证(2024)
在 cPanel 安装 SSL 证书的核心动作是:把域名证书、私钥和 CA 中间证书(cabundle)一起粘贴到「SSL/TLS → Install and Manage SSL for your site」,缺中间证书就会报证书链错误。 cPanel & WHM 110+ 的 AutoSSL 默认调用 Let's Encrypt,证书 90 天有效、到期前 30 天自动续签,单域名站点通常无需手动安装。 私钥与证书不匹配时,用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 分别取 MD5 比对,不一致只能重新签发。 命令行批量安装可用 uapi --user=USER SSL install_ssl domain=example.com cert=... key=... cabundle=...,适合多域名迁移。 验证是否生效:openssl s_client -connect example.com:443 -servername example.com 看到 Verify return code: 0 (ok) 即证书链完整。
为什么 cPanel 安装 SSL 证书会失败?先定位三类根本原因
如果你在 cPanel 上传证书后浏览器仍显示“不安全”,或者 AutoSSL 日志里反复出现 DCV failed,先别急着删除重装。按下面三类原因逐一排查,能覆盖绝大多数失败场景;再往前一步,还要先确认你的 cPanel 版本——菜单入口和默认 CA 在不同版本里并不相同。
第一步:确认版本,否则你可能连上传位置都找不到
据 cPanel 官方文档,从 110(LTS)到 118,证书管理已统一收敛到「SSL/TLS → SSL/TLS Status」,AutoSSL 默认使用 Let’s Encrypt 签发,证书有效期 90 天,并在到期前约 30 天自动重签;而 11.9x 时代的入口叫「SSL/TLS Manager」,路径为「SSL/TLS → Manage SSL Sites」,很多教程截图与你的面板对不上,就是因为版本不同。
# 查看 cPanel & WHM 版本(root 执行)
cat /usr/local/cpanel/version
# 示例输出:110.0.48
# 查看 AutoSSL 当前使用的 CA 与状态
/usr/local/cpanel/bin/whmapi1 get_autossl_providers | grep -i -E "name|enabled"
| 对比项 | cPanel & WHM 110 LTS / 118 | 旧版 11.9x |
|---|---|---|
| 证书管理入口 | SSL/TLS → SSL/TLS Status | SSL/TLS → SSL/TLS Manager |
| 上传表单位置 | SSL/TLS Status → 域名 → 上传证书 | Manage SSL Sites → 粘贴 CRT/KEY/BUNDLE |
| AutoSSL 默认 CA | Let’s Encrypt(90 天) | Sectigo/Comodo 为主 |
| DCV 方式 | HTTP-01 为主,支持 DNS-01 | HTTP-01 |
原因一:CA Bundle 留空,只上传了叶子证书
这是出现频率最高的一类。cPanel 的 CA Bundle 字段留空时,Apache 只发送单张叶子证书,客户端无法把签发链补全,curl 会直接报 curl: (60) SSL certificate problem: unable to get local issuer certificate,Java、Android 老版本客户端和部分 API 调用同样会失败。正确做法是把中间证书按「叶子 → 中间」的顺序拼接后粘贴进 CA Bundle(若 CA 提供交叉签名链,则按叶子 → 中间 → 根的顺序,根证书通常不必包含)。
# 拼接顺序:站点证书在前,中间证书在后
cat example.com.crt intermediate.crt > fullchain.crt
# 验证链条是否完整,输出必须为 cert.crt: OK
openssl verify -untrusted intermediate.crt example.com.crt
# 线上实测,确认服务器实际下发的链长度大于 1
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"
原因二:私钥与证书不配对
最常见于“CSR 在 A 机器生成、私钥却在 B 机器重新生成”。此时 cPanel 会明确提示 The private key does not match the certificate,安装按钮直接变灰。用模数哈希比对即可判定,两行输出必须完全一致(ECC 证书请把 rsa 换成 ec)。
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# 两行哈希一致 = 配对;不一致只能重新签发证书,无法“修复”
原因三:域名验证(DCV)失败
AutoSSL 走 HTTP-01 时,要求 http://example.com/.well-known/acme-challenge/<token> 直接返回 200。若被 301 跳到 HTTPS、被 WAF 返回 403、或被 CDN 拦截,签发就会在最后一步失败。按 Let’s Encrypt 文档说明,验证请求必须能从公网 80 端口无重定向地取到 token。
# 手动探测验证路径(应返回 200,而非 301/403)
curl -sS -o /dev/null -w "%{http_code} %{redirect_url}n"
http://example.com/.well-known/acme-challenge/testfile
# 查看失败原因
tail -n 100 /usr/local/cpanel/logs/autossl_log | grep -i "DCV failed"
# 排查完强制重跑一次
/usr/local/cpanel/bin/autossl_check --user=example
其他常见诱因:Cloudflare 开启橙云代理后,回源请求被改写,DCV 取不到源站 token,需临时切灰云或改用 DNS-01;防火墙只放行 443 未放行 80;DNS 的 CAA 记录只允许特定 CA 而拒绝 letsencrypt.org,同样会让签发在最后一步被拒。
# 检查 CAA 是否限制了签发机构
dig +short CAA example.com
# 空输出表示未设置;若返回 0 issue "digicert.com" 则 Let's Encrypt 无权签发
建议的排查顺序是:先看 autossl_log 里的具体错误码,再用 openssl verify 与模数哈希确认链条和密钥,最后用 curl 验证 DCV 路径可达性——三步走完,绝大多数 cPanel 安装 SSL 证书的失败都能定位到唯一原因。
cPanel 安装 SSL 证书的 8 个步骤(从生成 CSR 到强制 HTTPS)
很多人卡在 cPanel 安装 SSL 证书这一步,并不是因为操作复杂,而是因为 DNS 还没切好就急着点 Install。下面按真实操作顺序拆成 8 步,每步都给出可直接复制的命令和预期输出,照着走一遍大约 15 分钟(不含 CA 审核时间)。
第 1 步:确认域名解析指向本机。先验证 A 记录,再决定是否申请:
# 返回的 IP 必须与服务器公网 IP 一致
dig +short A example.com
dig +short A www.example.com
curl -s https://api.ipify.org; echo # 本机出口 IP,用于比对
# 若使用 Cloudflare,必须先改成灰云(DNS only)
# 橙云时代理会终止 TLS,HTTP-01 验证读到的是 Cloudflare 的 104.x/172.67.x 段 IP,必然失败
第 2 步:生成私钥与 CSR。cPanel 自带「SSL/TLS → Generate, view, upload or delete SSL keys」也能生成,但命令行更可控,尤其是 SAN 多域名:
# 需 OpenSSL >= 1.1.1(CentOS 7 自带 1.0.2k 会报 "req: Unknown option or argument addext")
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# 确认 SAN 真的写进去了,否则浏览器会报 NET::ERR_CERT_COMMON_NAME_INVALID
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com
注意 -nodes 表示私钥不加密(cPanel 导入时不支持带密码的 key),rsa:2048 是当前兼容性最好的默认值;若 CA 支持,可升到 rsa:3072 或 ECDSA P-256(Mozilla SSL Configuration Generator 的「Intermediate」档推荐)。
第 3 步:提交 CSR 签发。把 example.com.csr 全文(含 -----BEGIN CERTIFICATE REQUEST-----)粘贴给 CA,私钥永远不要上传:
| 证书类型 | 2024 年典型价格 | 签发耗时 | 验证方式 | 适用场景 |
|---|---|---|---|---|
| Let’s Encrypt DV | 免费 | < 1 分钟 | HTTP-01 / DNS-01 | 个人站、测试环境(90 天有效,需自动续期) |
| 商业 DV | 约 50–300 元/年 | 5–10 分钟 | DNS TXT 或文件验证 | 中小企业官网 |
| OV | 约 1000–3000 元/年 | 1–3 个工作日 | 人工核验营业执照 | 电商、需在证书详情展示企业主体 |
第 4 步:合并证书链。CA 通常会发两个文件:域名证书和中间证书。顺序错了 Chrome 仍可能通过,但 Android 旧版和 curl 会报 unable to get local issuer certificate:
# 顺序固定:站点证书在前,中间证书在后
cat example.com.crt intermediate.crt > fullchain.crt
# issuer 应为中间 CA(如 Let's Encrypt 的 R3/R10),不是根 CA
openssl x509 -in fullchain.crt -noout -issuer
# issuer=C = US, O = Let's Encrypt, CN = R3
第 5 步:页面上传。登录 cPanel → SSL/TLS → Install and Manage SSL for your site (HTTPS) → 选择域名 → Certificate 粘贴 fullchain.crt 全文、Private Key 粘贴 example.com.key 全文、CA Bundle 可留空(已含在 fullchain 中)→ 点击 Install Certificate。安装成功后 cPanel 会显示 SSL is active,并写入 /etc/apache2/conf.d/ssl/ 或 /var/cpanel/ssl/ 下。
第 6 步:强制 HTTPS。cPanel 102+ 在 Domains 页面每个域名右侧有 Force HTTPS Redirect 开关,打开即可;老版本或需要更细控制时改 public_html/.htaccess:
# cPanel 默认 Apache + mod_rewrite,注意放在 .htaccess 顶部
RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]
第 7 步:排查混合内容。打开 Chrome DevTools → Security 面板,看到 Resources — mixed content 就说明页面里还有 http:// 的图片、脚本或字体。按 F12 在 Sources 里全局搜索 http://,逐个改成 https:// 或协议相对写法。
第 8 步:命令行复验。浏览器绿锁不等于配置正确:
# 看证书有效期与签发者,确认返回的是新证书
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -dates -issuer
# 期望 301 + Location: https://example.com/
curl -I http://example.com
证书与私钥的匹配性可以用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 的输出比对,两者不一致时 cPanel 会直接报 The certificate does not match the private key,这是上传环节最常见的错误。
配置与命令示例:OpenSSL 3.0、uapi 与 .htaccess 的具体写法
很多人卡在最后一步:证书已经签发,却不知道在 cPanel 里到底该怎么“装”。下面给出可以直接粘贴执行的命令序列,全部基于 cPanel 110 与 OpenSSL 3.0(EA4 的 /usr/bin/openssl;先跑 openssl version 确认,低于 1.1.1 的版本不支持 -addext,需要改用临时配置文件写 SAN)。
为什么优先用 ECDSA P-256 而不是 RSA 2048? 因为 ECDSA 的密钥与签名都更小,TLS 握手时 Certificate 消息更短,能省掉一个 RTT 级别的字节量,并且证书体积小。生成私钥和 CSR 只需两条命令:
# 1) 生成 ECDSA P-256 私钥(prime256v1 即 secp256r1),不加密输出
openssl ecparam -name prime256v1 -genkey -noout -out example.com.key
chmod 600 example.com.key
# 2) 生成 CSR,CN 与 SAN 必须同时写,现代 CA 只看 SAN
openssl req -new -key example.com.key -out example.com.csr
-subj "/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"
| 对比项 | RSA 2048 | ECDSA P-256 |
|---|---|---|
| 私钥 / 证书典型体积 | 约 1.7 KB / 1.2 KB | 约 0.2 KB / 0.7 KB |
| TLS 1.3 签名长度 | 256 字节 | 64–72 字节 |
| 匹配校验方式 | x509 -modulus 比对 MD5 |
导出公钥后做哈希比对 |
| 客户端兼容性 | 全平台通吃 | 2014 年后主流浏览器;部分老 Android/Java 客户端不识别 ECDSA 套件 |
| 签发支持 | 所有 CA | Let’s Encrypt、Sectigo、DigiCert 均已支持 ECDSA 签发 |
证书和私钥到底配不配对? RSA 证书用 modulus 比对,两条输出必须逐字符一致:
# RSA:两行 MD5 必须完全相同,否则说明传错了 key
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECDSA:没有 modulus,改为比对导出的公钥
openssl x509 -in example.com.crt -pubkey -noout | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
root 用命令行安装(cPanel 110 的 uapi 语法),返回 result: 1 即成功:
uapi --user=myuser SSL install_ssl
domain=example.com
cert="$(cat fullchain.crt)"
key="$(cat example.com.key)"
cabundle="$(cat intermediate.crt)"
如果是从旧服务器整体迁移、域名有几十个,用 WHM API 循环调用更省事:
whmapi1 installssl domain=example.com
crt="$(cat fullchain.crt)"
key="$(cat example.com.key)"
cab="$(cat intermediate.crt)"
安装失败时不要靠猜,uapi 的 reason 字段会直接告诉你原因,典型返回如 result: 0 加 reason: The certificate provided does not match the private key. 或 The certificate is not valid for the domain "example.com"——前者是 key 传错,后者是 SAN 里漏了该域名。
怎么让 HTTP 自动跳转到 HTTPS? 在 public_html/.htaccess 最顶部(务必在 WordPress 自带规则之前)加入:
RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
注意 cPanel 域名级别已有 “Force HTTPS Redirect” 开关,两者同时开启会产生重复跳转链,建议只保留一处。
证书装好了,AutoSSL 会不会把它覆盖掉? 不会,但需要让 AutoSSL 重新识别。手动触发并实时看 DCV 结果:
# 单用户触发(cPanel 110 默认每 24 小时自动跑一次)
/usr/local/cpanel/bin/autossl_check --user=myuser
# 或者走 WHM API
whmapi1 start_autossl_check_for_one_user user=myuser
# 观察 DCV 校验过程,重点看 "DCV" 与 "SUCCESS" 行
tail -f /usr/local/cpanel/logs/autossl_log
据 Let’s Encrypt 文档,HTTP-01 校验要求 /.well-known/acme-challenge/ 返回 200 且内容完全一致,因此上面那段 301 跳转规则不要对 .well-known 路径生效,否则 DCV 会失败。相关概念如 ACME 协议(RFC 8555)、OCSP Stapling 与 HSTS 预加载列表,都会在后续章节展开。
方案选型对比:AutoSSL、免费 DV、付费 DV/OV 与通配符证书怎么选
在 cPanel 里装证书之前,先解决一个更前置的问题:这张证书由谁签发、买哪一种?下面这张表把常见方案的边界列清楚,后面三条建议对应最常见的三种决策场景。
| 方案 | 价格区间 | 有效期 | 验证方式 | 适用场景 |
|---|---|---|---|---|
| Let’s Encrypt AutoSSL | 0 元 | 90 天,自动续期 | HTTP-01 / DNS-01 | 单域名或少量子域名的常规站点 |
| 商业 DV 单域名 | 50–300 元/年 | 1 年 | DNS / 文件验证 | 需要固定到期日、无自动续期环境 |
| 商业 OV | 1000–3000 元/年 | 1 年 | 人工审核企业资质 | 对外电商、需展示组织信息 |
| 通配符 DV(*.example.com) | 300–1500 元/年 | 1 年 | DNS-01 | 子域名多、无法逐个签发 |
| 自签名证书 | 0 元 | 自定义 | 无 | 仅内网测试,浏览器会告警 |
建议一:单站点优先 AutoSSL。cPanel & WHM 默认每 24 小时执行一次 AutoSSL 检查,证书剩余 30 天时自动续签,运维成本最低——这个 30 天窗口与 Let’s Encrypt 官方文档建议的续期时机一致。需要立即签发或排查失败原因时,用 root 执行:
# 强制为单个 cPanel 账户跑一次 AutoSSL 检查(cPanel & WHM 110+)
/usr/local/cpanel/bin/autossl_check --user=example
# 查看运行结果与失败原因(HTTP-01 失败会写明 404 / 超时等)
tail -n 50 /var/cpanel/logs/autossl.log
但要清楚它的边界:据 Let’s Encrypt 文档,其证书固定 90 天有效期,且不签发 OV/EV 类型,想靠 AutoSSL 拿到一年期或带组织信息的证书是不可能的。
建议二:子域名超过 5 个或使用泛解析时选通配符证书。据 RFC 6125 第 6.4.3 节,通配符只匹配一个标签,*.example.com 不覆盖 a.b.example.com,这类二级子域必须单独签发或写入 SAN 列表。通配符证书只能走 DNS-01 验证,因此要求该域名的 DNS 由本机接管,或配置好 DNS 集群/支持 API 的 DNS 提供者,否则签发会直接失败。
建议三:对外支付、邮件签名、需要展示企业主体时选 OV。OV 证书的 Subject 会带 O= 组织字段,按 CA/Browser Forum 基线要求需对组织做人工审核,因此价格与周期都高于 DV;但浏览器地址栏的加密强度与 DV 完全相同(同为 RSA 2048 或 ECDSA P-256 配 SHA-256),差别只在身份背书。
算法怎么选。RSA 2048 兼容性最好,TLS 1.2 全支持;ECDSA P-256 握手更快、证书体积更小,但 Android 4.x 与 Windows XP 不支持。AutoSSL 默认签发 RSA 2048,可在 WHM » SSL/TLS » Manage AutoSSL » Providers 中启用 ECDSA。无论走哪条路,cPanel 安装 SSL 证书后都应从外部实测一次实际下发的证书:
# 从外部验证 443 端口实际下发的算法、签发者与到期日
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -text
| grep -E "subject=|issuer=|notBefore|notAfter|Public Key Algorithm|Signature Algorithm"
subject=C = US, O = Let's Encrypt, CN = R11
issuer=C = US, O = Let's Encrypt, CN = R11
notBefore=Mar 1 08:12:33 2024 GMT
notAfter=May 30 08:12:32 2024 GMT
Public Key Algorithm: rsaEncryption
Signature Algorithm: sha256WithRSAEncryption
若只是内网测试,自签名证书够用,但浏览器会抛 NET::ERR_CERT_AUTHORITY_INVALID,不可用于对外站点。生成命令(OpenSSL 1.1.1+ 支持 -addext):
openssl req -x509 -newkey rsa:2048 -sha256 -nodes -days 365
-keyout internal.key -out internal.crt
-subj "/C=CN/O=Internal/CN=intranet.local"
-addext "subjectAltName=DNS:intranet.local"
常见报错与排查:从 NET::ERR_CERT_COMMON_NAME_INVALID 到 DCV failed
证书装完打开网站却报错,问题基本落在三类:名字对不上、密钥配不上、链路补不全。下面按浏览器和命令行里最常出现的原文逐条拆解,每条都给可直接复制的核对命令。先看一张速查表,再往下看细节:
| 报错原文 | 根因 | 一条命令定位 |
|---|---|---|
| NET::ERR_CERT_COMMON_NAME_INVALID | 证书 SAN 不含当前访问域名 | openssl x509 -noout -ext subjectAltName -in fullchain.crt |
| The private key does not match the certificate | 私钥与证书不配对 | openssl x509 -noout -modulus -in fullchain.crt | openssl md5 |
| curl: (60) unable to get local issuer certificate | CA Bundle 缺失或顺序错误 | openssl verify -CAfile ca-bundle.crt fullchain.crt |
| The system could not verify the domain … DCV failed | HTTP-01 校验被跳转或 CDN 拦截 | curl -I http://example.com/.well-known/acme-challenge/test |
| SSL_ERROR_RX_RECORD_TOO_LONG | 用 https:// 访问了 80 端口 | curl -I http://example.com |
| Cloudflare 526 Invalid SSL certificate | 回源证书过期或自签名 | openssl s_client -connect 源站IP:443 -servername example.com |
浏览器提示 NET::ERR_CERT_COMMON_NAME_INVALID,是证书签错了吗?
不是签错,是覆盖范围不够。据 RFC 6125,现代浏览器早已忽略 CN 字段,只校验 subjectAltName(SAN)。只签了 example.com 却访问 www.example.com 必然触发。缺失就重签,OpenSSL 1.1.1 及以上(CentOS 8、Ubuntu 20.04 默认版本)可在生成 CSR 时直接补 SAN:
openssl req -new -newkey rsa:2048 -nodes
-keyout example.key -out example.csr
-subj "/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# -addext 仅 OpenSSL 1.1.1+ 可用;1.1.0 及以下需手写 openssl.cnf 的 [alt_names] 段
cPanel 安装 SSL 证书时报 The private key does not match the certificate 怎么办?
私钥被覆盖了,常见于重复签发后只换了 crt 没换 key。比对 modulus 摘要,MD5 完全一致才算配对:
openssl x509 -noout -modulus -in fullchain.crt | openssl md5
openssl rsa -noout -modulus -in example.key | openssl md5
# 两行输出必须相同,例如 (stdin)= 3f8a1c...
不一致且找不到原始私钥,只能重新生成 CSR 并重签——私钥无法从证书反推,这是 RSA/ECDSA 公钥密码学的前提。在 cPanel 中重新粘贴正确私钥时,注意 PEM 头尾 -----BEGIN PRIVATE KEY----- 不要带多余空格。
curl 报 (60) unable to get local issuer certificate?
CA Bundle 缺失或顺序错。按“叶子 → 中间 → 根”拼接后重新上传;根证书可省略,据 Let’s Encrypt 文档,服务器不应下发根证书,客户端本地信任库已有:
cat example.com.crt intermediate.crt > fullchain.crt
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.crt
# 输出 fullchain.crt: OK 表示链路完整
AutoSSL 日志里的 DCV failed 怎么排查?
HTTP-01 校验要求 /.well-known/acme-challenge/ 下随机文件返回 200。若返回 301,说明强制 HTTPS 规则拦住了该目录;返回 403 多为 CDN 或 WAF 拦截。给该目录加白名单:
# .htaccess 中放在强制跳转规则之前
RewriteCond %{REQUEST_URI} !^/.well-known/acme-challenge/
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
SSL_ERROR_RX_RECORD_TOO_LONG 和 Cloudflare 526 呢?
前者几乎都是把 https:// 打到了 80 端口,或 .htaccess 重定向成环,用 curl -I http://example.com 与 curl -I https://example.com 分别看响应头和跳转链路即可定位。后者是 Cloudflare 回源握手失败:回源证书过期或自签名。把 SSL/TLS 模式从 Flexible 改为 Full (strict),或在 cPanel 安装 Cloudflare Origin CA 证书(有效期 15 年)作回源证书,即可同时避免 526 与回源段明文传输。
怎么确认证书已生效?命令行、浏览器与在线检测三路验证
问:上传完证书,怎么最快确认它真的生效了?
三条路各查一层:openssl 查证书链,curl 查 HTTP/TLS 协商,浏览器和 SSL Labs 查信任与配置评分。三路结果不一致时,以命令行输出为准——浏览器和面板都有缓存。
问:怎么用一条命令确认证书链是完整的?
关键在 -servername:共享 IP 环境下服务器靠 SNI 选证书,漏掉这个参数可能连到同 IP 上另一张证书。据 OpenSSL 官方文档,s_client 默认不发送 SNI,必须显式指定。
# 1) 抓取证书并解析主题、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -subject -issuer -dates
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R3
# notBefore=Jun 1 00:00:00 2024 GMT
# notAfter=Aug 30 23:59:59 2024 GMT
# 2) 只看链校验结果
openssl s_client -connect example.com:443 -servername example.com /dev/null
| grep "Verify return code"
# Verify return code: 0 (ok) ← 链完整
# Verify return code: 21 (unable to verify the first certificate) ← 中间证书没装
# Verify return code: 20 (unable to get local issuer certificate) ← 根证书不被信任/自签
返回 21 是最常见的手动上传失误:只贴了域名证书,漏了 CA 下发的中间证书(Let’s Encrypt 的 R3/E1 之类)。cPanel 安装 SSL 证书时,「Certificate」框里必须把域名证书和中间证书按顺序拼接,否则浏览器在部分 Android 设备上会直接报「证书无效」。
问:HTTP 层怎么验证,怎么看到实际协商的 TLS 版本?
# 状态行,期望 HTTP/2 200;若返回 301 说明重定向未收敛
curl -sSI https://example.com | head -n 1
# HTTP/2 200
# 看真实协商的协议版本与套件(curl 7.88+ 默认支持 HTTP/2 与 TLS 1.3)
curl -vI https://example.com 2>&1 | grep -E "SSL connection|TLSv1.3"
# * SSL connection using TLSv1.3 / TLS_AES_256_GCM_SHA384
TLS 1.3 由 RFC 8446 定义,握手只保留 AEAD 套件,因此看到 TLS_AES_256_GCM_SHA384 就说明协议栈较新;若输出 TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384 也属正常,但出现 TLSv1 或 TLSv1.1 就必须在下一节加固。
问:怎么确认证书不会在半夜突然过期?
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -checkend 2592000
# Certificate will not expire (2592000 秒 = 30 天,可改成 86400 查 1 天)
# Certificate will expire ← 立即续签
问:浏览器里该看哪几个地方?
Chrome 打开 DevTools → Security 面板,顶部应显示「Connection is secure」。点 View certificate → Certification Path,正常是 3 层:叶子证书 → 中间证书 → 根证书。只显示 1 层或 2 层且中间带警告图标,就是中间证书缺失。同一面板下方若提示 Mixed Content,说明页面里还有 http:// 的图片或脚本,这不影响证书本身但会让锁标变灰。
问:在线评分拿到 B 是什么原因?
Qualys SSL Labs 输入域名扫描,A/A+ 是常见目标。据 SSL Labs 评分文档,掉到 B 的高频原因依次是:仍启用 TLS 1.0/1.1、缺少 HSTS 头、使用 RC4/3DES、证书链不完整。改完配置后务必点 Clear cache 再扫,否则看到的是旧结果。
| 验证路径 | 入口 | 能发现的问题 | 盲区 |
|---|---|---|---|
| openssl 命令行 | s_client -servername |
链不完整、已过期、SNI 选错证书 | 不检查重定向与混合内容 |
| curl | -sSI / -vI |
HTTP 状态码、TLS 版本、跳转链路 | 不复现浏览器信任库差异 |
| 浏览器 DevTools | Security 面板 | 证书路径层级、混合内容 | 本机缓存/例外会掩盖问题 |
| SSL Labs | ssllabs.com/ssltest | 协议、套件、HSTS、综合评级 | 公共扫描有缓存,需手动清除 |
问:cPanel 和 WHM 面板上还要核对什么?
cPanel 的 SSL/TLS Status 页面(SECURITY 分区)应让所有域名显示绿色锁和到期日;WHM 的 Manage AutoSSL 页面能看到上次检查时间与下次续签时间。两点注意:手动上传的证书会覆盖 AutoSSL 自动签发的 DV 证书,因此 cpanel 安装 ssl 证书 之后 AutoSSL 显示「已安装第三方证书」属正常;当面板显示与命令行对不上时,以 openssl s_client 的结果为准,面板数据来自本地缓存,通常滞后几分钟到数小时。
续期与自动化:AutoSSL 计划任务、到期监控与手动证书管理
AutoSSL 到底什么时候发起续签?为什么我的证书快到期了它却不动?据 cPanel 官方文档,AutoSSL 由 /usr/local/cpanel/bin/autossl_check 驱动,cPanel 的定时任务每天执行一次;对每个已纳入 AutoSSL 的域名,只有剩余有效期不足 30 天时才会真正发起验证和签发,否则直接跳过。所以“刚续完没动静”是正常行为,不是故障。排查时先看日志,别猜:
# 手动触发一次全量检查(root 执行,适合验证配置改动是否生效)
/usr/local/cpanel/bin/autossl_check --all
# 只检查单个用户,便于定位某个域名的 DCV 失败原因
/usr/local/cpanel/bin/autossl_check --user=example
# 查看最近一次运行结果,重点关注 "DCV" 和 "error" 关键字
tail -n 200 /usr/local/cpanel/logs/autossl_log | grep -Ei 'dcv|error|fail'
# 确认定时任务是否还在(cPanel 自带 cron,不要手写重复条目)
grep -r autossl /etc/cron.d/ /var/spool/cron/ 2>/dev/null
日志路径 /usr/local/cpanel/logs/autossl_log 适用于 cPanel 86 及以后版本;如果你看到 WARN Failed to create a new certificate ... DCV failed,八成是 .well-known/acme-challenge 被别的 ACME 客户端占用了,见文末“避免冲突”。
手动上传的商业证书怎么做到“快到期就报警”?用 OpenSSL 的 -checkend 比解析日期字符串更可靠——它直接以退出码回答“还剩几天”。notAfter 字段语义由 RFC 5280 定义,单位是秒,注意别把 864000(10 天)写成 86400(1 天)。
#!/bin/bash
# /usr/local/bin/ssl_expiry_check.sh
# 适用:OpenSSL 1.0.2+ / cPanel 100+;checkend 参数单位为秒
CERT=/home/example/ssl/example.com.fullchain.pem
DAYS=10
# -checkend 在"剩余有效期 < 指定秒数"时返回 1,否则返回 0
if ! openssl x509 -in "$CERT" -noout -checkend $((DAYS * 86400)) >/dev/null 2>&1; then
END=$(openssl x509 -in "$CERT" -noout -enddate) # 例:notAfter=Mar 1 00:00:00 2025 GMT
curl -s -H 'Content-Type: application/json'
-d "{"msgtype":"text","text":{"content":"example.com 证书即将过期:${END}"}}"
'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY'
fi
# crontab -e 加入:0 9 * * * /usr/local/bin/ssl_expiry_check.sh
WHM 能不能直接帮我发提醒?可以,但默认窗口较短:在 WHM » Server Contacts » Contact Manager 勾选 SSL Certificate Expiry 后,系统默认在到期前 14 天给管理员邮箱发信。多站点场景建议再加一层企业微信/钉钉 webhook(如上面的脚本),因为邮件容易淹没在告警海里。
续期之后需要手动重启 Apache 吗?不需要。在 WHM 的 Install and Manage SSL for your site 页面安装时,cPanel 会自动调用 /scripts/restartsrv_httpd 做平滑重启;用 API 安装(uapi SSL install_ssl)时返回值同样会带上服务重启状态,只有在你手工替换证书文件、绕过面板时,才需要自己补一条 /scripts/restartsrv_httpd。
AutoSSL 和 certbot 能同时用吗?不能。两者都会去争抢 public_html/.well-known/acme-challenge/ 目录,一个清理临时文件就会让另一个验证失败,典型报错是 Invalid response from ... 404。据 Let’s Encrypt 文档,ACME 客户端应在证书到期前 30 天续期,这与 AutoSSL 的策略重叠,等于双重签发、双重限流风险。二选一后,把另一个的定时任务注释掉:
| 维度 | cPanel AutoSSL | certbot 独立部署 | 手动上传商业证书 |
|---|---|---|---|
| 续期触发 | autossl_check 每日运行,剩余 <30 天签发 | systemd timer 或 cron,默认每日两次 | 人工,需自建监控 |
| 日志位置 | /usr/local/cpanel/logs/autossl_log | /var/log/letsencrypt/letsencrypt.log | 无 |
| 重启 Web 服务 | 安装时自动执行 restartsrv_httpd | 需配置 deploy-hook | 面板内安装自动,手工覆盖需手动 |
| 与面板冲突 | — | 会争抢 .well-known 目录 | 无 |
关掉 certbot 的定时器:systemctl disable --now certbot.timer(Debian/Ubuntu)或 crontab -e 注释掉 certbot 条目,然后用 cpanel 安装ssl证书 面板统一接管,避免出现“两套证书文件指向同一 vhost”的混乱。
装完证书还要做什么?TLS 版本、HSTS 与 OCSP Stapling 加固
证书装好、https:// 能正常打开,为什么 SSL Labs 评分还是 B?因为证书只证明“身份可信”,协议版本、加密套件、HSTS、OCSP Stapling 才决定“连接有多硬”。下面五项都能在 cPanel/WHM 里直接改,改完用 openssl s_client 复验。
1. 怎么彻底关掉 TLS 1.0/1.1?WHM → Apache Configuration → Global Configuration → SSL/TLS Protocol,只勾 TLS 1.2 与 TLS 1.3,保存后 cPanel 自动重写并重建 httpd.conf,等价于 SSLProtocol -all +TLSv1.2 +TLSv1.3。TLS 1.0/1.1 已在 RFC 8996(2021-03)被正式弃用,PCI DSS v3.2 起也禁止使用。注意该指令属于 server config 上下文,写进 .htaccess 无效,必须走 WHM 或 Pre VirtualHost Include。
# 期望:握手失败(sslv3 alert handshake failure / no protocols available)
openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 期望:Protocol : TLSv1.3,Cipher : TLS_AES_256_GCM_SHA384
openssl s_client -connect example.com:443 -tls1_3 </dev/null | head -20
2. 加密套件按什么标准配?用 Mozilla SSL Configuration Generator 选 “Apache + OpenSSL 1.1.1+、Intermediate”,粘到 WHM → Apache Configuration → Include Editor → Pre VirtualHost Include(全局生效,勿放 VirtualHost 内以免被 cPanel 覆盖):
# 白名单模式:只列 AEAD 套件,未列出的一律禁用,天然排除 RC4/3DES/CBC
SSLCipherSuite 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:!aNULL:!MD5:!RC4:!3DES
SSLHonorCipherOrder off # Apache 2.4.7+ 指令,默认 off;TLS 1.3 下建议保持 off
一个高频误区:TLS_AES_128_GCM_SHA256 这类 TLS 1.3 套件不受 SSLCipherSuite 控制,由 OpenSSL 默认提供,Apache 层面无法单独禁用——这是 RFC 8446 的设计,不是配置没生效。
3. HSTS 一上来就写 31536000 会怎样?若站内仍有 http:// 资源或某个子域没证书,浏览器会在 max-age 内强制 HTTPS 且不提供“继续访问”入口,相当于把访客锁在门外。建议分阶段:
# 第一阶段(.htaccess,需 mod_headers,cPanel 默认启用):观察 5 分钟,出错改 max-age=0 即可解锁
Header always set Strict-Transport-Security "max-age=300"
# 第二阶段:确认全站 HTTPS 后升到 1 年并覆盖子域
Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
# 仅当所有子域均已上 HTTPS、且接受“不可逆”时才追加 ; preload
| max-age 取值 | 生效时长 | 适用阶段 |
|---|---|---|
| 300 | 5 分钟 | 首次上线灰度,便于快速回退 |
| 86400 | 1 天 | 观察期,配合日志排查混合内容 |
| 31536000 | 1 年 | 稳定期,Mozilla 推荐的最小值 |
| 63072000 + preload | 2 年 | 提交 hstspreload.org 后硬编码进浏览器 |
4. OCSP Stapling 开了却没生效,报错怎么读?cPanel 的 EasyApache 4 当前 Apache 为 2.4.58+,已满足要求;SSLUseStapling 默认 off,需在全局作用域开启:
# Pre VirtualHost Include,VirtualHost 内设置无效
SSLUseStapling on
SSLStaplingCache shmcb:/run/httpd/ssl_stapling(32768)
SSLStaplingResponderTimeout 5
SSLStaplingReturnResponderErrors off # 取不到 OCSP 响应时不阻断握手
启动失败报 AH01980: couldn't configure stapling cache,说明 SSLStaplingCache 没在全局作用域或 /run/httpd 不存在;日志里出现 stapling response not cached,通常是出站 80 端口被防火墙拦截(OCSP 查询走 HTTP)。验证:
openssl s_client -connect example.com:443 -status -servername example.com /dev/null | grep -A2 "OCSP response"
# 成功:OCSP Response Status: successful (0x0),并带 This Update / Next Update 时间
5. Chrome 报 Mixed Content 怎么清?典型报错:Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure element 'http://example.com/a.jpg'. 先定位再改,别手动逐页翻:
# 定位主题/模板里写死的 http:// 资源
grep -rniE "http://[^"']+.(png|jpe?g|gif|css|js)" ~/public_html/wp-content/themes/ | head
# WordPress 批量改库(务必先备份);插件 Better Search Replace 等价于此命令
wp search-replace 'http://example.com' 'https://example.com' --all-tables --skip-columns=guid --precise
协议相对写法 //example.com/a.js 虽能规避,但在 file:// 预览、部分邮件客户端中会解析失败,现代做法直接写 https://。另外别忘了检查 CAA 记录与 Certificate Transparency 日志:换 CA 前未放行对应 CA 的 CAA,会让 Let’s Encrypt 续签失败,这比协议加固更容易在 90 天后突然爆雷。
AutoSSL 由 cPanel 调用 Let's Encrypt 等提供商,自动完成 CSR 生成、DCV 验证与安装,证书 90 天有效并自动续签;手动安装需要自己生成 CSR、向 CA 提交并粘贴证书与私钥,适合商业 OV、通配符或 CA 不在 AutoSSL 提供商列表中的场景。两者可以共存,但同一域名只应保留一个自动续期来源。
先看报错代码:NET::ERR_CERT_COMMON_NAME_INVALID 是 SAN 缺域名,NET::ERR_CERT_AUTHORITY_INVALID 是中间证书缺失,Mixed Content 则是页面里还有 http 资源。用 openssl s_client -connect example.com:443 -servername example.com 查看返回的证书链,再对照 DevTools 的 Security 面板逐项排除。
单站点、能接受 90 天自动续期,选 Let's Encrypt(AutoSSL 默认)即可,成本为 0;需要 1 年固定有效期、需要 OV 组织信息展示,或服务器无法开放 80 端口做 HTTP-01 验证时,选付费 DV/OV(DV 约 50–300 元/年,OV 约 1000–3000 元/年)。两者在浏览器里的加密强度没有区别。
这是私钥与证书不配对。执行 openssl x509 -noout -modulus -in example.com.crt | openssl md5 和 openssl rsa -noout -modulus -in example.com.key | openssl md5,两条 MD5 不一致就说明拿错了 key。找回签发时使用的那把私钥,找不到只能重新生成 CSR 并重签证书。
支持。在 Install and Manage SSL 页面选择主域名后粘贴通配符证书即可,但证书的 SAN 必须写成 *.example.com,且通配符只覆盖一级子域,a.b.example.com 需要单独签发。用 AutoSSL 申请通配符需要 DNS-01 验证,要在 WHM 中配置 DNS 提供商的 API 凭证。
在 Install and Manage SSL 页面点击安装后,cPanel 会自动调用 /scripts/restartsrv_httpd 完成平滑重启,通常无需手动操作。如果用 uapi 或 WHM API 在命令行安装,返回结果里会带 restart 状态,失败时手动执行 /scripts/restartsrv_httpd –hard 再验证。
最常见是 HTTP-01 验证被拦截:http://example.com/.well-known/acme-challenge/ 返回 301 跳转、403 或 CDN 缓存。检查是否开启了强制 HTTPS、防火墙是否只放行 443、Cloudflare 是否开着橙云代理;改为 DNS-01 验证或在验证期间临时关闭跳转通常可解决。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。