[Glossary]Official Manual · Term Reference

Shadowrocket Glossary

Look up terms by interface location and configuration purpose. First identify whether the item is a switch, protocol, or rule keyword, then check its parameters. The same English term can mean different things in different parts of the app.

Interface labels remain in English Rule keywords are case-sensitive Example domains do not indicate an available service

[Interface]

Interface & Switches

Distinguish interface labels from routing modes. In Global Routing, the Config, Proxy, and Direct options correspond to their respective modes. Config can also refer to the interface for managing configuration files.

Home
The interface for viewing server entries, choosing a connection target, and controlling the connection. An entry in the list only means its details have been saved; it does not confirm successful authentication, DNS resolution, or connection. Before connecting for the first time, check the selected entry, the connection switch, and the status shown by the system.
Global Routing
A setting that determines the overall routing mode for requests. Config processes requests according to the configuration, Proxy uses proxy mode, and Direct uses direct mode. It does not select the server protocol. If a rule does not seem to work, first check that Config is selected, then review the rule order.
Config
As a Global Routing option, Config processes requests according to the rules and settings in the current configuration. As an interface label, it refers to the place where configuration files are managed, selected, and edited. So, “Config imported” and “routing with Config” are not the same thing. After editing a file, confirm that it is the one currently in use, not another copy with a similar name.
Proxy
The proxy mode in Global Routing sends applicable requests through the current proxy, subject to any bypass settings in the system or configuration. It does not supply a server address, password, or transport parameters, and it does not guarantee that the selected server is reachable. Interpret Proxy in the interface separately from the uppercase PROXY in a rule.
Direct
The direct mode in Global Routing sends applicable requests to their destinations over the current network. It can help determine whether an issue occurs only on the proxy path, but accessing a destination after switching modes does not prove that all the original server parameters are correct. Direct connections still depend on the current network, DNS, and destination service.
Add Server
The entry point for manually adding server details. Have the parameters for a service you already use ready before proceeding. Select the correct protocol, then enter SERVER, port, authentication, and transport fields. Fields with the same name may not be interchangeable across protocols. Saving creates an entry; run a connectivity test afterward.
Connectivity Test
A test for checking whether an entry is reachable. Results depend on the test method, destination, and current network conditions. The reported time is not the actual download speed, and a successful test does not guarantee that every website, UDP request, or long-lived connection will work. When troubleshooting, note the test method and consider the results alongside actual access and the Log.

[Settings]

Settings

Settings affect behavior such as DNS resolution, connection triggers, tests, and logging. These explanations cover concepts and do not assume that every platform has the same menu locations or defaults. Check the current interface and configuration when choosing specific values.

DNS
DNS resolves domain names to IP addresses and is a necessary step before many connections can begin. A resolution failure is different from a proxy authentication failure; changing the proxy password usually will not fix a DNS error. Check the DNS server, the path taken by DNS requests, and whether the resolved address is expected. Avoid changing several settings at once so you can compare results.
On Demand
A mechanism that triggers a connection when specified conditions are met; it does not mean the connection will stay active at all times. Actual behavior depends on the trigger conditions, system state, and network changes. Whether a connection resumes after being turned off manually also depends on the current settings. After making changes, test on the relevant Wi-Fi, cellular, or network-switching scenarios instead of just checking whether the switch is on.
Ping
In settings and test descriptions, this commonly refers to a connectivity probe. Its exact meaning depends on the test method in use. Do not assume every result shown in milliseconds is the same as an ICMP round-trip time, and never treat it as a direct measure of bandwidth. To compare two entries, keep the test method, target, and network conditions as consistent as possible.
Log
Logs can help identify whether a connection problem occurred during DNS resolution, connection setup, authentication, or protocol negotiation. Reproduce the issue first, then check the relevant entries from around that time so old errors are not mistaken for the current cause. Before sharing logs, remove subscription URLs, authentication details, private server information, and anything that could reveal personal browsing activity.
iCloud Sync
iCloud can sync app-supported data across supported Apple devices; check the app's current settings for the exact scope. Syncing does not transfer live connection state or replace a separate backup that has been confirmed as restorable. When switching devices, check server entries, the selected configuration, and sync status before deleting data from the original device.

[Protocol]

Protocols

Protocol names identify connection methods; they do not guarantee service quality or define all settings by default. The descriptions below assume you already have server details. After importing, check that the protocol, authentication, security layer, and transport settings match.

Shadowsocks
A proxy protocol commonly configured with a server address, port, password, and encryption method. Both the encryption method and password must match the server; changing the name alone does not change how the protocol works. If the existing configuration includes additional transport parameters, check them against the original details. An address and port alone may not be enough.
VMess
A proxy protocol that authenticates using parameters such as a user ID, and commonly includes transport and TLS settings. The server address, user ID, and transport-layer parameters each serve a different purpose; one field cannot substitute for another. If the connection fails, check that the device's clock is accurate, then compare each setting with the original details.
VLESS
A proxy protocol whose user ID, transport, and security settings must each be checked. The name VLESS alone does not tell you whether TLS is enabled, and transport paths or Host values from another setup may not apply. If an imported entry appears but cannot connect, first compare its authentication and transport fields with the original configuration.
Trojan
A proxy protocol that typically uses TLS to protect traffic. Check the password, server address, port, and SNI. SNI indicates the server name during the TLS handshake and does not always match the connection address; use the details provided for your service. If a certificate error occurs, check the name, system clock, and certificate configuration. Do not use Allow Insecure as a routine fix.
HTTP / SOCKS5
Two different proxy protocols with distinct approaches to authentication, destination connections, and transport capabilities. An HTTP proxy can use CONNECT to establish a tunnel, but the protocol name alone does not prove that traffic between the client and proxy server is encrypted. When adding an entry, confirm which protocol the server uses, its authentication method, and whether TLS is required separately.
WireGuard
A key-authenticated tunneling protocol that uses UDP. Its configuration includes a key, endpoint, address, and routing information. The key field is not an ordinary username or password, and a private key should never appear in public screenshots or logs. Troubleshooting should account for UDP reachability, key pairing, tunnel addresses, and routes—not just the endpoint domain.
Hysteria2
A QUIC-based proxy protocol that depends on UDP availability on the current network to establish and carry connections. Match the server's authentication, port, TLS settings, and other relevant parameters when importing. The protocol name is no substitute for these details. If it fails on one network but works on another, consider the network conditions rather than repeatedly changing the password.

