WordPress 后台 524 与 Docker 出网故障复盘

前面的多站优化上线后，WordPress 前台仍然很快，但后台开始出现延迟和 EdgeOne 524。插件与主题安装页也无法正常连接 WordPress.org。

现象与影响

现象 1：后台“转圈几秒”，严重时 524

• 前台秒开（静态/页面缓存命中）
• 后台打开任意页面都要等，偶发直接超时（EdgeOne 524）

现象 2：插件/主题安装页报错

• “发生了预料之外的错误…”
• 站点健康提示：无法与 WordPress.org 通信、REST API/环回请求失败（超时）

排查过程

1）先从 EdgeOne 缓存模板入手：发现“模板不等于可用”

EdgeOne 的 WordPress 缓存模板存在两个典型坑：

• 规则里只提供 URL path = 等于，没有“前缀/包含/正则”时，/wp-admin/ 并不能覆盖 /wp-admin/*.php。
• 兜底写法（例如把“全站”写成 URL path = /.*）如果仍是“等于”，就等于没写。

采取的缓存策略（最终稳定版）

EdgeOne 只缓存静态资源，其他一律不缓存：

• IF：静态后缀（js/css/jpg/png/webp/svg/woff2…）→ TTL 7 天
• ELSE：不缓存

这能避免 HTML/登录态/REST 被边缘缓存误伤，也让“问题归因”更干净。

注：这一步解决的是“缓存误伤/不可控缓存”，但不是最终根因。

2）关键证据：PHP 容器里访问自己站点 REST（wp-json）超时

在宿主机执行：

docker exec -it PHP8 sh -lc 'curl -I -m 10 https://bubaigei.com/wp-json/ || true'

结果：curl: (28) Connection timed out after 10000 milliseconds

这条证据直接说明：后台慢不是浏览器/边缘的问题，是源站（容器）自己发 HTTP 请求就卡住了。

为什么会影响文章编辑页？

• WordPress 后台（特别是 Gutenberg 编辑器）大量依赖 REST API。
• REST/环回慢 → 任何后台页面都可能“转几秒”。

3）第一次误导：把域名映射到“公网 IP”在容器里仍超时

尝试在 compose 里加：

extra_hosts:
  - "bubaigei.com:139.155.110.8"

现象：容器 getent hosts 已指向公网 IP，但 curl https://bubaigei.com/wp-json/ 仍超时。

原因：容器访问宿主机公网 IP 常会遇到 NAT 回环/发夹（hairpin NAT）问题，宿主机自己能通但容器不一定能回环成功。

4）改用 host-gateway（172.17.0.1）

把域名映射改为 host-gateway 并重建容器后，再次验证：

docker exec -it PHP8 sh -lc 'getent hosts bubaigei.com; curl -I -m 10 https://bubaigei.com/wp-json/ || true'

输出解析到 172.17.0.1，并返回 HTTP/2 200。

这一步基本解决了：

• WordPress 后台的 REST/环回超时
• 后台页面普遍“转圈几秒”的核心卡点
• EdgeOne 524 的主要诱因（源站迟迟不响应）

5）第二个根因：插件/主题目录仍报错，宿主机能上网，容器不能上网

宿主机：

curl -I -m 10 https://api.wordpress.org/plugins/info/1.2/ || true
# 200 OK

容器（PHP8）：

docker exec -it PHP8 sh -lc 'curl -sS -m 10 -o /dev/null -w "HTTP=%{http_code}\n" https://api.wordpress.org/plugins/info/1.2/ || echo FAIL'
# 超时 FAIL

结论：不是 WordPress.org 被墙（宿主机能通），而是 Docker bridge 网络出网被拦。

6）快速定位：iptables FORWARD 默认 DROP

查看：

iptables -S FORWARD | head -n 20

结果：-P FORWARD DROP

这会导致：宿主机自己出网没问题，但容器转发/NAT 出网挂掉。

最终修复

A. 让容器内的“站点自请求”走 host-gateway（解决 REST/环回卡顿）

在 PHP8 的 compose 里：

extra_hosts:
  - "bubaigei.com:host-gateway"
  - "d4.bubaigei.com:host-gateway"

重建：

docker compose up -d --force-recreate

验证：

docker exec -it PHP8 sh -lc 'curl -I -m 10 https://bubaigei.com/wp-json/ || true'

B. 修复 Docker 出网（解决插件/主题目录、更新检查）

1）开启内核转发

sysctl -w net.ipv4.ip_forward=1

2）在 FORWARD 链插入三条放行规则（更稳，比全局 ACCEPT 更克制）

iptables -I FORWARD 1 -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT
iptables -I FORWARD 2 -i docker0 -o eth0 -j ACCEPT
iptables -I FORWARD 3 -i eth0 -o docker0 -j ACCEPT

如果默认网卡不是 eth0，用 ip route | grep default 看 dev 是什么再替换。

3）验证容器出网

docker exec -it PHP8 sh -lc 'curl -I -m 10 https://api.wordpress.org/plugins/info/1.2/ || true'

C. 持久化规则

1）保存 IPv4 规则

mkdir -p /etc/iptables
iptables-save > /etc/iptables/rules.v4

2）安装并启用持久化服务

apt-get update
apt-get install -y iptables-persistent
netfilter-persistent save

3）（可选）生成空的 IPv6 规则文件，避免启动报错

ip6tables-save > /etc/iptables/rules.v6
systemctl restart netfilter-persistent

验收标准

1）容器内 REST 自请求正常

docker exec -it PHP8 sh -lc 'curl -I -m 10 https://bubaigei.com/wp-json/ || true'
# 200

2）容器内能访问 WordPress.org API

docker exec -it PHP8 sh -lc 'curl -I -m 10 https://api.wordpress.org/plugins/info/1.2/ || true'
# 200

3）后台体验恢复

• 插件 / 主题安装页可正常加载
• 站点健康不再报 REST/环回/WordPress.org 通信超时
• EdgeOne 524 显著减少或消失

可继续检查的方向

• WP-Cron 改系统 cron，减少后台随机卡顿
• 定期检查 slowlog，定位慢插件/慢查询
• EdgeOne 单独给后台域名直连源站（admin 子域名不走边缘），体验更稳但配置略多