规范
代理服务（agent-service）是运行在中心服务器主机上的本机运维代理（Rust 实现），提供 PostgreSQL 数据库备份等主机侧运维能力，不经过网关。
本页为源码归纳（日期基线 2026-09-14；实例
http://192.168.1.53:8066同日实测）；重摸底刷新，非脚本生成。
service-positioning 服务定位
- 服务直接运行在中心服务器主机上，默认监听端口 （可配置），无网关前缀——API 基路径即
/agent-api/v1。 - 接口面共 5 个端点（数据库备份 3、系统 1、用户 1），全量清单见端点清单。
- 定时任务 1 个（每小时 PG 备份），全量清单见 data-service 运行时 · 定时任务。
request-and-auth 请求与鉴权
- 端点鉴权为可选
token查询参数：该值的生成算法属于内部实现，不在文档披露范围，具体生成方式请与开发人员沟通确认；token与time（客户端毫秒时间戳）查询参数成对使用（源码归纳）。 - 响应为普通 JSON（无统一信封），错误经 axum 错误处理返回；字段级契约以 Swagger 视图（静态 OpenAPI 3.1.0）为准。
scheduled-task 定时任务
agent-service 内置 1 个定时任务：每小时自动执行 PostgreSQL 数据库备份。
| 任务 | 触发 | 行为 |
|---|---|---|
| PG 数据库自动备份 | 每 3600 秒（tokio::time::interval，服务启动即开始计时） |
对容器 es-center-server-pg-0 内数据库 es-center-server（用户 es、容器内端口 5432）执行 pg_dump，产物落 {data_root}/db_backups（源码归纳） |
备份产物可通过 端点清单 中的 backup/list、backup/download/{filename} 查询与下载。
local-self-check 本机自查
在中心服务器主机上可直接自查 agent 的在线 API 文档（实例地址按实际部署替换，下例为局域网实测实例）：
- Swagger UI：
http://192.168.1.53:8066/swagger-ui - OpenAPI JSON：
http://192.168.1.53:8066/api-docs/openapi.json
拉取 OpenAPI JSON
本站 Swagger 视图 使用的静态 json 即由同步脚本从该地址刷新（重跑整体覆盖）。
目录