跳到主要内容
安装配置教程

wdCP SSL 证书安装教程:Nginx/Apache 配置、报错排查与 HTTPS 验证

wdcp ssl证书安装 — wdCP SSL 证书安装教程:Nginx/Apache 配置、报错排查与 HTTPS 验证
核心结论

wdCP 安装 SSL 证书的关键动作是:把 fullchain.pem 与 privkey.pem 放到 /www/wdlinux/nginx/conf/ssl/域名/,在站点 vhost 写入 ssl_certificate 与 ssl_certificate_key,执行 nginx -t 后 service nginx reload,最后用 curl -I https://域名 确认返回 200 或 301。 wdCP v3.3 默认常见组合为 Nginx 1.8.1、Apache 2.4.18、OpenSSL 1.0.2,只支持到 TLS 1.2;在 vhost 写 TLSv1.3 会报 invalid value TLSv1.3。 证书链优先用 fullchain.pem,执行 grep -c 'BEGIN CERTIFICATE' fullchain.pem 应为 2 或 3;缺中间证书时手机常报 NET::ERR_CERT_AUTHORITY_INVALID。 验证顺序建议:ss -lntp | grep 443 → curl -I https://域名 → openssl s_client -servername 域名 -status → SSL Labs 查看 Chain issues 是否为 None。 Let's Encrypt 证书有效期 90 天,可用 acme.sh --install-cert 配合 --reloadcmd 'service nginx reload' 自动续期;商业证书到期前 30-60 天换签。

为什么 wdCP 上装 SSL 证书容易卡住?先看版本、端口和证书链三个根因

很多人第一次在 wdCP 上配置 SSL 时会以为“上传证书、点保存就完事”,结果浏览器一直显示旧证书,或者手机打开报错、电脑上却正常。问题通常不在证书本身,而在于 wdCP 这套面板的组件年代、组合架构和证书文件形态三个地方。按下面的顺序逐项排查,能省掉大部分试错。

根因一:wdCP v3.3 默认组件偏旧,不支持 TLS 1.3。wdCP v3.3 默认搭载 Nginx 1.8.1、Apache 2.4.18,编译时链接 OpenSSL 1.0.2。据 OpenSSL 官方发布说明,TLS 1.3 从 OpenSSL 1.1.1(2018 年 9 月)才开始支持,所以这条组合天然与 TLS 1.3 无缘。先确认版本:

# 查看面板版本,v3 一般为 3.3.x;v2 的目录结构完全不同
cat /www/wdlinux/wdcp/version.txt

# 查看 Nginx 编译时链接的 OpenSSL 版本
nginx -V 2>&1 | grep -i openssl
# 典型输出:built with OpenSSL 1.0.2k-fips  26 Jan 2017
#           TLS SNI support enabled

此时如果在 vhost 里照抄网上的配置写 ssl_protocols TLSv1.2 TLSv1.3;,nginx -t 会直接报错,配置无法加载:

nginx: [emerg] invalid value "TLSv1.3" in /www/wdlinux/nginx/conf/vhost/example.com.conf:12

在 OpenSSL 1.0.2 上应写成 ssl_protocols TLSv1.2;(TLSv1.0/1.1 已被 RFC 8996 列为不应使用,不要再开)。若确实需要 TLS 1.3,只能升级 Nginx 到 1.13.0+ 并自行编译链接 OpenSSL 1.1.1+,属于另一个话题。

根因二:组合模式下 SSL 终止位置不清。wdCP 常见的 nginx+apache 组合里,Nginx 监听 80/443 做前端,Apache 退回 127.0.0.1:88 处理 PHP。此时若把证书只配在 Apache 的 443 上,而 443 早已被 Nginx 占住,浏览器拿到的仍然是 Nginx 的旧证书或自签证书。一条命令就能定位:

ss -lntp | grep -E ':(80|443|88|8080)b'
# 典型输出(组合模式):
# LISTEN 0 128 0.0.0.0:80    users:(("nginx",pid=1234,...))
# LISTEN 0 128 0.0.0.0:443   users:(("nginx",pid=1234,...))
# LISTEN 0 128 127.0.0.1:88  users:(("httpd",pid=5678,...))
# LISTEN 0 128 0.0.0.0:8080  users:(("wdcp",pid=9012,...))

看到 443 属于 nginx,证书就必须配在 Nginx 的 vhost 里,Apache 侧只做 HTTP 回源即可。

根因三:证书链缺失,电脑正常、手机报错。这是最高频的“玄学问题”。据 Let’s Encrypt 文档,服务端应下发 fullchain.pem(域名证书 + 中间证书),而不是 cert.pem。Nginx 的 ssl_certificate 必须指向包含 2–3 段证书的链文件:

# 统计链文件里的证书段数,输出 1 说明只上传了域名证书
grep -c 'BEGIN CERTIFICATE' /www/wdlinux/nginx/conf/ssl/example.com/fullchain.pem

# 只传域名证书时 curl 会报:
curl -I https://example.com
# curl: (60) SSL certificate problem: unable to get local issuer certificate

# 用 s_client 直连验证链是否完整
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep -i 'Verify return code'
# 期望:Verify return code: 0 (ok)

顺带两个容易忽略的点:其一,wdCP 面板默认跑在 8080,装完系统后 iptables 或云厂商安全组常常只放行了 80/8080,443 没开。telnet example.com 443 超时、curl -I https://example.com 返回 Connection refused 或 Operation timed out,八成就是这里。其二,wdCP v2 与 v3 的 SSL 菜单入口不同,v3.3 一般在“网站管理 → 站点 → 修改”里操作;升级前先确认版本号,别照着 v2 的教程去改 /www/wdlinux/wdapache/conf/httpd.conf,那台机器上可能根本没有这个文件。

