Windows 10企业版Docker容器部署Self-hosted Agent失败：无法解析dev.azure.com域名

我来帮你排查这个棘手的问题！你遇到的Invoke-RestMethod : The remote name could not be resolved: 'dev.azure.com'错误，核心原因是Windows Docker容器无法解析外部域名，没法和Azure DevOps服务器建立连接。咱们一步步来排查解决：

第一步：确认宿主机的网络连通性 #

先排除宿主机本身的网络问题，在你的Windows 10企业版机器上打开PowerShell，执行以下命令：

• 解析域名：nslookup dev.azure.com，看是否能返回正常的IP地址
• 测试端口连通性：Test-NetConnection dev.azure.com -Port 443，确认能成功建立TCP连接

如果宿主机这里就失败了，那得先解决宿主机的网络问题：比如检查DNS服务器设置、关闭不必要的防火墙/安全软件、确认是否需要配置代理等。

第二步：手动指定Docker容器的DNS服务器 #

Windows Docker容器默认会继承宿主机的DNS配置，但有时候会出现解析异常。可以尝试手动指定可靠的DNS服务器（比如谷歌的8.8.8.8）来运行容器，修改后的命令如下：

docker run --dns 8.8.8.8 -e AZP_URL="https://dev.azure.com/MyOrg/" -e AZP_TOKEN="XXXXXXXXXXXXXXXXXXXXXXXXXX" -e AZP_AGENT_NAME="LocalSelfHostTest1" -e AZP_POOL="LocalSelfHostTest" dockeragent:latest

第三步：尝试使用Host网络模式 #

Windows容器支持host网络模式（注意仅适用于Windows容器，Linux容器的host模式不同），这种模式下容器会直接使用宿主机的网络栈，可能绕过DNS解析的问题。修改运行命令：

docker run --network host -e AZP_URL="https://dev.azure.com/MyOrg/" -e AZP_TOKEN="XXXXXXXXXXXXXXXXXXXXXXXXXX" -e AZP_AGENT_NAME="LocalSelfHostTest1" -e AZP_POOL="LocalSelfHostTest" dockeragent:latest

第四步：进入容器内部排查网络细节 #

如果上面的方法都没效果，咱们直接进入容器内部查看网络状态：

1. 启动一个临时容器并进入PowerShell：

docker run -it --rm dockeragent:latest powershell

2. 在容器内执行以下命令，排查网络问题：
   • nslookup dev.azure.com：检查容器内是否能解析域名
   • Test-NetConnection dev.azure.com -Port 443：检查容器能否连接到Azure DevOps的443端口
   • Get-DnsClientServerAddress：查看容器当前的DNS服务器配置

如果容器内确实无法解析域名，可能是Docker的网络驱动出现异常，尝试重启Docker服务后再重试。

第五步：配置代理环境变量（如果宿主机使用代理） #

如果你的Windows 10机器是通过代理上网的，Docker容器需要额外配置代理环境变量才能访问外部网络。修改运行命令，添加代理相关的环境变量（替换为你实际的代理地址）：

docker run -e HTTP_PROXY="http://your-proxy-address:port" -e HTTPS_PROXY="http://your-proxy-address:port" -e NO_PROXY="localhost,127.0.0.1,dev.azure.com" -e AZP_URL="https://dev.azure.com/MyOrg/" -e AZP_TOKEN="XXXXXXXXXXXXXXXXXXXXXXXXXX" -e AZP_AGENT_NAME="LocalSelfHostTest1" -e AZP_POOL="LocalSelfHostTest" dockeragent:latest

内容的提问来源于stack exchange，提问作者Arvind Bhatt