KaTrain 远程 KataGo SSH 隧道 Socket 残留问题

Sun, 14 Jun 2026 14:24:22 +0800

最近把 KaTrain 配成了远程 KataGo：本地 Mac 只运行 KaTrain 界面，真正的 KataGo 分析放到远端 GPU 服务器上跑。整体体验很好，但这次遇到一个很典型的问题：KaTrain 里远程引擎显示“崩溃”或“无法使用”。

排查下来，服务器上的 GPU、Docker 镜像和模型文件都正常，真正的问题出在本地 SSH 隧道的 Unix socket 残留。

远程 KataGo 的整体结构链接到标题

我的配置大致是这样：

KaTrain
  └─ engine.altcommand
       └─ katago-bridge-analysis
            └─ /tmp/katago-tunnel.sock
                 └─ launchd 维护的 SSH 隧道
                      └─ 远端服务器 localhost:5000
                           └─ katago-multiplexer.py
                                └─ Docker KataGo TensorRT 容器

这里有几个关键点：

KaTrain 不直接启动本地 KataGo，而是通过 engine.altcommand 调用一个 bridge 脚本。
bridge 脚本连接本地 Unix socket：/tmp/katago-tunnel.sock。
这个 socket 背后是 launchd 长期维护的 SSH 隧道。
远端服务器上有一个 katago-multiplexer.py，负责把多个客户端请求转发给 KataGo analysis 进程。

也就是说，KaTrain App 关闭以后，SSH 隧道仍然可以由 launchd 继续维护。这样下一次打开 KaTrain 时，不需要重新建立完整链路。

Launchd on OHTLY Blog

KaTrain 远程 KataGo SSH 隧道 Socket 残留问题

远程 KataGo 的整体结构 链接到标题

远程 KataGo 的整体结构链接到标题