These system steps apply to iPhone and iPad: when iOS prompts you as Shadowrocket starts a connection, tap Allow to create the VPN configuration needed to handle traffic. If you deny the request, try connecting again; if you remove the configuration, Shadowrocket can create it again. Shadowrocket is also available for Mac (Apple silicon and Intel), Windows, Android, and Linux, each with its own authorization process. Don’t assume the system menus described here apply to other platforms. When troubleshooting, distinguish the system VPN configuration from in-app Config and subscriptions; there’s no need to erase all your data to fix a permissions issue.
1. Understand the Difference Between the System VPN and In-App Config
When you first start a connection in Shadowrocket, the app asks iOS to add a VPN configuration. This registers the configuration the app needs to establish a system network tunnel. It does not change your existing subscription or install its content as a device management profile. Once you allow the configuration, the app can start a tunnel using it. Access to a particular website still depends on the selected server, your network, and your rules.
People often call anything labeled “configuration” a “profile,” but these items have different locations and purposes. In particular, in-app Config is not the VPN entry in iOS Settings, and editing rules does not renew system VPN authorization.
| Item | Where to find it | What it does |
|---|---|---|
| System VPN configuration | System Settings → General → VPN & Device Management → VPN | Registers a VPN connection managed by Shadowrocket so the system can start or stop the tunnel. |
| In-app configuration | Shadowrocket → Config | Stores rules, policy references, and related configuration that determine how traffic is handled. |
| Servers and subscriptions | Shadowrocket → Home | Stores server details needed to connect and subscription content obtained from your provider. |
| Device management profile | System Settings → General → VPN & Device Management | May be used for organization management, certificates, or network settings. It is not a file you need to download separately for a standard first connection in Shadowrocket. |
Menu names vary with the system language and version. In Chinese, look under “Settings → General → VPN & Device Management → VPN.” Some system versions also offer a more direct VPN entry. Identify an item by the app it belongs to; don’t delete something just because “VPN” appears in its name.
2. Complete Authorization When the Prompt Appears
Before authorizing, make sure the request comes from Shadowrocket, which you opened, rather than a pop-up on a website. On an English-language system, the request typically includes Would Like to Add VPN Configurations and explains that VPN activity may be filtered or monitored. This is the system’s request for permission to handle network traffic; it does not mean the system has checked your provider or connection details.
-
Verify the source
Open Shadowrocket → Home and check the server entries already listed. Make sure the connection details came from your own provider. Don’t install a device management profile based on instructions from an unfamiliar website.
-
Start a connection
On Home, select the server you want to use, then turn on the connection switch at the top. If a system VPN configuration needs to be created, iOS will start the authorization flow the first time you connect.
-
Allow the configuration
Check that the request names Shadowrocket, then tap Allow. If prompted, authenticate using your device’s required method. You don’t need to enter your provider’s subscription password.
-
Check the VPN entry
Go to System Settings → General → VPN & Device Management → VPN. Confirm that a Shadowrocket configuration appears, then return to the app and check the connection status.
-
Test access
Open a website you know is available, then check the connection status on Home. Keep these results separate: authorization granted, tunnel connected, and website accessible. This makes it easier to identify the next issue.
If a valid Shadowrocket VPN configuration is already listed, you usually won’t be asked to add it again every time you connect. Not seeing the prompt again is normal; there’s no need to repeatedly delete the configuration just to make it appear.
3. How Traffic Flows Through the System VPN After You Tap Allow
The system VPN entry provides a tunnel; it doesn’t mean every request must go through a remote proxy server. After the app receives traffic, it handles it according to the current Global Routing mode and active configuration. Authorization and routing policies are separate layers, so changing rules cannot make up for incomplete system authorization.
- Proxy: Routes traffic through the proxy by default. The selected server details must still be valid, and your network must be able to reach the server.
- Direct: Routes traffic directly by default. A connected VPN status doesn’t mean the current request is being forwarded through a remote server.
- Config: Handles traffic according to the active configuration. Rules are matched from top to bottom;
FINALtypically handles traffic that didn’t match an earlier rule. - Scene: Applies routing for a selected scene. Its behavior depends on the scene configuration; it is not a switch for restoring system VPN authorization.
For example, in Config mode, DOMAIN-SUFFIX,example.com,DIRECT sends requests matching that domain suffix through DIRECT. The system VPN entry may still show as connected even when those requests don’t go through a remote proxy. This example illustrates the difference between routing policy and tunnel status; don’t use it to replace your existing configuration.
Bottom line: Verify authorization first, then check the traffic route
If the system lists a Shadowrocket entry and it can connect, leave it in place and check Global Routing and the active configuration. Don’t assume a website failing to load means “VPN permission wasn’t granted properly.”
4. Recover After Tapping Don’t Allow or Removing the Configuration
Tapping Don’t Allow blocks that configuration request; it doesn’t remove servers from Home or rules from Config. To recover, trigger the connection request again instead of uninstalling the app. If you manually deleted the system VPN configuration, first let the app try to create it again.
-
Stop the connection
Return to Shadowrocket → Home and turn off the connection switch. If the app is still connecting, wait for the current operation to finish before continuing.
-
Try again
Turn the connection switch at the top of Home on again. If the system needs to add a configuration, verify the app name, tap Allow, and complete any required device authentication.
-
Check for restrictions
If no prompt appears and the configuration still can’t be created, check the system VPN list and whether the device is managed by an organization. Managed devices may restrict adding VPN configurations; ask your device administrator about the applicable policy.
-
Verify again
Confirm that the Shadowrocket entry is back in the system list, then return to Home and try connecting again. If the app’s status hasn’t updated, quit and reopen it normally, then check once more.
Before deleting anything, check what it is
Only remove a VPN entry you’ve confirmed belongs to Shadowrocket. Don’t delete organization management or certificate profiles if you don’t know what they’re for. Removing a system VPN entry usually doesn’t erase app data, but uninstalling the app may affect local configuration. First confirm you have a backup or can retrieve the information again.
Don’t start by choosing Reset Network Settings. It affects more than one app’s VPN configuration and may require you to set up other network details again. Consider it only if the issue extends to the system network and you understand the impact, following the system’s supported process.
5. If You Still Can’t Connect, Identify the Point of Failure
“System permission granted,” “tunnel established,” and “server available” are different conclusions. Recording the exact error is more useful than simply saying “it won’t connect.” System alerts and app messages may use different languages; keep the original wording rather than attributing every connection failure to denied permission.
Error: VPN Connection
Cause and fix: This may be the title of a system connection error. The title alone can’t tell you whether the problem is authorization, tunnel startup, or connection details. Record the full message below it, check whether the system VPN entry exists, then check your current network and the server details on Home.
| What you see | Check first | Next step |
|---|---|---|
| No entry appears after you deny the request | The configuration hasn’t been created | On Home, turn the connection switch off and on again, then respond to the system authorization request. |
| The entry exists, but the connection stops immediately | Tunnel startup, system restrictions, or another active VPN | Temporarily stop other active VPN connections, note any message, then start Shadowrocket by itself. |
| It says connected, but websites won’t load | Server, DNS, routing, or network reachability | Check Global Routing and the active Config. Verify the protocol, address, port, and authentication fields provided by your service provider. |
| The connection comes back after you turn it off | On Demand conditions | Check Shadowrocket → Settings → On Demand. Temporarily disable the relevant On Demand rules while troubleshooting, then test again manually. |
Use the port supplied by your provider; don’t change it to 443 just because the protocol name looks familiar. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and WireGuard use different parameter formats. If a protocol or authentication field is incorrect, the remote connection may still fail even when the system successfully adds the VPN configuration.
Reauthorizing also won’t update subscription content. If the subscription has an outdated address or incorrect details, get valid information from your provider and update the subscription in the app. Don’t delete every configuration just because one server connection fails.
6. Common Questions About VPN Access and System VPNs
Can my provider see everything after I tap Allow?
You can’t determine that from this system prompt alone. The VPN configuration lets the app handle network traffic routed through the tunnel; the actual outbound path depends on your routing policy. What a remote server can access also depends on the connection method, DNS routing, and application-level encryption. Check your configuration and your provider’s policies; system authorization isn’t a privacy guarantee.
Do I need to tap Allow again every time I switch servers?
Usually not. Stop the connection on Home, select an existing server, and connect again. Switching servers is different from creating a new system VPN configuration as long as the existing configuration is still valid. You only need to respond to authorization if the system asks to add a configuration again.
Why does it reconnect shortly after I turn off the switch?
Go to Settings → On Demand and check whether automatic connection conditions are set. Temporarily disable the relevant conditions while troubleshooting, then connect manually from Home. If your device is managed by an organization, check for a management policy too. Repeatedly deleting the VPN entry won’t disable automatic connection conditions.
Do I need to install a certificate to add a VPN configuration?
System VPN authorization for a standard connection is separate from certificate installation. Don’t install an extra root certificate just because the add-configuration prompt appeared. This article doesn’t cover HTTPS decryption. If you have a separate need for a certificate, first confirm its purpose, trust scope, and specific configuration requirements.
Can I reuse the system VPN entry after switching devices?
Open Shadowrocket on the new device, check the imported data, and start a connection. Complete authorization based on the prompt shown on that device. The VPN status on your old device doesn’t mean the new device is already authorized. Restore server and configuration details from a backup method you’ve confirmed in advance.