让AI代管服务器：sshepherd——SSH的「零知识」革命

SSH 密钥写进 Prompt 这件事，应该是 AI 编程里最让安全工程师血压飙升的操作之一。

偏偏 AI Agent 要操作远程服务器，就绕不开这件事——要么把主机名、用户名、私钥路径全塞进上下文，Agent 手里捧着你的全部家当；要么交给它一个原始终端输出，它在混乱的 docker logs 里艰难地解析有效信息。

sshepherd 就是来解决这个困局的。它的核心理念很有意思：「零知识」——Agent 永远不看到密码、私钥、主机名、端口这些敏感信息。它通过 SSH alias、Postgres target 或 deploy recipe 的名称来调用操作，所有解析都在 SSH config、targets.toml、recipe TOML 这些本地文件里完成，Agent 拿到手的只有「执行结果」和「操作是否成功」。

它能做什么？

52 种操作，分为 9 大类：

• hosts：服务器健康检查（CPU、内存、磁盘、端口、OOM 记录）
• check：更细粒度的主机状态巡检
• services：docker 和 systemd 服务管理（查看、重启、日志）
• logs：日志追踪
• deploy：声明式部署，按 recipe 名称触发
• db：只读 Postgres 数据库内省
• files：远程配置文件读写
• config / security：配置管理和安全审计

所有输出统一为 JSON Envelope 格式（{"ok", "alias", "data", "error"}），Agent 解析有确定性，不会有 parse raw terminal dump 的噩梦。

怎么安装

作为 Claude Code Skill 安装：

npx claudepluginhub francostino/antigravity-awesome-skills --plugin sshepherd

或者直接用 CLI：

npx skills add https://github.com/sickn33/agentic-awesome-skills --skill sshepherd

不过要注意，sshepherd 本身只是一个 Agent-side 的调用层，你还需要在目标机器上预先配置好 SSH alias（~/.ssh/config）和 deploy recipes，它才能生效——换句话说，凭证和安全边界由运维工程师提前定义好，Agent 只在受控范围内行动。

为什么这件事值得注意

随着 Claude Code、Codex CLI、Cursor 这些 AI 编程工具越来越多地介入真实开发流程，AI 操作生产服务器的安全模型成了一个必须正视的问题。传统方案要么给 Agent 太多权限（把 SSH key 喂给它），要么给太少（限制它的感知能力）。

sshepherd 给出了第三种思路：零知识代理。不是让 Agent 少知道一点，而是让它根本不需要知道。把「谁能做什么」的决策从 Prompt 层下放到配置文件层，Agent 只负责执行有名字的操作。

这其实是一种 AI 编程里的最小权限原则——Agent 不持有凭证，只持有能力。

适用场景

• 需要在 CI/CD 流程里让 AI 完成服务器部署但不想暴露密钥
• 开发团队使用 AI 代码助手日常维护多台远程服务器
• DevOps 工程师想给 AI 一个安全的「远程操作手柄」

本质上，这是一个给 AI Agent 用的安全操作层。在 AI 编程工具真正接管开发生产力的路上，这种安全基础设施会越来越重要。

GitHub 仓库 · 支持 Claude Code、Codex CLI、Cursor CLI、Cline、Aider 等主流 AI 编程工具

GitHub: https://github.com/Antheurus/sshepherd