跳到主要内容
安装配置教程

WordPress 全站 HTTPS 配置全流程:从证书部署到混合内容清理的 8 步实操指南

wordpress 全站https — 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. 第 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. 第 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. 第 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. 第 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. 第 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. 第 6 步:清理主题与插件里的硬编码

    grep -rn "http://example.com" wp-content/themes wp-content/plugins 
      --include=*.php --include=*.css --include=*.js
    

    命中的多半是背景图、字体 @import 和硬编码的 AJAX 端点,逐个改成 //example.com 或 https://。

  7. 第 7 步:清对象缓存与瞬态

    wp cache flush          # 清 Redis/Memcached 对象缓存
    wp transient delete --all
    

    不清理的话,旧的 siteurl 会从缓存里继续吐出来,表现为后台改了、前台没变。

  8. 第 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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