Rules & Routing
Set a route for each destination based on matching conditions.
In Home, set Global Routing to Config, then open Config and check the [Rule] section of the active file. Rules are matched in order, and the first match determines whether traffic uses PROXY, DIRECT, or REJECT. FINAL applies only if no earlier rule matches. To handle a specific domain differently from its subdomains, place its DOMAIN rule before a broader DOMAIN-SUFFIX rule. Change one rule at a time when testing so you can identify what caused the result.
DOMAIN-SUFFIX,example.com,PROXY
See how to set the routing mode →
On Demand
Choose whether to connect automatically based on network conditions.
In Settings, turn on On Demand and check the trigger conditions shown on your device before deciding which networks should use it. If the connection starts again after you disconnect manually, check whether the current network meets a trigger condition before deleting any servers. To test, switch between two networks where testing is allowed and observe the switch. On Demand controls when to connect; Global Routing and the configuration determine where requests go after the connection is established.
Settings → On Demand
See switch and interface terminology →
Multiple protocols
Choose Type based on the server details you have, not by guessing from the protocol name.
After opening Add Server, check Type first. Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, and Hysteria2 use different fields; knowing the Host and Port alone isn't enough to identify the protocol. Enter details by checking each field against the original information, paying particular attention to transport, security settings, and any identification fields required by the server. If the connection fails, first check that each value is in the correct field. Don't add parameters from another protocol just to clear an error.
Add Server → Type / Host / Port
See the protocol reference →
Import subscriptions
Use Subscribe to manage a group of servers from the same subscription URL.
Import the full URL provided by your existing service provider. After saving, return to Home and check the SERVER group to confirm the expected entries appear. If the list is empty after an update, first check whether the URL was truncated, then confirm the server is still returning valid content. Updating a subscription and choosing the default server are separate actions; after a successful update, make sure the dot is still next to the server you want to test. Subscription URLs may contain access credentials, so don't include the full link or its QR code when reporting an issue.
Add Server → Subscribe
See what to check when a subscription is empty →
Config files
Save routing rules and configuration settings in a file.
In Config, confirm which file is active before editing. Otherwise, you could change a backup file while testing a different one. Keep a recoverable copy before making changes. When editing [Rule], check the rule order and FINAL, then return to Home to test. Before using iCloud sync, confirm that the device is signed in to the intended account and that sync is enabled in the app; then check for the file on another device. File sync does not automatically enable a configuration or replace testing it on the device.
[Rule]
FINAL,DIRECT
See configuration and rules terminology →
Diagnostic tools
First distinguish a failed connection from a destination that won't load or a difference in usage statistics.
In Home, use Connectivity Test to check the selected server, then test access to the same destination. If only some destinations fail, check the active mode and the rule that matched in the current configuration. To review traffic, check Data for statistics by server and by app. Before comparing readings, use the same time period and upload or download direction. In-app statistics may use different accounting from the server's billing. When reporting an issue, include what happened and how to reproduce it, but hide addresses and authentication details.
Connectivity Test → Data
See how to read Data statistics →