Official Manual · Glossary

Shadowrocket Glossary

Look up terms by screen and purpose. First distinguish Global Routing modes, Rule actions, and server settings, then follow the relevant steps. English names are shown as they appear in the app and configuration files.

Interface and Controls

Connection status, routing mode, and test results answer different questions and are not interchangeable.

Main Screen

Home

Home is the main screen for checking connection status, Global Routing, and the server list. An entry in the list only means its connection details are saved; it does not mean a tunnel is active. Before connecting for the first time, check the server and mode, then turn on the connection switch.

Routing Mode

Global Routing

Global Routing determines how connections are handled overall. Choose Config, Proxy, or Direct. It is not a server selector, and changing modes does not correct a server address or authentication details. When troubleshooting, note the current mode so you can compare results consistently.

Three Modes

Config / Proxy / Direct

Config follows the rules in the current configuration. Proxy routes general connections through the selected proxy. Direct connects without a proxy. These names describe overall modes, not the action on an individual Rule. System networking, app settings, and connection status can also affect the result.

Connection Triggers

On Demand

On Demand lets the system start a VPN connection when configured conditions are met; it is not a scheduled speed test. The connection may start again when conditions are met, even after you disconnect manually. To pause connections temporarily, check the On Demand setting and its trigger conditions.

Diagnostics

Connectivity Test

Connectivity Test checks how a server responds on the current network; the result depends on the test method. A response does not confirm that authentication, DNS, or access to the destination site is working. After testing, connect and visit the intended destination to verify access.

Traffic Monitoring

Data

Data shows traffic recorded by the app and can help you track changes over a period of use. The app and your provider may differ in what they count, when totals reset, and how traffic is measured, so the displayed figure is not necessarily your remaining allowance. Check your provider’s information to confirm usage limits.

App Settings

Settings

Settings contains app preferences, unlike the Config screen, which stores rules. When troubleshooting a connection, note the original values, change one setting at a time, and repeat the same test. Avoid changing DNS, routing, and connection triggers all at once in an attempt to restore access.

Protocols

A protocol defines how the client communicates with a server. Its type and settings must match the server; changing the protocol name alone does not convert a connection.

Proxy Protocols

Shadowsocks

Shadowsocks uses settings such as server address, port, encryption method, and password to establish a proxy connection. The encryption method must match the server; an incorrect method can cause the connection to fail even when the address is right. Get the required details from your service provider rather than guessing from another server’s settings.

Proxy Protocols

VMess

VMess authenticates with parameters such as a user ID and may also require a transport type and related options. After importing an entry, keep all settings included in the link rather than checking only the address and port. If authentication fails, check that the settings are complete and the device clock is accurate.

Proxy Protocols

VLESS

VLESS configures user authentication separately from transport-layer security; the name alone does not indicate how the connection is encrypted. Check the user ID and server requirements for TLS, transport, and other options. Do not convert a VMess entry to VLESS by changing only its type.

Proxy Protocols

Trojan

Trojan is commonly used with TLS and password authentication. The server address, port, password, and TLS-related names must match. Certificate validation errors can also cause connection failures. Check the server settings first; disabling validation should not be a routine fix.

QUIC-Based

Hysteria2

Hysteria2 is a QUIC-based proxy protocol that relies on UDP and matching authentication and TLS settings. UDP availability on the current network can affect the connection. Similar protocol names do not mean that server settings from different generations are interchangeable; import the details as provided.

Tunneling Protocol

WireGuard

WireGuard uses key-based authentication, with addresses and routing ranges defining tunnel traffic. A private key is sensitive information and should not be shared publicly alongside ordinary server names. Even after a successful handshake, incorrect DNS or routing ranges can prevent access to the intended destination.

Proxy Access

HTTP / SOCKS5

HTTP and SOCKS5 are different proxy access protocols; do not assume that the same port works for both. Username, password, and secure transport requirements depend on the server configuration. The protocol name alone does not guarantee that the entire connection is encrypted, so check transport security separately.

Rule Keywords

Check the match condition first, then the final action. The domains and IP ranges below are syntax examples, not usable server details.

Rule Basics

Rule

A Rule matches connections using conditions such as domain names or IP addresses, then specifies an action. Rules are generally checked in order; once an earlier rule matches, later rules may not apply. Save a copy of the configuration before adding a rule, and check whether a broader condition earlier in the list takes precedence.

Exact Domain

DOMAIN

DOMAIN matches an exact domain, for example DOMAIN,example.com,DIRECT. It does not automatically cover every subdomain just because the names are related. To include subdomains, consider DOMAIN-SUFFIX rather than stacking ambiguous keywords.

Domain Suffix

DOMAIN-SUFFIX

DOMAIN-SUFFIX matches a domain and its subdomains, for example DOMAIN-SUFFIX,example.com,PROXY. It matches at domain boundaries, not by searching for an arbitrary string. A service may use multiple domains, so one suffix rule may not cover all of its requests.

