跳到主要内容
ssl证书按装

wdcp 环境 HTTPS 与 SSL 证书配置实战:Nginx/Apache 配置示例、398 天有效期规则与真实报错排查

wdcp 环境 HTTPS 与 SSL 证书配置实战:Nginx/Apache 配置示例、398 天有效期规则与真实报错排查 — 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 已更新。

内容审核

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