Azure自托管Pipeline代理开机无法启动，求服务模式修复方案

1. 检查Windows服务基础状态 #

• 按Win+R输入services.msc回车，打开「服务」控制台
• 找到名称格式为「Azure Pipelines Agent (代理池名称_代理名称)」的服务
• 确认启动类型是「自动」，如果不是直接修改；要是已经是自动但服务停着，手动点启动，看会不会弹出错误提示

2. 查系统日志找启动失败原因 #

• 按Win+R输入eventvwr.msc回车，打开「事件查看器」
• 展开「Windows日志」→「系统」，筛选来源为「Service Control Manager」的事件
• 找对应Azure代理服务的失败记录，里面的错误代码和描述能直接定位问题（比如1053是启动超时，1067是进程意外终止）

3. 重配代理服务（无需重建代理） #

• 开管理员权限的命令提示符，进到c:\agents目录
• 先执行config.cmd remove，删掉现有服务配置
• 再执行config.cmd install，重新安装服务（原有代理注册信息会保留）
• 回到服务控制台，把启动类型设为自动，启动服务

4. 验证服务账户权限 #

• 在服务控制台右键代理服务→「属性」→「登录」选项卡
• 确认所用账户（默认是Local System）的权限：
  • 对c:\agents目录有读写权限
  • 能正常访问Azure DevOps的网络
  • 如果用的是域账户，检查账户没过期、密码没改

5. 排查系统组件损坏问题 #

• 执行sfc /scannow扫描修复系统文件，Windows更新可能搞坏部分组件
• 检查.NET Framework版本（Azure代理需要4.6.1以上），可以用命令reg query "HKLM\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full"查看版本号

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