Domain Keyword

DOMAIN-KEYWORD

DOMAIN-KEYWORD matches connections whose domain contains a specified keyword, for example DOMAIN-KEYWORD,example,PROXY. It generally covers more than an exact-domain or suffix match. A short keyword can affect unrelated domains, so define the intended scope before using one.

IP Address Ranges

IP-CIDR / IP-CIDR6

IP-CIDR is for IPv4 ranges; IP-CIDR6 is for IPv6 ranges. The prefix length after the slash defines the address range. For example, IP-CIDR,192.168.0.0/16,DIRECT sends that private address range to DIRECT. An IPv4 rule alone does not also cover IPv6.

IP Geolocation

GEOIP

GEOIP matches against an IP geolocation database, not a page’s language or domain suffix. The database may not be fully up to date, and the same domain can resolve to addresses in different regions. If the result is unexpected, check the actual resolved IP rather than relying on the site name.

Fallback Rule

FINAL

FINAL assigns a fallback action to connections not matched by earlier rules, for example FINAL,DIRECT. It is usually placed at the end; otherwise, later conditions may never take effect. When troubleshooting unexpected direct or proxy connections, check both the matching rule and the FINAL action.

Rule Actions

PROXY / DIRECT / REJECT

PROXY means use a proxy, DIRECT means connect directly, and REJECT means reject the connection. These uppercase terms are rule actions, distinct from the Proxy and Direct modes in Global Routing. Changing a rule action affects a connection only when the current mode uses the relevant rules.

Subscriptions and Configuration

Server entries store connection settings, subscriptions update those entries, and configuration files store rules and other settings. Importing one does not mean the other two are ready.

Connection Entries

Server / SERVER

A server entry stores the address, port, protocol, and authentication details, and usually appears in the SERVER section on Home. Selecting an entry and enabling the connection are separate actions; its name is just a label for identification. To enter details manually, start with Add Server. Get the required settings from your service provider.

Bulk Updates

Subscribe

Subscribe retrieves and updates a group of server entries using a subscription URL provided by your service provider. This subscription updates connection details; it is not an app purchase record. A full URL may contain access credentials, so hide sensitive information before sharing screenshots or logs.

Configuration Management

Config

A configuration file may include General settings, Rule, Host, and URL Rewrite sections; check the file itself for its contents. Config can refer to the screen or to the Global Routing mode that follows the configuration, depending on context. After importing a file, make sure it is selected; simply having it in the list does not make it active.

Domain Resolution

DNS

DNS resolves domain names to IP addresses and is one step in establishing most domain-based connections. DNS server reachability, caching, and resolution results can affect access and rules that depend on IP addresses. After changing DNS, test the same destination again. Not every access failure is caused by server latency.

Request Handling

URL Rewrite

URL Rewrite changes request URLs and other content based on match conditions; unlike a Rule, it does not choose the route for a connection. Whether it can handle a request also depends on whether the request is visible and the relevant settings are enabled. Broad changes may disrupt normal requests, so start by checking one reproducible destination.

Test Results

Latency

Latency is response time measured by a particular test method. It is not download speed and does not indicate long-term connection stability. Results from different test methods, destinations, and network conditions are not directly comparable. To assess real-world performance, also check authentication, DNS, destination access, and sustained transfers.

Installation and Platforms

Shadowrocket is available for iPhone, iPad, Mac, Windows, Android, and Linux. How to get the app, system permissions, and server information are separate matters.

System Permissions

VPN Configuration

The first time you connect, your iPhone or iPad may ask permission to add a VPN configuration. This authorization lets the app create a network tunnel; it is not a server subscription, and granting it does not confirm successful server authentication. If you decline, start the connection again and follow the system prompts. Before removing a system entry, confirm which app it belongs to.

Processor Architecture

Apple Silicon / Intel

Mac installers are available for Apple Silicon and Intel. Check your chip or processor in About This Mac first. If you see a message that the developer cannot be verified when opening the app for the first time, verify the source, then choose Open Anyway in Privacy & Security. For other warnings, follow the installation approval instructions rather than repeatedly trying a different architecture.

Purchase History

Purchased Items

Purchased Items lets you find an app in the App Store purchase history for the Apple ID used to buy it. Use it when switching devices or downloading the app again after purchase. If the app is missing, first check the account and storefront used for the purchase instead of buying it again. Check the App Store listing for iPhone and iPad system requirements.

How to Get the App

Two Ways to Get the App

The iPhone and iPad version is a one-time $2.99 purchase on the App Store. The Mac, Windows, Android, and Linux versions are free. For the App Store version, confirm the developer is Shadow Launch Technology Limited and the app ID is 932747118. Get the other versions from the all-platform downloads page, which serves installers from /dl/shadowrocket/. Shadowrocket is a closed-source commercial app; purchase history and server information from your service provider are managed separately.

Still have a specific question? Browse the Frequently Asked Questions, or return to the top of the glossary.