在安装 Docker 容器化平台时，我们遇到了一个典型问题：容器启动过程中访问镜像仓库服务失败，重试了 40 次依旧无法解决问题。 在 Docker 容器化平台安装过程中，我们遇到了一个典型问题：容器启动过程中访问镜像仓库服务失败，重试40次依然无果。 部署同学在节点上手工测试时发现报错。 对网络熟悉的同学都知道，主机上的 DNS 解析会优先匹配 /etc/hosts 中配置的本地解析，如果 hosts 里没有配置相关条目，系统才会通过 /etc/resolv.conf 中的 DNS 服务器进行查询。 排查过程中我们发现，仓库服务在部署时会在所有节点配置本地解析，可以先用 curl 或者 ping 命令测试解析效果。 节点手工访问同样出现解析失败的情况。 检查 /etc/hosts 确实配置了本地地址解析。 明明已经在 /etc/hosts 里写了对应的解析记录，为什么主机仍然提示无法解析这个域名？ 通过 strace 命令追踪解析调用的详细过程，我们发现解析过程中系统读取了 /etc/nsswitch.conf 配置文件。 进一步排查时注意到，该文件中的相关配置项被意外注释掉了。 这意味着解析顺序的配置被改动了。按照 Linux 的设计，系统解析域名时会严格按照 files → dns → myhostname 的顺序进行查询。一旦这个顺序被调整，甚至像这样直接被注释掉，就会出现“明明写在 /etc/hosts 里，却没有生效”的现象。 那么问题原因就很清楚了：由于此配置被注释，Linux 系统默认走到了 DNS 服务器查询 IP，但此域名并没有在 DNS 注册过，解析不出来完全符合预期。 修改 /etc/nsswitch.conf 文件，将注释去掉，恢复为系统默认的解析顺序配置。 保存后立即生效，再次访问服务时状态恢复正常。 通过这次排查我们可以总结出几点经验：首先，不要忽视基础配置文件的重要性。很多看似复杂的安装失败问题，最终原因往往出在最基础的系统配置上。其次，熟悉主机名解析顺序非常关键，/etc/nsswitch.conf 决定了系统解析域名的优先级顺序，但这个文件平时容易被忽略。最后，排查问题要有层次，先确认本地 hosts 解析是否生效，再检查 DNS 配置，最后才去检查系统配置文件，这样才能快速定位问题根源。