前言
上篇文章《用这些插件来优化你的WordPress博客体验,保护网站的安全》刚把插件整理利索,正打算按清单装两个新插件,WordPress后台的插件商店直接报了红:发生了预料之外的错误。赶紧去站点健康看一下,发现报错:cURL error 6: Could not resolve host: api.wordpress.org。

这个错误可不仅是无法访问插件商店,还会导致核心、主题、插件的自动更新失效,并可能引发依赖官方接口的功能异常,所以这个问题是非解决不可的。
先交代以下我博客的运行环境:跑在 VMRack 的一台洛杉矶VPS上,Ubantu22系统,用 1Panel 管理,WordPress 装在容器里。
下面是我排查这个问题的全过程,如果你也有这个困扰,可以参考看看。
先确认宿主机没毛病
所有问题都要先排查宿主机。
第一条命令查域名解析。dig 是命令行查 DNS 的工具,装在 dnsutils 这个包里(Ubuntu/Debian 用 apt 装;CentOS 系对应的是 bind-utils):
sudo apt install dnsutilsdig api.wordpress.org +short如果返回了具体的 IPv4 地址(各家网络环境不一样,具体值不用在意)。那么宿主机解析域名正常。
第二条命令查出站连接:
curl -v -I https://api.wordpress.org 如果TLS 握手成功、证书验证通过,能拿到 HTTP 状态码。那么宿主机到 WordPress.org 的路就是通的,注意要保证系统时间与当地时间一致(比如我的洛杉矶VPS就要和美国的时间对齐),时间不对会连证书校验都过不了。
第三条查本机缓存。nscd 是一个本机域名缓存服务,如果它缓存了旧的解析记录,也会造成连接错误:
systemctl is-active nscd如果返回 inactive,则表示没有缓存干扰。
到这里,宿主机的网络三件套——解析、连通、缓存全部正常。但站点健康里还是出现那个 cURL error 6。那么问题可能就出在博客程序自己的运行环境里,也就是容器。
对比容器内外的 DNS
怀疑容器,就先对比两边的 DNS 配置。宿主机和容器各有一份 /etc/resolv.conf,去看一眼这两个文件就明白差异:
cat /etc/resolv.conf宿主机这边是正常的公共 DNS;容器里则是 127.0.0.11——这是 Docker 的内置 DNS 代理,所有容器默认都走它,由它转发到真正的 DNS 服务器。这个地址本身是正常的,说明配置层面没错。
也就是说,容器的 DNS 架构没问题,但解析行为和宿主机不一样。问题应该藏在更深一层。
临时绕过:hosts 绑定
在动容器之前,先用一个经典办法验证判断:把 WordPress.org 的 IP(之前第一步查到的IPv4地址) 手工写进宿主机的 hosts 文件,跳过解析这一步:
echo "你查到的IP api.wordpress.org" | sudo tee -a /etc/hosts
然后重启 WordPress 容器,看看插件商店是否恢复了。
如果恢复正常,就把这条 hosts 记录删掉,因为 WordPress.org 的 IP 是会变的,今天绑的 IP 过段时间就会失效,找不到根本原因,商店还是会莫名坏掉。这招只适合用来应急,不是长久之计。所以我决定继续把根因挖出来。
关键转折
进容器看它的解析结果(容器名在 1Panel 的容器列表里能看到):
docker exec -it 容器名 bashgetent hosts api.wordpress.orggetent 是查系统解析结果的工具。这一下看到了有意思的东西:返回的是一条“2xxx:xxx:xxxx::xxxx:xxxx”这种样式的 IPv6 地址。
马上在容器内验证 IPv6 通不通:
curl -6 -I https://api.wordpress.org
连接失败。答案拼出来了:容器把域名解析成了 IPv6 地址,优先拿它去连,但这台服务器的网络环境走不通 IPv6,这个解析出来的地址用不了,WordPress 的 cURL 拿不到可用连接,最终就表现为"无法解析域名",引发 WordPress 报错断连。
走过的弯路:宿主机的配置管不到容器
知道是"解析策略问题"后,我先用常规思路改了两处宿主机配置:一处是 /etc/gai.conf(调整 IPv4/IPv6 的优先级),一处是新建 /etc/docker/daemon.json 给容器指定 DNS。
结果都无效:容器里解析依然优先返回 IPv6地址。
原因就是容器有自己独立的一套配置文件。gai.conf 在容器镜像里还有一份,改宿主机的管不到容器;daemon.json 里配 DNS 只是换了"问路的对象",没有改"拿到 IPv4 和 IPv6 时先走哪条"的策略。Linux 的地址选择策略遵循 RFC 6724,默认 IPv6 优先,这个策略要看容器自己的 gai.conf。
彻底解决:改容器自己的 gai.conf
还是在容器的命令行里,给容器的 gai.conf 加一行策略。gai.conf 是 glibc 的地址选择配置,控制"同一域名同时有 IPv4 和 IPv6 时优先用哪个",这行配置的作用就是把 IPv4 提到最优先:
echo 'precedence ::ffff:0:0/96 100' >> /etc/gai.conf改完即时生效,不用重启任何服务。用 getent 的 ahosts 模式验证——它会按系统策略把解析结果排序,排在最前面的就是系统会优先用的地址:
getent ahosts api.wordpress.org这次返回的 IPv4 地址排在了最前面。回插件商店,一切正常,问题彻底解决。
持久化:别让重建容器把修复抹掉
还有最后一步必须做。直接改容器内文件有个隐患:容器一旦重建(升级镜像、1Panel 里重装应用都会触发),文件就回到镜像里的初始状态,修复悄无声息地消失。
所以把这行配置固化下来,在容器的编排配置里加一个只读挂载:
volumes: - ./gai.conf:/etc/gai.conf:ro宿主机上放一份写好策略的 gai.conf,挂进容器覆盖原文件。以后容器怎么重建,策略都在。
总结
这次排查走完,留下三条经验:
- 排查顺序:先宿主机后容器、先连通性后解析策略,一步排除一层,别一上来就改配置;
- 容器是独立的配置世界:hosts、gai.conf、resolv.conf,容器里都有自己的副本,宿主机改了不等于容器生效;
- 修复要闭环:容器内改的文件要用挂载固化,否则一次重建就打回原形。
后台连不上 WordPress.org 这类问题的原因比较复杂,可能在宿主机,也可能在容器。不过一般来说,如果宿主机初次能够成功安装WordPress,那么宿主机错误的可能性是比较小的,根因最有可能就在容器里,下次再遇到容器里的网络怪病,就要记得想想 IPv6 这层。





