VSTS代理未读取已配置代理地址问题求助

1. 代理配置文件的位置与格式问题 #

• 确认代理文件存放路径：Windows代理需放在代理安装目录\.agent文件夹下；Linux/macOS放在代理安装目录/.agent下。文件名必须是proxy（无任何后缀），不能带.txt这类扩展名。
• 检查文件内容：确保文件内只有一行代理地址http://192.168.2.101:8080，无多余空格、换行或注释内容。

2. 代理服务未重启 #

修改代理配置文件后，必须重启Azure Pipelines代理服务才能让新配置生效，未重启的话代理会继续沿用旧配置，导致Agent.ProxyUrl仍为undefined：

• Windows：在系统服务列表找到Azure Pipelines Agent，右键选择重启。
• Linux/macOS：进入代理安装目录，执行./svc.sh restart命令。

3. 旧版本代理的兼容性bug #

你使用的2.181.2版本代理相对老旧，该版本可能存在代理配置读取的已知问题，建议升级到最新稳定版：

• 下载对应系统的最新代理安装包，停止现有代理服务，替换文件后重新配置启动。

4. 环境变量冲突 #

检查系统是否存在HTTP_PROXY、HTTPS_PROXY或NO_PROXY环境变量，这些变量会优先于代理文件的配置生效，若存在冲突会导致代理文件的设置被忽略。可临时删除这类环境变量，重启代理后重新测试。

5. 代理文件权限不足 #

确保运行代理服务的用户对proxy配置文件拥有读取权限，权限不足会导致代理进程无法读取文件内容，默认使用undefined的代理地址：

• Windows：打开文件属性的安全选项卡，给代理服务运行用户添加读取权限。
• Linux/macOS：进入代理配置文件所在目录，执行chmod 644 proxy命令设置正确权限。

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