指南

隨時隨地連回你的機器

跑智能體的機器多半藏在 NAT 後面——家裡路由器後方、公司內網、書桌上的筆電。這篇教你如何在不把 SSH 暴露到公網的前提下,用手機穩穩連回去。

這件事有兩種解法:一是在路由器上做連接埠轉發;二是把兩台裝置放進同一個私人網狀網路,讓手機透過固定位址連到那台機器,完全不必對外網開洞。這篇只講第二種,因為第一種正是很多人伺服器被駭的原因。

1 把伺服器加入網狀網路

Tailscale、NetBird、headscale 或自己架的 WireGuard,底層全都是 WireGuard 網狀網路。在伺服器執行一條指令,它就會拿到一個只有你自己裝置連得到的固定位址。

Tailscale 會配發 100.64.0.0/10 網段 IP,以及像 m1-pro.your-tailnet.ts.net 這樣的名稱。

2 把手機也加入同一個網路

裝好對應廠商的 iOS App 並登入,它會建立一個 VPN 設定檔。這一步完全還沒輪到 Moshpit 上場。

iOS 同一時間只能跑一條 VPN 通道,所以公司 VPN 和私人網狀網路通常無法同時開啟。

3 在 Moshpit 加入連線

主機=網狀網路的名稱或 IP。連接埠沒改過就是 22。填好使用者名稱,並在登入方式選用 SSH 金鑰。

Moshpit 會原封不動連往你輸入的位址。所謂「整合」就這麼簡單。

Moshpit 不內建任何 VPN,也沒有 Tailscale 專屬整合。它不會替你撥號、路由或探索裝置,只會對表單裡填的主機字串建立 TCP 連線,開啟 mosh 時再對同一個字串發送 UDP。只要你的手機連得到那個位址,Moshpit 就連得到。

已儲存的連線資料結構裡有一個 useTailscale 欄位,但 App 裡沒有任何地方讀取它,表單上也沒這個開關。那是歷史遺留欄位,先說清楚省得你到處找開關。

先說千萬別做的事

千萬不要轉發 22 埠又開密碼登入。

剛暴露到公網的 SSH 連接埠,幾分鐘內就會被掃描器盯上。開啟密碼驗證等於送給專業自動化腳本一場無限次猜密碼遊戲。用網狀網路是直接把目標藏起來,而不是硬扛攻擊。

如果真的別無選擇

少數網路環境確實裝不了網狀網路。萬一非得對外開放 SSH,最低底線是只允許金鑰登入——請注意這是最低門檻,不是推薦作法:

# /etc/ssh/sshd_config.d/moshpit.conf
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
AuthenticationMethods publickey
# check it parses, then reload: sudo sshd -t && sudo systemctl reload ssh

在規劃架構前,有三個關於 Moshpit 的事實你必須先知道:

  • 只支援兩種驗證方式,沒有第三種。僅支援密碼與公開金鑰,不支援 keyboard-interactive,因此要求輸入 TOTP 驗證碼的 sshd 無法從 Moshpit 登入。
  • 不支援 ProxyJump、多層堡壘機與 agent forwarding。舊版連線模型上的 jumpHost 與 forwardAgent 欄位並未被本篇架構使用(若需單層跳板主機,請參閱 1.1.0 的跳板主機文件)。
  • 直接貼入表單時不支援加密私密金鑰。如果 PEM 帶有密碼短語,在連線表單內直接貼上會驗證失敗。建議改在 Moshpit 內產生金鑰(設定 → SSH 金鑰 → +)並把公開金鑰放到伺服器上——這樣還能存入安全隔離區並用 Face ID 上鎖。

為什麼 UDP 很重要

UDP 出現了兩次,理由完全不同。

一次在底層,因為 WireGuard 走 UDP;一次在上層,因為 mosh 也走 UDP。兩者的失敗表現完全不一樣,腦子裡先把它們分開會省很多事。

底層的網狀網路

wireguard · udp

  • Tailscale 會盡力在兩台機器間打通直連 UDP 路徑,預設監聽埠為 41641(兩端出站)
  • 打不通時會自動改走中繼轉發。中繼一樣能通,只是延遲較高
  • 在任一端執行 tailscale status 就能看到目前是 direct 還是中繼
  • 路由器完全不需要開放任何進站連接埠

上層的 mosh

跑在通道裡面

  • Mosh 本身是端對端 UDP;套在網狀網路上就是通道裡的 UDP,你的路由器根本看不到它
  • mosh-server 每個工作階段會綁定設定範圍內的一個連接埠,預設 60000–61000
  • Moshpit 會往表單裡填的同一個主機字串、搭配伺服器回報的連接埠送出 UDP 封包
  • Mosh 無法脫離 SSH 單獨啟動——TCP 必須先通,UDP 才派得上用場
