> For the complete documentation index, see [llms.txt](https://docs.9proxy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.9proxy.com/integrations/gb-based-residential-proxies/mobile-devices/shadowrocket.md).

# Shadowrocket

**Shadowrocket** is a powerful app that lets you securely route traffic through a proxy connection. Follow this guide to integrate your **9Proxy Residential Proxy** with **Shadowrocket**.

## 1. Before You Begin

Make sure you’ve already:

* Created a 9Proxy sub-user
* Generated an active proxy session

Not sure how to do that? View the proxy setup guide [here](https://docs.9proxy.com/getting-started/residential-proxy-by-gb/proxy-generation).

## 2. Step-by-Step Setup

{% stepper %}
{% step %}

#### Install & Launch Shadowrocket

Download **Shadowrocket** from the App Store and open the app.
{% endstep %}

{% step %}

#### Add a New Proxy Server

Tap “**Add Server**” on the home screen.
{% endstep %}

{% step %}

#### Select Proxy Type

In the new window, tap “**Type**” and choose either HTTP or SOCKS5. Then go back to the previous screen.
{% endstep %}

{% step %}

#### Enter Proxy Details

Fill in your proxy credentials as follows:

<table><thead><tr><th width="200">Field</th><th>What to Enter</th></tr></thead><tbody><tr><td>Address</td><td>Your proxy IP (e.g., 38.180.149.107)</td></tr><tr><td>Port</td><td>Your proxy port (e.g., 17521)</td></tr><tr><td>User</td><td>Structured 9Proxy username (see below)</td></tr><tr><td>Password</td><td>Your 9Proxy  sub-account password</td></tr></tbody></table>

**Username Format**

{% code overflow="wrap" %}

```
<subaccount>-country-<country_code>-st-<state_code>-city-<city_code>-isp-<isp_code>-ssid-<session_id>-sst-<session_time>
```

{% endcode %}

{% hint style="info" %}
The username includes your proxy targeting settings like country, session ID, etc. For help creating your custom proxy username, refer to [this guide](https://docs.9proxy.com/getting-started/residential-proxy-by-gb/making-requests).
{% endhint %}

**Example Configuration:**

<figure><img src="/files/9c7484e304f0ecbe8efaf37fc0a80870a7f10387" alt=""><figcaption></figcaption></figure>

* **Proxy Host**: 38.180.149.107
* **Port**: 17521
* **Username**: useruser123-country-US-ssid-rhdN1907ma
* **Password**: X12345678
  {% endstep %}

{% step %}

#### Save & Activate the Proxy

Press the back arrow (top-left), then toggle the switch under "Not Connected" to activate your proxy.
{% endstep %}

{% step %}

#### Allow VPN Configuration

If prompted, tap “**Allow**” to let **Shadowrocket** add a VPN profile.

Enter your iPhone passcode to confirm.
{% endstep %}
{% endstepper %}

## 3. That’s It!

Your proxy is now active. To verify, visit: <https://ipinfo.io/what-is-my-ip>

Need help? Our support team is here for you anytime.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.9proxy.com/integrations/gb-based-residential-proxies/mobile-devices/shadowrocket.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.