遠端 Mac

2026 Tailscale 遠端 Mac 總走 DERP?OrbStack SSH 延遲排障

VS Code 可以連上,但終端輸入有明顯遲滯、拉取程式碼很慢,OrbStack 裡的服務也像是間歇性失聯。

最快的處理方式不是先調整 OrbStack:先在存取端與遠端 Mac 執行 tailscale status、tailscale ping、tailscale netcheck,確認目前是 direct、peer-relay 還是 DERP;能改善網路條件時優先恢復 P2P,嚴格 NAT 無法消除時再評估 Peer Relay,並讓 SSH 先落到 Mac 主機,而不是直接暴露 OrbStack 只允許 localhost 的內建 SSH。

這篇適合三類讀者:把家中或辦公室 Mac mini 當作日常遠端開發機、長期看到 relay 的個人開發者;使用 VS Code Remote SSH 登入 Mac 後,還要進入 OrbStack Linux 或容器的工程師;以及正在比較自有節點與雲端 Mac 租賃的小型團隊負責人。

先把「OrbStack 很慢」拆成三條可能路徑

一個典型誤判是:VS Code Remote SSH 尚能建立工作階段,於是使用者把終端延遲、套件下載緩慢和容器回應遲滯全部歸咎於 OrbStack。實際上,至少有三個不同層次可能同時出問題:

  • Mac 主機層:CPU、記憶體壓力、磁碟 I/O 或服務本身回應緩慢。
  • Tailscale 網路層:連線先經 DERP,或因 UDP 受限而無法升級到 direct。
  • OrbStack 內部層:Linux 機器、容器服務、連接埠映射或監聽位址設定不一致。

Tailscale 的初始連線輸出不能直接代表整個工作階段的穩定路徑;應先判斷連線類型,再看 NAT 與 UDP,接著確認 SSH 是進入 Mac 還是錯誤地指向 OrbStack 入口,最後才處理容器服務。可先參考 Tailscale 連線類型說明,其中列出 direct、Peer Relay 與 DERP 的定位。

觀察結果 優先懷疑位置 下一個動作
tailscale ping 顯示 direct,但 SSH 仍卡頓 主機負載、SSH 服務或應用層 查 Mac 負載、系統 SSH 與 OrbStack 服務
長期顯示 DERP,且 netcheck 顯示 UDP 不可用 NAT、防火牆或出口網路 先檢查兩端 UDP 與 NAT,再評估 Peer Relay
Mac 可登入,但容器服務無法從遠端開啟 連接埠映射、監聽位址或 LAN 設定 在 Mac、Linux 機器與容器內逐層測試
Tailscale 裝置看似在線,但 SSH、OrbStack 都失聯 macOS 休眠、重啟或斷電恢復 先驗證主機狀態,不要繼續修改 DERP

第一步:用三個命令確認目前到底走哪條路

在存取端執行 tailscale status

在筆電或工作站,也就是發起 SSH 的那台裝置執行:

tailscale status

預期可看到遠端 Mac 的裝置名稱、Tailscale 位址與連線狀態。這一步的用途是確認節點是否仍在 Tailnet 中,而不是單獨證明 SSH 路徑良好。若遠端 Mac 不在清單或狀態顯示離線,應先處理主機在線問題;若節點在線,進入下一步。

在存取端執行 tailscale ping

tailscale ping <遠端Mac的Tailscale名稱或位址>

tailscale ping 會提供比一般 ICMP 測試更有用的 Tailscale 路徑資訊。請留意輸出中的 direct、peer-relay 或 DERP 類型;官方 ping 類型文件可用來核對各類輸出的含義。

判斷分支如下:

  • 顯示 direct:Tailscale 已建立點對點路徑;若 SSH 仍慢,重心應移到 Mac、SSH、OrbStack 或服務本身。
  • 顯示 peer-relay:目前使用可達的對等中繼;不要直接把它當成錯誤,先觀察穩定性與兩端網路限制。
  • 顯示 DERP:目前仍透過 DERP 中繼;需要用 netcheck 查明是 UDP 不可用、NAT 太嚴格,還是出口政策阻擋升級。

在兩端各自執行 tailscale netcheck

在存取端與遠端 Mac 都執行:

tailscale netcheck

必須分別記錄執行端、UDP 是否可用、NAT 行為及可使用的 DERP 區域。不要只在一端執行後推論另一端;P2P 建立取決於兩端的網路條件。若一端 UDP 可用、另一端被企業防火牆攔截,仍可能無法直連。可對照 Tailscale 裝置連通性文件與官方防火牆說明逐項核查。