啟動過程全貌

SSH 負責點火,之後就退場

Moshpit 透過已驗證的 SSH 連線執行一條指令、讀回它印出的一行結果,然後關閉 SSH。接下來全靠 UDP。

這就是為什麼連線後擋掉 SSH 不會讓 mosh 斷線,但擋掉 UDP 會;也是為什麼如果某條網狀網路載 TCP 很順卻中繼 UDP 很糟,用 mosh 反而比純 SSH 還卡。

PATH="$PATH:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/local/sbin:$HOME/.local/bin" \
  mosh-server new -s -c 256 -p 60000:61000 -l LANG=en_US.UTF-8

MOSH CONNECT 60001 <22 base64 chars = a 16-byte AES-128 key>

哪裡該開哪些連接埠

項目連接埠方向原因
SSHTCP 22 (或自訂連接埠) 伺服器進站 Mosh 沒有獨立啟動模式——靠 SSH 啟動 mosh-server 並把金鑰傳回來
mosh 工作階段UDP 60000–61000 伺服器進站、手機出站 每個工作階段由 mosh-server 在範圍內任選一個連接埠
網狀網路直連UDP 41641 兩端出站 Tailscale 預設值。被擋只會降為中繼,不會徹底斷線
你的路由器全部不用開 — 不需要任何連接埠轉發,這正是採用這套作法的最大意義

在網狀網路上,「伺服器進站」指的是網狀網路介面的進站規則。主機防火牆依然會攔截它:ufw、firewalld 與雲端安全群組都擋在通道與 mosh-server 之間。只針對 tailscale0 放行這段連接埠並不等於對全世界開放,而這恰恰是大家最常漏掉的一步。

你可以在設定 → MOSH · 漫遊 → UDP 連接埠範圍調整範圍(起/迄,須介於 1–65535 且起始值 ≤ 結束值)。連線表單會以唯讀方式顯示同一組範圍。若起始值超出有效範圍,會整個省略 -p 改用 mosh-server 預設值;若結束值無效,則會鎖定在單一起始連接埠。

最常見的坑

選一個位址,到哪裡都用同一個。

這是最像 App bug、實際上卻完全不是 bug 的問題。它常常讓人白耗整個晚上,所以值得單獨拉一節出來講。

Moshpit 啟動伺服器時下的是 mosh-server new -s。這個參數相當於 mosh 1.4 起的預設行為 --bind-server=ssh:伺服器只會綁定 SSH 連線進來的那個介面位址。這是刻意設計,確保 UDP 封包沿著剛剛登入成功的同一條路徑回傳。

帶來的結果就是:

  • 你在家裡連 192.168.1.30 啟動的工作階段,mosh-server 只綁在 192.168.1.30。出門切到網狀網路後,這台伺服器就完全連不到。
  • 反之,透過網狀網路啟動的工作階段只綁在網狀網路位址,回到區域網路直連內網 IP 也會連不到。
  • 這都不是 Moshpit 出錯,而是 --bind-server=ssh 的正常行為。

解法很單純:一律用網狀網路名稱來儲存連線,就算在家裡也用這個連線。同在區網時,網狀網路本來就會自動走區網直連。一個位址、一條連線,走出大門也不會突然斷線。

孤兒 mosh-server 會越積越多

每次新連線都會啟動一個新的 mosh-server。線路斷掉時舊的不會自動退出,會繼續佔著它的 UDP 連接埠。幾個星期反覆重連下來就會堆滿一堆。Moshpit 目前不會自動清理它們——這是確實存在的缺口,不是刻意設計。

pgrep -fl mosh-server                 # what's still running
lsof -nP -iUDP | grep mosh-server     # and which address each one bound
pkill -f mosh-server                  # the blunt fix; kills live sessions too

第二條指令印出的綁定位址同時也是很好的診斷線索:一眼就能看出每個工作階段當初是從哪個網路建立的,往往就能立刻解釋為什麼其中某一個不再回應。

iOS 權限

區域網路權限,以及拒絕它之後會長什麼樣

iOS 把存取區域網路位址鎖在一次性的權限視窗後面。如果你幾個月前在別的畫面順手按了不允許,就會遇到下面這種怪現象。

系統提示

只會跳出一次

首次連線到區網位址時出現。Moshpit 的權限說明寫著:「Moshpit 透過 SSH 和 mosh(UDP)連線到你區域網路裡的伺服器。沒有這個權限,連 192.168.x.x 這類內網主機會失敗。」

遭到拒絕

