跳转到内容
Octoboard 文档

通过 Tailscale 用浏览器访问

通过你自己的 Tailscale 网络,在另一台电脑的浏览器中打开 Octoboard,无需 SSH 或远程桌面。主机是运行 Octoboard 的那台电脑:Mac、Windows 电脑,或运行 octoboardd 的 Linux 服务器。SSH 登录(macOS 上的“远程登录”)可以保持关闭。

不确定该用哪种方式?请看选择连接方式。

你电脑上的浏览器 → 你电脑上的转发程序(127.0.0.1) ⟷ Tailscale ⟷ 主机上的转发程序(127.0.0.1) → Octoboard

新手须知
  • Tailscale:一项把你的设备通过互联网连成私有网络的服务,不管设备在哪里都能用。你用自己的账号登录它。
  • tailnet:你的 Tailscale 网络,也就是登录了你 Tailscale 账号的那些设备。
  • 127.0.0.1(回环地址):永远指“本机”的地址。
  • 端口:用来指定电脑上某个程序的编号,就像门牌号。127.0.0.1:3369 就是本机的 3369 端口。
  • socat:一个免费的小程序,负责把连接从一处转到另一处。这里用它做转发程序。
  • Tailscale Serve:Tailscale 的一条命令,只把端口共享给你的 tailnet。与它相近的 Tailscale Funnel 会把端口共享到整个互联网,这里千万不要用。
  • 终端:输入命令的窗口,macOS 上是“终端”,Windows 上是 PowerShell。

出于安全考虑,Octoboard 只接受在 127.0.0.1(永远指“本机”的地址,也叫回环地址)上打开的浏览器页面,所以不能直接在浏览器里输入主机的 Tailscale 地址。做法是在两台电脑上各运行一个小的转发程序:你这边的让主机看起来就在本机 127.0.0.1 上,主机那边的把连接交给 Octoboard,中间由 Tailscale 传输。

  • 两台电脑都装好 Tailscale,并登录同一个 tailnet。请使用只包含你自己设备的 tailnet:它允许访问主机的每台设备,都能访问你共享的端口。

  • 是 Mac 或运行 Linux 的电脑,都要装 socat。Windows 电脑不需要。

    如果还没有 Homebrew,请先安装它(macOS 自带的工具都做不了这件事),然后在“终端”中运行:

    Terminal window
    brew install socat
  • 使用期间要开着两到三个窗口:主机上的转发程序和 Tailscale Serve(Windows 主机不需要转发程序),以及你电脑上的转发程序(Windows 电脑不需要)。

  1. 获取浏览器地址,地址里带有登录密钥,用浏览器打开即可直接登录。

    在 Octoboard 中打开设置 › 远程访问,开启允许远程访问,再点击允许确认。开关下方会出现两个标签页。在浏览器标签页的第 2 步:浏览器地址处,点击复制地址。

    请用只有你自己能看到的方式把地址传到另一台电脑,比如发给自己的笔记:它的作用相当于密码。

    跳过第 1 步:SSH 转发。应用的设置里多处提到 SSH,这里可以不用管,本指南只用到浏览器地址。

    请保持 Octoboard 运行,退出后远程访问会随之中断。

  2. 在主机上启动转发程序,把主机 127.0.0.1 上的一个端口接到 Octoboard。下文的主机端口就是这个端口。

    在“终端”中运行这条命令,不要关闭窗口。它只监听 127.0.0.1:3370。

    Terminal window
    socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"

    主机端口是 3370。

  3. 用 Tailscale Serve 把主机端口共享给你的 tailnet,不要关闭窗口。不要使用 Tailscale Funnel,它会把端口公开到互联网上。

    Terminal window
    tailscale serve --tcp=3370 tcp://127.0.0.1:3370

    如果用的是 App Store 版 Tailscale,请用 /Applications/Tailscale.app/Contents/MacOS/Tailscale 代替命令中的 tailscale。如果用的是独立版,请先在它的设置中的 CLI integration 里安装命令。

    检查方法:在另一个窗口运行 tailscale serve status,列表中应该有主机端口。

  1. 在这台电脑的 Tailscale 应用中找到主机,记下它的名称(如 my-mac)或地址(形如 100.x.y.z 的数字)。

  2. 在这台电脑上启动转发程序,让主机出现在本机的 127.0.0.1:3369 上。如果这台电脑上的 3369 端口已被占用,请换一个端口,并在浏览器地址中也改成它。

    把下面命令中的 <host> 换成主机的名称或地址,<host port> 换成主机端口。

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:<host>:<host port>

    比如主机是一台名为 my-mac 的 Mac:

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:my-mac:3370

    在“终端”中运行,不要关闭窗口。

  3. 打开在主机上复制的浏览器地址。它以 http://127.0.0.1:3369/ 开头。

看到 Octoboard 在浏览器标签页中打开,而且没有要求你登录,就说明成功了。

  • 页面打不开:某个窗口被关掉了,或其中的命令已停止。请确认转发程序和 Tailscale Serve 都还在运行,并且主机上的 tailscale serve status 列出了主机端口。
  • socat 提示“Address already in use”:这台电脑上的该端口已被占用。请换一个端口;如果是你这边的电脑,浏览器地址里也要改成它。
  • 页面被拒绝或一片空白:请确认打开的是 127.0.0.1 开头的地址,而不是主机的 Tailscale 名称或 100.x.y.z 地址。
  • 打开页面时,主机上的转发程序提示“Connection refused”或“No such file or directory”:允许远程访问没有开启,或主机上的 Octoboard 没有运行(Linux 上是 octoboardd 没有运行)。
  • 在用来浏览的电脑上:按 Ctrl+C 停止 socat;在 Windows 上,以管理员身份打开 PowerShell,删除转发:

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • 在主机上:按 Ctrl+C 停止 Tailscale Serve 命令和 socat。用 tailscale serve status 确认已不再共享任何内容;如果端口仍在列表中,用 tailscale serve --tcp=3370 off 移除它(Windows 上用 tailscale serve --tcp=3369 off)。

  • 主机是 Mac 或 Windows 时,不再需要时请关闭允许远程访问。这会关闭浏览器入口,并断开所有用该密钥打开的页面。

  • 如果地址可能已泄露,在浏览器标签页点击轮换密钥给它换一个新密钥,Linux 上运行 octoboardd address --rotate。用旧地址打开的页面会被断开。

  • 地址就是密码:地址里的密钥可以完全控制主机上的 Octoboard,包括运行任何命令。密钥在你轮换之前一直有效。它会留在浏览器的历史记录和书签里,开启同步后还会同步到你的其他设备。
  • 谁能访问:能访问主机端口并持有密钥的任何人。两台电脑上的转发程序只监听 127.0.0.1,主机所在网络或你本地网络中的其他设备访问不到;Tailscale Serve 只让你的 tailnet 能访问主机端口,并受它的访问规则限制。
  • 只在没有其他人登录的电脑上使用:主机或你电脑上的其他用户账户可以连接这些 127.0.0.1 端口;转发程序没在运行时,他们还可以占用该端口,在你的浏览器重连时拿到密钥。通过 SSH 连接时,Mac 或 Linux 主机没有这个弱点;用桌面应用时,你自己的电脑也没有。但用浏览器时,你用来浏览的电脑仍有这个弱点,因为那里的 SSH 转发同样监听 127.0.0.1 端口。
  • 不要使用 Funnel:Tailscale Funnel 会把端口公开到整个互联网。