核心概念
OmniGate 里最重要的两个概念是网域和资源。
网域
网域表示一种接入网络的方式。它不是单纯的协议枚举,而是一个可保存、可命名、可重复添加的配置实例。
例如你可以有:
家庭 FRP私人服务器 FRP本地直连
每个网域都有自己的配置。OmniGate 支持多个网域同时在线,打开资源时 App 会按需激活当前资源所属网域。所有网域通道均在 App 内运行,不是系统级 VPN,不会影响其他 App 的网络流量。网域列表右侧会显示连接状态图标:绿色勾表示已连接,蓝色转圈表示连接中,红色叉表示失败,灰色圆表示离线。
资源
资源表示某个网域下可以访问的具体服务。资源类似书签,但包含协议、地址、端口、认证和打开方式。
常见资源包括:
- Web 管理页面
- SSH 终端
- SFTP 文件管理
- FTP 文件管理
- SMB 文件共享
- WebDAV 文件服务
- VNC 远程桌面
网域和资源的关系
资源总是属于某个网域。点击资源时,OmniGate 先连接网域,再连接资源。
例如:
家庭 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 或显式文件传输的流量更容易被准确统计。
网络切换恢复
当设备网络发生变化(如 WiFi 切换到蜂窝数据、切换到不同的 WiFi、或重新联网)时,OmniGate 会自动检测并恢复连接:
- 先断开所有旧连接。
- 按优先级串行重连:当前正在使用的资源所属网域优先,然后是设置了自动连接的网域。
- 未在使用且未设置自动连接的网域不会重连,只标记为已断开。
这样可以在切换网络后尽快恢复工作状态,同时避免不必要地重连不常用的网域。
后台超时
应用进入后台后,网域连接不会立即断开,而是在设定的超时时间后自动断开所有网域。默认 5 分钟。回到前台后,设置了自动连接的网域会自动重新上线。
可以在 设置 > 通用 > 后台保持连接 或 iOS 系统设置中调整超时时长。详见 全局设置 > 后台保持连接。
桌面快捷方式
资源可以添加到 iOS 主屏幕作为独立快捷方式图标。长按资源或在资源列表左滑选择"快捷方式"后:
- Safari 打开引导页,按提示"添加到主屏幕"。
- 添加后,点击主屏幕图标直接打开 OmniGate 并跳转到对应资源。
详见 桌面快捷方式。
iPad / macOS 多 Tab
在 iPad 或 macOS 上,OmniGate 使用分栏布局,右侧支持多 Tab 浏览。每打开一个资源会创建一个新 Tab,可以在不同资源之间快速切换。iPhone 保持原有的单栏导航。
