WordPress SSL 配置怎么做?从 TLS 终止位置到 is_ssl() 判定的 7 步实操与报错排查
WordPress SSL 配置的关键在于让 PHP 层的 is_ssl() 返回 true,并把 siteurl/home 改成 https,而不只是装好证书;证书只需 4 行 ssl_ 指令,真正让地址栏显示安全的是 wp-config.php 里的 WP_HOME/WP_SITEURL 加一次 wp search-replace。 is_ssl()(wp-includes/load.php)只认 $_SERVER['HTTPS'] 为 'on'/'1' 或 SERVER_PORT 为 443,TLS 在 CDN、SLB、Ingress 终止而回源为 HTTP 时该函数返回 false,必须由 Web 服务器补 X-Forwarded-Proto。 Nginx 1.25.1 起 http2 指令独立,正确写法是 listen 443 ssl; 加 http2 on;,ssl_certificate 必须指向 fullchain.pem,只配 cert.pem 会导致部分安卓 WebView 报 unable to get local issuer certificate。 数据库替换用 wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise(WP-CLI 2.10+),不要手写 UPDATE ... REPLACE,PHP 序列化字符串长度错位会让页面构建器数据失效。 验证三件套:curl -sI https://example.com 看 200 与 HSTS 头、openssl s_client -connect example.com:443 -servername example.com -tls1_3 看 Verify return code: 0 (ok)、wp eval 'var_dump(is_ssl());' 看 bool(true)。
WordPress SSL 配置后站点还是显示“不安全”?三类根本原因
证书装好、浏览器直接访问 https://example.com 也正常,可 WordPress 后台仍提示 HTTPS 不可用、页面里混着 http:// 资源——先别怀疑证书,先看 WordPress 到底怎么判断 HTTPS。据 WordPress 开发者参考,判定逻辑只有十几行,位于 wp-includes/load.php(WordPress 6.7 仍无变化):
// wp-includes/load.php —— is_ssl() 的完整判定逻辑(WordPress 6.7)
function is_ssl() {
if ( isset( $_SERVER['HTTPS'] ) ) {
if ( 'on' === strtolower( $_SERVER['HTTPS'] ) ) {
return true;
}
if ( '1' == $_SERVER['HTTPS'] ) { // 注意是宽松比较,但 PHP 8 下 'https' != '1'
return true;
}
} elseif ( isset( $_SERVER['SERVER_PORT'] ) && ( '443' == $_SERVER['SERVER_PORT'] ) ) {
return true; // 关键:elseif!HTTPS 存在但值不合法时,不再看端口
}
return false;
}
它只认 $_SERVER['HTTPS'] 等于 'on'/'1',或 $_SERVER['SERVER_PORT'] 等于 443。一旦返回 false,home_url()、site_url()、wp_enqueue_style() 全都会继续拼 http://,这就是”证书明明装好了却仍显示不安全”的传导链。
根因一:TLS 终止在 CDN / SLB / K8s Ingress,PHP 看不到 HTTPS 变量。回源请求是明文 HTTP,Nginx 收到的 $scheme 就是 http,SERVER_PORT 是 80,is_ssl() 必然为 false。验证方法是直接在服务器上打印变量:
# 在 WordPress 根目录临时建一个探针文件(用完立即删除)
cat > ssl-probe.php <<'EOF'
<?php
// 打印 is_ssl() 实际读取的三个变量
var_dump($_SERVER['HTTPS'] ?? null, $_SERVER['SERVER_PORT'] ?? null,
$_SERVER['HTTP_X_FORWARDED_PROTO'] ?? null);
EOF
curl -s https://example.com/ssl-probe.php # 期望看到 "on" / 443 / "https"
根因二:代理层配了转发头,但没人把它翻译成 PHP 变量。这正是 WordPress SSL 配置最常翻车的一步。Nginx 1.26 需要在 http 上下文用 map 把 X-Forwarded-Proto: https 映射为 HTTPS=on(直接写 fastcgi_param HTTPS $http_x_forwarded_proto; 是错的,PHP 8 下 '1' == 'https' 为 false):
# /etc/nginx/conf.d/wordpress-proxy.conf —— Nginx 1.26,TLS 在 CDN/SLB 终止
map $http_x_forwarded_proto $fastcgi_https { # map 必须放在 http 上下文
default off; # 默认值:不是 https 就是 off
https on; # 关键行:https -> on,命中 is_ssl()
}
server {
listen 80;
server_name example.com;
root /var/www/wordpress;
location ~ .php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_param HTTPS $fastcgi_https; # 关键行
fastcgi_param HTTP_X_FORWARDED_PROTO $http_x_forwarded_proto;
}
}
# Apache 2.4.62 + mod_remoteip,TLS 在负载均衡终止
# /etc/apache2/conf-available/wordpress-proxy.conf
RemoteIPHeader X-Forwarded-For
RemoteIPTrustedProxy 10.0.0.0/8 # 只信任内网回源段,勿用 0.0.0.0/0
SetEnvIf X-Forwarded-Proto "^https$" HTTPS=on # 关键行:供 is_ssl() 读取
据 RFC 7239,X-Forwarded-Proto 是事实标准而非正式规范字段;Apache 侧更规范的做法是同时下发 Forwarded: proto=https,但 WordPress 核心不解析它,仍要靠上面的 HTTPS=on 兜底。配置错误时后台”站点健康”会持续报 HTTPS 不可用 — 无法检测 HTTPS 支持。
根因三:内容层硬编码。配置改对了,但文章正文、主题 header.php、页面构建器里写死了 http:// 的图片和脚本,浏览器控制台报 Mixed Content: The page at 'https://…' was loaded over HTTPS, but requested an insecure image 'http://…'. This request has been blocked.(据 Mozilla MDN,主动混合内容如脚本会被直接拦截,被动内容如图片降级为警告)。Elementor 3.2x 把页面结构序列化在 _elementor_data 字段里,必须走支持序列化反序列化的替换工具:
# WP-CLI 2.11 + WordPress 6.7,先 dry-run 看命中数量,确认后再执行
wp search-replace 'http://example.com' 'https://example.com'
--all-tables --precise --report-changed-only --dry-run
# 去掉 --dry-run 正式执行;--all-tables 已覆盖 wp_postmeta 中的 _elementor_data
| 根因 | 典型现象 | 一句话判定 | 修复位置 |
|---|---|---|---|
| 代理终止未透传 | 站点健康报 HTTPS 不可用;home_url() 输出 http |
is_ssl() 返回 false |
Nginx map + fastcgi_param HTTPS;Apache SetEnvIf |
| 应用层未消费转发头 | 探针能看到 X-Forwarded-Proto: https,但 $_SERVER['HTTPS'] 为空 |
头传了但没翻译成 PHP 变量 | 同上,或 wp-config.php 兜底赋值 |
| 内容硬编码 http:// | 控制台 Mixed Content;锁图标显示”不安全” | 配置全对,但数据库/模板里有 http | wp search-replace + 主题模板 |
一个容易忽略的前提:后台强制 HTTPS 依赖 is_ssl()。WordPress 5.3 起,若 wp-config.php 未显式定义 FORCE_SSL_ADMIN,其默认值取 wp_force_ssl_admin() 的结果,而该函数在未定义常量时以 is_ssl() 为基准。所以在根因一、二的场景下,后台不但不会强制 HTTPS,登录 cookie 的 secure 标志也不会置位,表现为后台点”查看站点”被踢回 http、反复要求重新登录。稳妥做法是显式声明:
// wp-config.php —— 放在 "That's all, stop editing!" 注释之前
define( 'FORCE_SSL_ADMIN', true ); // 显式开启,不依赖 is_ssl() 推导
define( 'FORCE_SSL_LOGIN', true ); // 登录表单同样强制 HTTPS
// 注意:仅当整站已能正常提供 HTTPS 时开启,否则会把后台锁死
低频但致命的第四种:COOKIE_DOMAIN 写死。若 wp-config.php 里写了 define( 'COOKIE_DOMAIN', '.example.com' ); 而站点同时存在 www 与非 www 访问,HTTPS 下 cookie 域判定会冲突,登录页直接返回 错误:Cookie 被阻止。请启用 Cookie 后重试。处理方式是删掉该常量让 WordPress 自动推导,或改用 define( 'COOKIE_DOMAIN', false );,并统一 301 到单一主机名。
版本基线供对照:Nginx 1.26、Apache 2.4.62、PHP 8.2/8.3、WordPress 6.7、MySQL 8.0 或 MariaDB 10.11。据 Let’s Encrypt 文档,证书有效期 90 天,certbot 2.x 通过 systemd timer 每日两次检查续期,acme.sh 3.x 用 cron 每日检查;续期失败后仍有 30 天宽限,但若 90 天到期未续,上面的所有配置会一次性全部失效——把 certbot renew --dry-run 加进监控,比事后排查便宜得多。
WordPress SSL 配置的 7 个实操步骤:从证书签发到应用层确认
证书签发只是起点,真正决定 WordPress 是否“认为”自己跑在 HTTPS 上的,是后面六步里的三处细节:fullchain.pem 的选择、fastcgi_param HTTPS 的传值、以及 wp-config.php 中的常量覆盖。下面按顺序给出可直接执行的命令与配置。
第 1 步:签发证书(两条路线选其一)
# 路线 A:Certbot(Debian 12 / Ubuntu 22.04+,certbot 2.x)
sudo apt update && sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com --redirect
# 产物目录:/etc/letsencrypt/live/example.com/
# fullchain.pem = 站点证书 + 中间证书 ← 配置时用这个
# privkey.pem = 私钥
# cert.pem = 仅站点证书,缺中间证书,浏览器会报 chain 不完整
# 路线 B:acme.sh v3.0.x(不依赖 root 的 certbot,支持 ECC)
curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --issue -d example.com -w /var/www/html --keylength ec-256
# 安装到 Nginx 目录并注册自动续期
~/.acme.sh/acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.crt
--reloadcmd "systemctl reload nginx"
| 对比项 | Certbot 2.x | acme.sh 3.0 |
|---|---|---|
| 自动改写 Nginx 配置 | 支持(--nginx) |
不支持,需 --install-cert |
| 默认密钥算法 | ECDSA P-256(2.0 起) | RSA 2048,需 --keylength ec-256 |
| 续期间隔 | 剩余 30 天(90 天有效期) | 剩余 30 天,cron 每日检查 |
| 依赖 | Python 3 + 发行版包 | 纯 Shell,无依赖 |
第 2 步:让 Nginx 监听 443(Nginx 1.26 / 1.27)
server {
listen 443 ssl;
http2 on; # 1.25.1 起独立指令;旧写法 listen 443 ssl http2; 会报 deprecated 警告
server_name example.com www.example.com;
ssl_protocols TLSv1.2 TLSv1.3; # 1.23.4 起默认值即为 TLSv1.2 TLSv1.3
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_session_cache shared:SSL:10m;
}
sudo nginx -t && sudo systemctl reload nginx
# 若误写成 listen 443 ssl http2; 会看到:
# nginx: [warn] the "listen ... http2" directive is deprecated, use the "http2" directive instead
第 3 步:80 端口 301 跳转,但别删掉 ACME 校验路径
server {
listen 80;
server_name example.com www.example.com;
# 这一行由 certbot 自动写入,务必保留,否则续期时 HTTP-01 校验 404
location ^~ /.well-known/acme-challenge/ { root /var/www/html; }
return 301 https://$host$request_uri;
}
据 Let’s Encrypt 文档,HTTP-01 校验失败后证书不会立即失效,但若连续 30 天未能续期,90 天有效期的证书就会真正过期。典型报错为:Challenge failed for domain example.com ... Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404。
第 4 步:把协议信息传给 PHP-FPM——这一步直接决定 is_ssl() 的返回值。
location ~ .php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
fastcgi_param HTTPS $https if_not_empty; # SSL 连接下 $https 为 "on",否则为空
fastcgi_param HTTP_X_FORWARDED_PROTO $scheme; # 反代/CDN 场景的兜底判断
}
WordPress 的 is_ssl() 依次检查 $_SERVER['HTTPS'] 是否为 on/1、HTTP_X_FORWARDED_PROTO 是否为 https、HTTP_FRONT_END_HTTPS。缺了这两行,后台会报“混合内容”或陷入 ERR_TOO_MANY_REDIRECTS。
第 5 步:在 wp-config.php 中固定站点地址
// 放在 /* That's all, stop editing! */ 之前
define('WP_HOME', 'https://example.com');
define('WP_SITEURL', 'https://example.com');
define('FORCE_SSL_ADMIN', true); // 强制后台走 HTTPS,需显式声明
常量优先级高于 wp_options 表里的 siteurl/home,因此数据库里的旧 http 值不再生效,多环境切换也无需改库。
第 6 步:备份后批量替换数据库中的 http 链接
wp db export backup.sql
wp search-replace 'http://example.com' 'https://example.com'
--all-tables --precise --skip-columns=guid
# --precise 逐条 PHP 反序列化替换,避免序列化字符串长度错位
# --skip-columns=guid 保留 RSS GUID,防止阅读器重复推送旧文章
第 7 步:刷新缓存,顺序不可颠倒
wp cache flush
wp rewrite flush
# 再清 CDN 的 HTML 缓存(Cloudflare: Purge Everything;或 purge by URL)
必须先改配置、再刷缓存。若先刷缓存,旧页面会被重新缓存,用户仍会命中 http:// 版本的 HTML 与其中的绝对链接,形成混合内容告警。
完成以上七步后,可用 curl -sI https://example.com | head -1 确认返回 HTTP/2 200,并在站点健康面板确认“HTTPS 可用”。关于 TLS 终止究竟放在 Nginx、负载均衡器还是 CDN 边缘,以及 HSTS 预加载的取舍,属于下一层的话题。
WordPress SSL 配置示例:Nginx 1.26、Apache 2.4 与 wp-config.php 片段
把配置真正落到文件里,最容易出问题的不是 TLS 握手本身,而是”源站怎么知道自己被 HTTPS 访问”。下面按部署形态给出可直接复制的片段,均以 Nginx 1.26(http2 on 指令在 1.25.1 起取代 listen ... http2,1.26 上旧写法会报 the "listen ... http2" directive is deprecated 警告)与 Apache 2.4.62 为基准。
Nginx 1.26 直连站点:编辑 /etc/nginx/conf.d/example.conf。关键在于 fastcgi_param HTTPS $https if_not_empty;——PHP-FPM 默认不继承任何 HTTPS 标记,不写这行 WordPress 的 is_ssl() 恒为 false。
server {
listen 443 ssl;
http2 on; # Nginx ≥1.25.1 写法
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3; # Mozilla 中间配置兼容线
ssl_session_cache shared:SSL:10m; # 1MB ≈ 4000 会话
ssl_session_timeout 1d;
ssl_stapling on; # OCSP 装订,需 resolver
ssl_stapling_verify on;
resolver 223.5.5.5 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
root /var/www/wordpress;
location ~ .php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_param HTTPS $https if_not_empty; # 让 is_ssl() 为 true
fastcgi_param HTTP_X_FORWARDED_PROTO $scheme;
}
}
Apache 2.4.62 反代场景:证书文件必须是 fullchain.pem(含中间证书),只给 cert.pem 会导致部分安卓与 Java 客户端报 unable to get local issuer certificate。
# sudo a2enmod ssl headers remoteip 然后 systemctl reload apache2
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
# 前置 CDN/负载均衡时补回 HTTPS 标记
SetEnvIf X-Forwarded-Proto https HTTPS=on
# Cloudflare 回源时还原真实客户端 IP(替代已废弃的 mod_cloudflare)
RemoteIPHeader CF-Connecting-IP
</VirtualHost>
wp-config.php 常量块:放在 require_once ABSPATH . 'wp-settings.php'; 之前。写死 WP_HOME/WP_SITEURL 后,后台”设置 → 常规”里两个地址框会变灰,这是 WordPress 的既定行为,不是故障。
define('WP_HOME', 'https://example.com');
define('WP_SITEURL', 'https://example.com');
define('FORCE_SSL_ADMIN', true); # 强制后台走 HTTPS
define('FORCE_SSL_LOGIN', true); # 登录表单强制 HTTPS
CDN 回源:Cloudflare 或阿里云 CDN 需在 Nginx 加 set_real_ip_from <回源网段>; 与 real_ip_header CF-Connecting-IP;,并把 SSL/TLS 模式从 Flexible 改成 Full (strict)。Flexible 下 CDN 回源是明文 HTTP,源站 is_ssl() 为 false,WordPress 会不停 301 到 https,形成重定向循环(浏览器报 ERR_TOO_MANY_REDIRECTS)。
| 场景 | 判断 HTTPS 的依据 | 常见误配 |
|---|---|---|
| Nginx + PHP-FPM 直连 | fastcgi_param HTTPS |
漏写,后台无限跳转 |
| Apache 反代 | SetEnvIf X-Forwarded-Proto |
只开 SSLEngine,后端仍判 HTTP |
| CDN 回源 | 回源协议 + real_ip 头 | 停留在 Flexible 模式 |
WP-CLI 2.10+ 校验与批量替换:先 dry-run 看影响行数,--precise 让 WP-CLI 反序列化后再替换,避免破坏 widget 与主题选项里的序列化字符串(否则页面出现 unserialize(): Error at offset)。
wp option get home
wp option update siteurl 'https://example.com'
wp search-replace 'http://example.com' 'https://example.com'
--all-tables --precise --dry-run # 先试跑,确认行数后再去掉 --dry-run
wp eval 'var_dump(is_ssl());' # 期望 bool(true)
wp cache flush
OpenSSL 手工核验:据 OpenSSL 文档,-servername 用于发送 SNI,缺省时多站点会拿到错误证书。
openssl s_client -connect example.com:443 -servername example.com -tls1_3
</dev/null 2>/dev/null | openssl x509 -noout -subject -dates -ext subjectAltName
# 检查输出:SAN 含 example.com 与 www.example.com;notAfter 距现在 > 60 天
证书续期由 Let’s Encrypt 的 90 天有效期驱动,建议 certbot renew --dry-run 纳入月度检查;HSTS 一旦下发 max-age=31536000,回退到 HTTP 在一年内对老访客不可行,先在测试域用 max-age=300 验证。
WordPress SSL 配置方案怎么选?证书位置、跳转执行方与代价对比
做 WordPress SSL 配置时,第一个要决定的问题往往不是“用哪家证书”,而是TLS 到底在哪一层终止。这一层决定了三件事:证书文件放在哪台机器、X-Forwarded-Proto 由谁补上、以及 WordPress 里的 is_ssl() 能不能返回 true。下表按“证书位置 + 跳转执行方”把主流方案摊开对比:
| 方案 | 适用场景 | 关键配置 | 代价与限制 |
|---|---|---|---|
| 源站 Nginx/Apache 直接持证书 | 单机 VPS、有 root 权限 | ssl_certificate 指向 fullchain.pem,certbot --nginx 自动改配置 |
需开放 80 做 HTTP-01 校验;多机部署要逐台续期 |
| CDN 终止 TLS(Cloudflare、阿里云 CDN) | 有国内外多节点需求 | SSL/TLS 模式设 Full (strict),回源走 443 | Flexible 模式会让 is_ssl() 失效;HTML 缓存需主动 purge |
| 负载均衡 / K8s Ingress 终止 | 多副本、滚动发布 | Ingress 注解或 SLB 托管证书,应用侧信任 X-Forwarded-Proto |
需在 wp-config.php 信任代理头,否则后台跳转异常 |
| 插件自动申请(Really Simple SSL 9.x) | 共享主机、无 SSH | 插件面板一键签发并写 .htaccess | 证书与域名绑定,换域名需重签;配置不在版本库 |
| 面板一键(宝塔 9.x) | 国内中小站点 | 站点设置 → SSL → Let’s Encrypt | 续期任务失败不易察觉,需定期看面板日志 |
选型判断顺序是固定的:先确认 TLS 在哪一层终止,再决定 X-Forwarded-Proto 由谁补。如果 TLS 在 CDN 终止、而源站又对 80 端口做 301 到 https,就会出现 CDN→源站→CDN 的往返,浏览器侧的表现是 ERR_TOO_MANY_REDIRECTS;此时要么让源站直接返回 200,要么让 CDN 回源走 443 并在源站放行。当 TLS 不在 PHP 所在机器终止时,$_SERVER['HTTPS'] 为空,is_ssl() 返回 false,典型症状是后台“混合内容”警告和登录后无限跳回登录页。
<?php
// wp-config.php —— 放在 /* That's all, stop editing! */ 之前
// 仅当请求来自可信代理时才信任该头,避免被伪造
if (isset($_SERVER['HTTP_X_FORWARDED_PROTO'])
&& $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {
$_SERVER['HTTPS'] = 'on'; // 让 is_ssl() 返回 true
}
// 反向代理场景下还需固定站点地址,避免数据库里残留 http:// 记录
define('WP_HOME', 'https://example.com');
define('WP_SITEURL', 'https://example.com');
证书链完整性优先于算法选择。Nginx 的 ssl_certificate 必须指向 fullchain.pem(叶子证书 + 中间证书),只配 cert.pem 时,部分安卓 WebView、Java 客户端和旧版 curl 会报 unable to get local issuer certificate,而桌面 Chrome 因为能补链反而看不出问题——据 Let’s Encrypt 文档,fullchain.pem 就是为这种场景提供的。上线前用下面这条命令核验服务端实际下发的链:
# 适用 OpenSSL 1.1.1 / 3.x;-verify_return_error 让链错误直接以非 0 退出
openssl s_client -connect example.com:443 -servername example.com
-verify_return_error </dev/null 2>&1 | grep -E "Verify return code|depth="
# 期望输出:Verify return code: 0 (ok),且 depth=1 处出现中间证书的 CN
性能取舍同样落在这一层:TLS 1.3 加 OCSP Stapling 可把首次握手压到 1-RTT,后台一次加载几十个静态资源时收益明显;ssl_session_cache shared:SSL:10m(10MB 约 4 万个会话)配合 ssl_session_timeout 1d 能显著减少重复握手,注意共享内存区命名要全局唯一,避免与同机其他站点冲突。以下片段适用 nginx 1.18+(Ubuntu 22.04 默认版本),协议组合参考 Mozilla Server Side TLS 的 intermediate 配置:
server {
listen 443 ssl;
http2 on; # nginx ≥1.25.1 写法;旧版写 listen 443 ssl http2;
server_name example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 必须含中间证书
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3; # 默认仅 TLSv1.2/1.3 即可覆盖主流客户端
ssl_session_cache shared:WP_SSL:10m; # 名称唯一,避免多站点共享同一内存区
ssl_session_timeout 1d;
ssl_stapling on; # OCSP Stapling,需配合 resolver
ssl_stapling_verify on;
resolver 1.1.1.1 8.8.8.8 valid=300s;
}
预算方面:Let’s Encrypt 与 ZeroSSL 免费、有效期 90 天,certbot renew --dry-run 可验证续期链路是否真的通;单域名付费 DV 证书大致 50–300 元/年,通配符 OV 约 1500–5000 元/年。对绝大多数 WordPress 站点,免费证书配合正确的自动续期与 wp-config.php 代理头配置即可满足需求,付费更多买的是有效期长度与组织核验——这也是 WordPress SSL 配置里最容易被高估的一项支出。
WordPress SSL 配置常见错误与真实报错对照
这一节按“报错原文 → 触发条件 → 一条可复制的首查命令”来组织。排查 WordPress 的 SSL 问题,第一步通常应当是确认跳转链和证书链断在哪一跳,而不是先去改配置。据 Let’s Encrypt 文档,/etc/letsencrypt/live/ 下放的是符号链接,实体证书在 archive/,只备份 live 目录是续期后 443 端口突然无法访问的常见原因。
问:为什么浏览器报 ERR_TOO_MANY_REDIRECTS?
高频成因有两个:Cloudflare 的 SSL/TLS 模式设为 Flexible,回源走 80,而源站 Nginx 又对 80 做了 301 跳 https;或者 wp-config.php 里 WP_HOME/WP_SITEURL 写死 https,但 Nginx 的 server 块只 listen 80。跳转超过 3 次基本可判定循环(curl 7.x 的 --max-redirs 默认值为 50,需要手动压低才看得见报错):
# 压低最大跳转数,直接看跳了几次、最终落在哪个 URL
curl -sIL --max-redirs 3 http://example.com -o /dev/null
-w 'redirects=%{num_redirects} final=%{url_effective} code=%{http_code}n'
# 输出 redirects=3 且 curl 提示 "Maximum (3) redirects followed" → 判定为循环
# 再对照 Cloudflare 面板 SSL/TLS → Overview,Flexible 应改为 Full (strict)
问:页面能打开但样式全丢,控制台报 Mixed Content 怎么修?
报错原文形如 Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure element 'http://example.com/wp-content/uploads/...'。先处理数据库里的旧协议串,WP-CLI 会自动反序列化,避免把页面构建器的 JSON 改坏:
# --dry-run 先看影响行数;--precise 逐行处理更保险但更慢(WP-CLI 2.x)
wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise --dry-run
wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise
wp cache flush # 有对象缓存时必须清,否则旧值会回写
主题/子主题里硬编码的地址要改成 esc_url( home_url( '/wp-content/uploads/x.png' ) );页面构建器(Elementor、Divi)把布局存在 postmeta 的序列化 JSON 里,search-replace 之后仍需在编辑器里重新保存一次页面才会刷新缓存副本。
问:cURL error 60: SSL certificate problem: unable to get local issuer certificate 是什么原因?
这是 wp_remote_get() 请求外部 API(支付回调、字体服务、更新服务器)时 PHP 的 CA bundle 过期或路径为空。PHP 的 curl.cainfo 默认值为空,此时沿用编译时的系统证书;一旦系统包过期就会全线失败。
# Debian/Ubuntu:重装根证书并确认 PHP 实际加载的 CA 路径
apt update && apt install --reinstall ca-certificates
php -i | grep -iE 'curl.cainfo|openssl.cafile'
# php.ini 中显式指定(改完必须重启 php-fpm,CLI 与 FPM 是两份配置)
# curl.cainfo = /etc/ssl/certs/ca-certificates.crt
# openssl.cafile = /etc/ssl/certs/ca-certificates.crt
systemctl restart php8.2-fpm
其余三类报错的速查对照(WordPress 6.4+ 的“站点健康 → HTTPS 可用性”会用 wp_remote_get() 请求 home_url(),返回 WP_Error 或状态码非 200 即判失败):
| 报错原文关键词 | 首查命令 | 根因与修复 |
|---|---|---|
| 您的站点无法通过 HTTPS 访问 | wp eval 'var_dump(wp_remote_get(home_url(),["sslverify"=>true]));' |
回源 443 被安全组拦截;SNI 未配置导致命中默认站点证书;本机 hosts 未解析到自身公网 IP |
| 错误:Cookie 被阻止 / 登录后跳回 wp-login.php | wp option get siteurl; wp option get home |
两者一个 http 一个 https;COOKIE_DOMAIN 写死 .example.com 造成 www 与非 www 冲突。强制重登:wp user session destroy 1 --all |
| nginx: [emerg] no “ssl_certificate” is defined for the “listen … ssl” directive | nginx -T | grep -n ssl_certificate |
路径写错,或 certbot 续期后软链接指向已被清理的 archive 目录;确认 nginx 运行用户对 live/ 与 archive/ 有读权限 |
最后一条尤其值得强调:nginx -T 输出的是合并后的实际生效配置,比翻看 sites-enabled 更可靠;Mozilla SSL Configuration Generator 生成的片段里 ssl_certificate 是必填项,漏写就会在 nginx -t 阶段直接 emerg 退出,而非运行时报错。
证书签发成功不等于 WordPress SSL 配置生效。从 TCP 到 PHP 一共四层,任何一层断链都会出现“浏览器显示锁形图标、后台却提示不安全”的割裂现象。下面 6 个动作按层递进,每条都给出可直接复制的命令与判读标准。
第 1 步:HTTP 层看协议版本与 HSTS 头。据 RFC 6797,HSTS 响应头只允许在 HTTPS 响应中出现,因此它同时是“TLS 终止已生效”和“浏览器已被要求强制升级”的双重证据。
# 期望首行 HTTP/2 200,且响应头含 strict-transport-security
curl -sI https://example.com | head -n 8
# strict-transport-security: max-age=31536000; includeSubDomains
# 若服务器对 HEAD 返回 405,改用:curl -s -o /dev/null -w '%{http_code} %{http_version}n' https://example.com
第 2 步:验证明文跳转链路。要求 301 且 Location 与上一步使用同一主机名,避免 www 与裸域互相跳转造成重定向循环。
curl -sI http://example.com | head -n 5
# 期望:HTTP/1.1 301 Moved Permanently
# Location: https://example.com/
# 只验一次不带 -L:跟随跳转会掩盖 ERR_TOO_MANY_REDIRECTS
第 3 步:证书层验证信任链与有效期。用 -servername 显式发送 SNI,否则共享 IP 上可能取到默认站点的证书。
# 有效期与主体(RFC 8446 定义的 TLS 1.3 握手)
openssl s_client -connect example.com:443 -servername example.com -tls1_3 /dev/null
| openssl x509 -noout -dates -subject
# 单独确认校验结果:必须 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com -verify_return_error &1
| grep -E 'Verify return code|Protocol|Cipher'
notAfter 距今应大于 14 天。Let’s Encrypt 文档明确证书有效期 90 天,续期失败通常在第 60 天后才暴露,留 14 天窗口足够人工介入。
第 4 步:应用层——判断 WordPress SSL 配置是否真正穿透到 PHP。这一步最容易踩坑:WP-CLI 运行在 CLI 环境,没有 $_SERVER['HTTPS'],is_ssl() 恒返回 false,直接 eval 会得出错误结论。
wp option get home # 必须 https://example.com
wp option get siteurl # 必须 https://example.com,与 home 一致
wp eval 'var_dump(is_ssl());' # CLI 下 bool(false),不可作为结论
wp eval '$_SERVER["HTTPS"]="on"; var_dump(is_ssl());' # 模拟 Web 请求:bool(true)
第 5 步:前端层。DevTools → Console 过滤 “Mixed Content” 应为 0 条;Network 面板所有资源协议为 https 或 h2;Security 面板显示 “This page is secure (valid HTTPS)”,点证书可展开完整信任链。
第 6 步:第三方评分与站点健康。SSL Labs 目标 A 及以上,重点盯 “Certificate is not trusted” 与 “Chain issues” 两项,可用 Mozilla SSL Configuration Generator 5.7 生成的 intermediate 配置作对照基线。后台“工具 → 站点健康 → 状态”确认“HTTPS 可用性”为绿色,再触发一次真实外部请求验证出站证书校验:
# 触发一次真实 HTTPS 出站请求,暴露 CA 包缺失问题
wp cron event run wp_version_check
# 典型失败:cURL error 60: SSL certificate problem: unable to get local issuer certificate
# 修复:在 php.ini 设置 curl.cainfo = /etc/ssl/certs/ca-certificates.crt(默认空,依赖系统 CA)
| 检查层 | 命令 / 入口 | 通过标准 | 典型失败信号 |
|---|---|---|---|
| HTTP | curl -sI https://… |
HTTP/2 200 + HSTS 头 | HTTP/1.1 200、无 strict-transport-security |
| 跳转 | curl -sI http://… |
301 + Location 同主机名 | 302、Location 指向 www 再跳回裸域 |
| 证书 | openssl s_client |
Verify return code: 0 | code 20/21/62,notAfter 已过期 |
| 应用 | wp option get home |
home 与 siteurl 均为 https | 仍为 http://,后台登录后被踢出 |
| 前端 | DevTools Console | Mixed Content 0 条 | 硬编码 http 的图片/脚本被拦截 |
| 健康 | 站点健康 / SSL Labs | HTTPS 可用性绿色、评级 A+ | cURL error 60、Chain issues: Incomplete |
若第 1、2 步通过而第 4 步的 home/siteurl 仍是 http,说明反向代理未向 PHP 传递 X-Forwarded-Proto,需要在 wp-config.php 中依据代理头修正 $_SERVER['HTTPS'],而不是去动证书。
WordPress SSL 配置之后的长期维护:续期、HSTS 与多站点
证书续期显示成功,为什么浏览器还在报旧证书?
因为 certbot renew 只把新文件写进 /etc/letsencrypt/live/example.com/,不会通知 Nginx 重新加载。据 Let’s Encrypt 文档,证书有效期为 90 天,官方客户端在剩余约 30 天时由 systemd timer 触发续期;缺少 deploy hook 时,Web 进程会一直持有旧证书,直到下一次 reload 或重启。WordPress SSL 配置上线只是开始,真正容易出问题的是三个月后。正确的续期钩子写法:
# 方式一:certbot ≥ 0.20,renew 成功后自动执行
certbot renew --deploy-hook 'systemctl reload nginx'
# 方式二:acme.sh,默认约 60 天续期,重载命令写进安装参数
acme.sh --install-cert -d example.com -d www.example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd 'systemctl reload nginx' # 缺这行 = 续了但没生效
验证 timer 是否真的在跑,而不是只看到 “enabled”:
systemctl list-timers | grep certbot
# 期望:Sat 2025-06-14 03:12:00 UTC 11h left ... certbot.timer certbot.service
# 列表为空说明只有 cron 或纯手动,需补:systemctl enable --now certbot.timer
certbot renew --dry-run # 演练,走 staging,不消耗正式速率限制
| 对比项 | certbot | acme.sh |
|---|---|---|
| 默认续期触发 | systemd timer,每日两次随机延迟 | 安装时写入的 cron,到期前约 30 天 |
| 续期后重载服务 | 需 --deploy-hook |
需 --reloadcmd |
| 验证方式 | systemctl list-timers |
crontab -l | grep acme.sh |
HSTS 应该一步到位设成两年吗?
不建议。HSTS 由浏览器强制缓存,下发后服务端无法“撤回”,只能等 max-age 过期。据 RFC 6797,一旦进入 preload 列表,移除周期以月计,且已缓存策略的用户侧完全不可控。分三阶段推进:
| 阶段 | 响应头 | 观察期 | 主要风险 |
|---|---|---|---|
| 1 试运行 | max-age=300 |
1 周 | 几乎可忽略 |
| 2 正式 | max-age=31536000 |
≥ 1 个月 | 任一子域仍走 HTTP 即无法访问 |
| 3 preload | 再加 includeSubDomains; preload |
长期 | 撤销困难,不可回滚 |
# Nginx ≥ 1.7.5 支持 always,保证 4xx/5xx 响应也带 HSTS 头
add_header Strict-Transport-Security "max-age=300" always;
# 一周无异常后替换为:
# add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
DISABLE_WP_C Ron 打开后,证书到期提醒邮件为什么没来?
插件更新检查、备份、SSL 监控告警都跑在 WP-Cron 上。若 wp-config.php 里写了 define('DISABLE_WP_CRON', true);,就必须由系统 crontab 接管,否则任务只在有人访问时才触发,低流量站会长期延迟,直接错过续期窗口:
# crontab -e -u www-data
*/5 * * * * /usr/bin/wp cron event run --due-now --path=/var/www/html --quiet
换域名时先改哪一步,子站才不会跳回 http?
- 先在
wp-config.php定义WP_HOME与WP_SITEURL(优先级高于数据库,可兜底); wp search-replace 'https://old.com' 'https://new.com' --all-tables --precise --recurse-objects,--precise避免 PHP 序列化数据被破坏(WP-CLI ≥ 2.0);wp cache flush,清 CDN 与 OPcache,最后重新签发证书——旧证书 SAN 不含新域名会报NET::ERR_CERT_COMMON_NAME_INVALID。
Multisite 要多做一步:wp_blogs.domain 与 wp_site.domain 存的是不带协议的裸域名,search-replace 覆盖不到,只改主站会让子站跳回 http:
wp db query "UPDATE wp_blogs SET domain='new.com' WHERE domain='old.com';"
wp db query "UPDATE wp_site SET domain='new.com' WHERE domain='old.com';"
wp site list --fields=blog_id,url # 逐条核对子站 URL
怎么在用户看到 NET::ERR_CERT_DATE_INVALID 之前发现过期?
监控是 WordPress SSL 配置里最容易被跳过的一环。最低成本是拨测:
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com
# 输出 200 0 表示链验证通过;非 0 即 OpenSSL 的 X509_V_ERR_* 错误码
规模化建议用 Prometheus blackbox_exporter 的 probe_ssl_earliest_cert_expiry(返回 Unix 时间戳),配告警表达式 (probe_ssl_earliest_cert_expiry - time()) / 86400 < 14,把故障窗口从“等用户反馈”的数天压到小时级。
最少两行:define('WP_HOME','https://example.com') 与 define('WP_SITEURL','https://example.com'),放在 /* That's all, stop editing! */ 之前。后台强制 HTTPS 由 WordPress 5.3 起默认开启,如需显式声明可加 define('FORCE_SSL_ADMIN', true)。若站点在反向代理后面,还要配合 Web 服务器传 X-Forwarded-Proto,否则常量写了也可能被 is_ssl() 判定覆盖。
把 Cloudflare 的 SSL/TLS 模式从 Flexible 改成 Full (strict),否则 Cloudflare 到源站是明文 HTTP,源站 is_ssl() 为 false,容易出现 ERR_TOO_MANY_REDIRECTS 或后台登录死循环。同时在 Nginx 里配 set_real_ip_from 与 real_ip_header CF-Connecting-IP,让日志和限流拿到真实客户端 IP。
插件适合不能碰服务器配置的共享主机用户,Really Simple SSL 9.x 会自动加 301 跳转并做一次混合内容扫描,但它会把规则写进 .htaccess,迁移时容易残留。有 root 权限的 VPS 更推荐在 Nginx 加 wp-config.php 层做,配置可版本化、可审计,插件只在需要批量修内容时临时启用。
这是 cookie 域与协议不一致的典型症状:先确认 home 与 siteurl 的协议、域名(含不带 www)完全一致,再清空浏览器里该域名的 cookie 和 wp_usermeta 中的 session_tokens。若用了 CDN,检查是否只对 HTML 开了 HTTPS 而 wp-admin 走了 http。必要时临时 define('WP_DEBUG', true) 打开 debug.log 看重定向来源。
不需要,只要续期后执行 nginx -t && systemctl reload nginx(或 apachectl -k graceful)让新证书生效即可。certbot 2.x 的 systemd timer 默认每天跑两次,acme.sh 用 cron 每天检查;建议在续期钩子里加 –deploy-hook 'systemctl reload nginx',避免续期成功但进程还在用旧证书。
多站点每个子域都要能通过证书校验,单域名证书不够,通常用 *.example.com 泛域名证书并通过 DNS-01 方式签发。域名映射字段里如果仍存 http,要在 wp_blogs 与 wp_site 表里一并替换,只改主站 siteurl 会出现子站跳转回 http 的问题。
配置动作完全一样,差别在有效期与信任链:Let's Encrypt、ZeroSSL 都是 90 天,需要自动化续期;付费 DV 通常 1 年,单域名年费大致 50–300 元,通配符 OV 约 1500–5000 元/年,多的是组织信息核验与保险额度。对 WordPress 而言,能自动续期的免费证书配合正确的 wp-config.php 配置,安全性并不弱于 DV 证书。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。