宝塔面板 SSL 证书部署与 HTTPS 升级实战:Discuz、小程序和 wdcp 配置指南
问题背景与根因:HTTP 站点为什么必须升级 HTTPS
浏览器已将 HTTP 标记为不安全,微信小程序从上线起就要求请求域名使用 HTTPS。Discuz 的登录、支付、会员中心和 UCenter 通信涉及 Cookie 与表单,明文传输存在劫持风险;HTTP/2、HSTS、Service Worker 等能力也依赖 TLS。真正的根因不是装一个证书文件,而是证书链、域名匹配、协议版本、跳转链路、混合内容五个环节中任一失败,都会显示不安全或接口失败。必须修正旧说法:公共可信 TLS 证书最长有效期为 398 天,Let’s Encrypt 证书为 90 天,不存在默认一年且无需续期的公共证书;EV 证书在现代浏览器地址栏也不再展示公司名称。宝塔、wdcp 只是管理面板,最终仍要落到 Nginx、Apache、IIS、Tomcat 的证书文件和 443 监听。
date -u
timedatectl set-ntp true
ss -lntp | grep -E ':80|:443'
部署前先确认域名解析到正确服务器 IP,安全组和防火墙放行 80、443,系统时间准确。否则后续签发、OCSP 校验和浏览器信任判断都可能异常。
证书选型与申请材料:DV、OV、EV 与 398/90 天规则
按覆盖范围分:单域名证书只保护一个主机名,如 t.example.com;多域名证书通过 SAN 保护 a.example.com、b.example.com;通配符证书保护 *.example.com 的所有二级域名,但不包含根域 example.com,根域需额外加入 SAN。按验证等级分:DV 只验证域名控制权,通常几分钟签发;OV 验证企业身份,常见 1 至 5 个工作日;EV 验证更严格,但现代浏览器不再在地址栏显示企业名。公共可信证书最长 398 天,Let’s Encrypt 为 90 天,应使用 ACME 自动续期。申请时通常需要域名管理权限,按 CA 要求添加 TXT 记录或放置验证文件。
如自建 CSR,可用 OpenSSL 1.1.1 以上执行:
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'
提交 CSR 后保存好私钥,私钥权限设为 600。商业证书交付时通常给 fullchain.pem 与 privkey.pem,宝塔导入时不要只粘贴域名证书 cert.pem,否则部分客户端会报缺少中间证书。
宝塔面板完整实操:申请、导入、部署与强制 HTTPS
第一步,在宝塔面板进入网站,点目标站点设置,选择 SSL。使用 Let’s Encrypt 时勾选根域和 www 域名,选择文件验证或 DNS 验证;使用商业证书时把 fullchain.pem 粘贴到证书栏,把 privkey.pem 粘贴到私钥栏。第二步,保存后开启强制 HTTPS。第三步,检查 Nginx 配置并重载:
/www/server/nginx/sbin/nginx -t
/etc/init.d/nginx reload
chmod 600 /www/server/panel/vhost/cert/example.com/privkey.pem
ss -lntp | grep ':443'
Apache 环境执行 /etc/init.d/httpd configtest 后 reload,并确认 mod_ssl 已启用。若 443 被占用,先查监听进程;若面板提示证书保存成功但浏览器仍报错,重点检查是否只部署了 cert.pem、域名 SAN 是否包含 www、CDN 是否也配置了 HTTPS。证书更换时先上传新证书和私钥,再重载服务,不要先删除旧文件,避免 reload 失败导致站点中断。
Discuz 与小程序 HTTPS 配置:后台、UCenter 与混合内容
Discuz 开启 HTTPS 后,进入后台全局站点信息,把站点 URL 改为 https://www.example.com;进入 UCenter 应用管理,把应用地址同步改为 HTTPS;更新缓存。若使用自定义表前缀,可执行类似 SQL,并先备份数据库:
UPDATE pre_common_setting SET svalue='https://www.example.com' WHERE skey='siteurl';
grep -RIn 'http://www.example.com' /www/wwwroot/discuz/template /www/wwwroot/discuz/static | head
模板、插件、编辑器上传地址中残留的 http:// 会造成混合内容,浏览器控制台会提示 Mixed Content。将资源改为 //www.example.com 或 https://www.example.com。小程序侧在微信公众平台开发设置中配置 request 合法域名,例如 https://api.example.com,要求受信任 CA 签发、TLS 1.2 以上、使用 443 端口,中国大陆主体通常还需域名备案。开发者工具勾选不校验合法域名只能临时调试,真机发布仍会校验。
配置示例:Nginx、Apache、IIS、Tomcat 与 wdcp 的 443 跳转
Nginx 站点可参考以下最小配置,证书路径按宝塔实际目录调整:
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;
ssl_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;
ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
add_header Strict-Transport-Security 'max-age=31536000' always;
root /www/wwwroot/example.com;
index index.php index.html;
}
Apache 示例:
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /path/fullchain.pem
SSLCertificateKeyFile /path/privkey.pem
</VirtualHost>
IIS 在 MMC 中导入 PFX,站点绑定 443 并勾选要求 SSL,HTTP 跳转用 URL Rewrite;Tomcat 在 server.xml 配置 443 Connector,使用 JKS 或 PKCS12 keystoreFile。wdcp 站点修改 /www/wdlinux/nginx/conf/vhost/example.com.conf 或 Apache 对应 vhost,替换证书路径后执行 service nginx reload 或 service httpd reload。
对比表格:证书类型、覆盖范围与部署方式怎么选
| 类型 | 验证内容 | 签发时长 | 浏览器展示 | 适用场景 |
|---|---|---|---|---|
| DV | 域名控制权 | 分钟级 | 锁标志,无组织名 | 个人博客、Discuz、小程序后端 |
| OV | 域名加组织信息 | 1 至 5 个工作日 | 锁标志,证书详情含组织 | 企业门户、内部系统 |
| EV | 严格组织与法律验证 | 数个工作日 | 现代浏览器不再显示公司名 | 金融、电商等强合规场景 |
| 覆盖方式 | 示例 | 注意点 |
|---|---|---|
| 单域名 | t.example.com | 不保护 www 或其他子域 |
| 多域名 SAN | a.example.com、b.example.com | 域名数量受套餐限制 |
| 通配符 | *.example.com | 不包含根域 example.com |
公共可信证书最长 398 天,Let’s Encrypt 为 90 天。Nginx 用 fullchain.pem 加 privkey.pem,Apache 用 SSLCertificateFile 加 SSLCertificateKeyFile,IIS 用 PFX,Tomcat 用 JKS 或 PKCS12。预算有限且只做域名验证时,DV 已满足大多数业务。
常见错误排查:真实报错与修复命令
NET::ERR_CERT_DATE_INVALID:证书过期或系统时间错误。执行 openssl x509 -in fullchain.pem -noout -dates 查看有效期,续期后重载 Nginx。 SSL_ERROR_BAD_CERT_DOMAIN:证书 SAN 不含当前域名,执行 openssl x509 -in fullchain.pem -noout -ext subjectAltName,重新签发并加入 www。 curl: (60) SSL certificate problem: unable to get local issuer certificate:缺少中间证书,改用 fullchain.pem。 ERR_TOO_MANY_REDIRECTS:CDN 已终止 TLS 而源站再次 301,检查 curl -I http://example.com 返回的 Location,回源改 HTTPS 或在源站判断 X-Forwarded-Proto。
403 Forbidden:查看 tail -f /www/wwwlogs/nginx_error.log,检查证书目录权限、站点根目录和 index 配置。 502 Bad Gateway:PHP-FPM 未启动或 socket 不匹配,执行 systemctl status php-fpm 或检查宝塔 PHP 服务。 Mixed Content:用 grep -RIn ‘http://’ 检查模板和插件资源。小程序报 request:fail ssl hand shake error 时,优先检查证书链、TLS 版本、443 端口和域名是否在合法域名列表。
效果验证:浏览器、OpenSSL、curl 与小程序真机检查
先验证跳转与响应:
curl -I http://example.com
curl -I https://example.com
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | openssl x509 -noout -dates
预期结果是 HTTP 返回 301 或 302 并跳转到 HTTPS,HTTPS 返回 200;证书主题、签发者、有效期和 SAN 均正确。浏览器地址栏应显示锁标志,点击可查看证书链。可再用 SSL Labs 检查评级,目标至少 A;用 nmap –script ssl-enum-ciphers -p 443 example.com 检查协议与套件。小程序在开发者工具详情中查看域名信息,并用真机预览发起一次 wx.request,确认无证书和混合内容报错。
常见问题
宝塔面板已经部署证书,为什么浏览器仍显示不安全?
优先检查是否只部署了 cert.pem 而缺少中间证书,域名 SAN 是否包含 www,页面是否残留 http:// 资源,以及 CDN 缓存是否仍返回旧证书。执行 openssl s_client 验证实际返回的证书链。
Let’s Encrypt 90 天证书如何自动续期?
在宝塔 SSL 页面开启自动续期,或使用 certbot renew、acme.sh –renew 配合计划任务。续期成功后必须 reload Nginx 或 Apache,否则进程仍使用旧证书。
通配符证书能保护根域 example.com 吗?
不能。*.example.com 只匹配 a.example.com 这类二级域名,根域 example.com 需要单独加入 SAN 或另签证书。
更换 SSL 证书后需要重启服务器吗?
不需要重启整台服务器。Nginx 执行 nginx -t 后 nginx -s reload,Apache 执行 configtest 后 graceful,IIS 更新 443 绑定即可。
Discuz 开启 HTTPS 后登录失败或 UCenter 通信失败怎么办?
检查后台站点 URL、UCenter 应用地址、Cookie 域是否统一为 HTTPS 域名,并清理模板和插件中的 http:// 资源。必要时更新缓存并检查混合内容控制台报错。
微信小程序必须使用 EV 证书吗?
不需要。DV 证书即可,但必须是受信任 CA 签发、TLS 1.2 以上、使用 443 端口,域名需加入 request 合法域名;中国大陆主体通常还需完成备案。