通过 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。
为什么要多这几步
Section titled “为什么要多这几步”出于安全考虑,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无需安装:Windows 主机本来就在
127.0.0.1的端口上为浏览器提供服务,用来浏览的 Windows 电脑则改用系统自带的命令。Terminal window sudo apt install socat如果发行版不用
apt,请改用它的包管理器(dnf、pacman等)。 -
使用期间要开着两到三个窗口:主机上的转发程序和 Tailscale Serve(Windows 主机不需要转发程序),以及你电脑上的转发程序(Windows 电脑不需要)。
-
获取浏览器地址,地址里带有登录密钥,用浏览器打开即可直接登录。
在 Octoboard 中打开设置 › 远程访问,开启允许远程访问,再点击允许确认。开关下方会出现两个标签页。在浏览器标签页的第 2 步:浏览器地址处,点击复制地址。
请用只有你自己能看到的方式把地址传到另一台电脑,比如发给自己的笔记:它的作用相当于密码。
跳过第 1 步:SSH 转发。应用的设置里多处提到 SSH,这里可以不用管,本指南只用到浏览器地址。
请保持 Octoboard 运行,退出后远程访问会随之中断。
在 Octoboard 中打开设置 › 远程访问,开启允许远程访问,再点击允许确认。开关下方会出现两个标签页。在浏览器标签页的第 2 步:浏览器地址处,点击复制地址。同时记下浏览器端口下显示的端口号。
请用只有你自己能看到的方式把地址传到另一台电脑,比如发给自己的笔记:它的作用相当于密码。
跳过第 1 步:SSH 转发。应用的设置里多处提到 SSH,这里可以不用管,本指南只用到浏览器地址。
请保持 Octoboard 运行,退出后远程访问会随之中断。
以运行 octoboardd 的用户身份运行这条命令,复制它输出的以
http://127.0.0.1:3369/开头的地址。忽略之后输出的 SSH 命令。Terminal window octoboardd address -
在主机上启动转发程序,把主机
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。无需运行任何命令:Octoboard 自己就在浏览器端口上监听,而且只监听
127.0.0.1。主机端口就是浏览器端口(没改过的话是 3369)。以同一用户身份,在一直开着的终端或
tmux会话中运行这条命令。它只监听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。 -
用 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 里安装命令。在 PowerShell 或命令提示符中运行:
Terminal window tailscale serve --tcp=3369 tcp://127.0.0.1:3369如果改过浏览器端口,请换成你的端口。
Terminal window tailscale serve --tcp=3370 tcp://127.0.0.1:3370如果 Tailscale 提示权限不足,请运行一次
sudo tailscale set --operator="$USER"让你的用户可以管理它,或用sudo运行这条命令。检查方法:在另一个窗口运行
tailscale serve status,列表中应该有主机端口。
在用来浏览的电脑上
Section titled “在用来浏览的电脑上”-
在这台电脑的 Tailscale 应用中找到主机,记下它的名称(如
my-mac)或地址(形如100.x.y.z的数字)。 -
在这台电脑上启动转发程序,让主机出现在本机的
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在“终端”中运行,不要关闭窗口。
以管理员身份打开 PowerShell。把下面命令中的
<host IP>换成主机的100.x.y.z地址(这条命令只认数字地址,填名称不行),<host port>换成主机端口。Terminal window netsh interface portproxy add v4tov4 listenaddress=127.0.0.1 listenport=3369 connectaddress=<host IP> connectport=<host port>这个转发会一直保留,重启后也在,直到你删除它(见下文),所以不需要开着窗口。它依赖默认运行的 IP Helper 服务。
-
打开在主机上复制的浏览器地址。它以
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 会把端口公开到整个互联网。