Підключення та інтеграції

Формат рядка проксі

Рядок резидентного чи мобільного проксі має вигляд host:port:login:password. Усі налаштування — локацію, тип проксі, сесію та фільтр — записано в логіні через дефіс. Нижче пояснено, які бувають параметри, у якому порядку вони йдуть і які поєднання допустимі.

Хост, порт і авторизація

Що однакове в усіх рядках резидентних і мобільних проксі.

Хост

connect.proxeta.io

Адреса шлюзу. У прикладах нижче її замінює умовний proxy.example.invalid.

Порт

8080 — HTTP, 1080 — SOCKS5

Рядки HTTP і SOCKS5 з однаковими налаштуваннями відрізняються лише портом.

Вхід лише за логіном і паролем: прив’язки за IP (білого списку адрес) немає. Пароль один для всіх ваших рядків, а логін змінюється разом із налаштуваннями. UDP не підтримується, зокрема й через SOCKS5.

Чим HTTP відрізняється від SOCKS5 і який протокол вибрати, розібрано в статті «HTTP чи SOCKS5: який протокол проксі вибрати».

З чого складається логін

Порядок параметрів завжди однаковий.

<акаунт>-country-<код>[-region-<код>][-city-<код>][-isp-<код> | -zip-<індекс>][-type-mobile][-ipv4-true][-sid-<сесія>][-<фільтр>]

Параметри у квадратних дужках необов’язкові, вертикальна риска означає «одне з двох». Параметри відокремлюються дефісом:

<акаунт>

Завжди першим

Ім’я вашого проксі-акаунта. Воно однакове в усіх ваших рядках.

country-<код>

Обов’язково

Країна: двобуквений код ISO 3166-1 малими літерами, наприклад us або de. Велика Британія — gb, а не uk.

region-<код>

Необов’язково

Регіон або штат, наприклад california.

city-<код>

Необов’язково

Місто, наприклад los_angeles. Можна вказати й без регіону.

isp-<код>

Не разом із zip

Інтернет-провайдер, а в мобільних проксі — оператор зв’язку, наприклад t_mobile_usa.

zip-<індекс>

Не разом з isp

Поштовий індекс, наприклад 90003. З ним region і city до рядка не записуються.

type-mobile

Лише в мобільних

Мобільний проксі. Без цього параметра рядок резидентний.

ipv4-true

Необов’язково

Лише IPv4. Без нього вихідна адреса може бути як IPv4, так і IPv6.

sid-<сесія>

Лише в липкій сесії

Ідентифікатор липкої сесії. Без нього рядок працює в режимі ротації.

<фільтр>

Завжди останнім

Оптимізація пулу: filter-medium, speed-fast або filter-medium-speed-fast.

Локація: країна, регіон, місто, провайдер або ZIP

Як указати місто, провайдера чи поштовий індекс.

Країна обов’язкова. Регіон і місто уточнюють локацію, їх можна вказати разом або окремо: рядок із country-us-city-miami теж допустимий.

Далі вибирають щось одне: провайдера (isp) або ZIP-код (zip). У генераторі за це відповідає перемикач «Таргетинг»: «Провайдер (ISP)» або «ZIP-код». У мобільних проксі в полі провайдера вибирають оператора зв’язку.

Якщо задано ZIP-код, регіон і місто до рядка не потрапляють: локацію визначає індекс. У генераторі вони лише звужують список ZIP-кодів.

country + region, city, isp

Можна: будь-яке з трьох уточнень, окремо чи разом.

country + zip

Можна: region і city тоді до рядка не записуються.

isp + zip

Не можна: генератор поверне помилку.

Без country

Не можна для резидентних і мобільних проксі.

type-mobile, ipv4-true, sid, фільтр

Можна з будь-якою локацією.

ZIP-коди

Генерацію за ZIP перевірено лише на числових кодах США, наприклад 90003. Коди з пробілом або дефісом генератор не приймає, а для інших країн роботу ZIP-таргетингу ми не перевіряли.

Сесія: параметр sid

Як зберегти один IP або отримувати новий.

Рядок із параметром sid — це липка сесія. Поки ви підключаєтеся з цим рядком без змін, сервіс зберігає одну вихідну IP-адресу якомога довше, доки провайдер не розірве з’єднання. Налаштування тривалості немає, і конкретного терміну ми не обіцяємо, тож перевіряйте IP після перепідключення.