根因 典型现象 快速验证 修复方向
组件旧,不支持 TLS 1.3 nginx -t 报 invalid value "TLSv1.3" nginx -V 2>&1 | grep -i openssl 改为 ssl_protocols TLSv1.2;,或升级 Nginx + OpenSSL 1.1.1+
组合模式终止点错位 浏览器仍显示旧证书/自签证书 ss -lntp | grep ':443' 证书配到 Nginx vhost,Apache 只做 127.0.0.1:88 回源
证书链缺失 电脑正常、iOS/Android 报错,curl: (60) grep -c 'BEGIN CERTIFICATE' fullchain.pem ssl_certificate 指向 fullchain.pem(2–3 段)
443 未放行 telnet 超时、Connection refused telnet example.com 443 iptables 放行 443 + 云安全组入方向加规则

装之前先核对:证书文件、私钥、域名与 wdCP 版本要准备什么

证书装进 wdCP 之前,先把”文件、配对、域名、链路、引擎”这五项核对完,能挡掉后续 80% 的 400/443 报错。顺序不要乱:文件没放对目录,后面的配置再正确也白搭。

第一步:固定命名与目录,并收紧私钥权限。建议统一用 fullchain.pem、privkey.pem、chain.pem 三个名字,放到按域名区分的独立目录,例如 /www/wdlinux/nginx/conf/ssl/example.com/。私钥绝不能放进网站根目录(如 /www/web/example_com/public_html),否则 https://example.com/privkey.pem 可能被直接下载。Nginx/Apache 的主进程以 root 启动时读取证书,因此 600 root:root 不影响运行:

# 1) 建立专用目录(多站点按域名分目录,便于续期时整目录替换)
mkdir -p /www/wdlinux/nginx/conf/ssl/example.com
cp fullchain.pem chain.pem privkey.pem /www/wdlinux/nginx/conf/ssl/example.com/

