WDCP 环境 HTTPS 配置与 SSL 证书续费完整指南(含 Nginx/Apache 配置、398 天与 90 天有效期规则、真实报错排查)
一、问题背景与根因:2018 年的说法今天必须重写
原文写于 2018 年,当时 Chrome 68 刚刚开始把 HTTP 页面标记为“不安全”,SSL 证书普遍还能一次签 2 年。今天规则已经变了三件事,直接决定了 WDCP 老服务器上 HTTPS 为什么“配了不生效、续了还过期”:
- 证书有效期上限:CA/Browser Forum 规定公有可信证书单次签发不得超过 398 天(2020-09-01 起强制执行),Chrome、Safari 对超过 398 天的证书直接拒绝握手,不再是“警告”。
- 免费证书周期:Let’s Encrypt 固定 90 天,ACME v1 早已下线,必须使用 ACME v2 客户端(acme.sh、certbot 2.x 及以上)。国内云厂商的免费 DV 证书也已普遍缩短为 90 天。
- 面板行为:WDCP(wdlinux)v3 的站点 vhost 模板默认只写 80 端口,面板里的 SSL 开关对多域名、泛域名支持有限,且续费后不会自动 reload Web 服务。
在 WDCP 上 HTTPS 起不来的根因通常只有四条:
- 模块缺失:Apache 没 LoadModule ssl_module,或 nginx 编译时未带 –with-http_ssl_module,配置写了也不生效;
- vhost 未覆盖:证书传上去了,但站点真正读取的是 /www/wdlinux/nginx/conf/vhost/xxx.conf,文件里没有 listen 443 ssl;
- 证书链不全:只部署了域名证书、没带中间证书,PC 上正常,安卓微信里报“证书无效”;
- 续费未生效:新证书已下载但没 reload,或续费时复用了旧 CSR,导致私钥与证书不匹配,nginx 直接启动失败。
下面按“环境检查 → 签发/续费 → 写配置 → 排错 → 验证”的顺序给出可直接执行的命令,路径以 WDCP v3 默认安装目录 /www/wdlinux 为准,nginx 与 apache 双引擎共存时两者都要改。
二、动手前的环境检查(5 分钟排除 80% 的坑)
WDCP 常见组合是 nginx 做前端、apache 做后端(80 端口由 nginx 监听并反代到 apache 的 88 端口),也可能是纯 nginx 或纯 apache。先确认三件事:引擎、SSL 模块、端口占用。
# 1. 系统与面板版本
cat /etc/redhat-release
cat /www/wdlinux/wdcp/version.txt 2>/dev/null
# 2. Web 引擎与 SSL 模块是否编译进去
/www/wdlinux/nginx/sbin/nginx -V 2>&1 | tr ' ' 'n' | grep -E 'ssl|http_v2'
/www/wdlinux/apache/bin/httpd -M 2>/dev/null | grep -E 'ssl_module|socache_shmcb'
# 3. OpenSSL 版本(决定能否用 -addext、TLS1.3)
openssl version -a
# 4. 端口监听情况
ss -lntp | grep -E ':(80|443|88)b'
# 5. 站点 vhost 目录(两个都要看)
ls -l /www/wdlinux/nginx/conf/vhost/
ls -l /www/wdlinux/apache/conf/vhost/
判读标准:
- nginx -V 输出里必须有
--with-http_ssl_module,否则要换官方编译版或重新编译; - httpd -M 输出里必须有
ssl_module和socache_shmcb_module(Apache 2.4 的 SSL session 缓存依赖它); - OpenSSL 需 ≥ 1.1.1 才能用 TLSv1.3 与
-addext参数; - 443 端口若被其他进程占用,后续
bind() to 0.0.0.0:443 failed就是这个原因。
改配置前先备份,WDCP 面板“站点管理”保存时会重写 vhost 文件,务必留后路:
mkdir -p /root/ssl_bak/$(date +%F)
cp -a /www/wdlinux/nginx/conf/vhost /root/ssl_bak/$(date +%F)/nginx_vhost
cp -a /www/wdlinux/apache/conf/vhost /root/ssl_bak/$(date +%F)/apache_vhost
mkdir -p /www/ssl/example.com
另外确认防火墙:firewall-cmd --add-service=https --permanent && firewall-cmd --reload,或 iptables -I INPUT -p tcp --dport 443 -j ACCEPT;云服务器还要在安全组放行 443,否则本地配置全对,外网依旧连不上。
三、生成 CSR / 私钥并签发证书
先明确一点:续费不是“再买一次”,而是用同一把私钥重新签发。如果服务商要求上传 CSR,建议把私钥和 CSR 生成在服务器本地,私钥永不出网。
cd /www/ssl/example.com
# 生成 2048 位私钥 + CSR,并直接写入 SAN(OpenSSL ≥ 1.1.1)
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
chmod 600 example.com.key
# 校验 CSR 内容
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
如果 OpenSSL 低于 1.1.1,需写临时配置 openssl.cnf,在 [v3_req] 段加 subjectAltName = DNS:example.com,DNS:www.example.com,再用 -extensions v3_req 生成。注意:没有 SAN 的证书在 Chrome 58+ 上会直接报 ERR_CERT_COMMON_NAME_INVALID,CN 字段已不再作为匹配依据。
没有商业证书时,用 acme.sh 走 Let’s Encrypt(90 天,自动续期):
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
# 方式一:webroot(站点必须能用 80 访问)
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com
-w /www/web/example_com/public_html --keylength ec-256
# 方式二:DNS API 自动验证(服务器无 80 端口、或在 CDN 后面时用)
export Ali_Key="LTAIxxxx" Ali_Secret="xxxx"
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d *.example.com
# 安装证书到固定路径,并绑定 reload 命令
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /www/ssl/example.com/example.com.key
--fullchain-file /www/ssl/example.com/fullchain.pem
--reloadcmd "service nginxd restart && service httpd restart"
注意 --fullchain-file:它输出的是“域名证书 + 中间证书”,Nginx 的 ssl_certificate 必须指向这个文件;只有域名证书会导致安卓端、Java 客户端、微信内置浏览器报证书链不完整。
四、Nginx 站点配置示例(WDCP vhost 直接可用)
WDCP 的站点配置文件在 /www/wdlinux/nginx/conf/vhost/example.com.conf。把原来的 80 段保留做跳转,新增 443 段:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com www.example.com;
root /www/web/example_com/public_html;
index index.php index.html;
ssl_certificate /www/ssl/example.com/fullchain.pem;
ssl_certificate_key /www/ssl/example.com/example.com.key;
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 on;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /www/ssl/example.com/fullchain.pem;
add_header Strict-Transport-Security "max-age=31536000" always;
add_header X-Content-Type-Options nosniff always;
location ~ .php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
要点:
- WDCP 老版本 nginx 是 1.4/1.8,可能不支持
http2关键字,需降级为listen 443 ssl;并加ssl on;之外的写法,或升级 nginx; - nginx + apache 双引擎时,若 nginx 只做反向代理,SSL 应配在 nginx 层,后端 apache 保持 88 端口 HTTP,
proxy_pass http://127.0.0.1:88;,并透传proxy_set_header X-Forwarded-Proto https;,否则 PHP 里$_SERVER['HTTPS']为空,程序仍生成 http 链接,浏览器报混合内容; - 不要用 WDCP 面板的“站点编辑”再保存一次,它会用模板重写该文件,建议面板保存后再手工补 443 段,或把 SSL 参数抽到
/www/wdlinux/nginx/conf/ssl_params.conf里include。
/www/wdlinux/nginx/sbin/nginx -t && service nginxd restart
五、Apache 站点配置示例(mod_ssl)
纯 Apache 环境或 nginx 已卸载时,配置在 /www/wdlinux/apache/conf/vhost/example.com.conf。先确认主配置里有:
grep -E 'LoadModule ssl_module|Listen 443' /www/wdlinux/apache/conf/httpd.conf
若没有,补上并重启(Apache 2.4 需要 socache 模块配合 SSLSessionCache):
LoadModule socache_shmcb_module modules/mod_socache_shmcb.so
LoadModule ssl_module modules/mod_ssl.so
Listen 443 https
站点 vhost:
<VirtualHost *:80>
ServerName example.com
ServerAlias www.example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
DocumentRoot /www/web/example_com/public_html
SSLEngine on
SSLCertificateFile /www/ssl/example.com/fullchain.pem
SSLCertificateKeyFile /www/ssl/example.com/example.com.key
# Apache < 2.4.8 才需要单独指定中间证书
# SSLCertificateChainFile /www/ssl/example.com/chain.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder on
SSLSessionCache shmcb:/www/wdlinux/apache/logs/ssl_scache(512000)
Header always set Strict-Transport-Security "max-age=31536000"
<Directory "/www/web/example_com/public_html">
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
说明:Apache 2.4.8 之后 SSLCertificateFile 可以直接吃 fullchain 文件,SSLCertificateChainFile 已废弃;如果服务商给的是三文件(crt + ca-bundle + key),把 crt 与 ca-bundle 按顺序 cat example.com.crt ca-bundle.crt > fullchain.pem 合并,顺序颠倒同样会导致链校验失败。
/www/wdlinux/apache/bin/apachectl configtest && service httpd restart
WDCP 中 apache 若作为 nginx 后端,请不要在 apache 上再开 443,否则会和 nginx 抢端口;此时 apache 只需监听 88,全部 TLS 终止交给 nginx。
六、证书续费:398 天与 90 天两套节奏
续费失败的绝大部分原因不是证书买错,而是“续了没装上”或“装上没 reload”。分两种情况处理。
情况 A:Let’s Encrypt / 90 天证书(推荐自动)。acme.sh 安装时会写入 crontab,确认存在:
crontab -l | grep acme
# 期望看到类似:
# 12 3 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null
~/.acme.sh/acme.sh --list # 查看所有证书与下次续期时间
~/.acme.sh/acme.sh --renew -d example.com --force # 手工强制续期测试
关键在 --install-cert 时绑定的 --reloadcmd:如果当初安装证书时没写,续期后文件更新了但服务没重启,浏览器仍读旧证书。补绑命令:
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /www/ssl/example.com/example.com.key
--fullchain-file /www/ssl/example.com/fullchain.pem
--reloadcmd "service nginxd restart && service httpd restart"
情况 B:商业 DV 证书(最长 398 天)。续费流程是:服务商后台下单 → 用原有私钥重新签发(或上传新 CSR)→ 下载 fullchain → 覆盖服务器文件 → reload。覆盖前先比对私钥是否匹配:
openssl x509 -noout -modulus -in /www/ssl/example.com/fullchain.pem | openssl md5
openssl rsa -noout -modulus -in /www/ssl/example.com/example.com.key | openssl md5
# 两行 md5 必须完全一致,否则 nginx 启动会报 key values mismatch
续费完成后立即核对生效时间与剩余天数:
openssl x509 -in /www/ssl/example.com/fullchain.pem -noout -subject -issuer -dates
# notBefore / notAfter 应为新周期,剩余天数 = (notAfter - now)
建议把“到期前 15 天提醒”写进监控:openssl x509 -checkend 1296000 -noout -in fullchain.pem || echo 证书即将到期(1296000 秒 = 15 天),接进 Zabbix 或企业微信机器人。
七、三种证书获取方式对比
| 方案 | 单次有效期 | 续费方式 | 成本参考 | 适用场景 |
|---|---|---|---|---|
| Let’s Encrypt(acme.sh) | 90 天 | cron 自动 + reloadcmd | 0 元 | 有 root 权限、能用 80 或 DNS 验证 |
| 国内云厂商免费 DV | 90 天(早期为 1 年) | 控制台手工申请、手工下载部署 | 0 元 | 无 shell、证书需与云资源绑定 |
| 商业 DV(Sectigo/GeoTrust 等) | 最长 398 天 | 后台下单重签,手工替换 | 数百元/年 | 需要发票、合同、等保合规审计 |
| OV/EV 企业证书 | 最长 398 天 | 需重新提交企业材料审核 | 数千元/年 | 金融、政企门户 |
| 自签名证书 | 自定义 | 手工重签并分发根证书 | 0 元 | 内网测试、内部 API |
WDCP 双引擎(nginx 前置 + apache 后端)与纯引擎的配置差异:
| 项目 | Nginx 终止 TLS | Apache 终止 TLS |
|---|---|---|
| 证书指令 | ssl_certificate / ssl_certificate_key | SSLCertificateFile / SSLCertificateKeyFile |
| 协议控制 | ssl_protocols TLSv1.2 TLSv1.3 | SSLProtocol -all +TLSv1.2 +TLSv1.3 |
| 配置校验 | nginx -t | apachectl configtest |
| 重启命令 | service nginxd restart | service httpd restart |
| 后端 HTTPS 识别 | proxy_set_header X-Forwarded-Proto https | 无需处理 |
选型建议:能用 acme.sh 就用 acme.sh,90 天自动续期比 398 天手工续期可靠得多——有效期越长,越容易忘记,而一旦过期,浏览器给的是整页红色拦截,不是提示。
八、常见错误排查(真实报错对照)
1)nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
私钥与证书不匹配,多见于续费时换了新私钥却沿用旧证书。用第六节的 modulus md5 比对法定位,重新签发或换回配对文件。
2)nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line)
证书文件格式不对:可能是 .pfx/.jks 未转 PEM、文件为空、或从 Windows 传上来带了 BOM。转换:openssl pkcs12 -in cert.pfx -nodes -out fullchain.pem;去 BOM:sed -i '1s/^xEFxBBxBF//' fullchain.pem。
3)浏览器 ERR_CERT_COMMON_NAME_INVALID
证书 SAN 中没有当前访问的域名。用 openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name' 核对,泛域名 *.example.com 不覆盖 example.com 本身,需两个都签。
4)curl: (60) SSL certificate problem: unable to get local issuer certificate
服务端只发了域名证书,缺中间证书。确认 ssl_certificate 指向 fullchain,而不是 cert.crt。
5)浏览器 ERR_SSL_PROTOCOL_ERROR / SSL_ERROR_RX_RECORD_TOO_LONG
443 端口上跑的不是 TLS,通常是 vhost 没生效(server_name 拼错、conf 未被 include)或 443 被其他 HTTP 服务占用。用 ss -lntp | grep 443 与 nginx -T | grep -n 'listen 443' 确认。
6)nginx: [emerg] bind() to 0.0.0.0:443 failed (98: Address already in use)
nginx 与 apache 同时监听 443,或旧 nginx 进程未退出。处理:ss -lntp | grep 443 找 PID → 停掉冲突服务 → 只保留一层做 TLS 终止。
7)NET::ERR_CERT_DATE_INVALID(续费后仍提示过期)
文件已更新但服务未 reload,或 CDN 上还挂着旧证书。先 service nginxd restart,再用 openssl s_client 从公网侧看实际下发的 notAfter。
8)Mixed Content:页面 HTTPS 但图片/JS 走 HTTP
后端程序未识别 HTTPS。nginx 反代场景补 proxy_set_header X-Forwarded-Proto https;,PHP 程序侧信任该头,或把站内硬编码的 http:// 改为 // 或 https://。
九、效果验证:五条命令确认真的生效
配置完不要只看浏览器,用命令行从外部视角验证:
# 1. 查看服务端实际下发的证书主题、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2. 查看证书链与校验结果(Verify return code 必须为 0)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -E 'Verify return code|Protocol|Cipher'
# 3. 验证 80 跳 443
curl -sI http://example.com | head -3
# 4. 验证证书校验通过(ssl_verify_result 为 0 表示可信)
curl -s -o /dev/null -w '%{http_code} %{ssl_verify_result} %{time_total}sn' https://example.com
# 5. 验证旧协议已关闭(应报 handshake failure)
openssl s_client -connect example.com:443 -tls1_1 </dev/null
期望结果:
- 第 2 条输出
Verify return code: 0 (ok),Protocol 为 TLSv1.2 或 TLSv1.3; - 第 3 条返回
HTTP/1.1 301且Location: https://example.com/; - 第 4 条返回
200 0; - 第 5 条出现
no protocols available或 handshake failure,说明 TLS 1.0/1.1 已禁用。
再用浏览器开发者工具 Console 确认没有 Mixed Content 警告,Security 面板显示“连接安全”。最后跑一次自动化到期检查并接入监控:
openssl x509 -checkend 1296000 -noout -in /www/ssl/example.com/fullchain.pem
&& echo OK || echo "证书将在 15 天内到期,请续费"
至此 WDCP 站点的 HTTPS 访问、证书续费与自动 reload 闭环完成。后续每次续费只需重复“替换文件 → 比对 modulus → reload → s_client 验证”四步即可。
常见问题
在 WDCP 面板里保存了站点配置,HTTPS 又失效了怎么办?
WDCP v3 的“站点管理 → 修改”会用模板重写 /www/wdlinux/nginx/conf/vhost/xxx.conf,手工加的 443 段会被覆盖。解决办法是把 SSL 参数抽成独立文件(如 /www/wdlinux/nginx/conf/ssl_params.conf),在面板生成的 vhost 里只保留一行 include ssl_params.conf;,并保留一份备份;每次面板操作后用 nginx -t 校验并 diff 备份文件。
证书已经续费,为什么浏览器还显示旧证书或已过期?
三个原因依次排查:①服务未 reload,service nginxd restart && service httpd restart;②文件覆盖到了错误路径,用 nginx -T | grep ssl_certificate 看实际加载的文件;③前面有 CDN 或负载均衡,证书要在 CDN 控制台同步更新。用 openssl s_client -connect 域名:443 -servername 域名 看服务端真实下发的 notAfter 即可定位。
443 端口 telnet 能通,但浏览器报 ERR_SSL_PROTOCOL_ERROR?
说明 443 上跑的不是 TLS 服务,而是普通 HTTP。常见于 vhost 没被 include、server_name 写错导致命中默认站点、或 nginx 与 apache 抢端口。用 ss -lntp | grep 443 确认监听进程,用 nginx -T | grep -n 'listen 443' 确认配置已加载,必要时 curl -v http://域名:443 看是否返回正常 HTML(返回 HTML 即证明不是 TLS)。
泛域名证书能直接用在主域名上吗?
不能。*.example.com 只匹配 www.example.com、api.example.com 这类一级子域,不匹配 example.com 本身,也不匹配 a.b.example.com。签发时要把主域名和泛域名一起写进 SAN:-d example.com -d *.example.com,否则主域名访问会报 ERR_CERT_COMMON_NAME_INVALID。
服务器没有 80 端口(或在 CDN 后面),Let’s Encrypt 怎么签?
改用 DNS-01 验证,不需要任何入站端口:acme.sh --issue --dns dns_ali -d example.com -d *.example.com(阿里云)、--dns dns_dp(DNSPod)、--dns dns_cf(Cloudflare)。首次需 export API 密钥,acme.sh 会自动写入账户配置,后续 cron 续期同样走 DNS 验证。
WDCP 同时装了 nginx 和 apache,证书到底配在哪一层?
看 80 端口由谁监听。若 ss -lntp 显示 nginx 占用 80、apache 在 88,则 TLS 在 nginx 层终止,apache 保持 HTTP 88 端口,并在 nginx 中加 proxy_set_header X-Forwarded-Proto https;;若 apache 直接监听 80,则在 apache 上开 mod_ssl 配 443。切忌两边都开 443,会直接触发 bind 端口占用错误。