第二步:按 NAT 與 UDP 狀況選擇處理路徑

無公網 IP 不等於必然無法直連。許多家用網路雖然沒有可從網際網路直接進入的位址,仍可能透過 UDP 打洞建立 direct;相反地,雙方都處於嚴格 NAT、企業防火牆阻擋 UDP,或出口映射頻繁改變時,直連可能反覆失敗。

建議依下列順序處理:

  1. 先確認兩端 UDP:在兩台裝置查看 netcheck,並核對是否有防火牆或公司網路政策限制。
  2. 改善其中一端的 NAT 條件:如果只有一端受限,優先調整較容易控制的家庭路由器、辦公室出口或網路分段。
  3. 觀察是否能穩定使用 Peer Relay:當直連不可靠、但存在可控且可達的對等節點時,Peer Relay 可能比反覆等待 direct 更適合日常工作;細節可參考Tailscale Peer Relay 官方文件。
  4. 最後才評估自訂 DERP:自訂中繼是拓撲、地區、合規或可控性選項,不是「看到 DERP 就必須自建」的修補方法。

提醒: 任何網路調整都不能保證特定環境必然建立 P2P。DERP 或 Peer Relay 是連線路徑,不應被簡化成安全性下降;實際風險仍取決於存取控制、裝置權限與服務暴露範圍。

網路觀察 建議選擇 不應作出的結論
兩端 UDP 可用,ping 顯示 direct 保留目前路徑,轉查 SSH 或 OrbStack 不要因為應用層慢就重建 DERP
一端 UDP 被封鎖,且可改善出口 先處理防火牆、NAT 或網路分段 不要假定無公網 IP 是唯一原因
嚴格 NAT,direct 長期失敗,但有可控對等節點 評估 Peer Relay 不要保證 Peer Relay 一定比 DERP 快
網路政策不能改,也沒有可用對等節點 保留 DERP,縮小服務暴露並接受路徑限制 不要把自訂 DERP當成延遲必然下降

第三步:把 SSH 入口放在 Mac 主機,而非 OrbStack 內建服務

OrbStack 官方文件已明確說明,其內建 SSH 預設只允許 localhost 連線;因此,遠端裝置不應把該入口當作可直接由 Tailnet 存取的 SSH 伺服器。可先查看OrbStack SSH 官方文件確認目前版本的行為。

較少暴露面的路徑是:

遠端工作站
   │
   └─ Tailscale SSH 或系統 SSH
          │
          └─ Mac 主機
                 │
                 └─ OrbStack Linux 機器或容器

實際排查可按以下順序執行:

  1. 在遠端工作站測試 Tailscale 裝置是否在線,再使用 Tailscale SSH 或系統 SSH 登入 Mac。
  2. 在 Mac 主機內確認本機 SSH 登入成功,並以本機名稱或 OrbStack 提供的方式進入 Linux 機器。
  3. 若工程需要獨立登入 Linux,在對應 Linux 機器內設定自有 SSH 服務,另行管理使用者、金鑰與授權。
  4. 設定 VS Code Remote SSH時,讓主機跳轉或端口轉發先落到 Mac,再由 Mac 進入 Linux;VS Code Remote SSH 文件可用作設定語法與跳轉架構的參考。
  5. 不要把 OrbStack localhost 端口直接轉成廣泛可達的 Tailnet 服務;每增加一個入口,都要說明誰能連線、要到哪個服務,以及何時撤銷權限。

若登入 Mac 本身已經卡頓,OrbStack 內建 SSH 並不是修復方向;應返回 tailscale ping 判斷路徑,並檢查 Mac 的 CPU、記憶體壓力與磁碟活動。

第四步:逐層確認容器端口,而不是只測一個位址

容器能在 Mac 上開啟,不代表遠端工作站一定能開啟。至少要區分四個概念:

  • 容器內服務實際監聽的位址;
  • OrbStack Linux 機器與容器之間的端口映射;
  • Mac 主機的 Tailscale 位址;
  • OrbStack 的私有網路與「Expose ports to LAN」相關設定。

資料流應先畫成:

遠端工作站
   │ Tailscale
   ▼
Mac 主機的 Tailscale 位址
   │
   ▼
OrbStack 虛擬網路/Linux 機器
   │
   ▼
容器端口映射
   │
   ▼
容器服務的監聽位址