# 2) 权限:公钥可读,私钥仅 root
chown root:root /www/wdlinux/nginx/conf/ssl/example.com/*.pem
chmod 644 /www/wdlinux/nginx/conf/ssl/example.com/fullchain.pem
chmod 600 /www/wdlinux/nginx/conf/ssl/example.com/privkey.pem

第二步:证书与私钥是否配对。据 OpenSSL 官方文档 openssl-x509(1) 的说明,-modulus 输出证书公钥模数,可与 openssl rsa -modulus 的输出比对,用于确认私钥与证书成对:

cd /www/wdlinux/nginx/conf/ssl/example.com
# 两条命令的输出必须逐字节相同
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem  | openssl md5
# 期望:(stdin)= 3f:1a:...:9c   ← 两行一致
# 不一致的典型后果:nginx: SSL_CTX_use_PrivateKey() failed (SSL: key values mismatch)

第三步:域名与有效期。据 Let’s Encrypt 文档,其证书有效期固定为 90 天,且到期前 30 天可续期;商业 DV 证书常见 12 个月。subject 的 CN 与 SAN 必须同时覆盖 example.com 与 www.example.com,只写 CN 的老式证书在现代浏览器(Chrome 58+)会因缺少 SAN 报 NET::ERR_CERT_COMMON_NAME_INVALID:

openssl x509 -in fullchain.pem -noout -subject -dates -ext subjectAltName
# subject=CN = example.com
# notBefore=Mar  1 00:00:00 2025 GMT
# notAfter=May 30 00:00:00 2025 GMT
grep -c 'BEGIN CERTIFICATE' fullchain.pem   # 期望 2 或 3

第四步:链数量与引擎类型决定文件拆分方式。据 Apache HTTP Server 2.4 的 mod_ssl 文档,SSLCertificateChainFile 自 2.4.8 起标记为废弃,2.4.18 起可直接把中间证书写入 SSLCertificateFile;而 Nginx 从始至终要求 ssl_certificate 指向”站点证书+中间证书”的合并文件。两者不可混用:

Web 引擎 推荐文件组合 关键指令 链文件处理
Nginx(任意版本) fullchain.pem + privkey.pem ssl_certificate / ssl_certificate_key 中间证书合并进 fullchain.pem
Apache ≥ 2.4.18 fullchain.pem + privkey.pem SSLCertificateFile / SSLCertificateKeyFile 可省略 SSLCertificateChainFile
Apache 2.4.8 ~ 2.4.17 cert.pem + chain.pem + privkey.pem 三个指令全写 必须单独指定链

第五步:确认 wdCP 跑的是哪种引擎并备份 vhost。wdCP v3 默认是 nginx 做前端、Apache 做后端的组合,两个 vhost 都要改、都要备份:

ps aux | grep -E 'nginx|httpd' | grep -v grep
# 两个进程都在 → nginx+apache 组合,需改两套配置

cp /www/wdlinux/nginx/conf/vhost/example.com.conf  /root/example.com.nginx.conf.bak.$(date +%F)
cp /www/wdlinux/apache/conf/vhost/example.com.conf /root/example.com.apache.conf.bak.$(date +%F)

wdCP SSL 证书安装完整步骤(以 v3.3 的 Nginx 站点为例,分步编号)

在 wdCP v3.3 里做 SSL 证书安装,最容易踩坑的不是证书本身,而是”到底该改 Nginx 还是 Apache”——因为 wdCP 默认是 Nginx 监听 80、Apache 监听 88 的组合模式(面板自身跑在 8080)。下面按可回滚的顺序分 6 步走,每步都给出可直接复制的命令。

步骤 1:先备份,保证 1 分钟内能回滚。wdCP 的 vhost 是纯文本,改坏了最快恢复方式就是覆盖回去。据 wdCP 官方文档,站点配置目录固定为 /www/wdlinux/nginx/conf/vhost/ 与 /www/wdlinux/apache/conf/vhost/:

# 备份 Nginx 与 Apache 两套 vhost,文件名带日期便于区分
cp -a /www/wdlinux/nginx/conf/vhost/example.com.conf  /root/example.com.conf.$(date +%F)
cp -a /www/wdlinux/apache/conf/vhost/example.com.conf /root/example.com.apache.$(date +%F)
# 回滚示例(1 分钟内可完成)
# cp -a /root/example.com.conf.2025-01-01 /www/wdlinux/nginx/conf/vhost/example.com.conf && service nginx reload

步骤 2:上传证书。在面板「网站管理 → 站点 → 修改 / SSL」中,把 fullchain.pem 的全文粘进”证书/公钥”框,privkey.pem 粘进”私钥”框。据 Let’s Encrypt 文档,fullchain.pem 必须是”服务器证书 + 中间证书”的串联顺序,只贴 cert.pem 会在部分安卓/旧客户端上报链不完整。若你的面板版本没有 SSL 入口,直接用 WinSCP 上传到:

mkdir -p /www/wdlinux/nginx/conf/ssl/example.com
# 上传后确认权限:Nginx worker 以 www 用户运行,私钥必须可读
chmod 600 /www/wdlinux/nginx/conf/ssl/example.com/privkey.pem
chmod 644 /www/wdlinux/nginx/conf/ssl/example.com/fullchain.pem

步骤 3:写 443 的 server 块。保留原有 80 的 server 块不动,在其中加一行 301,再新增一个 443 块。注意 wdCP v3.3 自带的 Nginx 为 1.8.x/1.14.x,ssl on; 指令自 1.15.0 起已废弃,统一用 listen 443 ssl;:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;   # 强制跳转,注意用 $host 保留域名
}
server {
    listen 443 ssl;
    server_name example.com www.example.com;
    ssl_certificate     /www/wdlinux/nginx/conf/ssl/example.com/fullchain.pem;
    ssl_certificate_key /www/wdlinux/nginx/conf/ssl/example.com/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;    # 默认值通常是 TLSv1 TLSv1.1 TLSv1.2,建议收窄
    ssl_session_cache   shared:SSL:10m;
    location / {
        proxy_pass http://127.0.0.1:88;     # 组合模式下后端仍是 Apache 的 88 端口
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto https;
    }
}

步骤 4:确认 443 到底由谁监听。这是 wdcp ssl证书安装 中最关键的一次判断,先看事实再动手:

ss -lntp | grep ':443'
# 输出示例:LISTEN 0 128 *:443 *:* users:(("nginx",pid=1234,fd=6))
443 监听进程 SSL 终止位置 要改的文件 注意事项
nginx Nginx nginx/conf/vhost/example.com.conf Apache 侧不要再配 SSLEngine on,否则 88 端口回源会二次加密
httpd Apache apache/conf/vhost/example.com.conf 必须删掉 Nginx 的 listen 443 ssl,否则报 bind() to 0.0.0.0:443 failed (98: Address already in use)

步骤 5:语法检查后再重载。不要跳过 -t,wdCP 自带的 Nginx 不会在 reload 前自动校验:

nginx -t -c /www/wdlinux/nginx/conf/nginx.conf
# 期望输出:nginx: configuration file ... test is successful
service nginx reload
httpd -t -f /www/wdlinux/apache/conf/httpd.conf   # 仅 Apache 终止 SSL 时需要
service httpd reload

常见真实报错:PEM_read_bio_X509_AUX() failed ... no start line 表示证书框里贴了私钥内容;SSL_CTX_use_PrivateKey_file() failed (SSL: key values mismatch) 表示证书与私钥不配对,可用 openssl x509 -noout -modulus -in fullchain.pem | md5sum 与 openssl rsa -noout -modulus -in privkey.pem | md5sum 对比两串哈希是否一致。

步骤 6:放行端口并刷新面板缓存。本机防火墙默认只放行 80/8080,443 需要手动加规则;云服务器还要在安全组放行 443(入方向 TCP):

iptables -I INPUT -p tcp --dport 443 -j ACCEPT
service iptables save          # CentOS 6 及 wdCP 自带规则集生效
service wdcp restart           # 只重启面板,不重启网站进程

若面板仍显示”未开启 SSL”,多半是面板自身缓存未刷新而非配置失败,重启 wdcd/wdcp 服务后重新进入站点页即可。至此 wdcp ssl证书安装 的主体流程完成,下一步才是验证证书链与 HTTPS 跳转是否符合 RFC 8446 与 Mozilla 推荐配置。

Nginx 与 Apache 配置片段:可直接替换的参数与版本注意事项

先说结论:在 wdCP v3.3 上,证书路径由面板决定,但 ssl_certificate、SSLCertificateFile 这些指令必须手工写进 vhost 文件;面板不会替你补全 OCSP 与 HSTS 参数。下面按“Nginx → Apache → 强制跳转 → 安全加固”的顺序给出可直接替换的片段。

Nginx 1.8.1 的 443 server 块该怎么写?

wdCP 的 Nginx vhost 位于 /www/wdlinux/nginx/conf/vhost/example.com.conf,把 80 的 server 复制一份改为 443 即可。证书建议放在面板之外的自建目录,避免升级被覆盖:

# 文件:/www/wdlinux/nginx/conf/vhost/example.com.conf
server {
    listen 443 ssl;                      # Nginx < 1.15 用这一行;1.15+ 可拆成 listen 443; ssl on; 已废弃
    server_name example.com www.example.com;

    ssl_certificate     /www/wdlinux/nginx/conf/ssl/example.com/fullchain.pem;  # 必须含中间证书
    ssl_certificate_key /www/wdlinux/nginx/conf/ssl/example.com/privkey.pem;    # 权限 600,属主 root

    ssl_protocols       TLSv1.2;         # wdCP v3.3 默认 OpenSSL 1.0.2,不能写 TLSv1.3
    ssl_ciphers 'ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384';
    ssl_prefer_server_ciphers on;

    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 10m;             # 默认 5m,握手复用率提升后调大

    add_header Strict-Transport-Security 'max-age=31536000' always;  # RFC 6797 定义,仅 HTTPS 响应生效
    ssl_stapling on;                     # 默认 off
    ssl_stapling_verify on;              # 默认 off
    ssl_trusted_certificate /www/wdlinux/nginx/conf/ssl/example.com/chain.pem;

    root /www/web/example_com/public_html;
    index index.php index.html;
}

为什么写 TLSv1.3 会直接失败? 因为 ssl_protocols 的取值由编译时的 OpenSSL 决定。wdCP v3.3 自带 OpenSSL 1.0.2,不认这个枚举值,nginx -t 会报:

# /www/wdlinux/nginx/sbin/nginx -t
nginx: [emerg] invalid value "TLSv1.3" in /www/wdlinux/nginx/conf/vhost/example.com.conf:12
nginx: configuration file /www/wdlinux/nginx/conf/nginx.conf test failed

只有当 openssl version 显示 1.1.1 及以上、且 Nginx ≥ 1.14 时,才可写成 ssl_protocols TLSv1.2 TLSv1.3;。据 Mozilla Server Side TLS 指南(v5.7 配置生成器),生产环境应禁用 TLS 1.0/1.1,仅保留 TLS 1.2 的 AEAD 套件,这既满足 PCI DSS 也避开已公开的 BEAST/POODLE 类问题。

Apache 2.4.18 的 443 vhost 有何不同?

# 文件:/www/wdlinux/apache/conf/vhost/example.com.conf
<VirtualHost *:443>
    DocumentRoot /www/web/example_com/public_html
    ServerName example.com
    SSLEngine on                                   # 2.4 必须显式开启
    SSLCertificateFile      /www/wdlinux/apache/conf/ssl/example.com/cert.pem
    SSLCertificateKeyFile   /www/wdlinux/apache/conf/ssl/example.com/privkey.pem
    SSLCertificateChainFile /www/wdlinux/apache/conf/ssl/example.com/chain.pem  # 2.4.8 起也可并入 cert.pem
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1         # 注意是“减法”语法,与 Nginx 相反
    SSLCipherSuite ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384
    SSLHonorCipherOrder on
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

# 生效与验证
/www/wdlinux/apache/bin/httpd -t && service httpd restart
用途 Nginx 指令 Apache 指令 默认值
证书链 ssl_certificate(fullchain) SSLCertificateChainFile 无
协议控制 ssl_protocols 白名单 SSLProtocol 黑名单 Nginx 跟随 OpenSSL
会话超时 ssl_session_timeout SSLSessionCacheTimeout 5m / 300s
OCSP 装订 ssl_stapling SSLUseStapling on off

强制 HTTPS:为什么会出现 301 循环? Nginx 在 80 的 server 里写 return 301 https://$host$request_uri; 即可;Apache 用 Redirect permanent / https://example.com/,或 RewriteRule ^(.*)$ https://%{HTTP_HOST}$1 [R=301,L]。若同时打开 wdCP 面板的“强制 HTTPS”开关又手写规则,两层跳转互相指向,浏览器报 ERR_TOO_MANY_REDIRECTS——二选一,改完务必用 curl -I http://example.com 确认只出现一次 301 且 Location 正确。

OCSP 装订为何显示 tryLater? 因为 ssl_trusted_certificate 指向的链不完整或缺少根证书,Nginx 无法校验响应签名。按 Let’s Encrypt 文档,fullchain.pem 已含中间证书,但 ssl_trusted_certificate 需要的是签发者链,通常直接用 chain.pem 即可。验证命令:

openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -i "OCSP Response Status"
# 期望输出:OCSP Response Status: successful (0x0)

面板上传、手动改 vhost、CDN 卸载怎么选?wdCP 场景对比表

只有一个站点,面板上传、手动改 vhost、CDN 卸载,到底选哪个?先给结论:单站点且面板里有 SSL 入口,就走面板上传;域名数量在 5 个以上或需要泛域名,直接维护 vhost 文件更可控;日 PV 超过 10 万再考虑把 TLS 终止放到 CDN。下表以 wdCP v3.3 + 单域名 DV 证书为基准做横向对比,选择哪种方式做 wdCP SSL 证书安装,基本取决于站点数量和运维习惯。

方案 适用场景 关键配置 维护成本 注意事项
面板 SSL 上传 单站点、单域名 后台粘贴 fullchain + key 低 面板版本不同,上传后仍要 nginx -t
手动改 vhost 多域名、泛域名、组合模式 编辑 /www/wdlinux/nginx/conf/vhost/*.conf 中 改错需回滚,至少备份 1 份配置
CDN 卸载 SSL 高并发、跨地域 源站可 HTTP:80,CDN 回源 443/80 中 需同步证书到 CDN,注意回源 Host
Apache 直接 SSL 无 Nginx 或 Apache 单引擎 SSLEngine on + 443 vhost 中 确认 443 未被 Nginx 占用

为什么”面板上传成功”不等于配置生效?wdCP 面板只是把证书内容写进 vhost 再触发 reload,不同小版本写入的字段名和证书路径并不一致;粘贴 fullchain 时漏掉中间证书,或顺序颠倒(按 RFC 8555 / CA 规范,站点证书在前、中间证书在后,根证书可省略),会让部分 Android 7 以下与旧 Java 客户端握手失败。上传后必须手工校验:

# wdCP v3.3 默认路径;先做语法检查,再平滑重载(不要直接 restart)
/www/wdlinux/nginx/sbin/nginx -t
# 期望输出:nginx: configuration file /www/wdlinux/nginx/conf/nginx.conf test is successful
/www/wdlinux/nginx/sbin/nginx -s reload

# 手动改 vhost 前先备份,改错可一键回滚
cp /www/wdlinux/nginx/conf/vhost/example.com.conf 
   /www/wdlinux/nginx/conf/vhost/example.com.conf.bak.$(date +%F)

组合模式下为什么一开 443 就起不来?wdCP 的 nginx+apache 组合模式里,Nginx 默认监听 80 并反代到 Apache 的 8080/88。若在 Nginx 和 Apache 的 vhost 里同时写 listen 443 ssl,第二个进程会抢端口失败,报错原文是 nginx: [emerg] bind() to 0.0.0.0:443 failed (98: Address already in use)。排查只需一条命令,确认 443 只有一个进程在听:

# 查看 443 监听者;正常应只有 nginx(或只有 httpd),不能两者并存
ss -lntp | grep ':443'
# 冲突时典型输出:
# LISTEN 0 128 0.0.0.0:443 0.0.0.0:* users:(("nginx",pid=1234,...))
# LISTEN 0 128 0.0.0.0:443 0.0.0.0:* users:(("httpd",pid=5678,...))

wdCP v3.3 能开 TLS 1.3 吗?不能。面板自带 Nginx 1.8.1、OpenSSL 1.0.1e 级别组件;而 TLS 1.3 由 RFC 8446 定义,需 OpenSSL 1.1.1 及以上才实现,Mozilla 的 Server Side TLS 推荐配置也早已把 TLS 1.3 列为默认项。想同时拿到 TLS 1.3 与 HTTP/2,要么升级到 Nginx 1.14+ 并确认 OpenSSL 1.1.1+,要么把 TLS 终止放到 CDN 或负载均衡上。版本自查:

# 一次性看清 Nginx 版本与编译时的 OpenSSL 版本
/www/wdlinux/nginx/sbin/nginx -V 2>&1 | grep -E 'nginx version|built with OpenSSL'
# 典型输出:nginx version: nginx/1.8.1
#           built with OpenSSL 1.0.1e-fips 11 Feb 2013   (不支持 TLS 1.3)

成本和时间大概是多少?据 Let’s Encrypt 文档,DV 证书有效期 90 天、官方建议剩余 30 天时续期,用 acme.sh 自动续期一次约 1-2 分钟,费用 0 元;商业 DV 常见 0-200 元/年,OV 约 1000-3000 元/年、签发需 1-3 个工作日。单个站点手动完成 wdCP SSL 证书安装(含上传、改配置、验证)约 10-20 分钟。

CDN 卸载要注意什么?源站可以只保留 HTTP:80,由 CDN 回源 443 或 80;但证书必须同步到 CDN 节点,且回源 Host 头要与源站 server_name 完全一致,否则会命中默认站点、返回不属于该域名的证书。源站若同时保留 HTTPS,回源协议要和源站监听端口对齐,避免”CDN 回源 443、源站只开 80″这类静默 502。

常见报错与排查:key values mismatch、no start line、443 不通怎么处理

证书装完 nginx -t 直接红字退出?先按报错原文对号入座。下面六类报错覆盖了 wdCP 面板上 wdcp ssl证书安装 绝大多数失败场景,每条都给出可直接复制的定位命令,以及 wdCP v3(Nginx 与 Apache 双引擎并存)下的配置路径。

为什么报 key values mismatch?报错原文:nginx: [emerg] SSL_CTX_use_PrivateKey_file("/www/wdlinux/nginx/conf/ssl/example.com/privkey.pem") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。含义是 ssl_certificate 与 ssl_certificate_key 不是同一对密钥,常见于续签后只替换了证书、私钥仍留旧订单,或上传时误拿了上一次签发包的 key。用模数比对,两行 md5 必须完全一致:

# RSA 证书:比对证书与私钥的 modulus(OpenSSL 1.0.2+ 均支持)
openssl x509 -noout -modulus -in /www/wdlinux/nginx/conf/ssl/example.com/cert.pem | openssl md5
openssl rsa  -noout -modulus -in /www/wdlinux/nginx/conf/ssl/example.com/privkey.pem | openssl md5

# ECC 证书没有 modulus,改用公钥指纹比对
openssl x509 -in cert.pem -noout -pubkey | openssl md5
openssl pkey -in privkey.pem -pubout | openssl md5

不一致就回到同一签发订单的压缩包重新上传 privkey.pem,不要从旧证书目录里拷贝 key 凑数。

为什么报 no start line?原文:PEM_read_bio_X509_AUX(...) failed (SSL: error:0906D06C:PEM routines:PEM_read_bio:no start line)。这几乎总是文件根本不是 PEM,或者把 CSR 当证书贴了进去。用首行自检:

head -1 /www/wdlinux/nginx/conf/ssl/example.com/cert.pem
# 正确:-----BEGIN CERTIFICATE-----
# 若为 -----BEGIN CERTIFICATE REQUEST----- 说明传的是 CSR,需换正式证书文件

为什么报 unknown directive “ssl”?说明当前 Nginx 未编译 http_ssl_module。wdCP 服务器上可能同时存在系统 nginx 与面板自带 nginx,务必确认启动的是哪一个:

nginx -V 2>&1 | grep -o with-http_ssl_module
# 无输出 = 未编译 SSL 模块;改用 wdCP 自带二进制
/www/wdlinux/nginx/sbin/nginx -V 2>&1 | grep -o with-http_ssl_module

Apache 报 file does not exist or is empty 怎么办?原文:httpd: Syntax error on line 33 of /www/wdlinux/apache/conf/vhost/example.com.conf: SSLCertificateFile: file '/www/wdlinux/apache/conf/ssl/example.com/cert.pem' does not exist or is empty。先看文件大小再逐级查权限(Apache 以 www 用户运行,父目录缺 x 位同样读不到):

ls -l /www/wdlinux/apache/conf/ssl/example.com/cert.pem
namei -l /www/wdlinux/apache/conf/ssl/example.com/cert.pem   # 逐级显示每一层权限

浏览器报 NET::ERR_CERT_AUTHORITY_INVALID、curl 报 (60) unable to get local issuer certificate?这是缺中间证书。据 RFC 5280 第 6.1 节,服务器有义务发送中间证书以便客户端构建到可信根的完整链。检查与配置差异如下:

grep -c 'BEGIN CERTIFICATE' /www/wdlinux/nginx/conf/ssl/example.com/fullchain.pem
# 期望 2~3(叶子证书 + 中间证书,含根则 3);为 1 说明只上传了叶子证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | grep -c 'BEGIN CERTIFICATE'
配置项 Nginx(wdCP v3 默认引擎) Apache 2.4(wdCP v3 可切换)
证书文件 ssl_certificate 指向 fullchain.pem(证书+中间证书拼接) SSLCertificateFile 叶子证书
中间证书 拼进 fullchain.pem,无独立指令 SSLCertificateChainFile(2.4.8 起已废弃,可直接并入 SSLCertificateFile)
私钥 ssl_certificate_key SSLCertificateKeyFile
语法检查 nginx -t apachectl -t 或 /www/wdlinux/apache/bin/apachectl -t

ERR_SSL_VERSION_OR_CIPHER_MISMATCH 或 sslv3 alert handshake failure 怎么处理?这是协议版本或加密套件协商失败。Nginx 1.23.0 起 ssl_protocols 默认值已从 TLSv1 TLSv1.1 TLSv1.2 改为 TLSv1.2 TLSv1.3(据 Nginx 官方文档);更老的 wdCP 内置版本仍可能默认放开 TLSv1。建议显式声明,并保留 Mozilla 推荐的现代套件:

ssl_protocols TLSv1.2 TLSv1.3;                 # TLSv1.3 需 OpenSSL 1.1.1+ 与 Nginx 1.13.0+
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256;
ssl_prefer_server_ciphers on;                 # 默认 off,建议开启以优先服务端套件顺序
ssl_session_cache shared:SSL:10m;             # 默认 none,10m 约可缓存 4 万会话

若仍有 IE8/Android 4.x 等旧客户端接入需求,应单独建一个仅开 TLSv1 的 server 块按 UA 分流,而不是在全局把 TLSv1 重新打开——据 Let’s Encrypt 与 Mozilla SSL 配置生成器的建议,TLSv1.0/1.1 已于 2021 年被主流浏览器弃用。

怎么确认 wdCP 的 SSL 配置真的生效?四层验证命令

第一层:443 端口上到底是谁在监听?

在 wdCP 里装完证书却没生效,八成先卡在这一步。先用 ss 看清监听进程,再决定是去改 Nginx 配置还是 Apache 配置——wdCP v3.3 默认用 Nginx 1.14/1.16 做前端,Apache 2.4 只做后端,此时 443 上应该只有 nginx,如果看到 httpd 独占 443,说明站点被切换成了纯 Apache 模式。

# 1) 谁在监听 443(wdCP 的 nginx 与 httpd 通常只应有一个)
ss -lntp | grep ':443'
# 期望:users:(("nginx",pid=12345,fd=6))  或  ("httpd",pid=...)
# 无任何输出 = 443 没人监听,先查 ssl 配置段是否被注释

# 2) HTTP 层能否握手(-I 发 HEAD 请求)
curl -I https://example.com
# 期望首行:HTTP/1.1 200 OK 或 HTTP/1.1 301 Moved Permanently
# 报错 curl: (7) Failed to connect to example.com port 443: Connection refused
#   → 证书没写进当前 vhost,或改完配置没执行 service nginx reload
# 若站点对 HEAD 返回 405,改用:
curl -s -o /dev/null -w '%{http_code}n' https://example.com

第二层:拿到的证书是不是你刚装的那张?

关键参数是 -servername,它负责发送 SNI 扩展(见 RFC 6066)。wdCP 是多站点共用一个 IP 的典型场景,不加 SNI 时 OpenSSL 只会返回该 IP 上第一个 vhost 的证书,于是你看到”证书装对了但浏览器仍报错”的假象。据 OpenSSL 官方文档,s_client 的 -servername 正是用于指定 SNI 主机名。

openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates
# 核对 subject 里的 CN 以及是否覆盖所有域名(SAN 需另用 -ext subjectAltName 查看)
# notAfter 必须晚于当前时间;Let's Encrypt 证书有效期现为 90 天
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -ext subjectAltName

第三层:协议版本与加密套件是否符合预期?

Nginx 在 1.23.4 之前 ssl_protocols 默认值是 TLSv1 TLSv1.1 TLSv1.2,从 1.23.4 起改为 TLSv1.2 TLSv1.3;Apache 2.4 的 SSLProtocol 默认是 all -SSLv3。要禁用 TLS 1.1,必须显式写进 vhost,否则它依然可用。Mozilla SSL Configuration Generator 的 intermediate 配置即要求 TLS 1.2 起步。

# TLS 1.2 应成功
curl -vI --tls1.2 https://example.com
# TLS 1.1 应失败(报 alert protocol version 或 handshake failure 才算达标)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null

第四层:证书链、OCSP 与 HSTS 是否完整?

# 链与 OCSP 装订(若未开启 stapling 会显示 no response sent,属正常)
openssl s_client -connect example.com:443 -servername example.com -status /dev/null 
  | grep -i 'OCSP Response Status'
# 权威判定看 SSL Labs 的 Chain issues 是否为 None:
# https://www.ssllabs.com/ssltest/analyze.html?d=example.com

# 80 端口是否 301 到 https
curl -sI http://example.com | grep -i '^location'
# 期望:Location: https://example.com/

# HSTS 头(RFC 6797)
curl -sI https://example.com | grep -i strict-transport-security
# 期望:max-age=31536000

Nginx 里写 add_header Strict-Transport-Security "max-age=31536000" always; 时,always(1.7.5+ 可用)保证 4xx/5xx 响应也带该头,否则错误页会漏掉 HSTS,这是 wdCP SSL 证书安装完成后最容易被忽略的一处细节。

验证层 判定命令 通过标准 常见失败原因
进程端口 ss -lntp | grep ':443' 有 nginx 或 httpd 监听 vhost 未含 ssl 段、未 reload
证书内容 openssl x509 -noout -dates CN/SAN 匹配且未过期 缺 -servername、多站点串证
协议版本 openssl s_client -tls1_1 失败即合规 未显式关闭旧协议
链与 HSTS SSL Labs + curl -sI Chain issues=None、有 STS 头 缺中间证书、add_header 漏 always

续期与回滚:Let's Encrypt 90 天证书和商业证书在 wdCP 上怎么维护

Let’s Encrypt 的 90 天证书在 wdCP 上到底要不要手动续? 不需要手动“到期再换”,但必须确认自动续期真的在跑。据 Let’s Encrypt 官方文档,其证书有效期固定为 90 天,官方建议在到期前 30 天完成续期;acme.sh 默认在签发后约 60 天触发续期,也就是剩余约 30 天时执行。在 wdCP 上完成 wdcp ssl证书安装 只是起点,续期后的“写文件 + reload”才是决定 HTTPS 是否真正生效的关键。

以 wdCP v3 默认路径为例,Nginx 站点用 --install-cert 把新证书落到站点目录,并让 acme.sh 在续期成功后自动重载 Nginx:

# 将 example.com 的证书安装到 wdCP 的 Nginx 站点目录
# --reloadcmd 只在证书真正更新后执行;路径必须与 vhost 中 ssl_certificate 指向一致
acme.sh --install-cert -d example.com 
  --key-file /www/wdlinux/nginx/conf/ssl/example.com/privkey.pem 
  --fullchain-file /www/wdlinux/nginx/conf/ssl/example.com/fullchain.pem 
  --reloadcmd 'service nginx reload'

# Apache 站点则换成:
# --key-file /www/wdlinux/apache/conf/ssl/example.com/privkey.pem
# --fullchain-file /www/wdlinux/apache/conf/ssl/example.com/fullchain.pem
# --reloadcmd 'service httpd reload'

怎么确认自动续期没有“悄悄失效”? 先看 cron,再看 acme.sh 自己记录的下次续期时间。acme.sh 安装时默认写入一条每天执行的 cron(分钟和小时随机),不要只依赖 wdCP 面板提醒:

crontab -l | grep acme.sh
# 典型输出:
# 17 3 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null

acme.sh --list
# 关注 Renew 列,即 Next renewal time;示例:
# Main_Domain  KeyLength  SAN_Domains      CA           Created               Renew
# example.com  ec-256     www.example.com  LetsEncrypt  2025-01-01T00:00:00Z  2025-03-02T00:00:00Z

商业证书怎么换、怎么回滚? 商业证书通常 1 年,CA/Browser Forum 规定公有 TLS 证书最长 398 天,建议到期前 30–60 天重新签发。换证前先备份旧证书、私钥和 vhost;覆盖 fullchain.pem 与 privkey.pem 后必须先 nginx -t 再 reload,否则配置错误会让整站 443 直接不可用。

# 1) 换证前备份(Nginx 示例;Apache 把 nginx 换成 apache)
BK=/root/ssl-backup/$(date +%F)
mkdir -p "$BK"
cp -a /www/wdlinux/nginx/conf/ssl/example.com/fullchain.pem "$BK"/
cp -a /www/wdlinux/nginx/conf/ssl/example.com/privkey.pem   "$BK"/
cp -a /www/wdlinux/nginx/conf/vhost/example.com.conf /root/example.com.conf.$(date +%F)

# 2) 覆盖商业证书后先语法检查,再重载
/www/wdlinux/nginx/sbin/nginx -t && service nginx reload

# 3) 回滚 vhost 配置(按实际备份日期替换 2025-01-01)
cp /root/example.com.conf.2025-01-01 /www/wdlinux/nginx/conf/vhost/example.com.conf 
  && nginx -t && service nginx reload

# 4) 若证书文件覆盖错,从备份恢复并核对证书/私钥是否配对
cp -a /root/ssl-backup/2025-01-01/fullchain.pem /www/wdlinux/nginx/conf/ssl/example.com/
cp -a /root/ssl-backup/2025-01-01/privkey.pem   /www/wdlinux/nginx/conf/ssl/example.com/
openssl x509 -noout -modulus -in /www/wdlinux/nginx/conf/ssl/example.com/fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in /www/wdlinux/nginx/conf/ssl/example.com/privkey.pem   | openssl md5
# ECC 证书没有 modulus,改用公钥比对:
# openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
# openssl pkey -pubout -in privkey.pem | openssl md5
维护项 Let’s Encrypt 商业证书
有效期 固定 90 天 通常 1 年,最长 398 天
续期触发 到期前约 30 天;acme.sh 默认签发后 60 天触发,--days 可调 到期前 30–60 天人工重新签发
wdCP 落地 acme.sh --install-cert 自动写文件并 reload 手动覆盖 fullchain.pem/privkey.pem,再 nginx -t && reload
回滚依据 acme.sh 备份、旧 fullchain/privkey /root/ssl-backup/ 与带日期的 vhost 备份
主要风险 cron 未执行、reloadcmd 失败导致旧证书继续服务 中间证书链漏拷、私钥与证书不匹配

有没有不依赖面板的到期监控? 有。用 openssl s_client 读取线上证书的 notAfter(RFC 5280 定义),每天算剩余天数,低于 15 天告警:

# /root/check_ssl_expiry.sh
#!/bin/bash
DOMAIN="example.com"
END=$(echo | openssl s_client -connect ${DOMAIN}:443 -servername ${DOMAIN} 2>/dev/null 
  | openssl x509 -noout -enddate | cut -d= -f2)
END_TS=$(date -d "$END" +%s)
NOW_TS=$(date +%s)
DAYS=$(( (END_TS - NOW_TS) / 86400 ))
echo "$(date '+%F %T') $DOMAIN 剩余 $DAYS 天"
[ "$DAYS" -lt 15 ] && echo "ALERT: $DOMAIN 证书剩余 $DAYS 天" | mail -s "SSL 告警" ops@example.com

# 加入 cron:每天 06:00 检查
# 0 6 * * * /bin/bash /root/check_ssl_expiry.sh >> /var/log/ssl_expiry.log 2>&1

把 wdcp ssl证书安装 的续期、回滚和监控串成闭环:crontab -l | grep acme.sh 确认任务存在,acme.sh --list 核对 Renew 时间,再用上面的 openssl s_client 脚本独立验证线上证书。这样即使 wdCP 面板没有提醒,也能在证书过期前 15 天收到可执行的告警,而不是等到浏览器报 NET::ERR_CERT_DATE_INVALID 才发现。

面板入口只负责把证书内容写入配置或证书目录,不同 wdCP v2/v3 版本行为不一致。上传后仍要用 nginx -t 检查是否生成 ssl_certificate 与 ssl_certificate_key,并确认 nginx+apache 组合下 443 由谁监听。若面板没有写入 443 server 块,就需要手动补 vhost。

不需要重启服务器。Nginx 用 service nginx reload,Apache 用 service httpd reload 即可平滑加载新配置;只有面板界面异常时才执行 service wdcp restart,它只重启面板,不影响网站。

Nginx 的 ssl_certificate 建议用 fullchain.pem,里面包含站点证书和中间证书;Apache 2.4.18 可以用 cert.pem 配 SSLCertificateFile,再用 chain.pem 配 SSLCertificateChainFile。判断标准是 grep -c 'BEGIN CERTIFICATE' fullchain.pem 为 2 或 3,且 SSL Labs 的 Chain issues 为 None。

常见原因是只部署了域名证书,没有发送中间证书,桌面浏览器可能缓存过中间证书而手机没有。把 ssl_certificate 换成 fullchain.pem,或在 Apache 增加 SSLCertificateChainFile,再执行 nginx -t 与 reload。

wdCP v3.3 组件较旧,常见 Nginx 1.8.1 与 OpenSSL 1.0.2,不支持 TLS 1.3,证书上传后常需手动检查 vhost;宝塔面板版本较新,通常提供 Let's Encrypt 一键申请与自动续期。若坚持 wdCP,建议用 acme.sh 做续期并定期跑 openssl s_client 验证。

这是证书与私钥不匹配。分别执行 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 和 openssl rsa -noout -modulus -in privkey.pem | openssl md5,两个 md5 必须一致。不一致就重新下载同一订单的私钥,不要混用旧证书的 key。

用 acme.sh 申请后执行 acme.sh –install-cert,把 –key-file 与 –fullchain-file 指向 wdCP 的证书目录,并设置 –reloadcmd 'service nginx reload'。acme.sh 会写入 cron 每天检查,90 天有效期通常会在到期前 30 天自动续期;用 acme.sh –list 查看下次续期时间。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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