# Working with Proxies

Proxies are one of the most important parts of using MVS Web. This guide explains why you need them, what types work best, where to get them, and how to set them up.

## Why You Need Proxies

When you connect to Telegram, your IP address is visible. If you perform many operations (registrations, checks, messages) from a single IP, Telegram will detect this as suspicious and may:

* Block your registrations
* Ban your accounts
* Restrict your API access

Proxies route your traffic through different IP addresses so each account appears to connect from a different location.

{% hint style="warning" %}
**Never run registration without proxies.** You will almost certainly get blocked. For checking and cleaning, proxies are also strongly recommended.
{% endhint %}

## Types of Proxies

### Mobile Proxies

* **What:** Route traffic through mobile carrier IP addresses
* **Best for:** Registration (highest success rates)
* **Cost:** Most expensive
* **Why they work:** Telegram trusts mobile IPs because many real users share them

### Residential Proxies

* **What:** Route traffic through home ISP connections
* **Best for:** Registration, checking, most operations
* **Cost:** Mid-range
* **Why they work:** Look like normal home internet connections

### Datacenter Proxies

* **What:** Route traffic through data center servers
* **Best for:** Checking, cleaning, parsing (low-risk operations)
* **Cost:** Cheapest
* **Limitations:** Higher ban rates for registration because Telegram knows these are not real users

{% hint style="info" %}
**For registration:** Use mobile or residential proxies. **For everything else:** Datacenter proxies work fine and are much cheaper.
{% endhint %}

## Where to Get Proxies

The **Partners** page in MVS Web has links to recommended proxy providers. You can also find providers on proxy review sites and forums.

When buying proxies, make sure:

* The provider supports **SOCKS5** protocol
* Proxies are in the **same country** as your SMS numbers (for registration)
* You get enough proxies for your thread count (1 proxy per 1-3 threads is a good ratio)

## How to Add Proxies to MVS Web

### Step 1: Go to the Proxies Page

Click **Proxies** in the sidebar (under Settings).

![Proxy Lists](/files/h5UTNK16zVE47m6gS4kg)

### Step 2: Create a New List

Click the **+ Add List** button in the top right corner.

### Step 3: Name Your List

Give it a descriptive name. Good examples:

* `ind` -- India proxies
* `za` -- South Africa proxies
* `froxy ZA` -- Froxy provider, South Africa
* `mobile US` -- Mobile proxies for USA

### Step 4: Add Proxies

Paste your proxies in the text area. Supported formats:

**Simple format:**

```
host:port:username:password
```

**URL format:**

```
socks5://username:password@host:port
http://username:password@host:port
```

### Step 5: Save

Click Save. Your list will appear in the table with the proxy count and creation date.

## Using Proxies in Modules

On every module page, there is a **Select proxy...** dropdown:

1. Click the dropdown
2. Choose the proxy list you want to use
3. Start your task

Proxies are distributed across worker threads using round-robin. If you have 10 proxies and 5 threads, each thread gets 2 proxies (cycling through them).

## Rotational (Backconnect) Proxies

Some proxy services give you a single `host:port` that automatically assigns a different IP on each connection. These are called rotational or backconnect proxies.

To use them:

1. Create a proxy list with just **one entry** (the single host:port)
2. All worker threads will connect through the same address
3. The provider handles IP rotation automatically

This is the easiest setup -- no need to manage many proxy addresses.

## How Many Proxies Do You Need?

A general guideline:

| Operation              | Proxies per Thread       |
| ---------------------- | ------------------------ |
| **Registration**       | 1 proxy per 1-3 threads  |
| **Checking**           | 1 proxy per 5-10 threads |
| **Cleaning / Profile** | 1 proxy per 3-5 threads  |
| **Parsing / Spamming** | 1 proxy per 1-2 threads  |

If you have fewer proxies than threads, they are reused (cycled). This works but means some IPs get more traffic.

## Troubleshooting Proxy Issues

| Problem                      | Solution                                                                               |
| ---------------------------- | -------------------------------------------------------------------------------------- |
| **Many connection errors**   | Your proxies may be dead. Test them with a proxy checker tool or try a different list. |
| **Slow operations**          | Your proxies are too slow. Try a different provider or closer geographic location.     |
| **Accounts getting banned**  | Your proxy IPs may be flagged. Try mobile/residential proxies instead of datacenter.   |
| **"No proxy list selected"** | Select a proxy list from the dropdown on the module page before starting.              |

{% hint style="info" %}
**Rotate your proxies regularly.** Old proxy IPs get flagged over time. Replace them periodically with fresh ones for the best results.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://mvs-3.gitbook.io/mvs-docs/guides/proxy-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.