Руководство по использованию

Все настройки гео-таргетинга и ротации задаются прямо в логине путём добавления специальных суффиксов. Пароль и хост/порт никогда не меняются — меняется только логин.

Форматы подключения

# HTTP
http://your_username:[email protected]:5000

# HTTPS (тот же URL — TLS устанавливается после CONNECT)
http://your_username:[email protected]:5000

# SOCKS5
socks5://your_username:[email protected]:1080

curl

# HTTP
curl -x http://your_username:[email protected]:5000 https://ipinfo.io

# SOCKS5
curl --socks5 v1.soxway.io:1080 -U your_username:your_password https://ipinfo.io

Python (requests)

import requests

proxies = {
    "http":  "http://your_username:[email protected]:5000",
    "https": "http://your_username:[email protected]:5000",
}

r = requests.get("https://ipinfo.io/json", proxies=proxies)
print(r.json())

Node.js (axios)

import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';

const agent = new HttpsProxyAgent(
    'http://your_username:[email protected]:5000'
);

const res = await axios.get('https://ipinfo.io/json', { httpsAgent: agent });
console.log(res.data);

Гео-таргетинг (суффиксы логина)

Добавляйте суффиксы к логину, чтобы выбрать локацию. Суффиксы можно комбинировать в любом порядке, но рекомендуемый порядок — гео → сессия → ttl.

Значения из нескольких слов: используйте дефис - вместо пробела — например _city-new-york. Шлюз приводит это к виду, который ожидает пул.

# Только США — ротация
socks5://your_username_country-US:[email protected]:1080

# Германия + регион Бавария
http://your_username_country-DE_region-bavaria:[email protected]:5000

# Великобритания + город Лондон
http://your_username_country-GB_city-london:[email protected]:5000

Режимы ротации

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

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

socks5://your_username_country-GB:[email protected]:1080

Стабильный — _s-SessionID

Один IP удерживается столько, сколько позволяет пул. Один и тот же Session ID всегда указывает на один и тот же IP.

socks5://your_username_country-GB_s-mySessionId:[email protected]:1080

Sticky — _s-SessionID + _ttl-Nm

IP удерживается N минут, затем ротируется. Разные Session ID дают разные IP.

# тот же IP на 30 мин, затем ротация
socks5://your_username_country-GB_s-ee2323b3_ttl-30m:[email protected]:1080

# другой ID → другой IP
socks5://your_username_country-GB_s-ee2323b4_ttl-30m:[email protected]:1080

# все параметры вместе
socks5://your_username_country-GB_region-england_city-london_s-abc123_ttl-60m:[email protected]:1080

_ttl- принимает минуты (_ttl-30m) или часы (_ttl-2h). _ttl- можно использовать и без _s- — тогда шлюз сам сгенерирует сессию, и режим станет sticky.

Полный справочник суффиксов логина

{token}[_country-XX][_region-Name][_city-Name][_isp-Name][_s-SessionID][_ttl-Nm]

• Сначала гео-суффиксы, затем сессия _s-, затем _ttl- для sticky.
• _s-SessionID включает стабильный режим; добавьте _ttl-Nm для sticky (с ограничением по времени).
• Разные Session ID всегда дают разные IP.
• Вся строка — это логин прокси; пароль не меняется.

Матрица поддержки гео по типам прокси

Суффиксы всегда принимаются шлюзом, но что именно учитывает каждый пул — различается. Неподдерживаемые суффиксы молча игнорируются.

Легенда

• ✅ поддерживается — ❌ игнорируется этим пулом.
• 🔒 фикс. — локация 4G Mobile задаётся при покупке; гео-суффиксы её не меняют.
• 🔄 API — ротация 4G Mobile управляется через API, а не через суффиксы логина.
• ≤120m — время жизни sticky-сессии ограничено 120 минутами; большие значения обрезаются.
• по умолч. Nm — если задать _s- без _ttl-, применяется время жизни sticky по умолчанию.