排查時不要一開始就開放所有端口,而是採用最小範圍測試:

  • 在容器內確認服務是否監聽預期端口,以及是否只綁定 127.0.0.1。
  • 在 OrbStack Linux 機器內測試該服務,確認端口映射是否存在。
  • 在 Mac 主機內以本機位址測試,再以 Mac 的 Tailscale 位址測試。
  • 在遠端工作站只測試指定服務端口,並記錄是逾時、拒絕連線,還是服務回應錯誤。
  • 若涉及 LAN 暴露,只允許必要的來源與端口,完成測試後移除不再需要的規則。

OrbStack 容器網路文件可用來核對容器端口與 Linux 機器網路行為。這裡最常見的錯誤,是把 Mac 的 localhost、Mac 的 Tailscale 位址與 OrbStack 私有位址視為同一層;三者實際上位於不同的轉發邊界。

第五步:先證明主機在線,再處理休眠與重啟

如果 tailscale status 顯示節點離線,或 Tailscale SSH、系統 SSH、OrbStack 服務同時失聯,問題更可能是 Mac 沒有保持可用,而不是 DERP 延遲。此時應在實體螢幕或既有管理途徑核對:

  • macOS 是否啟用了會中斷無人值守工作的自動睡眠設定;
  • 是否允許網路喚醒,以及該機型是否支援所需功能;
  • 斷電後是否設定自動啟動;
  • 重新啟動後 Tailscale 是否自動運作;
  • OrbStack Linux 與開發服務是否會隨主機恢復。

Apple 的桌面能源設定說明提醒,相關選項會受 macOS 版本與 Mac 機型影響,因此不能只按照另一台 Mac 的畫面照抄。

無人值守驗收清單

  • [ ] 鎖定螢幕後,從遠端工作站執行 tailscale ping。
  • [ ] 鎖定狀態下測試 Tailscale SSH 或系統 SSH。
  • [ ] 進入 Mac 後確認 OrbStack Linux 與開發服務仍在運作。
  • [ ] 讓 Mac 進入睡眠,再分別測試裝置狀態、SSH 與應用服務。
  • [ ] 重新啟動 Mac,確認 Tailscale、SSH、OrbStack 與開發服務的恢復順序。
  • [ ] 模擬斷電恢復,確認機型支援的自動啟動設定真的有效。
  • [ ] 將每次測試的連線類型、失聯時間與恢復方式保存,避免下次又把主機離線誤判成 DERP。

用條件分支決定是否繼續維護自有節點

  • 若 tailscale ping 穩定顯示 direct,休眠與重啟後服務可恢復,則繼續維護自有 Mac,重點放在權限、備份與監控。
  • 若 direct 不穩定,但 Peer Relay 可用,且節點仍能通過鎖定、重啟驗收,則先採用可控中繼,不必立即自建 DERP。
  • 若只能長期使用遠距 DERP,互動式 SSH 已影響工作,則先保存鏈路驗收結果,再比較不同地域與在線保障。
  • 若休眠、斷電或重啟後無法可靠恢復,則不要繼續修改 OrbStack 端口;應評估持續在線的雲端 Mac 環境。
  • 若團隊需要實體 USB、固定硬體或長時間高負載,則自有 Mac 仍可能較合適;若需求是臨時測試、遠端辦公或快速交付,租賃方案通常更容易控制維護責任。

需要比較雲端 Mac 的地域與交付方式時,可先查看 KuzCloud 的 Mac 方案資訊,再使用說明中心核對連線與使用限制。若目前自有方案的主要缺點是需要自行處理休眠、斷電恢復、NAT 與長期中繼,繼續投入排障未必比直接取得持續在線節點划算;對臨時算力、測試環境或遠端辦公而言,按地域、在線保障、交付方式與租賃週期比較 KuzCloud,通常能讓責任邊界更清楚。

常見問題

詳見本文上方的 FAQ 摺疊內容:重點包括 Tailscale 長期顯示 DERP 的原因、direct 與 relay 的判斷方式、嚴格 NAT 下的 Peer Relay 選擇、經由 Mac 進入 OrbStack Linux,以及 Mac 休眠後 Tailscale SSH 的恢復順序。保存一次完整的驗收記錄,比反覆修改 OrbStack 參數更能縮短下一次排障時間。

為遠端開發換上穩定在線的 KuzCloud Mac

KuzCloud 提供持續在線的遠端 Mac,減少設備休眠、NAT 與中繼連線造成的延遲問題。

無論是 SSH 開發、建置測試或長時間執行工作,都能透過穩定的雲端環境維持順暢流程。