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 用户手册