Skip to content

核心概念

OmniGate 裡最重要的兩個概念是網域和資源。

網域

網域表示一種接入網路的方式。它不是單純的協議列舉,而是一個可儲存、可命名、可重複新增的配置實例。

例如你可以有:

  • 家庭 FRP
  • 遠端 FRP
  • 本地直連

每個網域都有自己的配置。OmniGate 支援多個網域同時上線,打開資源時 App 會按需啟用當前資源所屬網域。所有網域通道均在 App 內運行,不是系統級 VPN,不會影響其他 App 的網路流量。網域列表右側會顯示連線狀態圖示:綠色勾表示已連線,藍色轉圈表示連線中,紅色叉表示失敗,灰色圓表示離線。

資源

資源表示某個網域下可以存取的具體服務。資源類似書籤,但包含協議、位址、連接埠、認證和打開方式。

常見資源包括:

  • Web 管理頁面
  • SSH 終端
  • SFTP 檔案管理
  • FTP 檔案管理
  • SMB 檔案共享
  • WebDAV 檔案服務
  • VNC 遠端桌面

網域和資源的關係

資源總是屬於某個網域。點擊資源時,OmniGate 先連線網域,再連線資源。

例如:

text
家庭 FRP
  ├─ 路由器 Web 管理頁
  ├─ NAS SMB
  ├─ NAS SSH
  ├─ Home Assistant
  └─ 遠端桌面

私人伺服器 FRP
  ├─ GitLab
  ├─ 跳板機 SSH
  └─ 管理面板

None 網域

None 是直連網域。它不啟動任何 App 內資料通道,資源會按系統當前網路直接存取。

適合:

  • 區域網路資源
  • 已經由系統級 VPN 接入的資源
  • 一般公網服務

FRP 的特殊性

FRP 網域儲存的是 frpc 客戶端級配置,例如 serverAddr、serverPort、user、token 和 transport protocol。

具體 STCP / XTCP visitor 放在資源層。打開某個 FRP 資源時,OmniGate 會為該資源啟動 visitor,並隨機綁定一個本地可用連接埠,資源客戶端再存取這個本地連接埠。

流量統計

資源頁面會顯示即時上傳和下載速度。部分協議流量來自系統框架或 WebKit,統計口徑可能與封包擷取工具不完全一致;透過內建 SOCKS5、Go mobile session 或明確檔案傳輸的流量更容易被準確統計。

## 自動連線

Tailscale 和 ZeroTier 網域支援「打開 App 時自動連線」開關。開啟後,App 啟動時會自動啟用該網域,無需手動點開資源才觸發連線。網域列表中會顯示 autolazy 標籤來區分。

自動連線按序列順序啟動,一個網域上線後再啟動下一個,避免並行啟動導致的資源競爭。每個網域最長等待 30 秒。

開啟自動連線會最佳化體驗(打開資源時網域已經 ready),但會增加記憶體和耗電。

網路切換恢復

當裝置網路發生變化(如 WiFi 切換到行動數據、切換到不同的 WiFi、或重新連網)時,OmniGate 會自動偵測並恢復連線:

  1. 先斷開所有舊連線。
  2. 按優先順序序列重連:當前正在使用的資源所屬網域優先,然後是設定了自動連線的網域。
  3. 未在使用且未設定自動連線的網域不會重連,只標記為已斷開。

這樣可以在切換網路後盡快恢復工作狀態,同時避免不必要地重連不常用的網域。

後台逾時

應用程式進入後台後,網域連線不會立即斷開,而是在設定的逾時時間後自動斷開所有網域。預設 5 分鐘。回到前景後,設定了自動連線的網域會自動重新上線。

可以在 設定 > 通用 > 後台保持連線 或 iOS 系統設定中調整逾時時長。詳見 全域設定 > 後台保持連線

桌面捷徑

資源可以新增到 iOS 主畫面作為獨立捷徑圖示。長按資源或在資源列表左滑選擇「捷徑」後:

  1. Safari 打開引導頁,按提示「新增到主畫面」。
  2. 新增後,點擊主畫面圖示直接打開 OmniGate 並跳轉到對應資源。

詳見 桌面捷徑

iPad / macOS 多 Tab

在 iPad 或 macOS 上,OmniGate 使用分欄佈局,右側支援多 Tab 瀏覽。每打開一個資源會建立一個新 Tab,可以在不同資源之間快速切換。iPhone 維持原有的單欄導覽。

OmniGate 使用者手冊