---
title: "Документация по прокси: настройка и геотаргетинг"
description: "Настройка прокси Proxonym: хосты и порты, аутентификация, ротация и sticky-сессии, геотаргетинг, примеры кода на 7 языках и коды ошибок."
url: https://proxonym.com/ru/docs
updated: 2026-10-02T03:03:46+00:00
---

# Документация Proxonym

Всё, что нужно для подключения к Proxonym: эндпоинты и порты, аутентификация, сессии, геотаргетинг, примеры кода и обработка ошибок.

- Шлюз `gw.proxonym.com`
- HTTP / HTTPS `8000`
- SOCKS5 `1080`
- Таргетинг `USERNAME-country-us-session-a7k2`

### Содержание

Краткая справка

- **Шлюз**: `gw.proxonym.com`
- **HTTP / HTTPS**: `8000`
- **SOCKS5**: `1080`
- **Страна**: `-country-de`
- **Город**: `-city-berlin`
- **Закреплённый IP**: `-session-a7k2`
- **Время удержания**: `-lifetime-30`

Ошибки шлюза

- `407` Учётные данные или белый список
- `402` Баланс исчерпан или тариф истёк
- `403` Сайт заблокирован правилами использования
- `429` Лимит частоты, снизьте темп
- `502` Сбой участника сети, повторите
- `504` Тайм-аут целевого сайта

**Не получается?** В справочном центре разобраны вопросы оплаты, ошибок и работы с аккаунтом.

