透過 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。
-
取得瀏覽器位址,位址裡帶有登入金鑰,用瀏覽器開啟就能直接登入。
在 Octoboard 中開啟設定 › 遠端存取,開啟允許遠端存取,再點選允許確認。開關下方會出現兩個分頁。在瀏覽器分頁的步驟 2:瀏覽器位址處,點選複製位址。
請用只有你自己看得到的方式把位址傳到另一台電腦,例如傳給自己的筆記:它的作用就像密碼。
跳過步驟 1:SSH 轉送。應用程式的設定裡有多處提到 SSH,這裡可以不用理會,本指南只會用到瀏覽器位址。
請讓 Octoboard 保持執行,結束後遠端存取也會隨之中斷。
在 Octoboard 中開啟設定 › 遠端存取,開啟允許遠端存取,再點選允許確認。開關下方會出現兩個分頁。在瀏覽器分頁的步驟 2:瀏覽器位址處,點選複製位址。同時記下瀏覽器連接埠下顯示的連接埠號碼。
請用只有你自己看得到的方式把位址傳到另一台電腦,例如傳給自己的筆記:它的作用就像密碼。
跳過步驟 1:SSH 轉送。應用程式的設定裡有多處提到 SSH,這裡可以不用理會,本指南只會用到瀏覽器位址。
請讓 Octoboard 保持執行,結束後遠端存取也會隨之中斷。
-
在主機的
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。不需要執行任何指令:Octoboard 本身就在瀏覽器連接埠上監聽,而且只監聽
127.0.0.1。主機連接埠就是瀏覽器分頁裡的瀏覽器連接埠(沒改過的話是 3369)。
在用來瀏覽的電腦上
Section titled “在用來瀏覽的電腦上”-
在 UU 遠程中,從我的设备開啟主機,點選裝置卡片上的更多,選擇端口映射,然後新增一條對應:
欄位 值 名称 Octoboard 本地端口 3369目标地址 127.0.0.1目标端口 主機連接埠 儲存並啟用,等它顯示已連線。如果這台電腦上的 3369 連接埠已被占用,請換一個本地連接埠,並在瀏覽器位址中也改成它。
-
確認只有這台電腦能使用這條對應。在這台電腦上開啟「終端機」(macOS)或 PowerShell(Windows),執行:
Terminal window lsof -nP -iTCP:3369 -sTCP:LISTEN輸出中應該有一行同時包含
127.0.0.1:3369和LISTEN。Terminal window netstat -ano | findstr :3369輸出中應該有一行以
TCP開頭、接著是127.0.0.1:3369,並以LISTENING和一個數字結尾。如果那個位置顯示的是
*:3369或0.0.0.0:3369,請刪除這條對應:你網路中的其他裝置也能存取 Octoboard。 -
開啟在主機上複製的瀏覽器位址。它以
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連接埠。