WordPress 全站 HTTPS 配置全流程:从证书部署到混合内容清理的 8 步实操指南
WordPress 全站 HTTPS 的核心是四件事:签发并部署 fullchain 证书、服务器层做 301、wp-config.php 固定 WP_HOME/WP_SITEURL、用 wp search-replace 把数据库里的 http:// 换成 https://,熟练的话 30–60 分钟可完成,停机窗口可控制在 5 分钟内。 混合内容(Mixed Content)是 WordPress 全站 HTTPS 失败的首要原因,执行 wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise --recurse-objects --skip-columns=guid --dry-run 可先预演,典型站点会命中 2000–30000 行。 Cloudflare、SLB、Nginx 反代场景必须让 PHP 识别 X-Forwarded-Proto,否则 is_ssl() 返回 false,wp-admin 会在 http/https 之间来回跳,报 ERR_TOO_MANY_REDIRECTS。 验证三件套:curl -sIL http://example.com 看是否只有一跳 301、openssl s_client -connect example.com:443 -servername example.com -showcerts 看证书链、curl -s https://example.com | grep -o 'http://[^"]*' 看残留明文链接(理想输出为空)。 HSTS 建议从 max-age=300 起步,稳定后再升到 31536000;提交 hstspreload.org 前必须确认所有子域都支持 HTTPS,因为移除预加载需要数月。
WordPress 全站 HTTPS 为什么总卡在“跳一半”?根本原因拆解
问:证书装好了,浏览器也有小锁,为什么后台一登录就被踢回 http?
因为 TLS 只加密了”这一条连接”,而 WordPress 判断自己是 http 还是 https,靠的是数据库里的两条记录。WordPress 把站点地址硬编码在 wp_options 表的 siteurl 与 home 两个字段中,据 WordPress 官方文档(Changing The Site URL),这两项优先级高于 wp-config.php 里的常量,除非你显式定义 WP_HOME / WP_SITEURL。只装证书不改库,前台仍会输出 http:// 资源。先用 WP-CLI(2.0+)确认现状:
# 数据库里写死的站点地址;输出仍是 http:// 就说明只装了证书、没做迁移
wp option get home
wp option get siteurl
# 正文里残留的 http:// 链接数量,这才是混合内容的主要来源
wp db query "SELECT COUNT(*) FROM wp_posts WHERE post_content LIKE '%http://example.com%';"
这时打开首页,Chrome DevTools 的 Console 会原样报出:
Mixed Content: The page at ‘https://example.com’ was loaded over HTTPS, but requested an insecure element ‘http://example.com/wp-content/uploads/2024/05/hero.jpg’. This request has been blocked.
问:那直接把库里所有 http:// 批量 REPLACE 成 https:// 行不行?
不行,这是 WordPress 全站 HTTPS 迁移中最大的坑。序列化数据是 WordPress 全站 HTTPS 迁移中最大的坑:wp_posts.post_content、wp_postmeta.meta_value、wp_options.option_value 里存有大量 PHP serialize 字符串,带长度前缀(例如 s:22:"http://example.com",22 是字节长度)。换成 https 后实际长度变成 23,前缀却仍是 22,unserialize() 返回 false,表现为小工具消失、主题设置清空、页面白屏。正确做法是用能重算长度前缀的 WP-CLI:
# 迁移前冷备份,务必先做(数据库 + wp-content 目录)
wp db export backup-before-https.sql
# 第一步只演练:--dry-run 报告将改动多少行,不写库
wp search-replace 'http://example.com' 'https://example.com'
--all-tables --precise --recurse-objects --skip-columns=guid --dry-run
# 确认无误后去掉 --dry-run 正式执行
# --precise 会同步修正序列化字符串的长度前缀,这是 SQL REPLACE 做不到的
# --skip-columns=guid 保留原 GUID,避免 RSS 聚合器把旧文当成新文重复推送
wp search-replace 'http://example.com' 'https://example.com'
--all-tables --precise --recurse-objects --skip-columns=guid
问:为什么套了 Cloudflare 或 SLB 就出现 ERR_TOO_MANY_REDIRECTS?
因为反向代理在边缘终止 TLS,回源走 HTTP,PHP 侧 $_SERVER['HTTPS'] 为空,is_ssl() 返回 false,WordPress 认为当前是 HTTP,于是 wp-admin 跳回 http,又被服务器 301 回 https,形成循环。在 wp-config.php 的 /* That's all, stop editing! */ 之前补回协议头,同时 Nginx 侧必须显式透传:
# nginx.conf —— 反向代理层,缺这两行 PHP 永远拿不到真实协议
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
// wp-config.php —— 仅当源站只能被代理回源、无法被公网直连时才可信
if ( isset( $_SERVER['HTTP_X_FORWARDED_PROTO'] )
&& 'https' === $_SERVER['HTTP_X_FORWARDED_PROTO'] ) {
$_SERVER['HTTPS'] = 'on'; // 让 is_ssl() 返回 true
}
Cloudflare 用户还需把 SSL/TLS 模式设为 Full (strict),否则回源段仍是明文,CF-Visitor 头里的 scheme 也会是 http。
问:桌面 Chrome 有小锁,为什么旧版 Android 和 curl 报证书错误?
证书链不完整。只部署域名证书而不带中间证书时,桌面 Chrome 靠 AIA 自动补链仍显示小锁,但 Android 7 以下、Java 8 以及部分 curl 会报 unable to get local issuer certificate,WordPress 后台”站点健康”也会提示无法与 WordPress.org 通信。用 OpenSSL 1.1.1+ 验证:
# 拉取服务端实际下发的整条链并校验
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
# 期望输出 stdin: OK;出现 unable to get local issuer certificate 即缺中间证书
# 只取校验结果行
openssl s_client -connect example.com:443 -servername example.com -verify_return_error &1
| grep 'Verify return code'
# 期望 Verify return code: 0 (ok)
| 现象 | 典型报错 | 根因 | 定位命令 |
|---|---|---|---|
| 前台图片/JS 被拦 | Mixed Content … has been blocked | siteurl/home 或正文残留 http:// | wp option get home |
| 小工具消失、白屏 | unserialize() 返回 false | SQL REPLACE 破坏了长度前缀 | wp search-replace --dry-run |
| 后台无限跳转 | ERR_TOO_MANY_REDIRECTS | 反代下 is_ssl() 为 false | curl -I https://example.com/wp-admin/ |
| 移动端/curl 报证书错误 | unable to get local issuer certificate | 证书链缺中间证书 | openssl s_client -showcerts |
问:迁移要花多少钱、停多久?
据 Let’s Encrypt 文档,其证书免费、有效期 90 天、基于 ACME v2(RFC 8555)自动续期,certbot --nginx -d example.com -d www.example.com 一条命令即可完成签发与 reload;商业 DV 单域名约 ¥30–300/年,OV 约 ¥800–3000/年。中小站点按”冷备份 → --dry-run 演练 → 执行替换 → 改 siteurl/home → 清缓存 → 回归测试”的顺序推进,正常停机窗口可控制在 5 分钟以内。
WordPress 全站 HTTPS 完整实操步骤(8 步,约 30–60 分钟)
30–60 分钟能不能把 wordpress 全站https 做完?能,但顺序不能乱:先备份、再签证书、最后才动数据库。下面 8 步按依赖关系排列,命令可直接粘贴。
-
第 1 步:备份数据库与站点文件
# 逻辑备份:--single-transaction 让 InnoDB 在一致性快照下导出,不阻塞写入 mysqldump --single-transaction --default-character-set=utf8mb4 -u wp_user -p wp_db > wp-$(date +%F).sql # 数据库超过 2 GB 时追加 --quick:逐行读取,避免 mysqldump 把整张表读进内存后 OOM mysqldump --single-transaction --quick --default-character-set=utf8mb4 -u wp_user -p wp_db > wp-$(date +%F).sql # 站点文件打包;tar 会打印 "Removing leading `/' from member names",属正常告警 tar czf wp-files-$(date +%F).tgz /var/www/html回灌到测试库验证一次(
mysql -u wp_user -p wp_test < wp-2025-01-01.sql),确认可恢复再继续。 -
第 2 步:签发证书(certbot 2.11 / acme.sh 3.0)
# certbot:--webroot 复用现有 80 端口站点完成 HTTP-01 校验,无需停机 certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --key-type ecdsa --elliptic-curve secp256r1 # 需要通配符(*.example.com)时只能走 DNS-01 certbot certonly --preferred-challenges dns -d '*.example.com' -d example.com # acme.sh 等价写法:纯 shell、无 Python 依赖,默认 RSA 2048,需显式指定 ec-256 acme.sh --issue -d example.com -d www.example.com -w /var/www/html --keylength ec-256据 Let’s Encrypt 文档,证书有效期 90 天,certbot 由 systemd timer 在剩余约 30 天时自动续期,acme.sh 自带 cron 默认提前 60 天。certbot 2.0 起
--key-type已默认为ecdsa,显式写出只是防止旧配置残留。 -
第 3 步:服务器层做唯一 301 跳转
# Nginx:80 端口的 server 块 server { listen 80; listen [::]:80; server_name example.com www.example.com; location /.well-known/acme-challenge/ { root /var/www/html; } # 放行续期校验 location / { return 301 https://$host$request_uri; } }# Apache:httpd.conf 或站点 vhost <VirtualHost *:80> ServerName example.com RewriteEngine On RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301] </VirtualHost>全站只保留这一条跳转规则,先关掉插件里的“强制 HTTPS”开关——两层 301 叠加会产生
ERR_TOO_MANY_REDIRECTS,且反向代理下的X-Forwarded-Proto判断经常误判。 -
第 4 步:在 wp-config.php 固定站点地址
// 必须插在 require_once ABSPATH . 'wp-settings.php'; 这一行之前 define('WP_HOME', 'https://example.com'); define('WP_SITEURL', 'https://example.com');常量的优先级高于
wp_options表,所以数据库里还是http://时你也能正常登录后台;定义后“设置 → 常规”里的两个地址框会变灰,避免误改。 -
第 5 步:WP-CLI 2.10+ 批量替换数据库
# 预演:只统计 affected rows,不写库 wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise --recurse-objects --skip-columns=guid --dry-run # 确认影响行数在几千到几万量级后,去掉 --dry-run 正式执行 wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise --recurse-objects --skip-columns=guid--precise走 PHP 反序列化,能同步修正序列化字符串里的长度字段;--skip-columns=guid是因为 GUID 被写进 RSS 作为永久标识,改了会让老订阅者重复收到历史文章(见 WordPress 开发者手册)。 -
第 6 步:清理主题与插件里的硬编码
grep -rn "http://example.com" wp-content/themes wp-content/plugins --include=*.php --include=*.css --include=*.js命中的多半是背景图、字体
@import和硬编码的 AJAX 端点,逐个改成//example.com或https://。 -
第 7 步:清对象缓存与瞬态
wp cache flush # 清 Redis/Memcached 对象缓存 wp transient delete --all不清理的话,旧的
siteurl会从缓存里继续吐出来,表现为后台改了、前台没变。 -
第 8 步:验证 + Search Console 收尾
curl -sI http://example.com | head -n 5 # 期望 301 + Location: https://example.com/ curl -sI https://example.com | grep -i strict-transport-security在 Google Search Console 新增
https://属性并重新提交 sitemap;旧 http 属性的 301 至少保留 6 个月。可选加固:按 Mozilla SSL Configuration Generator 的 Intermediate 配置启用 HSTS(RFC 6797),首轮建议max-age=300试跑,确认无子域混用 HTTP 后再拉到 31536000。
| 维度 | certbot 2.11 | acme.sh 3.0 |
|---|---|---|
| 默认密钥类型 | ECDSA(2.0 起) | RSA 2048,需 --keylength ec-256 |
| 默认续期阈值 | 剩余约 30 天 | 剩余 60 天(--days) |
| 运行时依赖 | Python / snap | 纯 shell + curl |
| 证书存放路径 | /etc/letsencrypt/live/example.com/ |
~/.acme.sh/example.com_ecc/ |
| 通配符 DNS 集成 | 需另装 DNS 插件 | 内置数十家 DNS API |
WordPress 全站 HTTPS 配置与命令示例(Nginx / Apache / wp-config / WP-CLI)
Nginx 的 80/443 双 server 块怎么写?证书为什么必须指向 fullchain.pem?
最省事、也最不容易踩坑的写法是两个独立 server 块:80 端口只做 301 跳转,443 端口才承载业务。把跳转和 TLS 分开写,可以避免在同一个 server 块里用 if 判断协议(Nginx 官方文档明确称 if 在 location 上下文是”evil”)。
# /etc/nginx/conf.d/example.conf
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri; # 用 $host 而非写死域名,便于多域名复用
}
server {
listen 443 ssl;
http2 on; # nginx ≥1.25.1 的新语法;旧版本写 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 必须是 fullchain
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3; # nginx ≥1.23.4 默认已是这两项,显式写兼容旧版
ssl_session_cache shared:SSL:10m; # 默认 none;10m ≈ 4 万个会话,可跨 worker 共享
ssl_session_timeout 1d;
add_header Strict-Transport-Security "max-age=300" always; # 先 300 秒试水,稳定后升到 31536000
}
关键点是 fullchain.pem。据 Let’s Encrypt 官方文档,该文件 = 站点证书 + 中间证书;只配 cert.pem 时,部分客户端(旧版 Android、Java 客户端、某些 curl 构建)不会自动补全中间证书,典型报错是 curl: (60) SSL certificate problem: unable to get local issuer certificate,浏览器端则表现为 NET::ERR_CERT_AUTHORITY_INVALID。验证方法:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE",正常应输出 2(或更多)。
| 文件 | 内容 | 能否单独用于 ssl_certificate |
|---|---|---|
| cert.pem | 仅站点证书 | 否,链不完整 |
| chain.pem | 仅中间证书 | 否 |
| fullchain.pem | 站点证书 + 中间证书 | 是,推荐 |
| privkey.pem | 私钥 | 配 ssl_certificate_key |
Apache 或 .htaccess 里怎么强制 HTTPS?套了 CDN 为什么会无限重定向?
# .htaccess 或 vhost 的 <Directory> 段内
<IfModule mod_rewrite.c>
RewriteEngine On
# 直连场景:用 %{HTTPS}
RewriteCond %{HTTPS} !=on
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
</IfModule>
若前面有 Nginx 反代、Cloudflare 等 CDN,Apache 收到的永远是明文 HTTP,%{HTTPS} 恒为 off,于是 301 到自己、再 301 到自己,浏览器报 ERR_TOO_MANY_REDIRECTS。此时把条件换成 RewriteCond %{HTTP:X-Forwarded-Proto} !https,并确保反代/CDN 确实下发了该头。同时别忘了 <IfModule mod_headers.c> Header always set Strict-Transport-Security "max-age=300" </IfModule>,Apache 的 HSTS 不随跳转自动生成。
wp-config.php 要加什么,才能让 WordPress 自己知道”我在 HTTPS 后面”?
// 放在 "/* That's all, stop editing! */" 之前
if (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {
$_SERVER['HTTPS'] = 'on'; // 修复 is_ssl() 误判,避免后台登录死循环
}
define('WP_HOME', 'https://example.com');
define('WP_SITEURL', 'https://example.com'); // 硬编码优先级高于数据库 wp_options
define('FORCE_SSL_ADMIN', true); // 默认 false;强制 wp-admin 与登录页走 HTTPS
用 WP-CLI 批量替换 http:// 链接,命令和输出长什么样?
$ wp search-replace 'http://example.com' 'https://example.com'
--all-tables --precise --recurse-objects --skip-columns=guid --dry-run
+------------+--------------+---------------+------+
| Table | Column | Rows affected | Type |
+------------+--------------+---------------+------+
| wp_posts | post_content | 1842 | PHP |
| wp_options | option_value | 37 | PHP |
+------------+--------------+---------------+------+
Success: 2879 replacements to be made (dry run).
--precise 会逐行反序列化再重算长度字段,比默认的 SQL 直替慢但能避免序列化数据损坏;--skip-columns=guid 是因为 GUID 一旦变更,RSS 阅读器会把旧文当新文重复推送;先 --dry-run 看行数,确认后再去掉该参数执行。这是 wordpress 全站https 迁移里最容易翻车的一步,务必先备份数据库。
证书续期后 Nginx 不会自动重载,钩子怎么写?
# 1) 先验证续期链路(不消耗速率限制)
certbot renew --dry-run
# 2) 部署钩子:/etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
#!/bin/sh
systemctl reload nginx # 用 reload 而非 restart,避免断连
# 3) chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
# 4) certbot 包自带 certbot-renew.timer,systemd 每天触发两次检查
systemctl list-timers | grep certbot
上线前怎么用两条命令确认真的生效?
curl -sI http://example.com | head -3
# 期望:HTTP/1.1 301 Moved Permanently / Location: https://example.com/
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 期望 issuer 为 R10/R11 或 ISRG Root X1,notAfter 约 90 天内
若 subject 与域名不符,多半是 server_name 与证书 SAN 不一致;若 notAfter 已过期,先查 certbot certificates 再排查钩子是否可执行——钩子没有 +x 时 certbot 只会在日志里静默跳过,续期成功但线上仍是旧证书。
WordPress 全站 HTTPS 方案选型对比:服务器跳转、插件、CDN 怎么选
先给结论:能拿到 SSH 就别犹豫,走「服务器 301 + WP-CLI 改库」;只有面板权限就用面板自带的 Let’s Encrypt + 强制 HTTPS;插件方案只适合当过渡桥。为什么?因为 WordPress 的站点地址(siteurl、home)和文章正文里的绝对链接都写死在数据库里,光加证书不换协议,浏览器地址栏变绿了,页面却仍在拉 http:// 的图片和 JS——这就是混合内容(mixed content)被 Chrome 拦截、控制台刷 Mixed Content: The page at 'https://…' was loaded over HTTPS, but requested an insecure element 的根因。
| 方案 | 适用场景 | 关键操作 | 主要风险 | 成本 |
|---|---|---|---|---|
| 服务器 301 + WP-CLI 改库 | 单站点、有 SSH 权限 | return 301 + wp search-replace |
序列化数据必须加 --precise,否则长度前缀错乱导致小工具/主题设置丢失 |
0 元 |
| Really Simple SSL 插件 | 虚拟主机、无 SSH | 插件用 ob_start 输出缓冲改写链接 |
每次请求多一层缓冲开销;JS/CSS 内硬编码的 http 改不到 | 免费版够用,Pro 约 $39/年 |
| Cloudflare Full (Strict) + Origin CA | 已有 CDN 的站点 | 源站装 15 年期 Origin CA 证书 | 误选 Flexible 会与源站 301 互相重定向,报 ERR_TOO_MANY_REDIRECTS |
免费套餐可用 |
| 宝塔 / aaPanel 一键 SSL | 面板用户 | 面板申请 Let’s Encrypt 并勾选「强制 HTTPS」 | 面板续期 cron 失败无人知晓,90 天后证书过期 | 0 元 |
证书怎么挑?据 Let’s Encrypt 官方文档,其 DV 证书有效期固定 90 天、支持 HTTP-01 与 DNS-01 两种校验,通配符必须走 DNS-01;而 CA/Browser Forum 基线要求把商业证书上限压到 398 天,所以“买一张管三年”的时代已经结束了。
| 类型 | 有效期 | 验证方式 | 价格区间 | 适合谁 |
|---|---|---|---|---|
| Let’s Encrypt DV | 90 天 | HTTP-01 / DNS-01 | 0 元 | 绝大多数 wordpress 全站https 站点 |
| 商业 DV | 398 天 | DNS / 文件 | ¥30–300/年 | 不想配自动续期 |
| OV | 398 天 | 企业资质核验 | ¥800–3000/年 | 有合规要求的企业站 |
| Cloudflare Origin CA | 15 年 | Cloudflare 内部签发 | 0 元 | 源站只对 Cloudflare 回源开放 |
服务器层的最小可用配置(nginx 1.18+,Ubuntu 20.04 默认源版本),注意 ssl_session_cache 默认是 off,必须显式打开:
# /etc/nginx/conf.d/wordpress-https.conf
server {
listen 80;
server_name example.com www.example.com;
return 301 https://example.com$request_uri; # 用 301 而非 302,浏览器会缓存并传递权重
}
server {
listen 443 ssl http2; # nginx ≥1.25.1 请改为 listen 443 ssl; + http2 on;
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; # TLS 1.0/1.1 已被主流浏览器于 2020 年弃用
ssl_session_cache shared:SSL:10m; # 约可缓存 4 万个会话,默认 off
ssl_session_timeout 1d;
ssl_stapling on; # OCSP stapling,省掉客户端一次 50–200 ms 的 CA 查询
ssl_stapling_verify on;
resolver 1.1.1.1 valid=300s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}
数据库替换务必先干跑。--precise 会逐行反序列化再重写,是修好 PHP 序列化长度前缀的唯一安全方式;guid 列按 WordPress 约定不改,否则 RSS 老订阅者会重复收到旧文:
# WP-CLI 2.7+;先 dry-run 看命中行数
wp search-replace 'http://example.com' 'https://example.com'
--all-tables --precise --recurse-objects --skip-columns=guid --dry-run
# 确认后去掉 --dry-run 正式执行
性能上别被“HTTPS 一定慢”吓到。据 RFC 8446(TLS 1.3),完整握手只需 1-RTT,会话复用支持 0-RTT;TLS 1.2 完整握手则是 2-RTT。开好 ssl_session_cache 与 HTTP/2 后,wordpress 全站https 与纯 HTTP 的 TTFB 差异通常落在 10–30 ms 内,真正拖慢体验的是没做 OCSP stapling 的那 50–200 ms 首次查询,以及混合内容导致的重复请求。
WordPress 全站 HTTPS 常见错误与真实报错排查
WordPress 全站 HTTPS 的报错,多半不是证书没签成,而是代理层、端口、证书 SAN、PHP CA 与数据库 URL 五处不一致。先按表定位,再执行对应命令。
| 报错/现象 | 最先检查 | 典型修复 |
|---|---|---|
ERR_TOO_MANY_REDIRECTS |
Cloudflare 模式 + 源站 301 | Full (strict) + 代理 HTTPS 识别 |
| Mixed Content | HTML/CSS 里的 http:// 绝对 URL |
curl 抓取 + search-replace |
SSL_ERROR_RX_RECORD_TOO_LONG |
是否用 https 访问 443;listen 443 ssl |
补 ssl 参数 |
NET::ERR_CERT_COMMON_NAME_INVALID |
证书 SAN 是否含当前域名 | 裸域 + www 一次签 |
cURL error 60 |
PHP CA bundle | curl.cainfo/openssl.cafile |
| 后台样式丢/跳回 http | siteurl/home + FORCE_SSL_ADMIN |
wp option + define |
为什么会出现 ERR_TOO_MANY_REDIRECTS? 九成是 Cloudflare 的 SSL 模式设为 Flexible,而源站又做 301:Cloudflare 回源走 HTTP,源站再跳 HTTPS,浏览器就在两者之间死循环。据 Cloudflare 文档,把 SSL/TLS → Overview 改为 Full (strict),并确保源站证书有效(否则会报 526);若 Cloudflare 已终止 TLS,在 wp-config.php 的 wp-settings.php 之前加入:
// wp-config.php:仅在可信反代后使用,让 WordPress 识别 X-Forwarded-Proto
if (isset($_SERVER['HTTP_X_FORWARDED_PROTO'])) {
if ($_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {
$_SERVER['HTTPS'] = 'on';
}
}
Mixed Content 的原文是什么? 浏览器控制台会给出:
Mixed Content: The page at ‘https://example.com/’ was loaded over HTTPS, but requested an insecure stylesheet ‘http://example.com/wp-content/themes/x/style.css’. This request has been blocked.
据 MDN 文档,混合内容会被浏览器按规范阻止;用下面命令定位页面中的绝对 http 资源,再查 CSS/JS 内的 url(http://...):
curl -s https://example.com | grep -o 'http://[^"]*' | sort -u | head -20
# 备份数据库后先 dry-run,确认无误再去掉 --dry-run:
wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise --dry-run
SSL_ERROR_RX_RECORD_TOO_LONG 是证书过期吗? 不是,典型是把 HTTPS 端口当 HTTP 访问,或 Nginx 的 443 块写成 listen 443; 漏了 ssl。据 Nginx 文档,listen 443 ssl 与 ssl_certificate/ssl_certificate_key 必须在同一 server 块成对出现:
nginx -T 2>/dev/null | grep -nE 'listens+443|ssl_certificate'
# 正确写法:
server {
listen 443 ssl; # 不能只写 listen 443;
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;
}
NET::ERR_CERT_COMMON_NAME_INVALID 怎么一次签全? 常见于证书只签了 www.example.com,用户却访问裸域。据 RFC 6125 与 Let’s Encrypt 文档,浏览器按证书 SAN 校验;签发时用一条命令同时包含裸域和 www:
sudo certbot certonly --nginx -d example.com -d www.example.com
# 通配符 *.example.com 只覆盖一级子域,不覆盖 a.b.example.com;
# 它也不包含裸域 example.com,且通配符证书需 DNS-01 验证。
cURL error 60: SSL certificate problem: unable to get local issuer certificate 与“无法与 WordPress.org 通信”怎么修? 这是 PHP 的 CA bundle 未配置;curl.cainfo 与 openssl.cafile 默认均为空。Debian/Ubuntu 可指向系统 CA:
; /etc/php/8.2/fpm/php.ini
curl.cainfo = "/etc/ssl/certs/ca-certificates.crt"
openssl.cafile = "/etc/ssl/certs/ca-certificates.crt"
; RHEL 系通常改为 /etc/pki/tls/certs/ca-bundle.crt
sudo systemctl reload php8.2-fpm
php -i | grep -E 'curl.cainfo|openssl.cafile'
# 应显示上述路径,而不是 no value
WordPress 全站 HTTPS 后,后台样式全丢、wp-admin 自动跳回 http 怎么办? 先用 WP-CLI 确认数据库值,再查主题 functions.php 或 wp-config.php 是否残留 http://example.com 硬编码:
wp option get siteurl
wp option get home
# 在 WordPress 根目录执行,把 your-theme 换成实际主题目录:
grep -RIn --include='*.php' 'http://example.com' wp-content/themes/your-theme wp-config.php
据 WordPress 文档,FORCE_SSL_ADMIN 默认 false;在 wp-config.php 中加入:
define('FORCE_SSL_ADMIN', true); // 默认 false,强制 /wp-admin 走 HTTPS
如何验证 WordPress 全站 HTTPS 真的生效了
跳转链里出现了几次 301 才算正常?
最常见的问题是“服务器 .htaccess 跳一次、插件又跳一次”,浏览器要经历两次往返才能拿到页面。用下面这条命令看跳转链,-I 只读响应头、-L 跟随跳转、-s 静默输出:
# 只保留状态行和 Location 头,一行一条跳转
curl -sIL http://example.com | grep -Ei '^(HTTP/|location:)'
# 想直接数跳转次数(0 表示没跳,1 表示一跳到位)
curl -sIL -o /dev/null -w 'redirects=%{num_redirects} final=%{url_effective}n' http://example.com
健康输出是「301 → 200」两行,例如 HTTP/1.1 301 Moved Permanently + location: https://example.com/ + HTTP/2 200。若看到两次及以上 301(http→https→https://www),说明 WordPress 插件(如 Really Simple SSL)和 Web 服务器的 rewrite 规则在重复跳转,应只保留一层。据 Google 搜索中心文档,301 与 308 对权重传递等价,但跳转层级过深会拉高首字节时间,也容易被抓取工具判为软 404。
证书是不是真的由 Let’s Encrypt 签发、还剩多少天?
-servername 不能省:在共享 IP 上缺少 SNI,拿到的可能是同服务器默认站点的证书。
# 取叶证书的生效时间、主体与签发者(openssl 1.1.1 / 3.x 均适用)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -dates -subject -issuer
# 数一下返回的证书链张数,正常为 2–3(叶证书 + 中间证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| grep -c 'BEGIN CERTIFICATE'
合格标准:notAfter 距今大于 30 天;issuer 为 CN = R10 或 CN = R11(据 Let’s Encrypt 文档,其证书自 2024 年起默认由 R10/R11 中间证书签发,有效期 90 天,官方建议剩余不足 30 天即续期);链长 2–3 张,只返回 1 张说明中间证书没配全,部分 Android 与旧客户端会报 unable to get local issuer certificate。
页面里还有没有 http:// 资源?
# 抓首页 HTML 里所有 http:// 开头的引用,去重后看前 20 条
curl -s https://example.com | grep -o 'http://[^"]*' | sort -u | head -20
理想输出为空。但这条命令只覆盖服务端渲染出的 HTML,JS 动态注入的资源抓不到,所以还要打开 Chrome DevTools:Console 面板过滤 Mixed Content,Network 面板右键表头勾选 Protocol 列后排序,http 请求数应为 0。据 MDN 与 W3C 混合内容规范,主动内容(script、iframe、XHR)会被浏览器直接拦截,被动内容(图片、音视频)在 Chrome 中会被自动升级为 https 或拦截,这也是“页面看着正常但功能坏掉”的典型来源。
HSTS 头与外部评级怎么核对?
# 期望输出:strict-transport-security: max-age=31536000; includeSubDomains
curl -sI https://example.com | grep -i 'strict-transport-security'
# testssl.sh 5.0,--fast 只跑关键检查项,几分钟出结果
./testssl.sh --fast https://example.com
HSTS 由 RFC 6797 定义,只对 HTTPS 响应生效且浏览器会记住 max-age;上线时建议先用 max-age=300 试跑,确认无 http 子域后再改到 31536000,因为一旦加 preload 并提交到 hstspreload.org,撤回周期以月计。评级方面,SSL Labs(ssllabs.com/ssltest)目标 A 及以上,testssl.sh 不应出现 HIGH 级告警(常见来源是 TLS 1.0/1.1 未关、RC4 或弱 DH 参数)。
WordPress 自己认为自己是 HTTPS 吗?
# 两个 option 都必须是 https 开头;--path 指向 WordPress 根目录
wp option get siteurl --path=/var/www/html
wp option get home --path=/var/www/html
# 查数据库里残留的硬编码 http 链接,表前缀用 wp db prefix 确认
wp db query "SELECT COUNT(*) FROM wp_posts WHERE post_content LIKE '%http://example.com%';"
前两条应返回 https://example.com,第三条应为 0。后台“工具 → 站点健康 → 信息 → 服务器”里的“是否使用 HTTPS”为“是”,对应 WordPress 5.7+ 的 https_status 检测项。注意不要用 SQL 的 REPLACE() 批量改正文——会破坏 PHP 序列化字段的长度前缀,应改用 wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise。
| 验证项 | 命令 / 入口 | 通过标准 |
|---|---|---|
| 跳转链 | curl -sIL |
仅一次 301,紧跟 200 |
| 证书 | openssl s_client |
剩余 >30 天,issuer 为 R10/R11,链长 2–3 |
| 混合内容 | curl | grep 'http://' + DevTools |
输出为空,http 请求数 0 |
| HSTS | curl -sI |
max-age=31536000; includeSubDomains |
| 评级 | SSL Labs / testssl.sh | A 及以上,无 HIGH 告警 |
| 站内状态 | wp option get / 站点健康 |
siteurl、home 均为 https,残留链接 0 |
这六项全部通过,才算 wordpress 全站https 真正落地;只看到地址栏小锁并不够——小锁只证明当前页面主文档走了 TLS,不覆盖跳转层数、证书链完整性和数据库里的旧链接。
WordPress 全站 HTTPS 上线后的长期维护:续期、HSTS 与混合内容监控
certbot 的自动续期到底有没有在跑?怎么确认它没有静默失败?
据 Let’s Encrypt 文档,证书有效期固定为 90 天,官方建议在到期前 30 天完成续期,逾期不续没有任何宽限期。certbot 的发行包在 systemd 环境下自带 certbot.timer(certbot ≥ 0.21,Ubuntu 18.04 / Debian 10 起默认安装),每天触发两次,实际配置为 OnCalendar=*-*-* 00,12:00:00 叠加最长 12 小时的 RandomizedDelaySec,用于给 ACME 服务器削峰,所以别按固定时间点去对表。
# 1) 确认定时器存在且处于 active (waiting)
systemctl list-timers certbot.timer
systemctl status certbot.timer --no-pager
# 2) 演练一次完整续期,不写盘、不消耗速率限制
sudo certbot renew --dry-run
# 成功时末尾输出:Congratulations, all simulated renewals succeeded
# 3) 演练失败就看日志,别猜
sudo journalctl -u certbot.service -n 50 --no-pager
# 典型报错:Failed to renew certificate example.com with error:
# DNS problem: NXDOMAIN looking up A for example.com
续期成功但浏览器仍提示证书过期,九成是 Nginx 没重载——它把旧证书缓存在 worker 内存里。用 deploy hook 补上这一步:
sudo mkdir -p /etc/letsencrypt/renewal-hooks/deploy
sudo tee /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh >/dev/null <<'EOF'
#!/bin/sh
# certbot 仅在证书确实更新后才执行 deploy hook
nginx -t && systemctl reload nginx
EOF
sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
HSTS 能不能一次写满 max-age=31536000?
不能。据 RFC 6797,HSTS 一旦下发,浏览器在 max-age 期间对该域名强制 HTTPS,没有任何浏览器端回退入口——证书出问题时用户看到的 NET::ERR_CERT_DATE_INVALID 页面连”继续访问”都点不了。所以只能阶梯放量,短 max-age 就是你唯一的回滚手段。
| 阶段 | 响应头取值 | 建议观察期 | 主要风险 | 回退方式 |
|---|---|---|---|---|
| 1 试水 | max-age=300 |
24 小时 | 几乎无 | 等 5 分钟自动失效 |
| 2 加固 | max-age=86400 |
1 周 | 证书链故障时用户 1 天内不可访问 | 改回 300,等 1 天 |
| 3 长周期 | max-age=31536000; includeSubDomains |
长期 | 任一子域缺证书即整域不可达 | 无,只能等一年 |
| 4 preload | max-age=31536000; includeSubDomains; preload |
提交前先跑数周 | 写入 Chrome 硬编码列表 | 申请移除,需数月 |
加 includeSubDomains 前,必须逐个确认 mail.、api.、cdn. 等所有子域都有有效证书。据 hstspreload.org 的提交要求,preload 门槛是 max-age ≥ 31536000、含 includeSubDomains、所有子域支持 HTTPS 且不再重定向到 HTTP;提交后进入 Chrome 硬编码列表,移除需跟随浏览器发布周期,往往数月才能生效。WordPress 站常有测试子域或客户自建 CDN,这一步最容易翻车。
自动续期失败了怎么第一时间知道?
用外部探针独立验证,别信任本机 certbot 的日志。Zabbix、Uptime Kuma 或一条 cron 都能做:
# 取真实链上证书的到期时间(不是本地文件时间)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate
# 输出:notAfter=Jun 12 03:14:07 2026 GMT
# 换算成剩余天数,低于 21 天告警
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -checkend $((21*86400)) || echo "CERT EXPIRING"
-servername 不能省,否则 SNI 缺失会拿到默认站点的证书,监控就白做了。openssl x509 -checkend 在 OpenSSL 1.0.2+ 均可用。
上线后还有零星的 http:// 资源怎么办?
先加一层兜底,把残留的 http 子资源在浏览器侧自动升级为 https:
# nginx.conf 的 server 块内;always 需 nginx ≥ 1.7.5
add_header Content-Security-Policy "upgrade-insecure-requests" always;
注意 add_header 的继承规则:只要 location 块里自己写了任何一条 add_header,server 级的全部失效,务必用 curl -I https://example.com 逐路径验证响应头真的存在。CSP 的 upgrade-insecure-requests 只处理页面引用的资源,修不了硬编码在 JS 里的 API 回调地址,那类问题仍需定期扫描:
grep -rn --include='*.js' --include='*.php' 'http://'
wp-content/themes/your-theme/assets/
| grep -v 'www.w3.org' # 过滤 schema 命名空间等合法 http 串
浏览器控制台的 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure element 'http://...' 就是漏网资源的定位线索,MDN 的 Mixed Content 文档列出了被动/主动混合内容的不同阻断策略,图片属被动内容可被升级,XHR 与脚本属主动内容会被直接拦截。
多站点、多域名与 CDN 场景下的 WordPress 全站 HTTPS
WordPress Multisite 下 wp search-replace 到底该加什么参数?
多站点网络里每个子站都有自己的 wp_2_options、wp_3_posts 等表,不加 --network 就只处理主站。WP-CLI 2.1 起 search-replace 支持 --network(默认关闭),会遍历网络内全部站点表:
# 0) 多站共用 wp_users / wp_usermeta,替换错了会锁死所有站点登录,先整体备份
wp db export /backup/pre-https-$(date +%F).sql
# 1) 演练:--dry-run 默认 false,必须显式加上;--precise 走 PHP 反序列化安全替换(较慢但不会破坏序列化字段)
wp search-replace 'http://example.com' 'https://example.com'
--network --all-tables-with-prefix --precise --report-changed-only --dry-run
# 2) 确认无误后去掉 --dry-run 执行
wp search-replace 'http://example.com' 'https://example.com'
--network --all-tables-with-prefix --precise --skip-columns=guid
# 3) 只想修某个子站:用 --url 指定,避免误伤
wp search-replace 'http://sub.example.com' 'https://sub.example.com'
--url=https://sub.example.com --all-tables-with-prefix --precise
# 4) wp_blogs / wp_site 不在 --network 覆盖范围,必须手动改,否则子站后台跳转仍走 http
wp db query "UPDATE wp_blogs SET domain='example.com'; UPDATE wp_site SET domain='example.com';"
Cloudflare 该选哪种 SSL/TLS 模式?据 Cloudflare 文档,Origin CA 证书默认有效期 15 年,仅被 Cloudflare 边缘信任,适合锁死源站只允许 CF 回源。
| 加密模式 | 边缘→源站 | WordPress 后果 |
|---|---|---|
| Flexible | HTTP(80) | 源站 301 跳 https,CF 再以 http 回源 → ERR_TOO_MANY_REDIRECTS,是 wordpress 全站https 死循环的头号原因 |
| Full | HTTPS,不校验证书 | 可用但存在中间人风险 |
| Full (strict) | HTTPS + 校验证书链 | 推荐;源站装 Origin CA 或 Let’s Encrypt 证书 |
负载均衡后面,日志全是 10.x 内网 IP 怎么办?证书装在 LB 上,源站需信任代理头,Nginx 内置 realip 模块(1.2.1+,默认 off):
set_real_ip_from 10.0.0.0/8; # 只信任 LB 网段,切勿写 0.0.0.0/0
set_real_ip_from 172.16.0.0/12;
real_ip_header X-Forwarded-For; # 默认 X-Real-IP
real_ip_recursive on; # 默认 off,多级代理时取最左侧可信 IP
同时让 WordPress 识别 HTTPS,否则后台仍生成 http 链接:
// wp-config.php,仅在确认请求来自可信 LB 时启用
if (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {
$_SERVER['HTTPS'] = 'on';
}
多域名要几张证书?据 Let’s Encrypt 文档,单张证书最多含 100 个名称(SAN),通配符 *.example.com 只覆盖一级子域,a.b.example.com 不匹配。域名少时把多个 server_name 塞进同一个 443 块共用一张 SAN 证书;域名归属不同团队时每域一个 server 块各自 ssl_certificate,靠 SNI 分流。
OCSP stapling 值得开吗?能省掉客户端单独查询 OCSP 的一次往返,实测首字节时间改善 20–80 ms。Nginx 1.3.7+ 支持,默认 off:
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; # 注意是 chain.pem,不是 fullchain.pem
resolver 8.8.8.8 1.1.1.1 valid=300s;
resolver_timeout 5s;
# 验证是否生效:输出中出现 "OCSP Response Status: successful" 即为正常
openssl s_client -connect example.com:443 -servername example.com -status </dev/null | grep -A2 "OCSP Response"
只要 http 全部 301 到 https 且 sitemap 里只出现 https URL,权重会正常转移,一般 2–8 周完成。谷歌从 2014 年起把 HTTPS 作为轻量排名信号,百度也在 2015 年公告对 HTTPS 站点优先展示;真正导致掉收录的是 http 与 https 同时可访问、形成重复内容。
可以,插件会在 PHP 输出缓冲层把 http:// 改写成 https://,并自动加 HSTS 和 301,对没有 SSH 权限的虚拟主机够用。但它多一层 ob_start 开销,且改不到 .js、.css 文件内部硬编码的地址;建议把 301 交给服务器层,插件只作为过渡或兜底。
先执行 curl -sIL https://example.com/wp-admin/ 看跳转链,若在 http 与 https 之间来回跳,说明 PHP 侧 is_ssl() 返回 false。检查 wp-config.php 是否按 HTTP_X_FORWARDED_PROTO 设置 $_SERVER['HTTPS']='on',以及 Cloudflare 是否仍处于 Flexible 模式。
加密强度与浏览器兼容性一致,都是 RSA 2048 或 ECDSA P-256,支持 TLS 1.2/1.3。差别在有效期(90 天 vs 398 天)、是否带商业 SLA 与赔付条款、以及 OCSP/CRL 服务的稳定性。预算为 0 就用 Let's Encrypt 配自动续期,需要赔付条款再考虑 OV。
不会,只要搜索串写成完整的 http://example.com 而不是只写 http://。–precise 会按 PHP 序列化规则重算字符串长度,避免反序列化失败;–skip-columns=guid 建议保留,因为 guid 是文章永久标识,改了可能导致 RSS 订阅者重复收到旧文章。
用 curl -s https://example.com | grep -o 'http://[^"]*' | sort -u 全量扫 HTML,再 grep -rn 'http://' wp-content/themes/*/assets 查 CSS 的 url(http://…) 与 JS 动态拼接地址。异步加载的资源不会立刻报错,需要在 DevTools Network 面板刷新后按 Protocol 列排序查看。
TLS 1.3 完整握手只需 1-RTT、会话复用可 0-RTT,开启 http2、ssl_session_cache shared:SSL:10m 与 OCSP stapling 后,HTTPS 与 HTTP 的 TTFB 差异通常在 10–30 ms 内。真正拖慢速度的是混合内容重试和证书链不完整导致的额外握手。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。