wdcp 环境 HTTPS 与 SSL 证书配置实战:Nginx/Apache 配置示例、398 天有效期规则与真实报错排查
一、问题背景与根因:wdcp 站点为什么开不起 HTTPS
wdcp(WDlinux Control Panel)基于 lanmp/lnmp 一键安装包,安装完成后默认只生成 80 端口的 vhost 配置,443 监听、证书指令、301 跳转规则都需要额外添加。很多人把证书上传到 /www/wdlinux/nginx/conf/ssl/ 之后 https:// 依然打不开,原因基本落在下面四类根因上。
根因 1:没有 443 监听。执行 ss -lntp | grep -E ':(80|443)b',如果只看到 80,说明 Nginx/Apache 根本没有监听 443,此时改多少证书内容都没有用。
根因 2:端口被拦。云厂商安全组默认只放行 22/80/3389,本机 iptables 或 firewalld 也可能拦截。检查命令:iptables -L INPUT -n --line-numbers | grep 443、firewall-cmd --list-services。
根因 3:Web 服务缺 SSL 模块。Nginx 用 nginx -V 2>&1 | tr ' ' 'n' | grep -w with-http_ssl_module 检查;Apache 用 httpd -M | grep -w ssl_module。wdcp 自带的 nginx 1.8.x 一般已编译 ssl 模块,但自行升级或替换过二进制的环境容易丢。
根因 4:证书链不完整。只部署了域名证书(leaf),没有带中间 CA。PC 端 Chrome 往往能通过 AIA 自动补链,但微信小程序、Android WebView、iOS 原生请求会直接报 request:fail ssl hand shake error。这是“电脑能开、手机不能开”的头号原因。
补充两点:wdcp 面板自身监听 8080,与站点 443 完全无关,不要因为面板能登录就认为 443 通畅;微信小程序强制所有请求走 HTTPS 且要求 TLS ≥ 1.2,iOS ATS 默认也禁止明文 HTTP,运营商劫持插入广告的问题同样要靠 HTTPS + HSTS 解决。
建议把定位顺序固定为:端口 → 模块 → 配置文件 → 证书链 → 协议与套件,按这个顺序排查基本不会绕圈。
二、证书选型与有效期规则:398 天与 90 天
先纠正一个过时认知:公开信任的 TLS 证书最长有效期自 2020-09-01 起为 398 天,“买一张证书用一年”已经是历史。Let’s Encrypt 免费证书固定 90 天,acme.sh 默认在剩余 60 天时自动续期。按 CA/Browser Forum SC-081 决议,有效期还会继续缩短:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。因此自动化续期不是可选项,而是必选项。
验证等级:DV 只验证域名控制权,几分钟即可签发;OV 需营业执照与电话核验,3-5 个工作日;EV 审核更严,但 Chrome/Safari/Firefox 早已移除地址栏显示公司名的 UI,公司名只出现在证书详情里,不必为“地址栏绿标”多付费用。
覆盖范围:单域名(example.com);多域名 SAN(一张证书挂多个域名,主流 CA 支持 100 个);通配符 *.example.com 只覆盖一级子域,不覆盖 a.b.example.com,也不覆盖裸域 example.com,通常要写成 example.com + *.example.com 一起申请。
生成 CSR(RSA 2048):
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key
-out example.com.csr
-subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
生成 ECC P-256 私钥(握手更快、证书更小,现代客户端全支持):
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr -subj '/CN=example.com'
内网测试可用自签证书:openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout self.key -out self.crt -subj '/CN=test.local',但自签证书不能用于小程序与公网业务。拿到证书后先核对信息再部署:
openssl x509 -in example.com.crt -noout -subject -issuer -dates -ext subjectAltName
三、实操步骤一:用 acme.sh 签发证书(DNS 验证)
wdcp 环境多为国内服务器,80 端口 HTTP-01 验证常因备案或拦截失败,推荐 DNS-01 验证,同时天然支持通配符。
1)安装 acme.sh 并指定 CA:
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
acme.sh --set-default-ca --server letsencrypt
2)配置 DNS API(以阿里云为例,腾讯云为 dns_dp、Cloudflare 为 dns_cf):
export Ali_Key='LTAI5t******'
export Ali_Secret='******'
acme.sh --issue --dns dns_ali -d example.com -d www.example.com --keylength ec-256
3)没有 API 权限时用手动 TXT 模式:
acme.sh --issue --dns -d example.com -d '*.example.com'
--yes-I-know-dns-manual-mode-enough-go-ahead-please
dig TXT _acme-challenge.example.com +short
acme.sh --renew -d example.com --yes-I-know-dns-manual-mode-enough-go-ahead-please
4)把证书安装到 wdcp 固定路径,并挂上重载命令。关键点:必须用 --fullchain-file 而不是 --cert-file,否则又会退化成缺中间证书:
mkdir -p /www/wdlinux/nginx/conf/ssl
acme.sh --install-cert -d example.com --ecc
--key-file /www/wdlinux/nginx/conf/ssl/example.com.key
--fullchain-file /www/wdlinux/nginx/conf/ssl/example.com.fullchain.pem
--ca-file /www/wdlinux/nginx/conf/ssl/example.com.chain.pem
--reloadcmd 'service nginxd restart'
5)商业证书流程不同:把上一步生成的 CSR 提交给 CA,选择 DNS TXT 验证,CA 会给出 _dnsauth.example.com 的 TXT 值,添加后 dig TXT _dnsauth.example.com +short 确认生效再点验证。CA 下发的压缩包通常包含域名证书 example.com.crt、中间证书 example.com.ca-bundle、私钥 example.com.key,需按顺序拼接成 fullchain:
cat example.com.crt example.com.ca-bundle > example.com.fullchain.pem
grep -c 'BEGIN CERTIFICATE' example.com.fullchain.pem # 正常为 2 或 3
最后收紧私钥权限:chmod 600 /www/wdlinux/nginx/conf/ssl/*.key && chown root:root /www/wdlinux/nginx/conf/ssl/*.key,权限过宽在部分版本会触发启动告警。
四、实操步骤二:在 wdcp 中启用 443 并放行端口
1)先确认架构与配置路径,不同 wdcp 版本目录略有差异:
cat /www/wdlinux/wdcp/version.txt
ls /www/wdlinux/
ls /www/wdlinux/nginx/conf/vhost/ # Nginx 站点配置
ls /www/wdlinux/apache/conf/vhost/ # Apache 站点配置(部分版本在 httpd/conf/vhost)
2)面板方式(wdcp v3):后台 → 网站管理 → 站点列表 → 站点“修改” → 勾选“启用 SSL/HTTPS”,把 fullchain.pem 全文粘进证书框、.key 全文粘进私钥框 → 保存。面板会重写 vhost 并自动补上 443 段。
3)手工方式(面板不支持或需要精细控制时):直接编辑 /www/wdlinux/nginx/conf/vhost/example.com.conf,写入第五节的两段配置。改完必须先测试再重载:
nginx -t
service nginxd restart # wdcp 的服务名是 nginxd,不是 nginx
service httpd restart # 走 Apache 的站点
service wdcp restart # 面板自身
4)放行 443,三层都要确认:
# 云厂商控制台安全组:入方向放行 TCP:443(0.0.0.0/0)
firewall-cmd --permanent --add-service=https
firewall-cmd --reload
firewall-cmd --list-services
iptables -I INPUT -p tcp --dport 443 -j ACCEPT
service iptables save
ss -lntp | grep ':443'
5)若 443 已被占用,用 ss -lntp | grep ':443' 找到 PID,再 ps -ef | grep <PID> 确认进程,决定改端口还是停服务。wdcp 面板默认 8080,正常不会与 443 冲突。
6)站点根目录与 PHP 转发沿用原 80 端口配置,注意 fastcgi_pass 不要写成外网 HTTP 地址,否则 HTTPS 页面会混入 HTTP 资源,触发浏览器“混合内容”拦截,地址栏的锁形标志消失。
五、配置示例:Nginx 与 Apache 完整片段
Nginx(wdcp 自带 1.8.x 及以上均适用):
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/wdlinux/nginx/conf/ssl/example.com.fullchain.pem;
ssl_certificate_key /www/wdlinux/nginx/conf/ssl/example.com.key;
ssl_trusted_certificate /www/wdlinux/nginx/conf/ssl/example.com.chain.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:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
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;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Content-Type-Options nosniff always;
add_header X-Frame-Options SAMEORIGIN always;
location ~ .php$ {
fastcgi_pass unix:/tmp/php-cgi.sock;
fastcgi_index index.php;
include fastcgi.conf;
}
}
版本提醒:Nginx 1.25.1 之后 http2 不能写在 listen 后面,要改成 listen 443 ssl; 再单独写一行 http2 on;,否则启动报 invalid parameter "http2"。
Apache 2.4(wdcp 的 httpd 站点):
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
DocumentRoot /www/web/example_com/public_html
ServerName example.com
SSLEngine on
SSLCertificateFile /www/wdlinux/apache/conf/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /www/wdlinux/apache/conf/ssl/example.com.key
# 2.4.8 之前必须单独指定中间证书;之后可并入 SSLCertificateFile
SSLCertificateChainFile /www/wdlinux/apache/conf/ssl/example.com.chain.pem
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
改完执行 httpd -t(或 apachectl configtest)再 service httpd restart。HSTS 头一旦下发就会被浏览器记住 max-age 时长,建议先用 max-age=300 验证,确认全站 HTTPS 且无混合内容后再调到 31536000,否则出问题时用户会被强制跳转且无法回退。
六、对比表格:证书类型、覆盖范围与配置差异
表 1:验证等级对比(注意 EV 已不再在地址栏显示公司名)
| 类型 | 审核内容 | 签发时长 | 浏览器表现 | 适用场景 |
|---|---|---|---|---|
| DV | 域名控制权(DNS TXT / HTTP 文件) | 几分钟至 1 小时 | 锁形标志,无组织信息 | 个人站、博客、API、小程序后端 |
| OV | 营业执照 + 电话核验 | 3-5 个工作日 | 锁形标志,证书详情含公司名 | 企业官网、SaaS 平台 |
| EV | 严格人工尽调 | 5-10 个工作日 | 锁形标志(地址栏不显示公司名) | 金融、支付等有合规要求的场景 |
表 2:覆盖范围对比
| 类型 | 示例 | 覆盖数量 | 注意点 |
|---|---|---|---|
| 单域名 | example.com | 1 | www 子域需另加或另购 |
| 多域名 SAN | example.com + api.example.com | 通常 ≤100 | 跨多个主域时最经济 |
| 通配符 | *.example.com + example.com | 不限一级子域 | 不覆盖 a.b.example.com 与裸域 |
表 3:Nginx 与 Apache 配置指令对照
| 功能 | Nginx | Apache 2.4 |
|---|---|---|
| 监听 443 | listen 443 ssl http2; | <VirtualHost *:443> + SSLEngine on |
| 证书 / 私钥 | ssl_certificate / ssl_certificate_key | SSLCertificateFile / SSLCertificateKeyFile |
| 中间证书 | 并入 fullchain.pem | SSLCertificateChainFile(2.4.8 之前) |
| 协议版本 | ssl_protocols TLSv1.2 TLSv1.3; | SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 |
| 加密套件 | ssl_ciphers ECDHE-…; | SSLCipherSuite HIGH:!aNULL:!MD5 |
| HTTP 跳转 | return 301 https://$host$request_uri; | Redirect permanent / https://example.com/ |
| 配置检查 | nginx -t | httpd -t / apachectl configtest |
| 重启服务 | service nginxd restart | service httpd restart |
选型结论:个人站与小程序后端用 DV + 通配符即可满足;企业门户可用 OV 增强可信度;EV 仅在合同或合规明确要求时购买。无论哪种类型,398 天上限意味着必须建立到期台账,免费证书则必须做自动化续期。
七、常见错误排查(真实报错对照)
1. nginx: [emerg] unknown directive "ssl" in /www/wdlinux/nginx/conf/vhost/example.com.conf:12
当前 Nginx 未编译 ssl 模块。用 nginx -V 2>&1 | grep -o with-http_ssl_module 确认,无输出说明需要更换带 ssl 的二进制包,改配置无用。
2. nginx: [emerg] SSL_CTX_use_PrivateKey_file("/www/wdlinux/nginx/conf/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
私钥与证书不匹配,常见于重复申请后只换了其中一个文件。比对模数:
openssl x509 -noout -modulus -in example.com.fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两个 md5 必须一致;ECC 证书则用 openssl ec -in example.com.key -pubout | openssl md5 与 openssl x509 -in cert.pem -noout -pubkey | openssl md5 对比。
3. curl: (60) SSL certificate problem: unable to get local issuer certificate
服务端缺中间证书,客户端无法构建信任链。用 --fullchain-file 重新安装,或把 crt 与 ca-bundle 拼接后重载。浏览器报 NET::ERR_CERT_AUTHORITY_INVALID 是同一原因。
4. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID
证书 SAN 列表不含当前访问域名,例如只申请了 example.com 却访问 www.example.com,或通配符证书访问了二级子域 a.b.example.com。用 openssl x509 -in cert.pem -noout -ext subjectAltName 核对。
5. ERR_SSL_PROTOCOL_ERROR / ERR_CONNECTION_REFUSED
443 没有监听或被安全组拦截。依次执行 ss -lntp | grep ':443'、telnet example.com 443、检查云安全组入方向规则。
6. SSL_ERROR_NO_CYPHER_OVERLAP
客户端与服务端没有共同协议或套件,多见于仍只支持 TLS 1.0 的老设备访问已禁用旧协议的站点,或 ssl_ciphers 写得过窄。先用 openssl s_client -connect example.com:443 -tls1_2 验证各版本握手情况。
7. nginx: [warn] "ssl_stapling" ignored, issuer certificate not found
未配置 ssl_trusted_certificate 或该文件不含中间证书,OCSP Stapling 无法生效,按第五节补上 chain 文件即可。
8. 微信小程序 request:fail ssl hand shake error
按顺序排查:证书链是否完整 → 是否禁用 TLS 1.0/1.1 → 域名是否与证书 SAN 完全一致 → 服务器时间是否准确(date 偏差超过证书有效期会直接握手失败)。
9. Job for nginxd.service failed because the control process exited with error code
先看 nginx -t 的具体行号,再看 tail -50 /www/wdlinux/nginx/logs/error.log,wdcp 的日志路径与官方默认不同,别找错文件。
八、效果验证:从本机到在线评级
1)基础连通与跳转:
curl -I http://example.com # 期望 301,Location: https://example.com/
curl -I https://example.com # 期望 200,且响应头含 strict-transport-security
curl -vI https://example.com 2>&1 | grep -Ei 'SSL connection|subject|issuer|expire'
2)证书链与有效期:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 期望 verify return code: 0 (ok),且能看到完整的两级证书链
3)协议与套件:
openssl s_client -connect example.com:443 -tls1_1 </dev/null # 期望 handshake failure
openssl s_client -connect example.com:443 -tls1_2 </dev/null # 期望 Verify return code: 0
nmap --script ssl-enum-ciphers -p 443 example.com
4)混合内容检查:Chrome DevTools → Console,出现 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure element 'http://...' 说明页面里还有硬编码的 http 资源,需改为协议相对地址或统一走 https。
5)在线评级:SSL Labs(https://www.ssllabs.com/ssltest/)输入域名,A/A+ 为合格;出现 “Chain issues: Incomplete” 就是缺中间证书,出现 “This server accepts RC4” 或 “TLS 1.0” 说明协议套件未收紧。
6)小程序侧验证:微信开发者工具 → 详情 → 本地设置,勾选“不校验合法域名”只用于开发;真机预览必须用已备案且证书链完整的域名,才能确认真实环境可用。
7)建立例行检查脚本,把证书到期时间纳入监控:
#!/bin/bash
end=$(openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
echo "example.com 证书剩余 ${days} 天"
[ "$days" -lt 15 ] && echo "WARN: 证书即将到期"
九、续期与到期监控
Let’s Encrypt 证书 90 天有效期,acme.sh 默认剩余 60 天时自动续期,安装时已写入 crontab。确认任务存在:
crontab -l | grep acme
acme.sh --list
acme.sh --cron --home ~/.acme.sh # 手动触发一次,观察输出
续期后必须让 Web 服务重载,否则新证书不会生效。这依赖 --install-cert 时指定的 --reloadcmd,可用 acme.sh --info -d example.com 查看已记录的 reloadcmd 是否正确指向 service nginxd restart 或 service httpd restart。测试方法:
acme.sh --renew -d example.com --force
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -dates
商业证书为 398 天上限,无法自动续期,需要人工提前 30 天重新签发并替换文件。建议建立台账,记录域名、CA、签发日、到期日、部署路径、负责人;替换流程固定为:新证书写入临时文件 → nginx -t 校验 → 原子替换(mv)→ reload → 用 openssl s_client 复核序列号是否更新。
通配符证书续期依赖 DNS API 凭据,凭据失效会导致续期静默失败。建议在监控里同时检查两项:证书剩余天数与 acme.sh 的 cron 日志(~/.acme.sh/acme.sh.log)。对于多台服务器共用同一张证书的场景,可在签发机续期后通过 rsync 分发 fullchain 与 key,再远程执行 reload,避免每台机器各自跑 DNS 验证造成 TXT 记录冲突。
最后提醒:证书有效期持续缩短是确定趋势(2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天),把续期与重载做成全自动流程,比记住任何一次到期日期都更可靠。
常见问题
问:Let’s Encrypt 只有 90 天,能不能直接买 398 天的商业证书省事?
可以,但并不能“省事”。398 天是当前公开信任证书的上限,到期仍需人工更换,只是频率从每 2 个月一次降到每年一次。商业 DV 证书的价值在于技术支持与赔付条款,若预算有限,用 acme.sh + DNS API 做全自动续期反而更不容易出事故。关键是无论哪种证书,都要有到期监控和 reloadcmd 自动重载,否则续期成功但服务未重载同样会过期。
问:证书装好后电脑能打开,微信小程序却提示 ssl hand shake error,是什么原因?
最常见是证书链不完整:服务端只配了域名证书,没有带中间 CA。PC 浏览器会通过证书里的 AIA 地址自动下载中间证书补链,而小程序与 Android WebView 不会。解决办法是把域名证书与中间证书拼接成 fullchain 后配置到 ssl_certificate(Apache 用 SSLCertificateChainFile),再用 openssl s_client -showcerts 确认返回的是完整两级链。其次检查是否仍允许 TLS 1.0/1.1,小程序要求 TLS ≥ 1.2。
问:通配符证书能不能覆盖 www.example.com 和 a.b.example.com?
*.example.com 覆盖 www.example.com、api.example.com 这类一级子域,但不覆盖 a.b.example.com 这类二级子域,也不覆盖裸域 example.com。因此实际申请时应同时提交 example.com 与 *.example.com 两个名字(同一张证书的 SAN 列表)。若业务存在多级子域,需要为每一级单独申请通配符,或改用多域名 SAN 证书逐条列出。
问:wdcp 面板里改了 SSL 配置,为什么站点还是走 HTTP?
三个检查点:一是 ss -lntp | grep ':443' 是否真的监听成功;二是配置改的是不是当前生效的 vhost 文件(Nginx 在 /www/wdlinux/nginx/conf/vhost/,Apache 在 /www/wdlinux/apache/conf/vhost/,部分版本在 httpd/conf/vhost);三是改完是否执行了 nginx -t 并 service nginxd restart。另外 wdcp 面板重新保存站点时会重写 vhost 文件,手工改动可能被覆盖,建议把手写配置放进独立的 include 文件并在面板设置后复核。
问:开启 HSTS 之后想回退到 HTTP,为什么改不回来?
因为 HSTS 策略被浏览器缓存在本地,max-age 期间内浏览器会强制把 http 请求升级为 https,服务端无法撤销。所以首次上线务必用较小值(如 max-age=300)验证,确认全站 HTTPS、证书链完整、无混合内容后再逐步调大。若已下发长周期 HSTS 且证书失效,用户只能清理浏览器 HSTS 缓存(Chrome 在 chrome://net-internals/#hsts 中删除域名)才能访问,这也是不要急于提交 HSTS preload 列表的原因。
问:证书续期成功了,但浏览器显示的到期时间还是旧的?
说明 Web 服务没有重新加载证书。Nginx/Apache 只在启动或 reload 时读取证书文件,覆盖文件本身不生效。检查 acme.sh --info -d 域名 里记录的 reloadcmd,确认命令能在当前环境执行(wdcp 的服务名是 nginxd 而非 nginx,写错会静默失败)。改好后执行 acme.sh --renew -d 域名 --force 并立即用 openssl s_client ... | openssl x509 -noout -dates 复核,确认 notAfter 已更新。