跳转到内容
Octoboard 文档

通过 UU 远程用浏览器访问

通过网易 UU 远程的端口映射,在另一台电脑的浏览器中打开 Octoboard,无需 SSH 或远程桌面。主机是运行 Octoboard 的那台电脑(即 UU 远程里的“被控端”);SSH 登录(macOS 上的“远程登录”)可以保持关闭,也不需要远程桌面会话。用来浏览的电脑称为访问端(即 UU 远程里的“主控端”)。

本页介绍的是在自己电脑的浏览器中打开 Octoboard,这种方式比远程桌面清晰流畅,但步骤更多。如果不介意延迟和模糊,直接用 UU 远程的远程桌面在主机上操作即可。

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

你电脑上的浏览器 → 你电脑上的 127.0.0.1 ⟷ UU 远程 ⟷ 主机上的 127.0.0.1 → Octoboard

新手须知
  • 127.0.0.1(回环地址):永远指“本机”的地址。
  • 端口:用来指定电脑上某个程序的编号,就像门牌号。127.0.0.1:3369 就是本机的 3369 端口。
  • 端口映射:UU 远程的一项功能,让主机上的某个端口出现在你自己的电脑上。
  • socat:一个免费的小程序,负责把连接从一处转到另一处。Mac 主机需要用它做转发程序。
  • 终端:输入命令的窗口,macOS 上是“终端”,Windows 上是 PowerShell。

UU 远程的端口映射会让主机上的 Octoboard 出现在你自己电脑的 127.0.0.1 上,而 Octoboard 只接受这个地址上的浏览器访问。

  • 两台电脑都是 Mac 或 Windows 电脑。UU 远程没有 Linux 版端口映射;请改用 Tailscale 或 SSH 访问 Linux 服务器。
  • 两台电脑都装好 UU 远程,并登录同一个账号,Windows 上需要 4.21.0 及以上版本,macOS 上需要 4.32.0 及以上版本。端口映射只支持 TCP,Octoboard 也只需要 TCP。撰写本文时,UU 远程把端口映射列为免费功能;如有疑问,请查看它当前的会员说明。
  • 访问端的 UU 远程里,“我的设备”中能看到这台主机。
  • 主机是 Mac 时,还需要 Homebrew,用来安装下文的 socat。
  1. 获取浏览器地址,地址里带有登录密钥,用浏览器打开即可直接登录。

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

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

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

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

  2. 在主机上准备一个能连到 Octoboard 的本机端口。下文的主机端口就是这个端口。

    Mac 为浏览器提供服务的方式 UU 远程无法映射,所以需要用 socat 做转发程序。在“终端”中安装它:

    Terminal window
    brew install socat

    然后运行这条命令,不要关闭窗口。它只监听 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。

  1. 在 UU 远程中,从我的设备打开主机,点击设备卡片上的更多,选择端口映射,然后新建一条映射:

    字段值
    名称Octoboard
    本地端口3369
    目标地址127.0.0.1
    目标端口主机端口

    保存并启用,等它显示已连接。如果这台电脑上的 3369 端口已被占用,请换一个本地端口,并在浏览器地址中也改成它。

  2. 确认只有这台电脑能用这条映射。在这台电脑上打开“终端”(macOS)或 PowerShell(Windows),运行:

    Terminal window
    lsof -nP -iTCP:3369 -sTCP:LISTEN

    输出中应该有一行同时包含 127.0.0.1:3369 和 LISTEN。

    如果那个位置显示的是 *:3369 或 0.0.0.0:3369,请删除这条映射:你网络中的其他设备也能访问 Octoboard。

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

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

  • 映射显示已连接,但页面打不开:主机是 Mac 时,socat 的窗口被关掉了或命令已停止;或者允许远程访问没有开启,或主机上的 Octoboard 没有运行。
  • 映射无法保存或连不上:这台电脑上的本地端口可能已被占用。请换一个,并在浏览器地址中也改成它。
  • 页面被拒绝或一片空白:请确认打开的是 127.0.0.1 开头的地址。
  • 在访问端电脑上:在 UU 远程的端口映射面板中停用或删除这条映射。关闭面板或断开连接也会让映射停止。
  • 主机是 Mac 时:按 Ctrl+C 停止 socat。
  • 在主机上,不再需要时请关闭允许远程访问。这会关闭浏览器入口,并断开所有用该密钥打开的页面。
  • 如果地址可能已泄露,在浏览器标签页点击轮换密钥给它换一个新密钥。用旧地址打开的页面会被断开。
  • 地址就是密码:地址里的密钥可以完全控制主机上的 Octoboard,包括运行任何命令。密钥在你轮换之前一直有效。它会留在浏览器的历史记录和书签里,开启同步后还会同步到你的其他设备。
  • 谁能访问:能访问主机端口并持有密钥的任何人。主机上的端口只监听 127.0.0.1;能用你的 UU 远程账号向这台主机映射端口的人也能访问它,请保管好这个账号。
  • 只在没有其他人登录的电脑上使用:主机或你电脑上的其他用户账户可以连接这些 127.0.0.1 端口;映射或 socat 没在运行时,他们还可以占用该端口,在你的浏览器重连时拿到密钥。通过 SSH 连接时,Mac 或 Linux 主机没有这个弱点;用桌面应用时,你自己的电脑也没有。但用浏览器时,你用来浏览的电脑仍有这个弱点,因为那里的 SSH 转发同样监听 127.0.0.1 端口。