Core Concepts

The two most important concepts in OmniGate are domains and resources.

Domain

A domain represents a way to access a network. It is not just a protocol enumeration, but a configurable, nameable, and reusable instance.

For example, you can have:

• Home FRP
• Your Private Server FRP
• Local Direct

Each domain has its own configuration. OmniGate supports multiple domains being online simultaneously. When you open a resource, the app will activate the domain that the resource belongs to on demand. All domain tunnels run within the app and are not system-level VPNs; they do not affect other apps' network traffic. The right side of the domain list shows a connection status icon: a green checkmark means connected, a blue spinner means connecting, a red cross means failed, and a gray circle means offline.

Resource

A resource represents a specific service accessible under a domain. Resources are similar to bookmarks but include protocol, address, port, authentication, and how to open them.

Common resources include:

• Web management pages
• SSH terminals
• SFTP file management
• FTP file management
• SMB file sharing
• WebDAV file services
• VNC remote desktops

Relationship Between Domains and Resources

A resource always belongs to a domain. When you tap a resource, OmniGate first connects to the domain, then connects to the resource.

For example:

Home FRP
  ├─ Router Web Admin
  ├─ NAS SMB
  ├─ NAS SSH
  ├─ Home Assistant
  └─ Remote Desktop

Private Server FRP
  ├─ GitLab
  ├─ Jump Server SSH
  └─ Admin Dashboard

None Domain

None is a direct connection domain. It does not start any in-app data channel; resources are accessed directly through the system's current network.

Suitable for:

• LAN resources
• Resources already accessible through a system-level VPN
• Regular public internet services

FRP Specifics

The FRP domain stores frpc client-level configuration, such as serverAddr, serverPort, user, token, and transport protocol.

Specific STCP / XTCP visitors are configured at the resource level. When opening an FRP resource, OmniGate starts a visitor for that resource and binds a random available local port. The resource client then accesses this local port.

Traffic Statistics

Resource pages display real-time upload and download speeds. Traffic from some protocols comes from system frameworks or WebKit, so the statistics may not perfectly match packet capture tools. Traffic through the built-in SOCKS5, Go mobile session, or explicit file transfers is more accurately tracked.

## Auto-Connect

Tailscale and ZeroTier domains support an "auto-connect on app launch" toggle. When enabled, the app will automatically activate that domain on startup, without needing to manually open a resource to trigger the connection. The domain list will display an auto or lazy label to distinguish the two states.

Auto-connect starts domains in serial order -- one domain goes online before the next starts -- to avoid resource contention from concurrent startup. Each domain waits up to 30 seconds.

Enabling auto-connect improves the experience (the domain is already ready when you open a resource), but it increases memory usage and battery consumption.

Network Switch Recovery

When the device's network changes (such as switching from Wi-Fi to cellular data, switching to a different Wi-Fi network, or reconnecting to the network), OmniGate automatically detects and recovers connections:

1. First, it disconnects all old connections.
2. Then it reconnects in serial order by priority: the domain of the currently active resource takes priority, followed by domains with auto-connect enabled.
3. Domains that are not in use and do not have auto-connect enabled will not be reconnected; they are simply marked as disconnected.

This allows you to resume working as quickly as possible after a network switch, while avoiding unnecessary reconnection of less commonly used domains.

Background Timeout

After the app enters the background, domain connections are not immediately disconnected. Instead, all domains are automatically disconnected after a configured timeout period. The default is 5 minutes. When returning to the foreground, domains with auto-connect enabled will automatically come back online.

You can adjust the timeout duration in Settings > General > Background Connection Timeout or in the iOS system settings. See Global Settings > Background Connection Timeout.

Home Screen Shortcuts

Resources can be added to the iOS home screen as standalone shortcut icons. After long-pressing a resource or swiping left in the resource list and selecting "Shortcut":

1. Safari opens a setup page. Follow the prompts to "Add to Home Screen."
2. After adding, tap the home screen icon to directly open OmniGate and jump to the corresponding resource.

See Home Screen Shortcuts for details.

iPad / macOS Multi-Tab

On iPad or macOS, OmniGate uses a split-column layout with multi-tab browsing on the right. Opening each resource creates a new tab, allowing you to quickly switch between different resources. iPhone retains the original single-column navigation.