Кожен рядок з однієї генерації отримує свій sid, тобто це окремі сесії. Потрібна інша адреса — візьміть інший рядок або натисніть «Перегенерувати». Значення sid складається лише з малих латинських літер і цифр, без дефісів; генератор створює його з 10 символів. Якщо ви складаєте рядки самі, для нової сесії підставте нове значення.

Рядок без sid працює в режимі ротації: кожне нове з’єднання може отримати новий IP. Запити в межах одного відкритого з’єднання (keep-alive) можуть виходити з однієї адреси.

Коли який режим вибирати, розібрано в статті «Sticky-сесія чи ротація IP».

Тип проксі, IPv4 і фільтр

Параметри після локації.

Мобільний рядок відрізняється від резидентного лише параметром type-mobile. Обидва типи витрачають один баланс трафіку. Параметр ipv4-true відповідає перемикачу «Лише IPv4».

Фільтр відповідає блоку «Оптимізація пулу» в генераторі й завжди стоїть у кінці логіна:

filter-medium

«Якість»

Фільтр якості IP. Стоїть у кабінеті за замовчуванням, і з ним Telegram-бот видає всі рядки.

speed-fast

«Швидкість»

Відбір за швидкістю замість фільтра якості.

filter-medium-speed-fast

«Якість + швидкість»

Обидва відбори одразу.

Будь-який фільтр звужує пул доступних адрес. Без параметра фільтра рядок використовує весь пул без відбору, але кабінет і бот таких рядків не видають. Шлюз розуміє й суворіший фільтр якості filter-high (разом зі швидкістю — filter-high-speed-fast), якого немає в генераторі.

Приклади рядків

Умовні дані: підставте свої з кабінету.

Місто, липка сесія, HTTP

proxy.example.invalid:8080:demo-country-us-region-california-city-los_angeles-sid-k7m2q9x4ab-filter-medium:demo-password

Мобільний оператор, лише IPv4, SOCKS5

proxy.example.invalid:1080:demo-country-us-isp-t_mobile_usa-type-mobile-ipv4-true-sid-k7m2q9x4ab-filter-medium:demo-password

ZIP-код, липка сесія

proxy.example.invalid:8080:demo-country-us-zip-90003-sid-k7m2q9x4ab-filter-medium:demo-password

Країна, ротація

proxy.example.invalid:8080:demo-country-de-speed-fast:demo-password

Де взяти коди локацій

Коди не треба підбирати вручну.

Відкрийте розділ «Створити проксі» в особистому кабінеті, виберіть країну, регіон, місто, провайдера або ZIP-код і згенеруйте рядок: коди з’являться в логіні. Списки регіонів, міст, провайдерів і ZIP-кодів залежать від типу проксі та режиму «Лише IPv4», тому коду, доступного для резидентних проксі, може не бути в мобільних.

Коди країн, регіонів і міст є й у рядках із Telegram-бота @proxetabot: знайдіть країну чи місто через пошук. Бот відповідає лише російською мовою й видає лише липкі сесії з фільтром «Якість», без вибору провайдера та ZIP-коду.

Коди пишуть малими латинськими літерами, а слова в них розділено підкресленням: los_angeles, t_mobile_usa. Якщо ви складаєте рядок самі, беріть коди лише зі згенерованих рядків: через невідомий код, зайвий параметр чи порушений порядок шлюз може відмовити в авторизації або видати IP не з тієї локації.

Рядок у вигляді URL

Для бібліотек і утиліт, які чекають адресу проксі одним рядком.

Кабінет видає рядки у форматі host:port:login:password. Багатьом програмам потрібен URL: http://login:password@host:8080 для HTTP або socks5h://login:password@host:1080 для SOCKS5 (із socks5h DNS-запит для імені сайту виконує проксі, а не ваш пристрій). Наприклад:

http://demo-country-us-sid-k7m2q9x4ab-filter-medium:demo-password@proxy.example.invalid:8080

Якщо в паролі є символи на кшталт @, : або /, закодуйте їх для URL. Приклади для curl — у статті «curl через проксі», для Python і Playwright — у статті «Проксі в Python: requests, httpx і Playwright».

ISP-проксі

Статичні адреси влаштовано інакше.

Параметри з цієї статті стосуються лише резидентних і мобільних проксі. Дані ISP-проксі фіксовані: IP, порт, логін і пароль зазначено в замовленні на вкладці «Мої проксі». Країну вибирають під час замовлення, а регіон, місто, провайдера, ZIP-код і сесію не налаштовують.

Не публікуйте рядки

У кожному рядку є пароль вашого акаунта. Не публікуйте рядки у відкритих репозиторіях, чатах і на форумах та не передавайте їх третім особам.