开发、运维好帮手 - deepseek-harness-remote-node
内容提要
AI Agent 受限于环境上下文，常见方案存在密钥泄露或安全风险。文章提出让环境接入 Agent：deepseek-harness-web 将 dsh 封装为单容器，集中管理模型、会话与密钥；remote-node 让远端机器主动连接，接管文件与命令接口，使 Agent 操作落在远端。相比逐机安装、SSH、Web IDE，更安全易管。
延伸解读
集中式密钥管理如何降低泄露风险
文章指出，在每台机器安装 Agent 会导致模型密钥扩散，N 台机器即 N 份密钥，泄露风险成倍增加。deepseek-harness-web 将模型调用、会话状态和密钥集中在一处管理，远端节点仅运行轻量转发进程，不持有模型访问凭证。这种设计减少了密钥暴露面，轮换时也只需改动宿主端，无需逐台操作。
远端节点主动连接带来的网络与安全优势
remote-node 让远端机器主动通过 wss 连接到 dsh 宿主，而非宿主主动 SSH 到目标机。这避免了宿主持有大量目标机私钥，降低了宿主机失守后的横向移动风险。同时，节点主动连接也简化了网络配置，目标机无需被宿主直接访问，适合反向场景或隔离环境。
与 SSH 和 Web IDE 方案的关键差异
文章对比了 SSH 和 Web IDE 方案。SSH 仅提供 shell，文件读写需拼命令，PTY 和 LSP 需额外搭建；Web IDE 虽提供完整开发环境，但需在每台机器维护运行时，且解决的是人的访问而非 Agent 的远程执行。remote-node 通过替换 ctx.fs 和 ctx.subprocess 两个接口，让 Agent 的文件操作、命令执行、终端和 LSP 全部落在远端，无需修改上层工具。
部署与使用中的注意事项
安装需 Node 22+ 环境，宿主和节点分别执行脚本。节点凭证由宿主安装脚本生成，需妥善保管。一台节点只运行一个 agent 进程，相同 hostname 的第二个 agent 会被拒绝，需检查重复进程。若使用域名访问，需正确设置 TRUSTED_HOST。卸载时需分别清理宿主和节点侧。
Q&A
deepseek-harness-remote-node 是什么？它主要解决什么问题？
deepseek-harness-remote-node 是一个让远端机器成为 deepseek-harness (dsh) 执行环境的工具。它解决的是 AI Agent 无法触达目标环境的问题：通过让远端机器主动连接到 dsh 的 Web 入口，Agent 的文件读写、shell 命令、终端和语言服务器操作都发生在远端机器上，而 Agent 循环、模型调用、会话状态和插件仍保留在宿主机。
deepseek-harness-remote-node 的工作原理是什么？
dsh 将 Agent 的环境操作收敛到两个接口：ctx.fs（文件读写、目录、元信息）和 ctx.subprocess（命令、终端、语言服务器）。remote-node 替换这两个 provider，将调用通过 WebSocket 通道转发到远端节点执行。节点主动连接宿主，上层能力（bash、PTY、LSP）无需修改，完全感知不到替换。
如何安装和配置 deepseek-harness-remote-node？
宿主和节点均需 Node 22+。宿主在 dsh-web 容器中运行 install-host.sh 脚本，可指定 --cwd 和 --proxy；节点在执行环境上运行 install-node.sh，然后使用 dsh-node 命令连接，需提供 --url（wss://<host>/node/v1）和 --credential（由宿主安装脚本生成）。安装后重启 dsh 即可。
deepseek-harness-remote-node 与直接安装 Agent 或 SSH 方案相比有什么优势？
相比直接安装 Agent，它避免了模型密钥扩散、会话历史分散、版本漂移和配置分散的问题；相比 SSH，它提供了更安全的密钥管理、更好的连通性、原生文件读写和完整的终端与 LSP 支持。它将模型调用、会话状态、密钥集中管理，远端只运行轻量转发进程，资源占用少，易于管控大批量机器。
deepseek-harness-web 在方案中扮演什么角色？
deepseek-harness-web 将 dsh 的 Web 界面打包成单个容器，一条命令即可启动 Agent，自带 Web UI、模型路由和持久化存储。它作为上位机，集中管理模型、会话与密钥，是 remote-node 的连接入口和人的操作界面。
使用 deepseek-harness-remote-node 时，Agent 的操作会在哪里执行？
Agent 的文件读写、shell 命令、终端和语言服务器操作全部在远端节点上执行，而 Agent 循环、模型调用、会话状态和插件保留在 dsh 宿主机。例如，问 Agent「工作机还剩多少磁盘空间？」，它会在远端节点上执行 df 命令，而不是在宿主上。
