> For the complete documentation index, see [llms.txt](https://jollyproxy.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jollyproxy.gitbook.io/docs/proxy-configuration/proxy-tool-configuration-guide/shadowrocket.md).
# Shadowrocket
{% hint style="danger" icon="exclamation" %}
**Usage Notice:** All JollyProxy proxy products must be used in an overseas network environment. Please ensure that you have configured the corresponding overseas network environment yourself.
{% endhint %}
This article will explain how to configure a **Static Residential Proxy** using the **Shadowrocket** client to achieve a more stable and secure network access environment.
> **Tip**: Residential proxies are used in the same way as static residential proxies.
### 1. Add a Proxy Configuration
Open the Shadowrocket app and tap the **+** button in the upper-right corner to add a new configuration.
### 2. Configure the Proxy Information
1. Select the proxy protocol type: **HTTP** or **SOCKS**.
2. Fill in the proxy information obtained from [JollyProxy](https://www.jollyproxy.com/):
* **Address (Server)**: Proxy server address
* **Port**: Proxy service port number
* **Username**: Proxy account
* **Password**: Proxy password
3. Tap the proxy and select an overseas network node.
4. Tap **Done** or **Save** in the upper-right corner to save the configuration.
### 3. Enable and Connect the Proxy
1. Return to the Shadowrocket main interface (home page); the node list will display the proxy node you just added.
2. Set the global routing mode:
* Select **Proxy** mode.
* Turn on the switch at the top to enable the proxy.
3. Handle the permission prompt:
* On the first connection, the system will display a VPN configuration dialog.
* Tap **Allow** to authorize; otherwise, the proxy function cannot be used.
4. Node management:
* If there are multiple nodes, tap a node to set it as the default.
* Each connection will automatically use the default node.
* To switch nodes, set another node as the default.
### 4. Verify the Proxy Connection
1. Ensure that the Shadowrocket switch at the top is turned on (shown in green).
2. Open Safari or another browser and visit [ipinfo.io](https://ipinfo.io).
3. Confirm that the displayed IP address matches the residential proxy IP you configured.
### Notes
**Connectivity Test Explanation**:
* Some IP addresses may show **timeout** during connectivity tests.
* This is a normal phenomenon of Shadowrocket's detection mechanism and does not affect actual use.
* You can ignore the timeout prompt; the proxy function will still work normally.
**Node Switching**:
* Before switching nodes, disconnect the current connection first.
* Then start a connection with the new node.
* This avoids Shadowrocket cached data affecting connection stability.
> You have now successfully configured and enabled the proxy in Shadowrocket and can securely access network resources.
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://jollyproxy.gitbook.io/docs/proxy-configuration/proxy-tool-configuration-guide/shadowrocket.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
