Herdr 如何在一个窗口里管理多台 SSH 机器machine add 到切换、禁用、删除全流程【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdrHerdr 的多机模式让你把 Local本机会话和若干台 SSH 机器放进同一个 Herdr 窗口每台机器保留自己独立的 Herdr 服务器、会话和运行中的进程互不干扰某一台掉线不会牵连其他机器。本文按添加 → 验证 → 切换 → 重命名/禁用/删除 → 处理连接问题的顺序给出文档中完整的操作流程。适用环境多机连接目前支持 Linux 和 macOS 客户端连接 x86_64 或 aarch64 的 Linux 或 macOS 服务器。Windows 客户端尚未验证多机连接独立的herdr --remote在 Windows 上仍可用原生 Windows 服务器不能作为 SSH 目标。前提先确认普通 SSH 可达添加机器之前先验证你对远程机器的普通 SSH 访问没有问题ssh workboxworkbox可以是 SSH config 里配置好的 Host 别名也可以是ssh://youserver:2222这类目标。对重复使用的目标建议写进 SSH config文档示例Host workbox HostName server.example.com User you Port 2222用 machine add 添加机器在交互式终端里运行 setup这样 Herdr 在安装或替换任何东西之前都可以先征求你的确认herdr machine add workbox --label Build machine该命令默认使用远程机的默认会话。一个机器 profile 只指向一个远程会话不会把主机上所有会话都拉进来。要挂到命名会话上加可选的--remote-session参数herdr machine add workbox --label Build machine --remote-session agents执行时 Herdr 会同时检查远程已安装的 binary 和正在运行的服务器并在保存 profile 之前启动所请求的后台服务器。客户端和服务器的版本不要求一致兼容即可。安装缺失或不兼容时会走基于审批的 setup如果需要替换正在运行的服务器setup 会在先停止它及其 pane 进程之前询问默认答案是 No安装和替换都缺省时一次确认即可覆盖。machine add不会启用实验性的 live handoff。setup 被取消或失败时profile 不会被保存。验证机器已添加添加完成后运行herdr打开 UI 检查。如果本地已经有 Herdr 客户端开着新添加并处于启用状态的机器通常在一秒内出现并在后台连接不会改变你当前的选择进行中的机器切换会先完成profile 变更才生效。远程服务器在 setup 退出后继续运行。也可以用列表命令核对已保存的 profile脚本场景可加--jsonherdr machine list在侧边栏里切换机器和工作区在侧边栏选择某台机器或它名下的工作区即可切换。被选中的机器接收你的 pane 输入和终端尺寸并提供可见的终端内容与图形其他已连接的机器不流式传输 pane 画面但会持续更新各自的工作区信息、agent 状态和通知。几个文档明确的行为边界Local 在启动时立即打开不等待 SSH 连接某台机器卡住不会阻塞另一台机器的输入。连接丢失后最后一个工作区和 agent 状态仍会显示但变暗——那是缓存信息不是实时状态。在新的连接和匹配的屏幕到来之前对这些缓存 pane 的输入和导航保持禁用。重连永远不会把选择权从你正在使用的机器上拿走。重命名、禁用与删除profile ID 必须从列表里读取不要自己根据 label 或主机名推导herdr machine list herdr machine rename profile-id --label New name herdr machine disable profile-id herdr machine enable profile-id herdr machine remove profile-id各命令的效果文档原文语义rename只改显示用的 label不触发重连。disable保留 profile 以便以后重新启用enable恢复启用。remove忘掉该 profile。禁用和删除都只断开客户端到该机器的那条连接远程机器上的会话和 agent 继续运行即使主机不可达也是如此。如果你删除或禁用的正好是当前正在查看的机器客户端会回到 LocalLocal 不可用时 Herdr 会明确提示并持续重试 Local 连接而不是悄悄选一台别的远程机器顶上。在有已启用保存机器的情况下即使 Local 失败或重启客户端仍可用。连接问题Reconnecting 与 Attention机器状态大致对应文档中的几类现象Reconnecting网络中断、休眠或 SSH 失败后Herdr 按有界退避重试。SSH 连接会检查应用层活动并在静默时探测坏掉的连接不会一直显示 Online。Attention目标机器需要后台连接无法完成的动作比如 host-key 审批、认证或需要一台兼容的服务器。其他机器此时仍可正常使用。Saved-machine file error目录文件不可读或非法时现有连接保持不变Herdr 给出提示并自动重试读取。后台连接永远不会回答提示也不会安装、更新、重启或交接服务器。出现 Attention 时在交互式终端里运行 Herdr 打印出的独立 setup 命令例如herdr --remote workbox使用你 profile 对应的目标如果添加时选了命名会话这里也要带上--session name。跟随审批提示完成 setup 后重启客户端重试 Attention 连接。认证失败时先按普通 SSH 排查如果密钥带 passphrase在启动 Herdr 的非交互式后台连接之前先用ssh-add把密钥加载进 agent。另外不要仅因为版本不同就停止正在运行的服务器。限制与保存数据边界保存的 profile 只包含不透明 ID、label、SSH 目标、显式远程会话和启用状态Herdr 不存储密码、私钥、agent ticket 或 SSH control socket认证始终交给 OpenSSH。客户端和服务器协商兼容性而不是要求版本一致。但已保存机器的连接额外要求服务器具备surface_interest和health_check能力没有这些能力的旧服务器会一直显示 Attention直到显式更新即使独立 attach 能工作也一样。更新兼容的客户端不会替换正在运行的远程服务器也不会停止它的 agent需要新的服务器端行为时要显式更新那台服务器。UI 使用客户端本地的主题、侧边栏设置和键位Herdr 不会把本地命令插件、配置、可执行文件或密钥拷贝到 SSH 主机上远程缺失的命令会显式失败。编辑客户端设置后用 UI 的reload config动作生效参见 Configuration。workspace、tab、pane ID 和 agent 名都限定在单个服务器内两台机器可以都有w1:p1或同名 agent在 UI 里选择机器不会改变已有 pane 中 CLI 命令继承的会话与 socket远程自动化应在目标主机上针对目标会话执行命令并在那里读取 ID。下一步需要单台远程机器的独立 attachtmux 风格 SSH 后运行herdr、herdr --remote、命名远程会话、--handoff等时参见 Persistence and remote access三种连接路径本地、SSH 内运行、remote attach的对比在 How to work with Herdr各命令的完整列表见 CLI reference。【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考