[Справочный центр](https://proxonym.com/ru/help) [Проверить прокси](https://proxonym.com/ru/proxy-checker)

## Быстрый старт

Это руководство за несколько минут проведёт вас от нового тарифа до работающего запроса через прокси. В нём используются резидентные прокси на общем шлюзе `gw.proxonym.com`. Другие продукты подключаются так же — через свой хост или список прокси; см. раздел «[Эндпоинты и порты](https://proxonym.com/ru/docs#endpoints-and-ports)».

### Три шага

1. **Пополните баланс и выберите тариф.** Внесите на баланс от $30 в криптовалюте, затем выберите в личном кабинете продукт и объём (см. [страницу с ценами](https://proxonym.com/ru/pricing)) и оплатите его с баланса. Тарифы на резидентные, мобильные и безлимитные резидентные прокси, общие прокси дата-центров и SERP API активируются сразу. ISP- и выделенные IP выдаются менее чем за час.
2. **Скопируйте учётные данные.** Имя пользователя и пароль для прокси находятся в личном кабинете. Во всех примерах на этой странице замените `USERNAME` и `PASSWORD` своими значениями.
3. **Отправьте запрос.** Укажите в клиенте адрес `gw.proxonym.com:8000` и пройдите аутентификацию по имени пользователя и паролю. Параметры, например страна и сессия, передаются в имени пользователя.

### Отправка первого запроса

Эта команда отправляет один запрос через резидентный IP в Германии и выводит IP-адрес, который видит целевой сайт:

**Shell**

```bash
curl -x http://gw.proxonym.com:8000 -U "USERNAME-country-de-session-a7k2:PASSWORD" https://api.ipify.org
```

- `-x http://gw.proxonym.com:8000` задаёт прокси. Оставляйте схему `http://` даже для HTTPS-сайтов: шлюз открывает зашифрованный туннель с помощью `CONNECT`.
- `-U "USERNAME-country-de-session-a7k2:PASSWORD"` передаёт учётные данные. `-country-de` выбирает IP в Германии, а `-session-a7k2` сохраняет этот IP для последующих запросов с тем же именем пользователя — по умолчанию на 10 минут.
- `https://api.ipify.org` — целевой сайт. Он возвращает IP-адрес, который видит, то есть ваш выходной IP, например `203.0.113.58`.

В Windows вводите `curl.exe` вместо `curl`. В Windows PowerShell 5.1 `curl` — это псевдоним `Invoke-WebRequest`, у которого другие параметры.

### Проверка выходного IP

1. Выполните `curl https://api.ipify.org` без прокси. Это ваш собственный IP — его также показывает страница «[Какой у меня IP](https://proxonym.com/ru/what-is-my-ip)».
2. Снова выполните команду через прокси. IP должен отличаться от вашего и не меняться от запуска к запуску, пока действует сессия.
3. Уберите `-session-a7k2` из имени пользователя и выполните команду несколько раз. Теперь каждый запрос выходит с нового IP.
4. Проверьте местоположение через прокси с помощью сервиса геолокации IP. Поле `country` в ответе должно содержать `DE`.

**Shell**

```bash
curl -s -x http://gw.proxonym.com:8000 \
  -U "USERNAME-country-de:PASSWORD" \
  https://ipinfo.io/json
```

Ответ `407` означает, что прокси отклонил ваши учётные данные. Проверьте их на опечатки и убедитесь, что параметры соединены дефисами и не содержат пробелов. Остальные коды описаны в разделе «[Ошибки и устранение неполадок](https://proxonym.com/ru/docs#errors-and-troubleshooting)».

Дальше вы можете управлять сменой IP с помощью [сессий](https://proxonym.com/ru/docs#rotating-and-sticky-sessions), выбирать местоположение через [геотаргетинг](https://proxonym.com/ru/docs#geo-targeting) или взять готовый клиент из [примеров кода](https://proxonym.com/ru/docs#code-examples).

## Аутентификация

Proxonym аутентифицирует подключения к прокси двумя способами: по имени пользователя и паролю, которые передаются при каждом подключении, или по белому списку IP, который позволяет указанным в нём машинам подключаться без учётных данных. Доступные способы зависят от продукта.

| Продукт | Имя пользователя и пароль | Белый список IP |
| --- | --- | --- |
| Резидентные, мобильные, безлимитные резидентные | Да, с параметрами в имени пользователя | Нет |
| Общие прокси дата-центров | Да | Да, включены 3 IP |
| ISP | Да, учётные данные — в списке прокси | Нет |
| Выделенные прокси дата-центров | Да, учётные данные — в списке прокси | Нет |

API аккаунта и SERP API вместо этого используют API-ключи. См. [справочник API](https://proxonym.com/ru/docs/api#authentication).

### Имя пользователя и пароль

Имя пользователя и пароль для прокси находятся в личном кабинете. Клиенты передают их с помощью Basic-аутентификации HTTP-прокси (заголовок `Proxy-Authorization`) или методом аутентификации SOCKS5 по имени пользователя и паролю. Большинство инструментов принимают их в одном из двух видов:

- в URL прокси: `http://USERNAME:PASSWORD@gw.proxonym.com:8000`
- отдельными настройками, например `-U USERNAME:PASSWORD` в cURL или параметром аутентификации прокси в вашей HTTP-библиотеке

На резидентных, мобильных и безлимитных резидентных прокси имя пользователя также содержит параметры, которые добавляются через дефис: `USERNAME-country-us-city-new_york-session-a7k2-lifetime-30`. Пароль остаётся прежним, какие бы параметры вы ни добавили. Параметры описаны в разделах «[Ротация и sticky-сессии](https://proxonym.com/ru/docs#rotating-and-sticky-sessions)» и «[Геотаргетинг](https://proxonym.com/ru/docs#geo-targeting)».

Если пароль содержит такие символы, как `@`, `:`, `/` или `#`, закодируйте их в URL прокси процентным кодированием: `@` превращается в `%40`. Незакодированные символы нарушают разбор URL и приводят к ошибкам `407` или сбоям подключения. В отдельных настройках имени пользователя и пароля кодировать ничего не нужно.

### Белый список IP (общие прокси дата-центров)

Общие прокси дата-центров поддерживают аутентификацию по IP источника вместо учётных данных — это удобно для инструментов, которые не умеют передавать имя пользователя прокси. Каждый тариф на общие прокси дата-центров позволяет добавить в белый список 3 IP.

1. Узнайте публичный IP машины, которая будет подключаться: выполните на ней `curl https://api.ipify.org`.
2. Добавьте этот IP в личном кабинете или запросом `POST /whitelist` (см. [API белого списка](https://proxonym.com/ru/docs/api#whitelist)).
3. Подключайтесь к любому `ip:port` из своего списка прокси дата-центров без учётных данных:

**Shell**

```bash
curl -x http://198.51.100.23:3129 https://api.ipify.org
```

Добавляйте в белый список только машины с постоянным публичным IP, например серверы. Домашние и офисные подключения часто меняют IP, а запросы с IP, которого нет в списке, завершаются ошибкой `407`. Если заняты все 3 слота, удалите один IP, прежде чем добавлять новый. Если не хотите управлять IP, используйте аутентификацию по имени пользователя и паролю.

### Субпользователи

Субпользователи — это дополнительные наборы учётных данных прокси в вашем аккаунте. У каждого из них свои имя пользователя, пароль, необязательный лимит трафика и статус, а трафик списывается с баланса вашего аккаунта. С их помощью можно выдать каждой команде, клиенту или проекту отдельные учётные данные, ограничить трафик задачи в ГБ, отслеживать расход по каждому субпользователю и отзывать один набор учётных данных, не затрагивая остальные.

Создавайте их в личном кабинете или запросом `POST /sub-users` (см. [API субпользователей](https://proxonym.com/ru/docs/api#sub-users)). Субпользователи указывают в имени пользователя те же параметры, что и вы, например `sub_k3v9q2xd-country-gb-session-x91`. Когда субпользователь исчерпает лимит трафика, его запросы будут завершаться ошибкой `402`, пока вы не повысите лимит. Отключённый субпользователь получает `407`.

### Безопасная смена учётных данных

Обращайтесь с учётными данными прокси как с любым другим секретом:

- Храните их в переменных окружения или менеджере секретов, но никогда — в исходном коде, репозиториях или клиентских приложениях.
- Выделяйте каждому сервису отдельного субпользователя, чтобы при утечке был скомпрометирован один набор учётных данных, а не все.
- Меняйте их по расписанию — и сразу же, если подозреваете утечку.

Чтобы сменить учётные данные без простоя, на время используйте старые и новые параллельно:

1. Создайте нового субпользователя запросом `POST /sub-users` с тем же лимитом трафика, что и у старого.
2. Разверните новые имя пользователя и пароль на всех воркерах.
3. Следите за значением `traffic_used_gb` старого субпользователя в личном кабинете или через `GET /sub-users`. Когда оно перестанет расти, значит, старые учётные данные больше никто не использует.
4. Удалите старого субпользователя запросом `DELETE /sub-users/{id}`.

После утечки не ждите планового развёртывания: сбросьте пароль запросом `PATCH /sub-users/{id}` с телом `{"reset_password": true}`. Старый пароль сразу перестаёт работать. API-ключи меняются так же: создайте новый ключ в личном кабинете, разверните его, затем отзовите старый.

## Эндпоинты и порты

К продуктам с ротацией IP вы подключаетесь по имени хоста. Статические продукты дают вам список IP прокси, к которым вы подключаетесь напрямую. В таблице перечислены все точки подключения.

| Продукт | Хост | Порт HTTP | Порт SOCKS5 | Аутентификация | Формат |
| --- | --- | --- | --- | --- | --- |
| [Резидентные](https://proxonym.com/ru/residential-proxies) | `gw.proxonym.com` | `8000` | `1080` | Имя пользователя и пароль | `USERNAME[-options]:PASSWORD` |
| [Мобильные](https://proxonym.com/ru/mobile-proxies) | `gw.proxonym.com` | `8000` | `1080` | Имя пользователя и пароль | `USERNAME-type-mobile[-options]:PASSWORD` |
| [Безлимитные резидентные прокси](https://proxonym.com/ru/unlimited-residential-proxies) | `de.unl.proxonym.com`, `use.unl.proxonym.com` или `usw.unl.proxonym.com` — в зависимости от выбора при оформлении заказа | `8000` | `1080` | Имя пользователя и пароль | `USERNAME[-options]:PASSWORD` |
| [ISP](https://proxonym.com/ru/isp-proxies) | IP из вашего списка | Порт из вашего списка | Тот же порт, что и для HTTP | Имя пользователя и пароль из вашего списка | `ip:port:username:password` |
| [Общие прокси дата-центров](https://proxonym.com/ru/datacenter-proxies) | IP из вашего списка | `3129` | `1081` | Белый список IP или имя пользователя и пароль | `ip:port` |
| [Выделенные прокси дата-центров](https://proxonym.com/ru/dedicated-datacenter-proxies) | IP из вашего списка | Порт из вашего списка | Тот же порт, что и для HTTP | Имя пользователя и пароль из вашего списка | `ip:port:username:password` |

`[-options]` обозначает необязательные параметры в имени пользователя, например `-country-us-session-a7k2`. Списки описаны в разделе «[Списки прокси дата-центров, ISP-прокси и выделенных прокси](https://proxonym.com/ru/docs#proxy-lists)».

### HTTPS-сайты

HTTP-порты обслуживают сайты как на `http://`, так и на `https://`. Для HTTPS прокси открывает туннель `CONNECT`, и TLS-шифрование остаётся сквозным, поэтому устанавливать сертификаты не нужно. Указывайте URL прокси с `http://`, даже если сайт работает по HTTPS. Подробности — в разделе «[Протоколы](https://proxonym.com/ru/docs#protocols-https)».

### API

| API | Базовый URL | Аутентификация |
| --- | --- | --- |
| API аккаунта | `https://api.proxonym.com/v1` | `Authorization: Bearer <API_KEY>` |
| Google SERP API | `https://serp.proxonym.com/v1` | Заголовок `X-API-Key` |

Оба описаны в [справочнике API](https://proxonym.com/ru/docs/api).

### Файрволы

Порты 8000, 1080, 3129 и 1081 не относятся к стандартным веб-портам, и некоторые корпоративные сети и группы безопасности в облаках их блокируют. Если подключение зависает ещё до получения ответа, разрешите исходящий TCP-трафик на используемые хост и порт прокси, а также UDP, если вы передаёте UDP через SOCKS5.

## Ротация и sticky-сессии

На резидентных, мобильных и безлимитных резидентных прокси момент смены выходного IP определяется именем пользователя. Есть два режима: ротация (по умолчанию) и sticky-сессии.

### Ротация (по умолчанию)

Без параметра сессии каждый запрос получает новый IP из пула:

**Текст**

```text
USERNAME-country-us
```

Ротация подходит для задач без сохранения состояния, которые загружают много независимых страниц. Каждый запрос выглядит как отдельный посетитель, и блокировка IP стоит вам одного запроса, а не всей задачи.

Шлюз назначает IP каждый раз, когда маршрутизирует новый запрос. Запросы, отправленные через повторно используемое HTTPS-соединение, идут по тому же туннелю `CONNECT` и сохраняют его IP. Чтобы каждый раз получать новый IP, открывайте новое соединение для каждого запроса или используйте sticky-сессии, чтобы точно управлять моментом смены IP.

### Sticky-сессии

Добавьте `-session-{id}`, чтобы сохранять один IP для нескольких запросов. Все запросы с одинаковым именем пользователя, включая ID сессии, используют один и тот же IP, пока сессия не закончится.

**Текст**

```text
USERNAME-country-us-session-a7k2
USERNAME-country-us-session-a7k2-lifetime-30
```

- `-session-{id}`: от 1 до 32 букв или цифр на ваш выбор. Новый ID начинает новую сессию на новом IP.
- `-lifetime-{minutes}`: сколько времени сессия сохраняет свой IP. Без этого параметра сессия длится 10 минут.

| Продукт | Время жизни | Максимальная длительность |
| --- | --- | --- |
| Резидентные | 1–120 минут, по умолчанию 10 | `-lifetime-120` (2 часа) |
| Безлимитные резидентные прокси | 1–720 минут, по умолчанию 10 | `-lifetime-720` (12 часов) |
| Мобильные | 1–3 минуты, задавайте явно | `-lifetime-3` (3 минуты) |

Резидентные и мобильные IP принадлежат реальным устройствам, которые могут уйти в офлайн. Считайте время жизни максимумом, а не гарантией: сессия может потерять IP раньше, и тогда запрос завершится ошибкой `502`. Если один и тот же IP нужен вам несколько дней, используйте [ISP-прокси](https://proxonym.com/ru/isp-proxies) или [выделенные прокси дата-центров](https://proxonym.com/ru/dedicated-datacenter-proxies).

### Пример последовательности запросов

Этот скрипт отправляет три запроса в одной sticky-сессии, а затем три запроса с ротацией:

**Shell**

```bash
# Sticky: same session ID, same IP for up to 30 minutes
for i in 1 2 3; do
  curl -s -x http://gw.proxonym.com:8000 \
    -U "USERNAME-country-us-session-job42-lifetime-30:PASSWORD" \
    https://api.ipify.org; echo
done

# Rotating: no session option, a new IP on every request
for i in 1 2 3; do
  curl -s -x http://gw.proxonym.com:8000 \
    -U "USERNAME-country-us:PASSWORD" \
    https://api.ipify.org; echo
done
```

Пример вывода:

**Текст**

```text
203.0.113.41
203.0.113.41
203.0.113.41
203.0.113.187
203.0.113.9
203.0.113.152
```

Чтобы перевести sticky-сессию на новый IP до её окончания, смените ID, например на `-session-job43`.

### Рекомендации

- **Используйте ротацию** для страниц без состояния: поисковой выдачи, карточек товаров, каталогов.
- **Используйте sticky-сессии**, когда сайт ожидает одного и того же посетителя на нескольких шагах: вход в аккаунт, корзина и оформление заказа, многошаговые формы, пагинация с привязкой к cookie.
- Используйте по одной сессии на воркер, профиль браузера или аккаунт со случайными ID, чтобы параллельные задачи никогда случайно не оказывались на одном IP.
- Задавайте время жизни, близкое к длительности задачи. Чем короче сессии, тем по большему числу IP распределяется ваш трафик.
- Отправляйте одно и то же имя пользователя во всех запросах сессии. Если изменить страну или другой параметр посреди сессии, IP может смениться.
- После блокировки или капчи переходите на новый ID сессии, а не повторяйте запрос с того же IP.

Подробнее о том, когда какой режим использовать, — в нашем [сравнении ротации и sticky-сессий](https://proxonym.com/ru/blog/rotating-vs-sticky-sessions).

## Геотаргетинг

Добавьте в имя пользователя параметры местоположения, чтобы выбрать, где будет находиться выходной IP. Они работают на резидентных, мобильных и безлимитных резидентных прокси. Местоположение статических продуктов определяется IP в вашем списке, поэтому для них фильтруйте список по стране.

### Параметры

| Параметр | Формат | Примеры |
| --- | --- | --- |
| `-country-{cc}` | Код ISO 3166-1 alpha-2 в нижнем регистре. Если не указать, страна будет случайной. | `-country-us`, `-country-gb`, `-country-de` |
| `-state-{name}` | Штат или регион в нижнем регистре, пробелы заменяются подчёркиваниями | `-state-california`, `-state-new_york` |
| `-city-{name}` | Город в нижнем регистре, пробелы заменяются подчёркиваниями | `-city-new_york`, `-city-sao_paulo` |
| `-asn-{number}` | Номер автономной системы сети | `-asn-7922` (Comcast) |

### Правила

- Используйте `-state` или `-city`, но не оба сразу в одном имени пользователя.
- Указывайте `-country` всякий раз, когда выбираете штат, город или ASN: многие названия городов встречаются в нескольких странах.
- Коды стран соответствуют ISO 3166-1, поэтому Великобритания — это `gb`, а не `uk`.
- Пишите названия строчными латинскими буквами (ASCII) с подчёркиваниями: `sao_paulo`, а не `São Paulo`.
- Указывайте параметры в том же порядке, что и везде в этой документации: страна, штат или город, ASN, тип, сессия, время жизни.

### Примеры

| Задача | Имя пользователя |
| --- | --- |
| Случайная страна | `USERNAME` |
| США | `USERNAME-country-us` |
| Калифорния | `USERNAME-country-us-state-california` |
| Нью-Йорк | `USERNAME-country-us-city-new_york` |
| Абоненты Comcast в США | `USERNAME-country-us-asn-7922` |
| Сан-Паулу, Бразилия | `USERNAME-country-br-city-sao_paulo` |
| Лондон, один IP на 30 минут | `USERNAME-country-gb-city-london-session-a7k2-lifetime-30` |
| IP мобильного оператора в США | `USERNAME-country-us-type-mobile` |

Чтобы узнать, где находится IP, обратитесь через прокси к сервису геолокации IP, как показано в разделе «[Проверка выходного IP](https://proxonym.com/ru/docs#quick-start-verify-exit-ip)».

### Покрытие

- **Резидентные:** 55 млн+ IP в 195+ странах. Крупнейшие пулы — США (8,3 млн), Бразилия (5,2 млн), Индия (3,2 млн), Великобритания (2,3 млн), Мексика (1,8 млн), Аргентина (1,5 млн), Индонезия (1,4 млн) и Филиппины (1,1 млн).
- **Безлимитные резидентные:** около 10 млн IP в 180+ странах.
- **Мобильные:** США (`us`), Великобритания (`gb`) и Австрия (`at`); список стран постепенно расширяется.

Чем уже таргетинг, тем меньше пул. В стране в любой момент онлайн много IP, а в небольшом городе или в одной ASN их может быть мало, поэтому будьте готовы к большему числу повторных попыток и меньшему числу уникальных IP. Покрытие по странам — на странице «[Локации](https://proxonym.com/ru/locations)».

### Если подходящего IP нет

Если подходящего IP нет, шлюз возвращает `502` — расширьте таргетинг. Прежде чем вернуть ошибку, шлюз делает повторные попытки, поэтому `502`, который повторяется для одного и того же имени пользователя, обычно означает, что сочетание параметров слишком узкое или в нём опечатка.

Чтобы расширить таргетинг, перейдите от города к штату, от штата к стране или уберите ASN. Проверьте и написание: `-city-newyork` или `-country-uk` ничему не соответствуют.

## Мобильные прокси

[Мобильные прокси](https://proxonym.com/ru/mobile-proxies) направляют трафик через IP операторов 3G, 4G и 5G. Операторы выводят в интернет множество абонентов через каждый публичный IP, поэтому сайты блокируют такие адреса с осторожностью — и они хорошо подходят для социальных платформ и приложений, ориентированных на мобильные устройства.

### Подключение

Мобильные прокси используют резидентный шлюз и ваши обычные учётные данные. Добавьте `-type-mobile` в имя пользователя:

**Shell**

```bash
curl -x http://gw.proxonym.com:8000 \
  -U "USERNAME-country-us-type-mobile:PASSWORD" \
  https://api.ipify.org
```

Мобильный трафик списывается с того же баланса ГБ, что и резидентный. Отдельного мобильного баланса, который нужно пополнять, нет.

### Локации

Мобильные IP доступны в США (`-country-us`), Великобритании (`-country-gb`) и Австрии (`-country-at`), и список стран постепенно расширяется. В стране без мобильного покрытия подходящих IP нет, поэтому шлюз возвращает `502`.

### Ротация и сессии

- **Ротация:** мобильные IP меняются при каждом подключении. Каждое новое подключение получает новый IP, а запросы внутри keep-alive-соединения используют его IP.
- **Sticky-сессии:** добавьте `-session-{id}` со временем жизни от 1 до 3 минут. Для мобильных прокси всегда задавайте время жизни явно.

**Текст**

```text
USERNAME-country-gb-type-mobile-session-m42x-lifetime-3
```

Трёх минут хватает на короткий сценарий, например на загрузку страницы профиля со всеми её ресурсами. Более длинные сценарии стройте так, чтобы они переживали смену IP: храните cookie и состояние на стороне клиента. Для аккаунтов, которым нужен один IP на несколько дней, используйте [ISP-прокси](https://proxonym.com/ru/isp-proxies).

## Безлимитные резидентные прокси

Тарифы на [безлимитные резидентные прокси](https://proxonym.com/ru/unlimited-residential-proxies) оплачиваются за скорость канала и срок, а не за ГБ. Трафик не учитывается: вам доступны около 10 млн резидентных IP в 180+ странах, а скорость тарифа задаёт максимальную суммарную пропускную способность.

### Серверы шлюза

Каждый тариф работает на выделенном сервере шлюза, который вы выбираете при оформлении заказа. Выбирайте сервер, ближайший к машинам, которые отправляют трафик; таргетировать любую страну через `-country` при этом всё равно можно.

| Сервер | Локация | Порт HTTP | Порт SOCKS5 |
| --- | --- | --- | --- |
| `de.unl.proxonym.com` | Германия | `8000` | `1080` |
| `use.unl.proxonym.com` | Восток США | `8000` | `1080` |
| `usw.unl.proxonym.com` | Запад США | `8000` | `1080` |

**Shell**

```bash
curl -x http://use.unl.proxonym.com:8000 \
  -U "USERNAME-country-us-session-a7k2-lifetime-240:PASSWORD" \
  https://api.ipify.org
```

Параметры в имени пользователя работают так же, как на резидентных прокси: страна, штат, город, ASN, сессия и время жизни. Подключайтесь только к серверу своего тарифа.

### Уровни скорости и сроки

Тарифы доступны со скоростью 100, 200, 400, 600 и 800 Мбит/с и 1 Гбит/с, на 1, 7 или 30 дней. Уровень ограничивает суммарную скорость всех ваших подключений, а не объём данных. Тарифы никогда не продлеваются автоматически: по окончании срока запросы завершаются ошибкой `402`, пока вы не продлите тариф. Цены — на [странице с ценами](https://proxonym.com/ru/pricing).

### Sticky-сессии до 12 часов

Безлимитные резидентные прокси принимают время жизни от 1 до 720 минут, так что с `-lifetime-720` одна сессия может сохранять IP до 12 часов. Как и на резидентных прокси, IP всё равно может уйти в офлайн до истечения времени жизни.

### Опция UDP

Опция UDP, которую выбирают при оформлении заказа, включает передачу UDP через SOCKS5 на порту `1080` с помощью команды SOCKS5 `UDP ASSOCIATE`. Без неё шлюз передаёт только TCP. См. раздел «[Поддержка UDP](https://proxonym.com/ru/docs#protocols-udp)».

### Разумное использование

Лимита в ГБ нет, а число параллельных подключений не ограничено. Действует принцип разумного использования согласно [правилам допустимого использования](https://proxonym.com/ru/acceptable-use). Для стабильно больших объёмов, превышающих уровни самостоятельного заказа, см. [корпоративные тарифы](https://proxonym.com/ru/enterprise). Подробнее: [как работают безлимитные резидентные прокси](https://proxonym.com/ru/blog/unlimited-residential-proxies-explained).

## Списки прокси дата-центров, ISP-прокси и выделенных прокси

Статические продукты не используют шлюз. Вы подключаетесь напрямую к IP прокси, закреплённым за вашим тарифом; их список можно скачать.

### Скачивание списка

Скачайте список в личном кабинете или получите его через API аккаунта:

**Shell**

```bash
curl -H "Authorization: Bearer $PROXONYM_API_KEY" \
  "https://api.proxonym.com/v1/proxies/datacenter?format=txt&country=us"
```

Продукт в пути — `datacenter`, `isp` или `dedicated`. `format` принимает значение `txt` (по одному прокси в строке) или `json`, а `country` фильтрует по коду страны. Подробности — в [справочнике API](https://proxonym.com/ru/docs/api#proxy-lists).

### Форматы

| Продукт | Формат строки | Пример строки | URL прокси |
| --- | --- | --- | --- |
| Общие прокси дата-центров | `ip:port` | `198.51.100.23:3129` | `http://198.51.100.23:3129` с IP из белого списка или `http://USERNAME:PASSWORD@198.51.100.23:3129`. SOCKS5: тот же IP, порт `1081` |
| ISP | `ip:port:username:password` | `198.51.100.61:6200:isp_k8w2m4:Tz6pW1qR8nVb3xYc` | `http://username:password@ip:port` или `socks5h://username:password@ip:port` |
| Выделенные прокси дата-центров | `ip:port:username:password` | `198.51.100.112:6200:ded_r4n7c2:Mb9xK2vQ7tLp4wZe` | `http://username:password@ip:port` или `socks5h://username:password@ip:port` |

Всегда берите хост и порт из своего списка.

### Распределение запросов по списку

Статические IP не меняются сами по себе: каждая строка списка — это всегда один и тот же выходной IP. Чтобы распределить запросы, перебирайте список по кругу в своём коде:

**Python**

```python
import itertools

import requests

# proxies.txt holds one ISP or dedicated proxy per line: ip:port:username:password
with open("proxies.txt") as f:
    lines = [line.strip() for line in f if line.strip()]

def to_url(line: str) -> str:
    ip, port, user, password = line.split(":", 3)
    return f"http://{user}:{password}@{ip}:{port}"

pool = itertools.cycle([to_url(line) for line in lines])

for _ in range(5):
    proxy = next(pool)
    r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=30)
    print(r.text)
```

### Общие прокси дата-центров

- 40 000 IP в 9 странах (США, Бразилия, Германия, Франция, Великобритания, Канада, Таиланд, Италия и Испания), а также смешанный пул. IP используются совместно с другими клиентами.
- HTTP на порту `3129` и SOCKS5 на порту `1081` каждого IP, с поддержкой UDP через SOCKS5.
- Аутентификация — по [белому списку IP](https://proxonym.com/ru/docs#authentication-ip-whitelist) (включены 3 IP) или по имени пользователя и паролю.
- Список статический, по умолчанию без ротации.
- Месячные уровни трафика: 250 ГБ, 1 ТБ, 5 ТБ или «Без ограничений». На уровень «Без ограничений» распространяется принцип разумного использования.

### ISP-прокси

- Статические IP, зарегистрированные на провайдеров домашнего интернета, только для вашего аккаунта, с безлимитным трафиком.
- 17 локаций: США (Нью-Йорк, Лос-Анджелес, Виргиния, пул Comcast и пул Verizon), Канада, Германия, Великобритания, Гонконг, Япония, Франция, Италия, Польша, Испания, Сингапур, Молдова и Южная Корея.
- Сроки — 1, 7, 30 или 90 дней, выдача менее чем за час. Тарифы никогда не продлеваются автоматически: проверяйте `expires_at` в списке JSON или в `GET /account` и продлевайте, когда сочтёте нужным.
- HTTP и SOCKS5 на одном порту, TCP и UDP через SOCKS5.

Впервые сталкиваетесь со статическими резидентными IP? Прочитайте, [что такое ISP-прокси](https://proxonym.com/ru/blog/what-is-an-isp-proxy).

### Выделенные прокси дата-центров

- Приватные IP, закреплённые за вашим аккаунтом, в 8 странах: США, Канада, Германия, Франция, Италия, Япония, Индия и Тайвань.
- Аутентификация по имени пользователя и паролю, учётные данные — в вашем списке. HTTP и SOCKS5 на одном порту.
- Безлимитный трафик, оплата за IP в месяц.
- Замена IP по запросу: в разделе «**Мои тарифы**» личного кабинета выберите «**Заменить IP**» и перечислите IP с указанием причины.

## Протоколы

Все продукты поддерживают HTTP, HTTPS и SOCKS5. Используйте тот протокол, который поддерживает ваш клиент: IP, учётные данные и параметры имени пользователя одинаковы для всех протоколов. Плюсы и минусы каждого разобраны в нашем [сравнении SOCKS5 и HTTP](https://proxonym.com/ru/blog/socks5-vs-http-proxies).

### HTTP

Для сайтов на `http://` клиент отправляет полный запрос прокси, а тот пересылает его целевому сайту. Используйте HTTP-порт и URL прокси со схемой `http://`. Подробнее — на странице «[HTTP-прокси](https://proxonym.com/ru/http-proxies)».

### HTTPS (CONNECT)

Для сайтов на `https://` клиент просит прокси открыть туннель методом `CONNECT`, а затем через этот туннель устанавливает TLS-соединение с целевым сайтом. Шифрование сквозное, а сертификат принадлежит самому сайту, поэтому дополнительно настраивать центр сертификации не нужно. URL прокси всё равно начинается с `http://`, потому что до открытия туннеля соединение с прокси идёт по обычному HTTP. Обмен выглядит так:

**Текст**

```text
CONNECT example.com:443 HTTP/1.1
Host: example.com:443
Proxy-Authorization: Basic VVNFUk5BTUUtY291bnRyeS11czpQQVNTV09SRA==

HTTP/1.1 200 Connection established
```

Значение в Base64 кодирует `USERNAME-country-us:PASSWORD`. HTTP-библиотека формирует его за вас.

### SOCKS5

SOCKS5 передаёт любой TCP-трафик, не только HTTP, а на некоторых продуктах ещё и UDP. Используйте порт `1080` на резидентном шлюзе и серверах безлимитных прокси, порт `1081` на общих IP дата-центров и порт из списка на ISP- и выделенных IP. Аутентификация выполняется методом SOCKS5 по имени пользователя и паролю — с теми же учётными данными и параметрами имени пользователя, что и в HTTP.

Чтобы имена хостов разрешались на стороне прокси, используйте `socks5h://`, где `h` означает удалённый DNS. С обычной схемой `socks5://` ваш компьютер сам разрешает имя целевого хоста: DNS-запрос утекает к вашему собственному резолверу и может вернуть адреса, предназначенные для вашего местоположения, а не для местоположения выходного IP.

**Shell**

```bash
curl -x socks5h://gw.proxonym.com:1080 \
  -U "USERNAME-country-us:PASSWORD" \
  https://api.ipify.org
```

В Python установите поддержку SOCKS командой `pip install "requests[socks]"` и используйте ту же схему:

**Python**

```python
import requests

proxy = "socks5h://USERNAME-country-us:PASSWORD@gw.proxonym.com:1080"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=30)
print(r.text)
```

Подробнее — на странице «[SOCKS5-прокси](https://proxonym.com/ru/socks5-proxies)».

### Поддержка UDP

UDP передаётся через SOCKS5 с помощью команды `UDP ASSOCIATE`, определённой в RFC 1928. Клиенту нужна SOCKS5-библиотека, которая её реализует: HTTP-прокси не умеют передавать UDP, а cURL не поддерживает UDP через SOCKS5.

| Продукт | HTTP и HTTPS | SOCKS5 через TCP | SOCKS5 через UDP |
| --- | --- | --- | --- |
| Резидентные | Порт 8000 | Порт 1080 | Нет |
| Мобильные | Порт 8000 | Порт 1080 | Нет |
| Безлимитные резидентные прокси | Порт 8000 | Порт 1080 | С опцией UDP, порт 1080 |
| ISP | Порт из списка | Порт из списка | Да, порт из списка |
| Общие прокси дата-центров | Порт 3129 | Порт 1081 | Да, порт 1081 |
| Выделенные прокси дата-центров | Порт из списка | Порт из списка | Нет |

Если вам нужен UDP, используйте ISP-прокси, общие прокси дата-центров или безлимитные резидентные прокси с опцией UDP.

## Примеры кода

Каждый пример отправляет один запрос через шлюз `gw.proxonym.com:8000` (резидентный IP в США, режим ротации) и выводит ответ `api.ipify.org` с вашим выходным IP. Замените `USERNAME` и `PASSWORD`, а таргетинг меняйте в имени пользователя, например `USERNAME-country-de-session-a7k2-lifetime-30`. В продакшене считывайте учётные данные из переменных окружения.

### cURL

**Shell**

```bash
# Rotating US IP: a new IP on every run
curl -x http://gw.proxonym.com:8000 \
  -U "USERNAME-country-us:PASSWORD" \
  "https://api.ipify.org?format=json"

# Sticky New York IP for 30 minutes
curl -x http://gw.proxonym.com:8000 \
  -U "USERNAME-country-us-city-new_york-session-a7k2-lifetime-30:PASSWORD" \
  "https://api.ipify.org?format=json"
```

О SOCKS5 — в разделе «[SOCKS5](https://proxonym.com/ru/docs#protocols-socks5)». Больше вариантов — в [руководстве по интеграции с cURL](https://proxonym.com/ru/integrations/curl).

### Python (requests)

**Python**

```python
import requests

USERNAME = "USERNAME-country-us"
PASSWORD = "PASSWORD"
GATEWAY = "gw.proxonym.com:8000"
URL = "https://api.ipify.org?format=json"

proxy = f"http://{USERNAME}:{PASSWORD}@{GATEWAY}"
proxies = {"http": proxy, "https": proxy}

# Rotating: each requests.get() opens a new connection and gets a new IP
r = requests.get(URL, proxies=proxies, timeout=(10, 60))
print(r.status_code, r.json())

# Sticky: the session ID keeps the IP; a Session also reuses the connection
sticky = f"http://{USERNAME}-session-a7k2-lifetime-30:{PASSWORD}@{GATEWAY}"
sticky_proxies = {"http": sticky, "https": sticky}
with requests.Session() as s:
    for _ in range(3):
        print(s.get(URL, proxies=sticky_proxies, timeout=(10, 60)).json())
```

Кортеж тайм-аутов задаётся как (подключение, чтение) в секундах. См. [интеграцию с Python Requests](https://proxonym.com/ru/integrations/python-requests) и наше [руководство по прокси в Python Requests](https://proxonym.com/ru/blog/python-requests-proxies).

### Python (aiohttp)

**Python**

```python
import asyncio

import aiohttp

PROXY = "http://gw.proxonym.com:8000"
AUTH = aiohttp.BasicAuth("USERNAME-country-us", "PASSWORD")
URL = "https://api.ipify.org?format=json"

async def fetch(session: aiohttp.ClientSession, n: int) -> None:
    async with session.get(URL, proxy=PROXY, proxy_auth=AUTH) as resp:
        data = await resp.json()
        print(n, resp.status, data["ip"])

async def main() -> None:
    timeout = aiohttp.ClientTimeout(total=60)
    async with aiohttp.ClientSession(timeout=timeout) as session:
        # 10 concurrent requests, each on its own connection, so each gets its own IP
        await asyncio.gather(*(fetch(session, n) for n in range(10)))

asyncio.run(main())
```

### Node.js (undici)

**JavaScript**

```javascript
// npm install undici, then save as proxy.mjs and run: node proxy.mjs
import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:PASSWORD@gw.proxonym.com:8000");

const res = await fetch("https://api.ipify.org?format=json", {
  dispatcher,
  signal: AbortSignal.timeout(60_000),
});
console.log(res.status, await res.json());
```

Агент держит соединения открытыми, поэтому последовательные запросы через один `ProxyAgent` могут идти с одного и того же IP. Если нужен явный контроль, используйте ID сессий. Подробнее — в [руководстве по интеграции с Node.js](https://proxonym.com/ru/integrations/nodejs).

### Node.js (axios с https-proxy-agent)

**JavaScript**

```javascript
// npm install axios https-proxy-agent, then run as an ES module: node proxy.mjs
import axios from "axios";
import { HttpsProxyAgent } from "https-proxy-agent";

const agent = new HttpsProxyAgent("http://USERNAME-country-us:PASSWORD@gw.proxonym.com:8000");

const { status, data } = await axios.get("https://api.ipify.org?format=json", {
  httpsAgent: agent,
  proxy: false, // the agent handles the proxy; turn off axios's own proxy handling
  timeout: 60_000,
});
console.log(status, data);
```

`HttpsProxyAgent` обслуживает сайты на `https://`. Для сайтов на `http://` передайте `HttpProxyAgent` из пакета `http-proxy-agent` в параметре `httpAgent`.

### PHP (cURL)

**PHP**

```php
<?php
$ch = curl_init('https://api.ipify.org?format=json');
curl_setopt_array($ch, [
    CURLOPT_PROXY          => 'http://gw.proxonym.com:8000',
    CURLOPT_PROXYUSERPWD   => 'USERNAME-country-us:PASSWORD',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10,
    CURLOPT_TIMEOUT        => 60,
]);
// For SOCKS5 with remote DNS, use CURLOPT_PROXY => 'socks5h://gw.proxonym.com:1080'

$body = curl_exec($ch);
if ($body === false) {
    fwrite(STDERR, 'cURL error: ' . curl_error($ch) . PHP_EOL);
    exit(1);
}
echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), ' ', $body, PHP_EOL;
```

Подробнее — в [руководстве по интеграции с PHP](https://proxonym.com/ru/integrations/php).

### Go (net/http)

**Go**

```go
package main

import (
    "fmt"
    "io"
    "log"
    "net/http"
    "net/url"
    "time"
)

func main() {
    proxyURL, err := url.Parse("http://USERNAME-country-us:PASSWORD@gw.proxonym.com:8000")
    if err != nil {
        log.Fatal(err)
    }

    client := &http.Client{
        Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
        Timeout:   60 * time.Second,
    }

    resp, err := client.Get("https://api.ipify.org?format=json")
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(resp.StatusCode, string(body))
}
```

Подробнее — в [руководстве по интеграции с Go](https://proxonym.com/ru/integrations/go).

### Java (HttpClient)

**Java**

```java
import java.net.Authenticator;
import java.net.InetSocketAddress;
import java.net.PasswordAuthentication;
import java.net.ProxySelector;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class ProxyExample {
    public static void main(String[] args) throws Exception {
        // Java disables Basic auth for HTTPS proxy tunnels by default. Re-enable it
        // before the first HttpClient is built, or start the JVM with
        // -Djdk.http.auth.tunneling.disabledSchemes=
        System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

        HttpClient client = HttpClient.newBuilder()
                .proxy(ProxySelector.of(new InetSocketAddress("gw.proxonym.com", 8000)))
                .authenticator(new Authenticator() {
                    @Override
                    protected PasswordAuthentication getPasswordAuthentication() {
                        if (getRequestorType() != RequestorType.PROXY) {
                            return null;
                        }
                        return new PasswordAuthentication("USERNAME-country-us", "PASSWORD".toCharArray());
                    }
                })
                .connectTimeout(Duration.ofSeconds(10))
                .build();

        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.ipify.org?format=json"))
                .timeout(Duration.ofSeconds(60))
                .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}
```

Требуется Java 11 или новее. Сохраните код в файл `ProxyExample.java` и выполните `java ProxyExample.java`. Подробнее — в [руководстве по интеграции с Java](https://proxonym.com/ru/integrations/java).

### C# (HttpClient)

**C#**

```csharp
// .NET 6 or later: create a console app with "dotnet new console" and replace Program.cs
using System.Net;

var handler = new HttpClientHandler
{
    Proxy = new WebProxy("http://gw.proxonym.com:8000")
    {
        Credentials = new NetworkCredential("USERNAME-country-us", "PASSWORD")
    },
    UseProxy = true
};

// Create one HttpClient per proxy configuration and reuse it
using var client = new HttpClient(handler) { Timeout = TimeSpan.FromSeconds(60) };

var body = await client.GetStringAsync("https://api.ipify.org?format=json");
Console.WriteLine(body);
```

### Браузеры и фреймворки

Руководства по настройке других инструментов: [Scrapy](https://proxonym.com/ru/integrations/scrapy), [Puppeteer](https://proxonym.com/ru/integrations/puppeteer), [Playwright](https://proxonym.com/ru/integrations/playwright), [Selenium](https://proxonym.com/ru/integrations/selenium), [AdsPower](https://proxonym.com/ru/integrations/adspower) и [Multilogin](https://proxonym.com/ru/integrations/multilogin). Полный список — на странице «[Интеграции](https://proxonym.com/ru/integrations)».

## Ошибки и устранение неполадок

Если запрос отклоняет или не может выполнить сам прокси, он отвечает одним из перечисленных ниже кодов. Любой другой код ответа приходит от целевого сайта.

### Коды ответа прокси

| Код | Значение | Частые причины | Решение |
| --- | --- | --- | --- |
| `407` | Требуется аутентификация на прокси | Неверное имя пользователя или пароль, опечатка в параметрах имени пользователя, незакодированный спецсимвол в пароле или, для общих прокси дата-центров, IP источника не из белого списка | Заново скопируйте учётные данные из личного кабинета, проверьте параметры, закодируйте пароль в URL процентным кодированием или добавьте свой IP в белый список |
| `402` | Требуется оплата | Баланс трафика исчерпан, тариф истёк или субпользователь достиг лимита трафика | Пополните баланс или продлите тариф — автоматически тарифы не продлеваются. Проверьте балансы через `GET /account` или повысьте лимит субпользователя |
| `403` | Доступ запрещён | Целевой сайт заблокирован согласно [правилам допустимого использования](https://proxonym.com/ru/acceptable-use) | Не повторяйте запрос: блокировка действует для всех аккаунтов. Клиенты с выделенными прокси дата-центров могут запросить проверку в тикете |
| `429` | Слишком много запросов | Сработала защита от превышения частоты запросов: ваш аккаунт превысил пиковый лимит — около 10 000 запросов в секунду | Снизьте частоту запросов и повторяйте их с экспоненциальной задержкой |
| `502` | Ошибка шлюза | Участник сети, через которого шёл запрос, дал сбой или ушёл в офлайн, либо ни один IP не подходит под ваш таргетинг | Повторите запрос. Если ошибка повторяется, расширьте таргетинг или, в sticky-сессиях, перейдите на новый ID сессии |
| `504` | Тайм-аут шлюза | Целевой сайт не ответил в течение 60 секунд | Повторите запрос, лучше с нового IP, и проверьте, что целевой сайт доступен |

### Ошибка прокси или целевого сайта?

Код `403` или `429` может прийти как от прокси, так и от сайта, к которому вы обращаетесь. Ошибки прокси требуют исправлений на вашей стороне или в аккаунте, а ошибки целевого сайта означают, что сайт отклонил запрос.

- **HTTPS-сайты:** ошибки прокси приходят в ответ на `CONNECT` — ещё до того, как что-либо дойдёт до целевого сайта. Клиенты сообщают о них как об ошибках прокси или туннеля, например `CONNECT tunnel failed, response 407` в cURL или `ProxyError` с текстом `Tunnel connection failed: 407` в Python. Код ответа, полученный в обычном ответе, пришёл от целевого сайта.
- **HTTP-сайты:** ошибка прокси и есть сам ответ. Запустите cURL с `-v`, чтобы увидеть весь обмен.

Если целевой сайт блокирует вас кодами `403`, `429` или страницами с капчей, снизьте частоту запросов, меняйте IP и подбирайте страну IP под аудиторию сайта. На хорошо защищённых сайтах резидентные и мобильные IP блокируются реже, чем IP дата-центров. Подробнее — в нашем руководстве по [парсингу без блокировок](https://proxonym.com/ru/blog/web-scraping-without-getting-blocked).

### Как исправить 407

1. Проверьте учётные данные без параметров: `-U "USERNAME:PASSWORD"`. Если так всё работает, проблема в параметрах.
2. Проверьте параметры: строчные буквы, соединение дефисами, без пробелов, ID сессии — от 1 до 32 букв или цифр.
3. Закодируйте спецсимволы пароля в URL прокси процентным кодированием.
4. Убедитесь, что IP в белом списке по-прежнему совпадает с публичным IP вашей машины, а субпользователи находятся в статусе `active`.

### Ошибки SSL

- **`wrong version number` или `SSL: WRONG_VERSION_NUMBER`:** URL прокси начинается с `https://`. Замените его на `http://`. Порт прокси работает по обычному HTTP, а TLS-соединение с целевым сайтом идёт внутри туннеля.
- **Ошибка проверки сертификата:** TLS-шифрование сквозное, поэтому сертификат принадлежит целевому сайту. Обновите набор корневых сертификатов (в Python — `pip install -U certifi`), проверьте системные часы и выясните, нет ли в вашей сети корпоративного прокси с инспекцией TLS.
- **Сбой рукопожатия на одном сайте:** сайт может отклонять TLS-настройки вашего клиента. Обновите клиент или библиотеку до актуальной версии.

Не отключайте проверку сертификатов (`curl -k`, `verify=False`) в продакшене: это скрывает причину ошибки и делает ваш трафик уязвимым для перехвата.

### Тайм-ауты

- Прокси ждёт ответа целевого сайта до 60 секунд, а затем возвращает `504`. Если тайм-аут клиента короче, вместо этого вы увидите тайм-аут на стороне клиента.
- Задайте тайм-аут подключения около 10 секунд и тайм-аут чтения около 60 секунд. Если подключиться к прокси за 10 секунд не удаётся, ищите проблему в своей сети или файрволе, а не на целевом сайте.
- Резидентные IP работают на реальных домашних подключениях и отвечают медленнее, чем IP дата-центров. Если задержка для вас важнее типа IP, попробуйте ISP-прокси или прокси дата-центров.
- Если тайм-ауты скапливаются в одной sticky-сессии, её IP, скорее всего, ушёл в офлайн. Перейдите на новый ID сессии.

### Ошибки подключения

- **Соединение сразу отклоняется или сбрасывается:** неверный порт или протокол. HTTP использует порт 8000 на шлюзах и 3129 на общих прокси дата-центров, SOCKS5 — порты 1080 и 1081.
- **Соединение зависает без ответа:** порт прокси блокирует файрвол; см. раздел «[Файрволы](https://proxonym.com/ru/docs#endpoints-and-ports-firewalls)».
- **Ошибки DNS через SOCKS5:** используйте `socks5h://`, чтобы имена хостов разрешал прокси.

### Как получить помощь

Ответы на частые вопросы — в [справочном центре](https://proxonym.com/ru/help). Возврат средств, замена IP и операции с вашими данными оформляются заявками в личном кабинете, в разделе «**Поддержка**»; там же аккаунты с активным тарифом на выделенные прокси дата-центров могут открывать тикеты. В тикете укажите время запроса с часовым поясом, использованные параметры имени пользователя (но никогда не пароль), домен целевого сайта, код ответа или текст ошибки, а также вывод `curl -v`, если он у вас есть. Сообщения по электронной почте мы не принимаем.

## Лимиты и разумное использование

Эти лимиты действуют для всех аккаунтов.

| Лимит | Значение | При достижении |
| --- | --- | --- |
| Параллельные подключения и сессии | Без ограничений на всех продуктах | Неприменимо |
| Частота запросов | Пиковая частота — около 10 000 запросов в секунду на аккаунт | Прокси возвращает `429` |
| Время ответа целевого сайта | 60 секунд | Прокси возвращает `504` |
| Время жизни sticky-сессии | 120 минут на резидентных, 720 — на безлимитных резидентных, 3 — на мобильных прокси | Сессия завершается, новая сессия начинается на новом IP |
| Пропускная способность безлимитных резидентных прокси | Скорость вашего тарифа: от 100 Мбит/с до 1 Гбит/с | Суммарная скорость не превышает уровень тарифа |
| Трафик общих прокси дата-центров | 250 ГБ, 1 ТБ или 5 ТБ в месяц либо «Без ограничений» в рамках разумного использования | Прокси возвращает `402`, когда объём трафика исчерпан |
| API аккаунта | 60 запросов в минуту | API возвращает `429` с `Retry-After` |
| SERP API | Месячный объём запросов вашего тарифа; 1 запрос возвращает 1 страницу выдачи | API возвращает `403` с `quota_exceeded` |

### Допустимое использование

Весь трафик должен соответствовать законодательству и [правилам допустимого использования](https://proxonym.com/ru/acceptable-use). Определяющим является текст правил. Если кратко, Proxonym нельзя использовать для:

- мошенничества, фишинга, обманных схем или любой другой незаконной деятельности;
- несанкционированного доступа, например подстановки украденных учётных данных (credential stuffing), захвата аккаунтов, подбора паролей перебором или сканирования систем без разрешения;
- спама и нежелательных массовых рассылок;
- атак типа «отказ в обслуживании» или намеренной перегрузки сайтов;
- распространения вредоносного ПО или управления ботнетами;
- незаконного сбора персональных данных.

Запросы к ресурсам, заблокированным согласно правилам, получают от прокси `403`. Некоторые чувствительные сценарии использования требуют проверки, прежде чем их разрешат; клиенты с выделенными прокси дата-центров могут запросить её через тикет.

### Разумное использование

У тарифов на безлимитные резидентные прокси и уровня трафика «Без ограничений» для общих прокси дата-центров нет лимита трафика. На них распространяется принцип разумного использования согласно правилам допустимого использования. Для стабильно больших объёмов комбинируйте несколько тарифов; см. «[Proxonym для команд](https://proxonym.com/ru/enterprise)».

## Рекомендации

### Повторное использование соединений

Каждое новое соединение обходится в TCP-рукопожатие, `CONNECT` и TLS-рукопожатие. Используйте один клиент на задачу: `requests.Session`, один `aiohttp.ClientSession`, один `ProxyAgent` в undici, один `http.Client` в Go или один `HttpClient` в .NET. Учитывайте, как повторное использование соединений влияет на ротацию:

- Повторно используемое HTTPS-соединение сохраняет свой туннель, а значит, и IP. Чтобы получать новый IP на каждый запрос, каждый раз открывайте новое соединение или управляйте IP явно с помощью ID сессий.
- В sticky-сессиях повторное использование только на пользу: тот же IP, меньше рукопожатий.

### Повторы с экспоненциальной задержкой

При больших объёмах часть сбоев неизбежна: участники резидентной сети уходят в офлайн, а медленные сайты не успевают ответить. Повторяйте запросы при `429`, `502`, `503`, `504` и сетевых ошибках с экспоненциальной задержкой и случайным разбросом (jitter) — до 3–5 попыток. Не повторяйте запросы, получившие от прокси `402`, `403` или `407`: тут нужно исправление, а не новая попытка.

**Python**

```python
import random
import time

import requests

PROXY = "http://USERNAME-country-us:PASSWORD@gw.proxonym.com:8000"
PROXIES = {"http": PROXY, "https": PROXY}
RETRY_STATUS = {429, 502, 503, 504}
NO_RETRY = ("402", "403", "407")

def fetch(url: str, attempts: int = 4) -> requests.Response:
    for attempt in range(1, attempts + 1):
        try:
            r = requests.get(url, proxies=PROXIES, timeout=(10, 60))
            if r.status_code not in RETRY_STATUS:
                return r
        except requests.exceptions.ProxyError as e:
            # The proxy refused the tunnel: 402, 403 and 407 need a fix, not a retry
            if any(f"failed: {code}" in str(e) for code in NO_RETRY):
                raise
        except (requests.exceptions.ConnectionError, requests.exceptions.Timeout):
            pass
        if attempt < attempts:
            time.sleep(min(30, 2 ** attempt) + random.random())  # 2, 4, 8 s plus jitter
    raise RuntimeError(f"{url}: still failing after {attempts} attempts")
```

Каждый повтор без параметра сессии уходит с нового IP. В sticky-сессиях после повторяющихся ошибок `502` или `504` переходите на новый ID сессии.

### Подбирайте локацию под целевой сайт

- Используйте выходные IP на том рынке, чей контент вам нужен: цены, позиции в выдаче и реклама зависят от страны и города.
- Согласуйте с IP и остальные параметры запроса: `Accept-Language`, валюту, а в браузерах — часовой пояс и локаль.
- Не сужайте таргетинг больше необходимого. У таргетинга по стране самый большой пул и меньше всего ошибок `502`.

### Соблюдайте robots.txt и условия сайтов

- Прежде чем собирать данные, прочитайте `robots.txt` и условия использования сайта и соблюдайте их.
- Ограничивайте частоту запросов к каждому домену, чтобы обход не замедлял сайт для его пользователей.
- Собирайте публичные данные, а любые персональные данные обрабатывайте в соответствии с применимым законодательством. Прокси повышают долю успешных запросов, но не позволяют обходить закон или условия сайта.

Наши резидентные и мобильные IP предоставляют люди, которые дали согласие через партнёрские приложения и SDK, получили всю необходимую информацию и могут в любой момент отказаться от участия. Как устроена сеть, читайте на странице «[Этика и происхождение IP](https://proxonym.com/ru/ethics)».

### Отслеживайте долю успешных запросов

- Записывайте в лог код ответа, домен целевого сайта, параметры имени пользователя и задержку каждого запроса.
- Отслеживайте долю успешных запросов по каждому сайту и каждой стране. Падение на одном сайте обычно означает, что он изменил защиту; падение везде указывает на вашу конфигурацию или аккаунт.
- Настройте оповещения по кодам прокси: рост `407` или `402` означает проблему с настройкой или оплатой, рост `502` часто указывает на слишком узкий таргетинг, а `504` — на медленные целевые сайты.
- Следите за трафиком в личном кабинете или через `GET /usage` и выделяйте каждому проекту отдельного субпользователя, чтобы расход учитывался правильно.

Чтобы подобрать тип IP для каждого сайта, прочитайте наше сравнение [резидентных прокси и прокси дата-центров](https://proxonym.com/ru/blog/residential-vs-datacenter-proxies) и [сценарий использования для парсинга сайтов](https://proxonym.com/ru/use-cases/web-scraping).

- [Интеграции](https://proxonym.com/ru/integrations): Пошаговая настройка 12 инструментов
- [Справочник API](https://proxonym.com/ru/docs/api): Аккаунт, расход, списки прокси, SERP API
