Tutorial for ShadowRocket app

This page shows you how to add your Hiddify subscription to Shadowrocket on iPhone and iPad, and how to use its most useful settings. Shadowrocket is a paid app that works with Xray-based configs.

Recommended: Hiddify App

The easiest app for a Hiddify server is the free Hiddify App. It is on the App Store. See How to install Hiddify App.

Before you start

• Buy and install Shadowrocket from the App Store.
• Have your user page link ready. This is the link your server admin sent you. It opens your personal Hiddify page.

A subscription link is one link that holds all your connection settings (configs). Shadowrocket can refresh it later to get new settings from the server.

Add your subscription: the quick way

1. On your iPhone, open your user page link in Safari.
2. Tap the large round button in the middle of the page. A window called Configure your VPN opens.
3. Under Choose one of the apps below, tap Shadowrocket. If you don't see it, tap View More. You can also download the app from here.
4. Tap Import To App. Shadowrocket opens and adds your subscription.

If that doesn't work, add the link by hand as shown below.

Lite and Normal configs no longer exist

Older versions of the user page offered two kinds of configs in an iOS tab: Lite (only blocked sites go through the VPN) and Normal (all traffic goes through the VPN). The current user page has no iOS tab and no Lite/Normal choice. If you want local sites to open without the VPN, ask your admin; this is set on the server. If your admin turned on WARP, local sites can open through WARP.

Add your subscription by hand

First get the link:

1. On your user page, open the menu and tap All Configs.
2. In the Subscription Links section, find Subscription link and tap Get Link. A window with a QR code and a Copy Link button opens.

Then add it to Shadowrocket in one of two ways.

Copy and paste the link

1. Tap Copy Link.

2. Open Shadowrocket and tap the + button in the top-right corner.

   

1. Set Type to Subscribe.
2. Paste the link into the URL field.

3. Tap Save.

   

All your configs now load in the app.

Scan the QR code

1. On the Shadowrocket home screen, tap the scanner button.

   

2. Scan the QR code shown on your user page. Your configs are added to the app.

Test the configs

On the home screen, tap Connectivity Test. The app tests each config.

For more realistic results:

1. Tap Settings in the bottom menu.
2. Set Test Method to Connect.
3. Run the test again.

Update your subscription

Tap the update icon above the configs of a subscription. The configs are updated with the latest settings from the server.

Subscription settings

Go to Settings and tap Subscribe near the bottom. Here you can set:

Update when the app opens

Turn on Update on Open.

Update automatically in the background

Turn on Auto Background Update. The app then refreshes your subscriptions at regular intervals.

Sort by ping

Turn on Sort by ping to list the configs by their test result, best first.

Prevent IP leaks

An IP leak means a website can see your real IP address even though the VPN is on.

1. Go to Settings, then UDP.
2. Turn on Disable STUN.

Fix missing sound in some apps

If some apps (for example Clubhouse) play no sound:

1. Go to Settings, then TCP.
2. Change the Fingerprint value.

Shortcuts

Go to Settings, then Shortcuts. Here you can set a voice command for an action, for example to start the VPN.

Keep the VPN on (On Demand)

Go to Settings, then On Demand.

Always On

When this is on, your VPN always stays on.

On Demand

When this is on and your connection drops, Shadowrocket blocks all internet traffic so your real IP address is not exposed.

Disconnect on Sleep

When this is on, the VPN disconnects when the phone goes to sleep.

Share your VPN with other devices

You can share your VPN with another device on the same network, for example a device that can't install a VPN app.

1. Go to Settings, then Proxy.
2. Tap Proxy Share.

3. Turn on Enable Share. The app shows an IP address and a port.

   

4. On the other device, open its network proxy settings and enter that IP address and port.

The other device now uses your VPN without installing anything.

Create a load balancer

A load balancer spreads your traffic over several configs, so one slow or blocked config doesn't stop you.

1. On the home screen, hold your finger on the screen and swipe down. A hidden menu opens.

   

2. Tap the + button.

   

3. Type any name.

4. Set Type to load-balance.
5. Under Policy, select the configs to use: the ones with the best ping, or all of them.
6. Leave Interval (time between tests) and Timeout (how long a config may fail and still count as working) at their default values, unless you know what you need.

7. Tap Save.

   

8. Tap the new load balancer, then tap Test. This tests it and connects through it.

   

When you turn Shadowrocket on or off, the load balancer turns on or off with it.

Fix sites or apps that don't open

If some sites or apps don't open, or Telegram GIFs don't load:

1. Go to Settings.
2. Open TCP.
3. Set TLS to Network.
4. Set Fingerprint to Safari15_5.
5. Set Max Read Length to 16384.
6. Go back to Home.
7. Set Global Routing to Proxy.