> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catproxy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Shadowrocket (Proxy Manager)

> Learn how to configure catproxy.io proxies in Shadowrocket for system-wide proxying on your iOS or macOS device.

Shadowrocket is a powerful, rule-based proxy utility client for iOS and macOS. It allows you to route all your device's traffic, or just specific apps, through a proxy.

### Step 1: Add a New Proxy

1. Open the Shadowrocket app.
2. On the main "Home" tab, tap **Add Server**.

<Frame caption="Tap 'Add Server' on the main screen to begin.">
  <img src="https://mintcdn.com/catproxyio/bJlShWsnZPTBNK0J/images/hero-dark.png?fit=max&auto=format&n=bJlShWsnZPTBNK0J&q=85&s=8d08bffd839b18ce77cdf594b95d2ae9" width="2064" height="1104" data-path="images/hero-dark.png" />
</Frame>

### Step 2: Select Proxy Type

In the "Add Server" screen, you need to specify the connection type.

1. Tap on **Type**.
2. Scroll through the list and select **HTTP**.

<Frame caption="Choose HTTP as the server type.">
  <img src="https://mintcdn.com/catproxyio/bJlShWsnZPTBNK0J/images/hero-dark.png?fit=max&auto=format&n=bJlShWsnZPTBNK0J&q=85&s=8d08bffd839b18ce77cdf594b95d2ae9" width="2064" height="1104" data-path="images/hero-dark.png" />
</Frame>

### Step 3: Enter Server and Authentication Details

Now, fill in all the necessary credentials for your catproxy.io proxy.

1. **Host:** Enter `proxy.catproxy.net`.
2. **Port:** Enter your proxy's specific port number (e.g., `5555`).
3. **User:** Enter your proxy's `Username`.
4. **Password:** Enter your proxy's `Password`.
5. **Remark (Optional):** Give your proxy a descriptive name, like `Catproxy US Residential`.

<Frame caption="Fill in the host, port, user, and password fields with your credentials.">
  <img src="https://mintcdn.com/catproxyio/bJlShWsnZPTBNK0J/images/hero-dark.png?fit=max&auto=format&n=bJlShWsnZPTBNK0J&q=85&s=8d08bffd839b18ce77cdf594b95d2ae9" width="2064" height="1104" data-path="images/hero-dark.png" />
</Frame>

<Info>
  **Geo-Targeting Tip:** To target a specific country, add the `-country-[code]` parameter directly to your username in the `User` field. For example: `PROXY_USERNAME-country-de`.
</Info>

6. Tap **"Done"** in the top right corner to save the server.

### Step 4: Connect to the Proxy

You're now ready to start routing your traffic.

1. Back on the "Home" tab, you will see your newly added proxy profile.
2. Tap the **toggle switch** at the top of the screen (next to "Not Connected").
3. If it's your first time, iOS/macOS will ask for permission to add a VPN configuration. Tap **Allow** and confirm with your device's passcode or Touch/Face ID.

The status will change to "Connected", and the toggle switch will turn green. All your device's traffic is now being routed through your catproxy.io proxy.

<Frame caption="Tap the main toggle switch to activate the proxy connection.">
  <img src="https://mintcdn.com/catproxyio/bJlShWsnZPTBNK0J/images/hero-dark.png?fit=max&auto=format&n=bJlShWsnZPTBNK0J&q=85&s=8d08bffd839b18ce77cdf594b95d2ae9" width="2064" height="1104" data-path="images/hero-dark.png" />
</Frame>

To verify, open a browser and visit an IP checker website like [IPinfo.io](https://ipinfo.io/what-is-my-ip). You should see the IP and location of your proxy. To disconnect, simply tap the toggle switch again.