SSH on OHTLY Blog

Tailscale 快速组网：macOS + Ubuntu 异地直连实战

Sun, 14 Jun 2026 23:45:51 +0800

场景链接到标题

家里一台 macOS，办公室局域网内一台 Ubuntu VM。以前要 SSH 访问办公室 VM，需要经过跳板机：

macOS → 跳板机 → 办公室内网 → VM

步骤繁琐，依赖跳板机在线，而且 scp 传文件要走两跳，速度慢。

目标：像在内网一样直接访问。

注册链接到标题

打开 Tailscale 官网，用 GitHub 账号授权登录即可。登录后自动创建一个 Tailnet（你的私人网络）。

免费版支持 3 个用户、100 台设备，个人使用完全够。

macOS 安装链接到标题

brew install --cask tailscale

安装后启动，菜单栏出现 Tailscale 图标。点击登录，浏览器打开认证页面，选择 GitHub 账号授权，几秒钟就加入 Tailnet 了。

Ubuntu Server 安装链接到标题

curl -fsSL https://tailscale.com/install.sh | sudo sh
sudo tailscale up

第二条命令会输出一个认证链接，浏览器打开，登录同个 GitHub 账号即可。

macOS 下用函数快速启动 VS Code SSH Remote

Sun, 14 Jun 2026 19:59:37 +0800

背景链接到标题

日常开发免不了频繁通过 VS Code 的 Remote SSH 连接远程服务器。每次都要敲：

code --remote ssh-remote+some-host /home/user/project

路径要记、主机名要打、目录要拼，烦。

能不能 rcode my-server 就完事？

其他方案对比链接到标题

先看看除了敲命令，还有哪些方式打开 Remote SSH：

方案	操作步骤	评价
VS Code 命令面板	`F1` → “Remote-SSH: Connect to Host…” → 选主机 → `File > Open Folder` → 选目录	点选四五次，慢
本地终端 `code --remote`	`code --remote ssh-remote+some-host /home/user/project`	可用，但路径要自己记
macOS `open` 打开 URL	`open vscode://vscode-remote/ssh-remote+some-host/home/user/project`	可脚本化，但路径写死
Markdown/HTML 中放 VS Code 链接	在文档里写 `vscode://vscode-remote/ssh-remote+some-host/home/user/project`，浏览器点击触发	适合文档入口，但仍然路径写死
终端别名/函数	本文方案	一行搞定

这里容易踩一个坑：code 是本地 macOS 上的 VS Code CLI，不是远程服务器上的命令。已经 SSH 登录到远程机器后再敲 code .，通常只会得到 command not found。

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 时，不需要重新建立完整链路。

SSH on OHTLY Blog

Tailscale 快速组网：macOS + Ubuntu 异地直连实战

场景 链接到标题

注册 链接到标题

macOS 安装 链接到标题

Ubuntu Server 安装 链接到标题