Tailscale、NetBird、headscale 或自己架的 WireGuard,底層全都是 WireGuard 網狀網路。在伺服器執行一條指令,它就會拿到一個只有你自己裝置連得到的固定位址。
Tailscale 會配發 100.64.0.0/10 網段 IP,以及像 m1-pro.your-tailnet.ts.net 這樣的名稱。
跑智能體的機器多半藏在 NAT 後面——家裡路由器後方、公司內網、書桌上的筆電。這篇教你如何在不把 SSH 暴露到公網的前提下,用手機穩穩連回去。
這件事有兩種解法:一是在路由器上做連接埠轉發;二是把兩台裝置放進同一個私人網狀網路,讓手機透過固定位址連到那台機器,完全不必對外網開洞。這篇只講第二種,因為第一種正是很多人伺服器被駭的原因。
Tailscale、NetBird、headscale 或自己架的 WireGuard,底層全都是 WireGuard 網狀網路。在伺服器執行一條指令,它就會拿到一個只有你自己裝置連得到的固定位址。
Tailscale 會配發 100.64.0.0/10 網段 IP,以及像 m1-pro.your-tailnet.ts.net 這樣的名稱。
裝好對應廠商的 iOS App 並登入,它會建立一個 VPN 設定檔。這一步完全還沒輪到 Moshpit 上場。
iOS 同一時間只能跑一條 VPN 通道,所以公司 VPN 和私人網狀網路通常無法同時開啟。
主機=網狀網路的名稱或 IP。連接埠沒改過就是 22。填好使用者名稱,並在登入方式選用 SSH 金鑰。
Moshpit 會原封不動連往你輸入的位址。所謂「整合」就這麼簡單。
Moshpit 不內建任何 VPN,也沒有 Tailscale 專屬整合。它不會替你撥號、路由或探索裝置,只會對表單裡填的主機字串建立 TCP 連線,開啟 mosh 時再對同一個字串發送 UDP。只要你的手機連得到那個位址,Moshpit 就連得到。
已儲存的連線資料結構裡有一個 useTailscale 欄位,但 App 裡沒有任何地方讀取它,表單上也沒這個開關。那是歷史遺留欄位,先說清楚省得你到處找開關。
先說千萬別做的事
剛暴露到公網的 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 的事實你必須先知道:
jumpHost 與 forwardAgent 欄位並未被本篇架構使用(若需單層跳板主機,請參閱 1.1.0 的跳板主機文件)。為什麼 UDP 很重要
一次在底層,因為 WireGuard 走 UDP;一次在上層,因為 mosh 也走 UDP。兩者的失敗表現完全不一樣,腦子裡先把它們分開會省很多事。
wireguard · udp
tailscale status 就能看到目前是 direct 還是中繼跑在通道裡面
mosh-server 每個工作階段會綁定設定範圍內的一個連接埠,預設 60000–61000Moshpit 透過已驗證的 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>
| 項目 | 連接埠 | 方向 | 原因 |
|---|---|---|---|
| SSH | TCP 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。出門切到網狀網路後,這台伺服器就完全連不到。--bind-server=ssh 的正常行為。解法很單純:一律用網狀網路名稱來儲存連線,就算在家裡也用這個連線。同在區網時,網狀網路本來就會自動走區網直連。一個位址、一條連線,走出大門也不會突然斷線。
每次新連線都會啟動一個新的 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 這類內網主機會失敗。」
iOS 會把發往區網的 UDP 封包直接丟掉而且不告訴任何人。TCP 不受影響,所以 SSH 完全正常,只有 mosh 停在黑畫面和閃爍游標。
系統提示不會自己再跳出來。請到 iOS 設定裡手動打開,再重新連線工作階段。
影響範圍直白講:這項權限管制的是區域網路位址(192.168.x.x、10.x.x.x 等),網狀網路位址的流量則是走 VPN 通道介面出去。但只要你有一丁點可能透過區網 IP 連那台機器,還是建議先把權限打開——因為被擋掉的症狀跟防火牆問題一模一樣,很容易白忙一個晚上查錯方向。
驗證清單
每一步都在排除底下那一層的問題。不要跳著做——九成以上的答案都在第 1 或第 2 步。
tailscale status # the peer line ends in "direct" or a relay name tailscale ip -4 # the address to put in the Host field
走中繼的對端一樣能連,但延遲比較高;網路狀況差的時候,這往往是「勉強能用」和「完全不能用」的分水嶺。
ssh -v user@m1-pro.your-tailnet.ts.net
如果這步就失敗,立刻停下來先修它。底下不通,上層什麼都跑不起來——mosh 沒有獨立模式,Moshpit 本質上首先是 SSH 客戶端。
這是大家最常略過、卻最能直接抓出病因的一步。在你的連接埠範圍內挑一個埠,在伺服器端監聽,從跟手機在同一個網路的電腦送測試封包:
# 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 問題。
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,但它是可以改的。
在 mosh 工作階段裡長按頂列的傳輸狀態標籤,打開 MOSH 診斷:裡面會列出 datagrams、applied、parse fails、gaps。最關鍵的一行根本不是數字:
MOSH DIAGNOSTICS No datagrams yet.
這代表字面意義上「一個封包都沒回來」——這個計數器在解密與解析之前就會累加。回程徹底斷了,別再查 Moshpit,直接回到第 3 步。
如果眼前這條網路把 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 裡沒有列出已信任清單或「忘記這台主機」的畫面,刪除連線也會保留指紋。合法更換金鑰時,需在警告視窗接受變更——該按鈕刻意標為破壞性樣式,預設按鈕則維持中斷連線。
常見問題
不用。Moshpit 只管連往一個位址,這個位址怎麼變可連線的完全由你決定。NetBird、headscale、原生 WireGuard、ZeroTier、公司 VPN,或擁有真實公網 IP 的伺服器,對 App 來說完全沒差別。這裡以 Tailscale 舉例,單純因為它是從零到連通最短的路。
1.1.0 已新增單層跳板主機(透過 SSH 的「經由」設定,等同 ssh -J),詳見跳板主機文件;不支援多層串接或 agent forwarding,且經由跳板主機時無法使用 Mosh。如果本來就有網狀網路,往往能直接省去跳板主機這層轉接。
十之八九是網路放行出站 UDP 卻攔截了回程封包——常見於分割通道 VPN、代理伺服器或企業防火牆。SSH 走 TCP 所以同一條路依然通。在那個網路跑一次上面的 nc -u 測試:如果那裡收不到回音而行動網路收得到,答案就找到了。
在 iOS 上通常不行,系統一次只允許一條 VPN 通道運作。如果必須掛著公司 VPN,私人網狀網路就得先停用,連線只能走企業網路提供的路徑。這是 iOS 系統限制,App 無法繞過。
看不到。它沒有網路探索功能,也沒有帳號。它只知道你手動填進去的連線,終端機流量也只會去那些伺服器。唯一由 Moshpit 營運的是推播中繼伺服器,只負責轉交無法解密的加密智能體提醒,絕不碰你的網狀網路或工作階段。要求「區域網路」權限純粹是為了不讓 iOS 丟掉區網 UDP 封包,而不是用來掃描裝置。
最可能就是位址問題。mosh-server 只綁定當初 SSH 登入進來的那個介面位址,所以透過網狀網路建的工作階段無法從區網直連,反之亦然。一律用網狀網路名稱儲存連線,回家也用同一條就好。詳見上方的選一個位址。
接著閱讀 從 iPhone 執行 Claude Code · 返回指南列表