Windows环境下手动安装Azure DevOps代理遇VS30063权限问题求助

1. 下载代理安装包 #

• 登录Azure DevOps Server（原TFS）门户，进入项目设置 -> 代理池
• 点击下载代理，选择对应操作系统的安装包（Windows/Linux/macOS）
• 将安装包解压到目标机器的本地目录，比如C:\AzureDevOpsAgent（Windows）或/opt/azuredevopsagent（Linux）

2. 配置代理 #

• 打开命令提示符（Windows）或终端（Linux/macOS），切换到解压后的代理目录
• 执行配置命令：
  Windows：config.cmd
  Linux/macOS：./config.sh
• 按提示输入信息：
  • Azure DevOps Server URL：必须带/tfs后缀，比如http://xxx.xxx.x.xxx:8080/tfs，不要仅输入IP加端口
  • 认证类型：选择Negotiate（域环境适用）或Personal Access Token (PAT)（通用场景）
  • 若使用PAT，需在TFS门户生成一个拥有代理池管理权限的令牌，确保令牌未过期
  • 代理池名称：选择已存在的代理池或新建一个
  • 代理名称：自定义即可
  • 工作目录：使用默认值或指定一个空目录

3. 安装并启动代理服务 #

• Windows系统：执行svc install将代理注册为Windows服务，再执行svc start启动服务
• Linux/macOS系统：执行./svc.sh install注册服务，./svc.sh start启动服务
• 验证：回到TFS门户的代理池页面，确认代理状态显示为在线

1. 检查基础网络连通性 #

• 在代理机器上执行ping xxx.xxx.x.xxx，确认服务器IP可达
• 执行telnet xxx.xxx.x.xxx 8080测试端口连通性，若无法连接，说明端口被拦截：
  • 检查TFS服务器的Windows防火墙，确保8080端口允许入站连接
  • 排查代理机器到TFS服务器之间的网络设备（路由器、交换机），确认8080端口已开放

2. 修正服务器URL格式 #

• 多数情况是URL缺少/tfs后缀，正确格式应为http://xxx.xxx.x.xxx:8080/tfs，重新执行配置命令输入正确URL后重试

3. 验证权限与认证方式 #

• 使用域账号认证时，确保代理机器已加入域，且代理服务的运行账号为域内账号并拥有TFS管理员权限
• 使用PAT认证时，确认PAT拥有**代理池（读取、管理）**权限，且未过期
• 在代理机器上用浏览器直接打开TFS服务器URL，确认能正常登录并访问代理池页面

4. 调整代理服务运行账号权限 #

• Windows系统：代理服务默认使用Local System账号，可能存在域权限问题，可修改服务登录账号为拥有TFS权限的域账号：
  打开服务面板，找到Azure DevOps Agent服务，右键选择属性 -> 登录，切换为域账号并输入密码
• Linux/macOS系统：确保运行代理的用户拥有足够的文件系统权限，且能正常访问TFS服务器

5. 排查代理配置文件 #

• 打开代理目录下的.agent配置文件，检查serverUrl字段是否正确
• 若配置有误，删除.agent文件后重新执行配置命令

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