跳到內容
Octoboard 說明文件

透過 UU 遠程用瀏覽器存取

透過網易遠端控制軟體 UU 遠程的連接埠對應,在另一台電腦的瀏覽器中開啟 Octoboard,不需要 SSH 或遠端桌面。主機是執行 Octoboard 的那台電腦;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. 在主機的 127.0.0.1 上準備一個能連到 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 連接埠。