- libraryagent:0700 目录内 0600 unix socket + SO_PEERCRED 同 uid, 固定 binary/归档/日志/项目/写入者声明,请求只能选范围与作业号 - API:POST/GET /api/v1/library/captures(入队 library.capture + 读队列状态) - worker:library.capture handler 走 socket;启动先 recover;不挂 Docker socket、 不持有来源凭据 - web:整库版本页显示真实作业状态并可发起封存(未接线/无权限给出原因) - scripts/library-agent-install.sh:构建、安装 systemd user 服务并读回权限
This commit is contained in:
+18
-1
@@ -45,7 +45,24 @@
|
||||
|
||||
同一个作业号重跑是**幂等重放**:直接返回已封存的同一份候选(`replay=true`、`source_read=false`、`writers_stopped=false`),不读来源、不停写入者;同一作业号换了 scope 或绑定库则明确拒绝。
|
||||
|
||||
页面侧的发起入口尚未接线(需要最小权限的主机执行边界,见进度文件),当前只能在目标主机执行命令。
|
||||
## 从页面发起封存(主机侧 agent)
|
||||
|
||||
页面点「发起对内/对外封存」只是**投递一个作业**;执行发生在这台主机上的 agent:
|
||||
|
||||
- `scripts/library-agent-install.sh` 构建并安装 `libraryagent`(systemd **user** 服务),
|
||||
监听 `~/.local/share/knowledge-governance/agent/agent.sock`,目录 0700、socket 0600,
|
||||
并额外用 `SO_PEERCRED` 要求对端与 agent 同 uid。
|
||||
- agent 自己固定 `libraryctl` 的路径、归档与日志根、Compose 项目与写入者声明;
|
||||
请求只能选 `scope`(internal/external)和作业号,**不能**指定路径、项目、容器或命令。
|
||||
- 只有 worker 通过挂载的 socket 目录投递作业(`LIBRARY_AGENT_SOCKET`)。容器里
|
||||
**没有** Docker socket,**没有**来源凭据:停写入者、读来源、恢复都在主机进程里完成。
|
||||
- worker 启动时会先调一次 `recover`,把上次崩溃留下的停机窗口收尾;
|
||||
失败会记日志而不是假装就绪。
|
||||
- 同一 `scope + 作业号` 重复投递时,agent 走幂等重放,不会第二次停源。
|
||||
|
||||
安全边界要说清:socket 目录对 worker 可写,因此被攻破的 worker 可以让 agent 执行
|
||||
"封存 internal/external"这一类动作(这正是页面能力),但拿不到 Docker API、
|
||||
拿不到来源凭据,也不能重定向到别的项目或路径。
|
||||
|
||||
## 2026-10-28 实测(本机测试栈)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user