SSH 連得上,mosh 一片黑

iOS 會把發往區網的 UDP 封包直接丟掉而且不告訴任何人。TCP 不受影響,所以 SSH 完全正常,只有 mosh 停在黑畫面和閃爍游標。

修正方式

設定 → Moshpit → 區域網路

系統提示不會自己再跳出來。請到 iOS 設定裡手動打開,再重新連線工作階段。

影響範圍直白講:這項權限管制的是區域網路位址(192.168.x.x、10.x.x.x 等),網狀網路位址的流量則是走 VPN 通道介面出去。但只要你有一丁點可能透過區網 IP 連那台機器,還是建議先把權限打開——因為被擋掉的症狀跟防火牆問題一模一樣,很容易白忙一個晚上查錯方向。

驗證清單

六個檢查步驟,照順序來

每一步都在排除底下那一層的問題。不要跳著做——九成以上的答案都在第 1 或第 2 步。

1 · 對端是否在線?是不是直連?

tailscale status          # the peer line ends in "direct" or a relay name
tailscale ip -4           # the address to put in the Host field

走中繼的對端一樣能連,但延遲比較高;網路狀況差的時候,這往往是「勉強能用」和「完全不能用」的分水嶺。

2 · 從同一個網狀網路的筆電跑純 SSH 會通嗎?

ssh -v user@m1-pro.your-tailnet.ts.net

如果這步就失敗,立刻停下來先修它。底下不通,上層什麼都跑不起來——mosh 沒有獨立模式,Moshpit 本質上首先是 SSH 客戶端。

3 · UDP 真的來回都通嗎?

這是大家最常略過、卻最能直接抓出病因的一步。在你的連接埠範圍內挑一個埠,在伺服器端監聽,從跟手機在同一個網路的電腦送測試封包:

# on the server
echo REPLY | nc -u -l 60005 > /tmp/udp-in

# from a laptop on the same Wi-Fi as the phone
echo PING | nc -u -w3 m1-pro.your-tailnet.ts.net 60005

兩邊都要看到對方送出的字。如果伺服器收到了 PING,但客戶端遲遲沒收到 REPLY,代表回程路徑死了——這就是 mosh 黑畫面的真相。這是網路問題,不是 App 問題。

4 · 流量進來的介面上有開放這段連接埠嗎?

sudo ufw status verbose                       # Debian / Ubuntu
sudo firewall-cmd --list-all                  # Fedora / RHEL
sudo ufw allow in on tailscale0 to any port 60000:61000 proto udp

如果有雲端安全群組,別忘了另外檢查。同時確認開放的範圍和 Moshpit 設定的是同一段——預設是 60000–61000,但它是可以改的。

5 · 看看 App 實際收到了什麼

在 mosh 工作階段裡長按頂列的傳輸狀態標籤,打開 MOSH 診斷:裡面會列出 datagrams、applied、parse fails、gaps。最關鍵的一行根本不是數字:

MOSH DIAGNOSTICS
   No datagrams yet.

這代表字面意義上「一個封包都沒回來」——這個計數器在解密與解析之前就會累加。回程徹底斷了,別再查 Moshpit,直接回到第 3 步。

6 · 啟用逃生門

如果眼前這條網路把 UDP 吃光了而你現在急著用終端機,直接點橫幅上的切換到 SSH,或點頂列的 MOSH 標籤並確認「要切換到 SSH 嗎?」。SSH 走 TCP,通常能穿透擋住 UDP 的路徑。這條橫幅可以關閉,絕不會卡住終端機——其實你的按鍵一直都有送到伺服器,只是畫面更新被擋住了。

⚠  Mosh isn't receiving data — your network may be
   blocking UDP (VPN, proxy, or firewall).

   Switch to SSH                                    ×

一筆實測數據,不是承諾

我們不拿空泛的形容詞吹牛,直接貼出一台實際用來測試的開發主機量測結果,這比寫一堆好聽的話有參考價值多了。

一台透過 Tailscale、經由中國大陸行動網路出口直連的 Mac:RTT 433–640 ms,約 13% 封包遺失。在這條線路上,SSH 握手要花 5.8–9 秒,但 Mosh 依然跑得動。純 mosh 工作階段約 10 秒出現第一個畫面;mosh 加上 tmux 因需兩次 SSH 握手,大約要 20–25 秒頂部路徑列才會填滿資料。

這只是在我們自己硬體上量過一次的單一線路,不是基準測試,你的網路條件一定不同。放上這組數字,是因為「扛得住掉包」這種說法本來就該附上實測數字。

