故障排查

排查連線問題時，先判斷失敗發生在網域層還是資源層。

網域連線失敗

### WireGuard

檢查：

• 對端位址和連接埠是否正確。
• 本地私鑰、對端公鑰、預共享金鑰是否匹配。
• 本地 IP 是否帶 CIDR。
• 伺服器端是否允許該 peer。
• 伺服器端是否允許轉發到目標內網。

FRP

檢查：

• serverAddr 和 serverPort 是否正確。
• token 是否匹配。
• transport.protocol 是否與伺服器端支援一致。
• user 和 clientID 是否與其他上線客戶端衝突。

如果 frps 提示 client_id is already online，說明相同 user/clientID 已經上線。

### Tailscale

檢查：

• 是否已登入。
• 裝置是否被 Tailscale 或 Headscale 管理端授權。
• 控制伺服器 URL 是否正確。
• Auth Key 是否有效。
• 當前網路是否能存取控制伺服器。

如果提示沒有登入連結，優先檢查 Headscale 是否支援互動式登入，或改用 Auth Key。

ZeroTier

檢查：

• Network ID 是否正確。
• ZeroTier 控制台是否出現新裝置。
• 新裝置是否已授權。
• 當前網路是否允許 ZeroTier 連線。

資源連線失敗

Web 頁面打不開

檢查：

• URL 是否包含 http:// 或 https://。
• 當前資源是否屬於正確網域。
• 目標 host 和連接埠是否可從該網域存取。
• HTTP 頁面是否被 App Transport Security 或混合內容策略攔截。

HTML 打開但頁面功能異常

可能是 Ajax、WebSocket 或重新導向位址沒有走通。檢查頁面中實際請求的位址是否仍在當前網域可達範圍內。

SSH 卡在連線中

檢查：

• host、port、username 是否正確。
• 當前網域是否已 ready。
• 目標 sshd 是否允許來自網域位址的連線。
• 認證方式是否正確。
• 私鑰是否需要密碼。

檔案管理空白或打不開目錄

檢查：

• FTP / SMB / SFTP / WebDAV 帳號密碼是否正確。
• path 是否是伺服器端存在的目錄。
• SMB path 是否包含共享名稱。
• 本地目錄是否已透過系統檔案選擇器授權。

VNC 連線失敗

檢查：

• 連接埠是否正確，常見為 5900 或 5901。
• 伺服器端是否啟用 VNC password auth。
• 密碼是否正確。
• 伺服器端是否啟用了 OmniGate 暫不支援的進階安全類型或編碼。

切換 App 或息屏後資源失效

行動系統可能會暫停後台連線。OmniGate 進入後台後會在設定的逾時時間（預設 5 分鐘）後自動斷開所有網域連線以節省電量。回到前景後，設定了自動連線的網域會自動重新上線。

如果資源無法恢復：

1. 先使用資源頁選單重新連線。
2. 如果仍失敗，返回資源列表重新打開。
3. 如果網域狀態異常，切換網域或重啟 App。

如果希望後台保持連線不斷開，可以在 設定 > 通用 > 後台保持連線 中選擇「永不斷開」，但會增加耗電。

切換網路後資源失效

切換 WiFi、切換到行動數據或重新連網後，OmniGate 會自動偵測網路變化並重連當前正在使用和設定了自動連線的網域。

如果自動重連沒有生效：

1. 檢查網域列表中對應網域的狀態是否已恢復為已連線。
2. 使用資源頁選單重新連線。
3. 如果仍失敗，返回資源列表重新打開資源。

## 日誌怎麼看

除錯時優先看 Xcode 控制台中以下關鍵詞：

• [ProxyRuntime]
• [Browser]
• [SSH]
• [WireGuardProxy]
• [TailscaleProxy]
• [ZeroTierProxy]
• [FRP]
• [SOCKS5]

判斷原則：

• 只有網域日誌，沒有資源日誌：資源可能還沒開始連線。
• 網域 ready 後資源失敗：優先查目標位址、連接埠、認證。
• 出現 direct mode：確認資源是否屬於 None 網域，或當前代理是否未啟用。