如何通过 SSH 管理远程机器PenguinHarness 机器管理与远程控制完全指南【免费下载链接】penguin-harness Unified and Stable RSI Platform项目地址: https://gitcode.com/gh_mirrors/pe/penguin-harnessPenguinHarness是一个统一的 RSI自改进研究平台它的机器管理功能让一台运行中的服务端通过你本地~/.ssh/config里已有的 SSH 别名把整套平台安装、连接、探测并热更新到任意远程机器上——无需公网地址、无需手动 scp一条 SSH 通道贯穿始终。本文是面向新手和普通用户的远程控制完全指南带你从第一个 SSH 别名开始5 分钟装好一台远程机器。一、机器管理是什么一台控制端N 台远程机器传统做法是scp打包上传 → 手动装 Node → 手动起服务 → 再想办法访问。PenguinHarness 把这些步骤收敛为一条常驻的 SSH 连接形如ssh -T -D port 别名 sh命令、脚本、状态包都走同一条 stdinAPI 访问则通过这条会话内部的 SOCKS 端口完成。这意味着每台机器始终只有一条连接再多调用方排队复用不会连接爆炸没有任何新端口对外监听远程机器不需要公网 IP 或端口映射安装、探测、连接、升级全部复用这同一条通道失败时你能直接看到 OpenSSH 自己的诊断。 核心心智模型你只需要维护~/.ssh/config里的 SSH 别名PenguinHarness 把别名原样交给 ssh其余全自动。二、开始前准备配置 SSH 别名PenguinHarness直接读取你本地机器的 SSH 配置不解析、不缓存因此你修改配置后无需任何同步操作。确认本地已安装sshWindows 10 自带 OpenSSH。在~/.ssh/config中为远程机器添加别名Host build-box HostName 192.168.1.50 User dev IdentityFile ~/.ssh/id_ed25519执行ssh build-box验证可以免密或输密码登录。⚠️ 别名可以是同一台主机的多个名字如build-box与bbPenguinHarness 内部用每台机器自己铸出的唯一machineId来识别机器别名只负责给人读。三、一键安装远程机器从空机到可用在 Web App 的Project 设置里找到Installed machines已安装机器区域步骤会发生什么1. 选择 SSH 别名列表来自你的 SSH 配置直接点选2. 点击安装服务端通过一条连接完成询问机器身份 → 推送安装器 → 推送状态包 → 回读最终版本3. 校验结果机器必须回报基础发行版 推送状态两部分才算成功步骤返回 0 但不落盘会被如实报为失败几个值得注意的设计幂等对已装好同版本的机器重复安装是无害的 no-op只重写记录属于 Project机器归属于发起安装的 Project主机本身全局共享其他 Project 可纳入而非重装避免 30 MB 的重复传输本机永远不是安装目标列表始终以运行服务端的本机开头对其安装会返回409 self_install。四、查看机器状态一行命令问出它在跑吗列表里每台机器都带有最近一次探测的状态running附端口、stopped或unreachable附 OpenSSH 诊断。状态背后是发给机器自己 CLI 的一条机器友好命令penguin server status # {running:true,port:7364,pid:41233,machineId:LNrJdHAZJ91G58i0}running 为真 pid 存活且端口可连接避免了旧式kill -0被复用的 pid骗过的经典坑探测是按需的POST …/machines/probe并发 5列表页不会偷偷对每台机器发请求同一时刻一台机器只被问一件事第二个请求排第一个的队再多标签页也不会多开连接。五、连接机器并在浏览器中远程使用连接Connect是比安装更进一步的动作服务端把远端的penguin server拉起来并保持会话打开之后远端 API 就在同源路径下应答/server/machineId/api/…带来的体验你的浏览器里始终是本地前端登录态完整切到远程机器就像切换一个工作区按机器自身 id寻址而非别名——给主机改名URL 也不会失效只有一个身份授权代理的是当初装机器那份 SSH 访问权会话令牌在机器本机铸出并复用浏览器的 cookie 从不过去断开连接disconnect只撤掉通道远端服务端继续运行不影响正在上面工作的人。另外GET …/dirs?path可以经这条连接直接浏览机器上的目录为远程任务选工作目录只花一条命令。六、模型凭据自动同步远程机器也能调用你的模型在远程机器上运行的 Agent 是从对面调用模型端点的。PenguinHarness 会在连接机器时把使用它的 Project 的模型配置一并推送过去在控制端编辑模型时三条入口整表保存 / 切换默认 / 登录铸造密钥都触发向外同步远端是合并而非覆盖机器上手工配置的条目会被原样保留密钥以打码形式回送不会泄露同步失败如实报告但从不致命机器保持连接日志里写的是机器自己说的话。七、升级远程机器热更新与受控重启若机器已带正确发行版、只是状态不同走机器自己的更新通道热更新而不是整套重装升级交接包含 platform、CLI、web 三份 bundle以及原生资产exec位随文件一起过去重启是独立操作文件不等于进程已更新不等于在跑新版。停止这一步是可核实的——SIGTERM 后 15 秒仍不放行会如实上报而不是一律 SIGKILL版本已一致但更新失败时任务会提议replaceProgram照装不误由你确认从不擅自停止别人正在用的服务端。对应的远端命令同样面向机器penguin server stop # {ok:true,pid:41233}八、常见问题与限制问题答案机器显示 unreachable日志里是 OpenSSH 自己的诊断先按它修好~/.ssh/config或网络Windows 远程机器能装吗能安装走 PowerShell 安装器、独立连接但暂不能连接会直接返回409 connect_unsupported升级后旧机器列表为空0.2.10 起安装记录迁入数据库旧 JSON 不再读取重新安装即可全程幂等且成本低机器被别的 Project 装过读作elsewhere而非未安装点纳入即可避免重复传输九、延伸阅读远程控制飞书 / Telegram / QQ / 微信机器人remote-control.zh.mdCLI 完整用法cli.zh.md机器管理演进记录machines-connection.zh.md、machines-identity.zh.md、machines-reach.zh.md实现源码packages/server/ 下的machines/transport/目录通往机器的唯一入口从一条 SSH 别名到一支可远程指挥的机器舰队PenguinHarness 的机器管理把运维脚本变成了点几下鼠标。【免费下载链接】penguin-harness Unified and Stable RSI Platform项目地址: https://gitcode.com/gh_mirrors/pe/penguin-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考