Official Manual · Glossary

Shadowrocket Glossary
Interface, Protocols & Rule Keywords

Check which screen a term appears on before reading its definition. Config can mean the configuration file manager or a Global Routing mode; PROXY in a rule is not the same as the Proxy control in the interface.

Use this page as a reference while reviewing Shadowrocket settings and configurations. Menu locations may vary by platform; interface terms remain in English. Import instructions assume you already have your own subscription or server details.

  • 5 categories
  • 30 glossary entries
  • Interface terms shown in English

Interface & Controls

These terms show where to manage connections, how they are handled, or how to check results. Distinguish between a saved setting, an active connection, and a successful request to its destination.

Interface & Controls / 01

Home

Home is where you view the server list, current selection, and connection toggle. A listed entry only means its details are saved; it does not confirm that the server is reachable. Before connecting for the first time, check the selected entry, start the connection, and verify the result with an actual request.

Interface & Controls / 02

Global Routing

Global Routing determines how connections are handled overall: Config applies configuration rules, Proxy routes traffic through a proxy, and Direct connects directly. If a rule does not seem to work, first check that a different mode is not selected.

Interface & Controls / 03

Config

Config can mean the configuration file manager or the Global Routing mode that applies configuration rules. A configuration file may contain sections such as General and Rule; a server subscription is primarily used to manage server entries. After importing a server list, check which configuration is selected.

Interface & Controls / 04

On Demand

On Demand triggers connection behavior when preset conditions are met. Set it up after confirming that a manual connection works. It does not refresh Subscribe content or fill in missing server details. If a connection starts automatically, check the On Demand conditions as well as the toggle on Home.

Interface & Controls / 05

Connectivity Test

Connectivity Test checks connectivity using the current test method and destination. Latency is usually shown in milliseconds. Lower latency does not necessarily mean faster downloads, and a timeout may be caused by the test destination or network conditions. Keep test conditions consistent when comparing results, then verify with a request to the actual destination.

Interface & Controls / 06

DNS

DNS resolves domain names to IP addresses, an important step before a connection can be established. Successful resolution does not guarantee that routing or the server connection will work, and a lookup failure does not by itself mean a subscription has expired. Check DNS resolution, rule matching, and connection results separately; avoid changing several settings at once.

Interface & Controls / 07

URL Rewrite

URL Rewrite handles request URLs that match specified conditions. It operates at a different level from Rule, which determines how a connection is routed. Its scope depends on the request type and related settings; it cannot access the content of every request. Define the target URL and match scope before configuring it. It is not a general-purpose page content filter.

Protocols

The protocol determines how the client and server exchange data. Choose the type that matches the details you have; changing only the protocol name while keeping parameters from another type usually will not produce a valid configuration.

Protocols / 08

Shadowsocks

Shadowsocks is a proxy protocol. Common required details include the server address, port, password, and encryption method. The encryption method must match the server; a matching password alone is not enough. If your server details include other parameters, retain them rather than copying only the address.

Protocols / 09

VMess

VMess is an authenticated proxy protocol, and the user ID is one of its connection parameters. Check the transport, path, Host, TLS, and other details against the actual configuration; not every entry uses the same combination. An inaccurate device clock can also affect authentication, so check the system time when troubleshooting.

Protocols / 10

VLESS

VLESS is a proxy protocol. Treat identity parameters separately from transport and security settings: a correct user ID does not mean the TLS, server name, or transport path is correct. When entering details manually, follow the complete information you already have rather than reusing a field combination from another protocol.

Protocols / 11

Trojan

Trojan is commonly used with TLS. The password is used for authentication, while the server name and certificate validation affect whether a secure connection can be established. The connection address and the domain on the certificate may serve different purposes. For certificate errors, check the domain, system time, and server configuration instead of weakening validation.

Protocols / 12

Hysteria2

Hysteria2 is a QUIC-based proxy protocol that relies on network support for the required UDP traffic. The address, port, authentication details, and TLS settings must match the server. If results change on a different network, check how that network handles UDP before concluding that the entry is misconfigured.

Protocols / 13

WireGuard

WireGuard uses public and private keys to create an encrypted tunnel. Its configuration includes a local key, peer public key, tunnel address, and peer endpoint. Allowed IP ranges determine which traffic enters the tunnel; they are not just descriptive notes. The private key is sensitive, so remove it before sharing a configuration or troubleshooting details.

Protocols / 14

HTTP / SOCKS5

HTTP and SOCKS5 are different proxy protocols; the same server address and port do not make them interchangeable. Check your server details to see whether a username, password, or additional transport security settings are required. The protocol name alone does not guarantee that all traffic is encrypted.

Rule Keywords & Policies

Read the match condition first, then the action at the end. Rules are generally processed in order. A connection matched earlier is not automatically reconsidered just because a more specific rule appears later.

Rule Keywords & Policies / 15

Rule

A rule combines a match condition with an action to specify how particular connections are handled. For example, a matching domain can be sent to PROXY, DIRECT, or REJECT. When troubleshooting, check both the rule order and Global Routing; seeing a domain in the file does not prove that the rule will apply.

