WorkBuddy安装失败若因DNS解析异常，需检查并修复/etc/resolv.conf：确认是否被systemd-resolved等动态覆盖；验证nameserver可达性与解析能力；临时替换为可信DNS测试；禁用动态管理并固化配置；排查容器是否绕过主机DNS。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装WorkBuddy时遇到域名无法解析、依赖包下载失败或服务注册超时等问题，则很可能是系统DNS解析异常所致。/etc/resolv.conf 文件是Linux系统中控制DNS解析行为的核心配置文件，其内容错误或被覆盖将直接导致安装流程中断。以下是针对该问题的排查与修复步骤：
一、确认当前 resolv.conf 文件是否被动态覆盖
许多现代Linux发行版（如使用systemd-resolved或NetworkManager的系统）会动态管理 /etc/resolv.conf，将其设为符号链接而非普通文件，手动修改可能被后续网络事件覆盖。
1、执行命令 ls -l /etc/resolv.conf 查看其类型及指向目标。
2、若输出显示为指向 /run/systemd/resolve/stub-resolv.conf 或 /run/NetworkManager/resolv.conf，说明该文件受服务动态管理。
3、运行 systemctl is-active systemd-resolved 检查 systemd-resolved 服务是否正在运行。
二、验证 resolv.conf 中的 nameserver 条目是否有效
DNS服务器地址必须可达且响应正常；无效IP（如0.0.0.0、127.0.0.1但未运行本地DNS服务）或不可达公网DNS（如已停用的8.8.8.8）会导致解析失败。
1、执行 cat /etc/resolv.conf 查看当前配置的 nameserver 行。
2、对每个 nameserver IP 执行 ping -c 3 <IP> 测试基础连通性。
3、使用 dig @<IP> google.com +short 验证该DNS服务器能否完成实际解析（需替换<IP>为具体地址）。
三、临时替换为可信DNS并测试解析能力
绕过当前配置，直接指定已知可用的DNS服务器进行测试，可快速判断是否为 resolv.conf 内容问题。
1、执行 sudo cp /etc/resolv.conf /etc/resolv.conf.bak 备份原始文件。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、执行 echo "nameserver 114.114.114.114" | sudo tee /etc/resolv.conf 写入国内可用DNS。
3、运行 nslookup workbuddy.example.com（替换为WorkBuddy安装过程中实际尝试解析的域名）验证是否返回正确A记录。
四、禁用动态DNS管理并固化配置
若确认 systemd-resolved 或 NetworkManager 干扰了 resolv.conf，需将其停用或重定向，确保配置持久生效。
1、对于 systemd-resolved：执行 sudo systemctl stop systemd-resolved 停止服务。
2、执行 sudo rm /etc/resolv.conf && sudo touch /etc/resolv.conf 清除符号链接并创建空文件。
3、写入稳定配置：echo -e "nameserver 223.5.5.5\nnameserver 114.114.114.114" | sudo tee /etc/resolv.conf。
五、检查容器或安装脚本是否绕过主机DNS设置
WorkBuddy安装过程若使用Docker或Podman拉取镜像，容器默认可能不继承宿主机 /etc/resolv.conf，或被 --dns 参数强制覆盖。
1、查看安装日志中是否出现 pull access denied 或 connection refused to registry 类错误。
2、检查是否有运行中的容器：执行 docker info | grep -i dns 查看Docker守护进程DNS配置。
3、临时启动一个测试容器验证：docker run --rm alpine nslookup hub.docker.com。