[Rule]

Rule Keywords

Rules are usually checked from top to bottom, and the first match determines the policy. When reading a rule, identify the match type, match condition, and policy in that order. Domain and IP rules rely on different information.

DOMAIN
Matches the exact specified domain, for example DOMAIN,example.com,DIRECT. This rule does not automatically include www.example.com, which is a separate domain. Consider this precise match when you want to change the policy for one complete domain only.
DOMAIN-SUFFIX
Matches a specified domain and its subdomains at the domain-suffix boundary, for example DOMAIN-SUFFIX,example.com,PROXY. It can match example.com and api.example.com, but it is not an arbitrary substring match. If a subdomain needs an exception, place the more specific rule above this broader one.
DOMAIN-KEYWORD
Matches a specified string anywhere in a domain name, for example DOMAIN-KEYWORD,example,PROXY. It is generally broader than exact-domain and suffix rules, and may match unrelated domains. Before using it, decide whether you need a substring match or a match covering a domain and its subdomains.
IP-CIDR
Matches destination addresses in an IPv4 range. In CIDR notation, the number after the slash is the network prefix length. For example, IP-CIDR,192.168.0.0/16,DIRECT can apply a policy to this private address range. The rule matches addresses, not website names; whether an address is available for matching also affects the result.
IP-CIDR6
Matches destination addresses in an IPv6 range using IPv6 prefix notation. IPv4 IP-CIDR rules do not automatically cover IPv6, so the same destination may match different rules when reached over different address families. If the same domain sometimes uses different policies, check both its IPv4 and IPv6 DNS results.
GEOIP
Matches a destination address using its allocation information in an IP geolocation database, for example GEOIP,CN,DIRECT. Database records do not indicate the user's location, a website's language, or the location of its operator, and may lag behind deployment changes. For consistent handling of a specific domain, do not rely on GEOIP alone to determine how all of its connections behave.
FINAL
Sets the final policy for requests that do not match earlier rules, and is usually placed at the end of the rule list. For example, FINAL,PROXY sends remaining requests to PROXY; it does not restart matching from the first rule. If many requests reach FINAL, check the scope and order of earlier rules and confirm that the expected configuration is in use.
PROXY / DIRECT / REJECT
Common rule policy identifiers for routing through a proxy policy, connecting directly, or rejecting a request. These are actions taken when a rule matches, not protocols such as Shadowsocks or VLESS. The target used by PROXY also depends on the current proxy selection and configuration. REJECT actively denies a request; do not mistake the resulting failure for an unreachable server.

[Profile]

Subscriptions & Configuration

Server entries describe connection targets; configuration files define how requests are handled. They are not interchangeable. This site explains how to manage subscriptions or server details you already have; it does not provide, sell, or recommend servers or subscriptions.

Subscribe
Fetches and updates server entries using a subscription URL you already have. Obtain the URL from your own service provider. It may contain account-identifying or access-authorizing parameters, so treat it as sensitive and do not post it publicly. A subscription update usually refreshes the entries it manages; it does not necessarily update the full rule configuration or manually edited content.
SERVER
The server address field, usually a domain name or IP address, used alongside separate port and authentication fields. Unless the field explicitly asks for a full URL, do not enter a subscription URL, webpage address, or URL with a path as the server domain. A server entry usually also includes protocol settings, so a SERVER value alone is not enough to connect.
Configuration File
A document containing settings and rules such as [General] and [Rule], describing how requests are handled. Importing a file does not mean it has been selected or that Global Routing is set to Config. Keep a recoverable copy before editing. After changes, test a specific request to verify rule matching rather than just checking whether the file saves.
URL Rewrite
A mechanism for rewriting request URLs or applying other actions under specified conditions. It operates at a different level from routing rules that determine the connection path. A DOMAIN-SUFFIX match does not make it take effect automatically; processing HTTPS content also depends on applicable conditions and certificate trust. Enable it only after understanding the rule source and scope. Do not add rewrite rules blindly to fix ordinary connection problems.
Purchased Items
The App Store section for viewing an account's purchase history. Use it to check the Shadowrocket purchase record and eligibility to redownload. The iPhone / iPad app costs $2.99 as a one-time purchase on the App Store; both devices can use the purchase history of the same account. The Mac, Windows, Android, and Linux versions are free. When redownloading, make sure the store account in use matches the original purchase account, and check availability as shown on the store page.

If you can identify the terms but still cannot connect, use Frequently Asked Questions to distinguish DNS, authentication, and rule-matching issues. To change a specific setting, check the Settings Reference.