> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/integrations/proxy-integrations/shadowrocket.md).

# Shadowrocket

[**Shadowrocket**](https://apps.apple.com/us/app/shadowrocket/id932747118) is a freeware encryption protocol app for secure and anonymous online browsing. 

Follow the instructions for [**iOS**](#ios) and [**Android**](#android) below to use the following Oxylabs proxies with Shadowrocket:

* Residential & Mobile Proxies
* Datacenter Proxies
* Dedicated Datacenter Proxies (Enterprise)
* Dedicated Datacenter Proxies (Self-service)
* ISP Proxies
* Dedicated ISP Proxies

## iOS

{% embed url="<https://youtu.be/6U69IWbTWmk>" %}

### **Step 1**

[**Download**](https://apps.apple.com/us/app/shadowrocket/id932747118) and open the Shadowrocket app.

### **Step 2**

Click **Add Server**.

![](/files/m7CqBFDHCaTqTfx5sihs)

### **Step 3**

In the following window, click on **Type**.

![](/files/DbeutgWeBc33JRiVZEXA)

### **Step 4**

Choose `HTTP`, `HTTPS`, or `SOCKS5` and go back to the previous screen.

<div data-full-width="true"><figure><img src="/files/LwcDzvC4bNEHZuhJRKlc" alt="" width="563"><figcaption></figcaption></figure></div>

### **Step 5**

Enter the details for your chosen proxy type:

* [Residential & Mobile Proxies](#residential-and-mobile-proxies)
* [Datacenter Proxies](#datacenter-proxies)
* [Dedicated Datacenter Proxies (Enterprise)](#dedicated-datacenter-proxies-enterprise)
* [Dedicated Datacenter Proxies (Self-service)](#dedicated-datacenter-proxies-self-service)
* [ISP Proxies](#isp-proxies)
* [Dedicated ISP Proxies](#dedicated-isp-proxies)

#### Residential & Mobile Proxies

**Host:** `pr.oxylabs.io`

**Port:** `7777`

**User:** `customer-username`

**Password:** `password`

{% hint style="warning" %}
Make sure to use `customer-` prefix with your username.
{% endhint %}

![](/files/D0iNLQawr22i5pLI3rDi)

You may also use **additional parameters** with residential and mobile proxies to set the geo-location (country, state, city, and etc.) and control sessions. Check out the [Residential Proxies documentation](/products/proxies/residential-proxies.md) to learn more. The table below provides an overview of available parameters and their example values.

<table><thead><tr><th width="167">Proxy parameter</th><th width="498">Example</th></tr></thead><tbody><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/UPg2AOzHh8eTwZf0ZfxE#country-specific-entry-nodes">Country entry node</a></td><td><p><strong>Host:</strong> <code>us-pr.oxylabs.io</code></p><p><strong>Port:</strong> <code>10000</code></p></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/UPg2AOzHh8eTwZf0ZfxE">Country</a></td><td><strong>User:</strong> <code>customer-username-cc-US</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/e93RpcKghZnkSC6ATFPI">State</a></td><td><strong>User:</strong> <code>customer-username-st-US_texas</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/SFkPGxvpqV8rBtKfCMo8">City</a></td><td><strong>User:</strong> <code>customer-username-city-paris</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/GZqlA7kjGCjYeRz47eX0">Continent</a></td><td><strong>User:</strong> <code>customer-username-cn-NA</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/ReB4Ej6De1X1uPh5QrRB">ZIP/Postal code</a></td><td><strong>User:</strong> <code>customer-username-cc-US-postalcode-90210</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/ATRXHGvVOBqV6HM3m3j4">ASN Targeting</a></td><td><strong>User:</strong> <code>customer-username-ASN-21928</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/MARGpYxVNKNfIa0J3Khs">Session</a> (up to 1440 minutes)</td><td><strong>User:</strong> <code>customer-username-sessid-qwerty123-sesstime-1440</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/R0QUr8pQBszqd43iT44n">Sticky session</a></td><td><p><strong>Host:</strong> <code>us-pr.oxylabs.io</code></p><p><strong>Port:</strong> <code>10001</code></p></td></tr></tbody></table>

Afterward, go back to the previous screen by pressing an arrow in the top-left corner for the next step.

#### Datacenter Proxies

**Host:** `dc.oxylabs.io`

**Port:** `8001`&#x20;

**User:** `user-USERNAME`

**Password:** `PASSWORD`

{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}

<figure><img src="/files/6Mfkn3KRW8GKfgmRbwsu" alt="" width="356"><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Pay-per-IP subscription" %}
The port is the sequential number assigned to an IP address from the [proxy list](/products/proxies/datacenter-proxies/proxy-list.md). Thus, port `8001` uses the first IP address from your list. You may also enable [proxy IP rotation](/products/proxies/datacenter-proxies/ip-control.md) by setting the port to `8000`.

Furthermore, you can specify the [geo-location](/products/proxies/datacenter-proxies/select-country.md), for example, the US, by setting the **Proxy username** to `user-USERNAME-country-US`.
{% endtab %}

{% tab title="Pay-per-traffic subscription" %}
The port `8001` picks a random IP address but stays consistent during a session. Alternatively, you can [rotate proxy IPs](/products/proxies/datacenter-proxies/ip-control.md) with each request by using port `8000`.

If you want to use a specific [geo-location](/products/proxies/datacenter-proxies/select-country.md), for example, the US, set the Proxy username to `user-USERNAME-country-US`.
{% endtab %}
{% endtabs %}

Afterward, go back to the previous screen by pressing an arrow in the top-left corner for the next step.

#### Dedicated Datacenter Proxies (Enterprise)

**Host:** `1.2.3.4` (IP address from your [proxy list](/products/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md))

**Port:** `60000` (HTTP), `1180` (SOCKS5)

**User:** `USERNAME`

**Password:** `PASSWORD`

<figure><img src="/files/tX0KaCGfXS4Dve7egtnW" alt="" width="353"><figcaption></figcaption></figure>

For Enterprise Dedicated Datacenter Proxies (purchased via sales), you’ll have to choose an IP address from the acquired [proxy list](/products/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md).

Afterward, go back to the previous screen by pressing an arrow in the top-left corner for the next step.

#### Dedicated Datacenter Proxies (Self-service)

**Host:** `ddc.oxylabs.io`

**Port:** `8001`

**User:** `user-USERNAME`

**Password:** `PASSWORD`

{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}

<figure><img src="/files/yyr6MfDDSOdYmgemWChZ" alt="" width="353"><figcaption></figcaption></figure>

For Self-Service Dedicated Datacenter Proxies (purchased via Oxylabs dashboard), the port indicates the sequential number of an IP address from the acquired [proxy list](/products/proxies/datacenter-proxies/proxy-list.md). If you want to get a different IP with each request, change the **Port** to `8000` to enable [proxy rotation](/products/proxies/dedicated-datacenter-proxies/self-service/proxy-rotation.md).

Afterward, go back to the previous screen by pressing an arrow in the top-left corner for the next step.

#### ISP Proxies

**Host:** `isp.oxylabs.io`

**Port:** `8001`

**User:** `user-USERNAME`

**Password:** `PASSWORD`

{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}

<figure><img src="/files/CDQ2ccjCROxgmFxjJqfQ" alt="" width="356"><figcaption></figcaption></figure>

ISP Proxies assign each port to a specific IP address and location. Port `8001` always uses the first IP from your [proxy list](/products/proxies/isp-proxies/proxy-list.md). Use port `8000` to enable [proxy rotation](/products/proxies/isp-proxies/proxy-rotation.md).

To get rotating IPs from a specific country's proxy pool, set the username using this format: `user-USERNAME-country-XX`, where `XX` is the country code (e.g., `US` for United States).

Afterward, go back to the previous screen by pressing an arrow in the top-left corner for the next step.

#### Dedicated ISP Proxies

**Host:** `disp.oxylabs.io`

**Port:** `8001`

**User:** `user-USERNAME`

**Password:** `PASSWORD`

{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}

<figure><img src="/files/YlnXMOJFygkdElQSZ2U2" alt=""><figcaption></figcaption></figure>

You will need to choose the port assigned to an IP address from the purchased [proxy list](/products/proxies/dedicated-isp-proxies/self-service/proxy-list.md), which you can find on the Oxylabs dashboard. The `8001` port will pick the first IP address from your list for all requests. Use port `8000` for automatic [proxy IP rotation](/products/proxies/dedicated-isp-proxies/self-service/proxy-rotation.md).

Afterward, go back to the previous screen by pressing an arrow in the top-left corner for the next step.

### **Step 6**

Turn on the proxy by activating a toggle under **Not Connected**.

![](/files/XxT7wKKaJNNh2CBTLkzz)

### **Step 7**

If that is your first time using Shadowrocket, you will get an iOS prompt to add Shadowrocket to VPN configurations. Click **Allow**. You will need to enter your iPhone passcode to confirm.

![](/files/WQ9knrSjwK3f7ibI4J8D)

### **Step 8**

That is it. A toggle is now active, and you can start using our proxies.

![](/files/RK5od27jKGXz6pO6yoGP)

### **Step 9**

You can test if the proxy is working by visiting [**ip.oxylabs.io**](https://ip.oxylabs.io/).

![](/files/9YqnE1mkgFKfNX9Rajj1)

Find the original Shadowrocket integration blog post [**here**](https://oxylabs.io/resources/integrations/shadowrocket).

## Android

### **Step 1**

[**Download**](https://play.google.com/store/search?q=shadowrocket\&c=apps) the app and install it.

### **Step 2**

Once set up, select (+) > **Type manually** > **Socks**.

<div data-full-width="false"><figure><img src="/files/cAZR5hJ91abe1h9HUY8j" alt=""><figcaption></figcaption></figure></div>

### **Step 3**

Specify the connection details an user credentials (created in the [Oxylabs dashboard](https://dashboard.oxylabs.io/en/)) for your chosen proxy type:

* [Residential & Mobile Proxies](#residential-and-mobile-proxies-1)
* [Datacenter Proxies](#datacenter-proxies-1)
* [Dedicated Datacenter Proxies (Enterprise)](#dedicated-datacenter-proxies-enterprise-1)
* [Dedicated Datacenter Proxies (Self-service)](#dedicated-datacenter-proxies-self-service-1)
* [ISP Proxies](#isp-proxies-1)
* [Dedicated ISP Proxies](#dedicated-isp-proxies-1)

#### Residential & Mobile Proxies

**Address:** `pr.oxylabs.io`

**Port:** `7777`

**User:** `customer-username`

**Password:** `password`

{% hint style="warning" %}
Make sure to use `customer-` prefix with your username.
{% endhint %}

<div data-full-width="true"><figure><img src="/files/2oVBqYqGmYiBMEiCre2v" alt=""><figcaption></figcaption></figure></div>

You may also use **additional parameters** with residential and mobile proxies to set the geo-location (country, state, city, and etc.) and control sessions. Check out the [Residential Proxies documentation](/products/proxies/residential-proxies.md) to learn more. The table below provides an overview of available parameters and their example values.

<table><thead><tr><th width="167">Proxy parameter</th><th width="498">Example</th></tr></thead><tbody><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/UPg2AOzHh8eTwZf0ZfxE#country-specific-entry-nodes">Country entry node</a></td><td><p><strong>Host:</strong> <code>us-pr.oxylabs.io</code></p><p><strong>Port:</strong> <code>10000</code></p></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/UPg2AOzHh8eTwZf0ZfxE">Country</a></td><td><strong>User:</strong> <code>customer-username-cc-US</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/e93RpcKghZnkSC6ATFPI">State</a></td><td><strong>User:</strong> <code>customer-username-st-US_texas</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/SFkPGxvpqV8rBtKfCMo8">City</a></td><td><strong>User:</strong> <code>customer-username-city-paris</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/GZqlA7kjGCjYeRz47eX0">Continent</a></td><td><strong>User:</strong> <code>customer-username-cn-NA</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/ReB4Ej6De1X1uPh5QrRB">ZIP/Postal code</a></td><td><strong>User:</strong> <code>customer-username-cc-US-postalcode-90210</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/ATRXHGvVOBqV6HM3m3j4">ASN Targeting</a></td><td><strong>User:</strong> <code>customer-username-ASN-21928</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/MARGpYxVNKNfIa0J3Khs">Session</a> (up to 1440 minutes)</td><td><strong>User:</strong> <code>customer-username-sessid-qwerty123-sesstime-1440</code></td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/R0QUr8pQBszqd43iT44n">Sticky session</a></td><td><p><strong>Host:</strong> <code>us-pr.oxylabs.io</code></p><p><strong>Port:</strong> <code>10001</code></p></td></tr></tbody></table>

#### Datacenter Proxies

**Address:** `dc.oxylabs.io`

**Port:** `8001`

**User:** `user-USERNAME`

**Password:** `PASSWORD`

{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}

<figure><img src="/files/hNB9oowAy34h8WZwNLhe" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Pay-per-IP subscription" %}
The port is the sequential number assigned to an IP address from the [proxy list](/products/proxies/datacenter-proxies/proxy-list.md). Thus, port `8001` uses the first IP address from your list. You may also enable [proxy IP rotation](/products/proxies/datacenter-proxies/ip-control.md) by setting the port to `8000`.

Furthermore, you can specify the [geo-location](/products/proxies/datacenter-proxies/select-country.md), for example, the US, by setting the **Proxy username** to `user-USERNAME-country-US`.
{% endtab %}

{% tab title="Pay-per-traffic subscription" %}
The port `8001` picks a random IP address but stays consistent during a session. Alternatively, you can [rotate proxy IPs](/products/proxies/datacenter-proxies/ip-control.md) with each request by using port `8000`.

If you want to use a specific [geo-location](/products/proxies/datacenter-proxies/select-country.md), for example, the US, set the Proxy username to `user-USERNAME-country-US`.
{% endtab %}
{% endtabs %}

#### Dedicated Datacenter Proxies (Enterprise)

**Address:** `1.2.3.4` (IP address from your [proxy list](/products/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md))

**Port:** `1180` (SOCKS5)

**User:** `USERNAME`

**Password:** `PASSWORD`

<figure><img src="/files/tkmDUk7PhaKcUFfkL2wQ" alt=""><figcaption></figcaption></figure>

For Enterprise Dedicated Datacenter Proxies (purchased via sales), you’ll have to choose an IP address from the acquired [proxy list](/products/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md).

#### Dedicated Datacenter Proxies (Self-service)

**Address:** `ddc.oxylabs.io`

**Port:** `8001`

**User:** `user-USERNAME`

**Password:** `PASSWORD`

{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}

<figure><img src="/files/IotRM3nAsItKNyyO0A8U" alt=""><figcaption></figcaption></figure>

For Self-Service Dedicated Datacenter Proxies (purchased via Oxylabs dashboard), the port indicates the sequential number of an IP address from the acquired [proxy list](/products/proxies/datacenter-proxies/proxy-list.md). If you want to get a different IP with each request, change the **Port** to `8000` to enable [proxy rotation](/products/proxies/dedicated-datacenter-proxies/self-service/proxy-rotation.md).

#### ISP Proxies

**Address:** `isp.oxylabs.io`

**Port:** `8001`

**User:** `user-USERNAME`

**Password:** `PASSWORD`

{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}

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

ISP Proxies assign each port to a specific IP address and location. Port `8001` always uses the first IP from your [proxy list](/products/proxies/isp-proxies/proxy-list.md). Use port `8000` to enable [proxy rotation](/products/proxies/isp-proxies/proxy-rotation.md).

To get rotating IPs from a specific country's proxy pool, set the username using this format: `user-USERNAME-country-XX`, where `XX` is the country code (e.g., `US` for United States).

#### Dedicated ISP Proxies

**Address:** `disp.oxylabs.io`&#x20;

**Port:** `8001`

**User:** `user-USERNAME`

**Password:** `PASSWORD`

{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}

<figure><img src="/files/5XVfcBPkojNl8pcQuWUh" alt="" width="254"><figcaption></figcaption></figure>

Choose the port assigned to an IP address from the purchased [proxy list](/products/proxies/dedicated-isp-proxies/self-service/proxy-list.md), found on the Oxylabs dashboard. The `8001` port will pick the first IP address from your list for all requests. Use port `8000` for automatic [proxy IP rotation](/products/proxies/dedicated-isp-proxies/self-service/proxy-rotation.md).

### **Step 4**

After confirming your proxy setup, select the **paper plane icon** to connect to a proxy. Make sure the connection is successful, and you see a confirmation showing latency (ms).

<figure><img src="/files/2jsfB27h3DiiKafcpEMP" alt="" width="563"><figcaption></figcaption></figure>

You are all set. All of your internet traffic is now rerouted through a proxy server.


---

# 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://developers.oxylabs.io/integrations/proxy-integrations/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.