Azure自托管代理报错：代理URL非合法绝对URI字符串

问题分析 #

从代理日志可明确：代理启动时加载/home/mo/azure-agent/.proxy文件配置，但文件内的代理URL "http://proxy.domain.com:SOME_PORT" 不符合标准绝对URI格式，导致代理无法识别代理配置，最终无法连接Azure DevOps服务而显示离线。

修复步骤 #

• 编辑代理根目录下的.proxy文件：

  nano /home/mo/azure-agent/.proxy
  

• 将文件中的代理URL替换为合法格式：把占位符SOME_PORT替换为实际的纯数字代理端口，例如：

  http://proxy.domain.com:8080
  

• 保存文件后重启代理服务：

  ./runsvc.sh restart
  

  若使用systemd托管代理，也可执行：

  sudo systemctl restart azure-pipelines-agent.service
  

验证 #

• 查看_diag目录下的最新日志，确认不再出现VstsAgentWebProxy相关错误信息
• 登录Azure DevOps Web界面，检查自托管代理状态是否恢复为在线

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