配置构建代理对接代理服务器后VSTS状态异常求助

问题背景 #

你尝试将VSTS构建代理对接已配置的代理服务器 http://MY_SERVER_DNS:8081，完成以下操作后出现异常：

• 在构建机器的代理目录下创建了包含代理地址的 .proxy 文件
• 配置了环境变量 VSTS_HTTP_PROXY_USERNAME 和 VSTS_HTTP_PROXY_PASSWORD
• 重启构建代理服务后，VSTS中的状态指示器由绿色变为红色，相关日志开头为 An...

可能的原因及解决步骤 #

1. .proxy 文件格式或内容错误

VSTS构建代理对 .proxy 文件的格式要求很严格，你可以先检查这几点：

• 确保文件内容是纯文本，没有多余空格、换行或特殊字符，正确格式应为：http://MY_SERVER_DNS:8081
• 如果代理服务器同时处理HTTP和HTTPS请求，建议在文件中分别声明：

  http=http://MY_SERVER_DNS:8081
  https=http://MY_SERVER_DNS:8081
  

• 避免编辑器自动添加BOM（字节顺序标记），可以用记事本打开文件后，选择「UTF-8无BOM」格式重新保存。

2. 环境变量配置未生效或权限问题

• 环境变量需要配置在系统环境变量中，而非用户环境变量——因为构建代理服务通常以系统账户运行，无法读取用户级别的变量
• 重启代理服务后，在构建机器的命令行中运行 echo %VSTS_HTTP_PROXY_USERNAME% 和 echo %VSTS_HTTP_PROXY_PASSWORD%，验证变量是否正确加载
• 用curl命令测试代理凭据是否有效，比如：

  curl -x http://MY_SERVER_DNS:8081 -U 你的用户名:你的密码 https://dev.azure.com
  

  如果curl测试失败，说明代理服务器的凭据或自身配置有问题，需要先排查代理服务器端。

3. 代理服务器的网络或防火墙限制

• 确认构建机器能连通代理服务器的8081端口：用PowerShell运行 Test-NetConnection MY_SERVER_DNS -Port 8081，或用命令行运行 telnet MY_SERVER_DNS 8081 测试连通性
• 检查代理服务器是否允许构建机器的IP地址访问，是否有防火墙规则拦截了构建代理的出站请求
• 确认代理服务器没有限制访问Azure DevOps相关域名，比如 dev.azure.com、*.visualstudio.com 等

4. 利用完整日志定位具体错误

你提供的日志片段不完整，建议获取详细日志：

• 找到构建代理目录下的 _diag 文件夹，里面的 Agent_*.log 文件包含完整的错误信息
• 查找日志中带有 proxy、failed、unauthorized 等关键词的条目，比如 401 Unauthorized（凭据错误）、Connection refused（网络不通）这类明确提示，能快速定位问题。

快速验证方案 #

如果上述排查没找到问题，可以尝试重新配置构建代理：停止代理服务后，运行 config.cmd remove 移除现有配置，再重新执行 config.cmd，在配置流程中手动输入代理地址和凭据（不用依赖 .proxy 文件和环境变量），看是否能成功连接VSTS。

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