准备环境
确认服务器、网络出口、系统账号、资源清单和联系人,明确访问边界。
01使用路径
确认服务器、网络出口、系统账号、资源清单和联系人,明确访问边界。
完成运行环境、资源授权和安全配置,确保 Agent 可主动出站。
验证注册、心跳、任务领取、资源访问、结果上传和日志留痕。
关注运行状态、任务失败、资源变更、版本升级和异常处理。
02安装部署
准备主机、系统运行时、时间同步、磁盘空间和稳定出站网络。
按机构、站点、资源和任务范围授权,优先使用最小权限账号。
配置密钥、证书、出口白名单、日志留存和升级策略,避免暴露入站入口。
03调试验证
Agent 实例能完成机构、站点和版本信息注册。
底座可持续接收心跳并展示最近在线时间。
Agent 能按授权范围领取白名单任务。
院内资源连接、账号权限和网络策略均满足任务需要。
任务结果、状态和摘要能回传到底座。
关键操作、失败原因、重试记录和版本信息可审计。
04常见问题与排障清单
| 问题现象 | 重点检查 | 处理建议 |
|---|---|---|
| 无法注册或心跳中断 | 网络出口、底座地址、机构标识、密钥和本机时间 | 先确认出站连通性,再核对配置和证书有效期,必要时重新发放接入凭据。 |
| 任务领取失败 | Agent 状态、任务授权、站点绑定、任务队列和版本兼容性 | 核对任务是否进入可领取状态,并确认 Agent 所属机构具备对应授权。 |
| 资源访问失败 | 资源地址、账号权限、院内防火墙、数据库或接口服务状态 | 使用最小测试资源验证访问链路,按资源类型补齐白名单和只读权限。 |
| 结果上传异常 | 上传接口、结果格式、任务状态、附件大小和重试日志 | 保留失败日志和任务编号,先排除格式与大小限制,再触发补偿上传。 |
| 升级后行为不一致 | Agent 版本、配置差异、插件版本、任务模板和发布记录 | 对比升级前后配置与日志,必要时按发布记录回退并补充兼容性验证。 |