那條線路還教了我們兩件值得先有心理準備的事:筆電一旦進入睡眠就會整個從網狀網路消失(direct → relayed → offline);另外裝了沉重外掛設定的 tmux 伺服器在首次啟動時可能死鎖。這兩者都不是網路問題,但看起來跟網路故障一模一樣。

仰賴它之前值得先知道的限制

就算連得上機器,這些事依然有邊界。

App 進背景會被系統暫停 iOS 會暫停 Moshpit、每 12 秒一次的保活計時器以及背景輪詢。即時智能體狀態會停在切出當下,等你切回 App 才補上——不過智能體推播通知依然會準時送達,因為那是由主機端自行端對端加密寄出的。離開超過 20 秒後,切回時 Moshpit 會強制重新連線,而不是輕信容易誤判半開連線的存活偵測。

走 mosh 時,tmux 和 herdr 會跑自己的 TUI Mosh 傳送的是繪製後的畫面差異,不是原始逐行位元組串流,因此無法承載 tmux -CC 或 herdr 的 frame protocol,兩者都會退回在 mosh 裡跑各自的全螢幕 TUI。原生控制清單靠旁邊另開的輕量 SSH 連線提供資料——如果網狀網路只放 UDP 而擋了 SSH,你就只看得到 tmux 畫面,沒有原生列表。

herdr 的直連 attach 是單一窗格獨佔 Moshpit 透過 --takeover 接管窗格。兩個 Moshpit 客戶端指到同一個 herdr 窗格時,大約每兩秒就會互相搶回一次控制權,這是 herdr 獨佔 attach 的特性,客戶端無法掩蓋。桌機上的 herdr TUI 不佔用 attach 擁有者,理論上同時開是安全的,但尚未實際驗證。

herdr 0.7.3 不回報窗格指令 當時 Homebrew 穩定版的快照裡不含窗格執行中的指令,因此頂列路徑會退回顯示 pane N。這不影響使用,但它是打開「選擇窗格」列表的入口,認得出來就不會困惑。

已信任的主機金鑰無法列表檢視或手動遺忘 首次連線時會顯示指紋與 ssh-keygen 比對指令。之後 App 裡沒有列出已信任清單或「忘記這台主機」的畫面,刪除連線也會保留指紋。合法更換金鑰時,需在警告視窗接受變更——該按鈕刻意標為破壞性樣式,預設按鈕則維持中斷連線。

常見問題

專門針對「連回機器」這件事。

一定要用 Tailscale 嗎?

不用。Moshpit 只管連往一個位址,這個位址怎麼變可連線的完全由你決定。NetBird、headscale、原生 WireGuard、ZeroTier、公司 VPN,或擁有真實公網 IP 的伺服器,對 App 來說完全沒差別。這裡以 Tailscale 舉例,單純因為它是從零到連通最短的路。

Moshpit 支援透過跳板主機連線嗎?

1.1.0 已新增單層跳板主機(透過 SSH 的「經由」設定,等同 ssh -J),詳見跳板主機文件;不支援多層串接或 agent forwarding,且經由跳板主機時無法使用 Mosh。如果本來就有網狀網路,往往能直接省去跳板主機這層轉接。

為什麼用 5G 連得上,換到公司 Wi-Fi 就不行?

十之八九是網路放行出站 UDP 卻攔截了回程封包——常見於分割通道 VPN、代理伺服器或企業防火牆。SSH 走 TCP 所以同一條路依然通。在那個網路跑一次上面的 nc -u 測試:如果那裡收不到回音而行動網路收得到,答案就找到了。

可以同時開公司 VPN 和私人網狀網路嗎?

在 iOS 上通常不行,系統一次只允許一條 VPN 通道運作。如果必須掛著公司 VPN,私人網狀網路就得先停用,連線只能走企業網路提供的路徑。這是 iOS 系統限制,App 無法繞過。

Moshpit 看得到我的網狀網路或其他機器嗎?

看不到。它沒有網路探索功能,也沒有帳號。它只知道你手動填進去的連線,終端機流量也只會去那些伺服器。唯一由 Moshpit 營運的是推播中繼伺服器,只負責轉交無法解密的加密智能體提醒,絕不碰你的網狀網路或工作階段。要求「區域網路」權限純粹是為了不讓 iOS 丟掉區網 UDP 封包,而不是用來掃描裝置。

為什麼一回到家,原本活著的 mosh 工作階段就斷了?

最可能就是位址問題。mosh-server 只綁定當初 SSH 登入進來的那個介面位址,所以透過網狀網路建的工作階段無法從區網直連,反之亦然。一律用網狀網路名稱儲存連線,回家也用同一條就好。詳見上方的選一個位址。

接著閱讀 從 iPhone 執行 Claude Code · 返回指南列表