Rule Keywords & Policies / 16

DOMAIN

DOMAIN matches an exact domain, making it useful for handling a specific hostname on its own. DOMAIN,example.com,DIRECT does not also cover www.example.com. Enter the domain itself, without the URL scheme or page path.

Rule Keywords & Policies / 17

DOMAIN-SUFFIX

DOMAIN-SUFFIX matches a domain suffix and can cover the specified domain and its subdomains. For example, DOMAIN-SUFFIX,example.com,PROXY sends matching connections in that domain range through a proxy. It matches domain boundaries; it does not search for a string anywhere in a URL.

Rule Keywords & Policies / 18

GEOIP

GEOIP matches a destination IP address against an IP geolocation database. Database location does not indicate a page's language, domain suffix, or where the site's operator is based. Results may also change as the database is updated. When combining GEOIP with domain rules, consider rule order and the actual destination IP after resolution.

Rule Keywords & Policies / 19

IP-CIDR / IP-CIDR6

IP-CIDR matches IPv4 ranges, and IP-CIDR6 matches IPv6 ranges. The prefix length after the slash determines the range. The example IP-CIDR,192.168.0.0/16,DIRECT sends the specified local address range directly. Do not assume an IPv6 connection will match if only an IPv4 condition is configured.

Rule Keywords & Policies / 20

FINAL

FINAL handles connections that have not matched an earlier rule and is usually placed at the end of the Rule section as a fallback. For example, FINAL,DIRECT sends remaining connections directly. If it appears earlier, later rules may never be checked, so review the order of the entire section after making changes.

Rule Keywords & Policies / 21

PROXY / DIRECT

PROXY sends matching connections through a proxy; DIRECT connects to the destination directly. These uppercase policy identifiers are distinct from Proxy and Direct in Global Routing: the former apply to individual rules, while the latter set the overall routing mode. DIRECT does not mean the app has stopped running.

Rule Keywords & Policies / 22

REJECT

REJECT blocks connections that match the rule; it does not inspect page content. If a domain serves several functions, an overly broad condition may also break sign-ins, images, or other normal requests. Test the intended behavior after adding a rule, and narrow the condition or revert the change if it blocks too much.

Continue to the subscriptions and server management guide →

Subscriptions & Server Fields

Importing writes data to the client; it does not guarantee that all fields are present or that a server is usable. The steps below assume you already have the relevant information. Links, QR codes, and configuration files may contain authentication credentials.

Subscriptions & Server Fields / 23

Subscribe

Subscribe imports and maintains a server list using a link you already have. A subscription link is not an ordinary web address. Updates may add, remove, or change entries managed remotely, so changes to the local list do not necessarily indicate an app error. Parameters such as tokens in the link may grant access; do not include them in public screenshots or troubleshooting logs.

Subscriptions & Server Fields / 24

Add Server

Add Server is where you enter server details manually. First select the protocol that matches the information you have. Required fields can change with the protocol, so entering only an address is not enough. Check the port, authentication, and transport settings, then add a note to help identify the entry.

Subscriptions & Server Fields / 25

Server address and port

The address identifies the destination and can be a domain name or IP address; the port identifies the service at that destination. A display name is only a label and cannot replace the actual address. Do not paste a webpage URL into the address field. When entering details manually, check for extra spaces, full-width characters, or an accidentally copied path.

Subscriptions & Server Fields / 26

Authentication and TLS fields

A password, username, or user ID is used for authentication. TLS and server name settings are used for secure transport and server identity verification. They serve different purposes, so one cannot replace the other. Check each field when troubleshooting; disabling certificate validation should not be used to hide a mismatched address or server name.

Subscriptions & Server Fields / 27

Scan QR Code and clipboard import

Scan QR Code reads configuration data from a QR code; clipboard import reads copied share content. The difference is only how the data is provided. A QR code or share link may represent a single server or other configuration data, so check what it contains first. Verify the imported details, and avoid leaving credentials on a shared device.

Getting the App

Shadowrocket is available for iPhone, iPad, Mac, Windows, Android, and Linux. Get the iPhone / iPad version from the App Store. Mac downloads are available for Apple Silicon and Intel; desktop and Android installers are on this site's download page under /dl/.

Getting the App / 28

App Store and app ID

For the iPhone / iPad app, verify the developer name Shadow Launch Technology Limited, the official icon, and app ID 932747118 in the App Store. A similar app name is no substitute for checking all three. Check the App Store listing for system requirements. The app ID identifies the product; it is not a record of purchases on your account.

Getting the App / 29

Purchased Items

Purchased Items refers to the purchase history for an App Store account and can help you find an app you've already obtained when changing or restoring a device. Use the original purchasing account and check availability in the current storefront. Redownloading the app and restoring server details are separate tasks, so keep your own configuration safe.

Getting the App / 30

App license and server access

The iPhone / iPad app costs $2.99 as a one-time App Store purchase; the Mac / Windows / Android / Linux versions are free. A one-time app purchase is not a server plan: getting the app does not provide a server or subscription. This site does not provide, sell, or recommend servers or subscriptions; it only explains how to import and manage information you already have.