Завантаження списку проксі у потрібному форматі: txt, CSV, API

Що таке список проксі?

Список проксі - це файл, де кожен куплений вами проксі записаний у окремому рядку. Більшість краулерів, інструментів автоматизації, антидетект-браузерів та програм для управління акаунтами можуть завантажувати такі списки для ротації проксі або призначення окремого проксі для кожного акаунта.

Оскільки різні інструменти підтримують різні формати, одні й ті ж проксі потрібно адаптувати. Socks5Proxy дозволяє обрати популярні формати заздалегідь, щоб вам не доводилося редагувати список після завантаження.

Якщо ви вручну редагуєте список, навіть пропущена двокрапка може призвести до того, що інструмент не зможе прочитати весь рядок. Отримання списку у правильному форматі з самого початку допоможе уникнути таких помилок, і навіть якщо ви купите новий план і список зміниться, ви зможете просто завантажити його у тому ж форматі.

In what formats can I download the proxy list?

На сторінці моїх проксі на панелі керування або через API виберіть один із наведених нижче форматів. Якщо вибрати HTTP, буде використовуватися HTTP порт, якщо SOCKS5 - SOCKS5 порт.

Формат можна змінити та завантажити знову. Ви можете отримати список IP для краулера у форматі http:// та для браузера у форматі socks5://, але самі IP та облікові дані залишаться незмінними.

Де завантажити список проксі?

Після оплати список IP з’явиться у розділі моїх проксі у панелі керування. Ви можете обрати формат, протокол, країну та план у верхній частині та завантажити файл у форматі .txt або .csv. Якщо ви придбали кілька планів, ви можете завантажити їх одним файлом або розділити за планами чи країнами.

Список відображається у таблиці з фіксованою висотою та прокруткою. Кожен рядок має кнопку копіювання, тому для невеликої кількості IP файл не потрібен.

Назва файлу містить формат та дату отримання, тому навіть якщо ви завантажуєте його кілька разів, легко визначити, який файл є найновішим. CSV-файли містять назви стовпців у першому рядку, тому при відкритті в електронній таблиці вони відразу відображаються у вигляді таблиці.

На екрані списку можна фільтрувати за країною, планом та терміном дії, а також завантажувати відфільтровані результати у файл. Наприклад, вибравши лише виділені ISP IP для США, можна одразу створити таблицю для зіставлення облікових записів у форматі CSV.

Як отримати список проксі через API?

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

Списки доступні за двома адресами. /proxies повертає JSON список з IP, портом, ім’ям користувача, паролем, країною, містом та терміном дії. /proxies/download повертає текст у вибраному форматі рядок за рядком. Обидві адреси дозволяють фільтрувати за країною (country) та протоколом (protocol).

Для API-запитів використовуйте API-ключі, а не токен облікового запису. Токен використовується лише для входу в панель керування, а API-ключі - для програмних операцій, таких як отримання списків. Навіть якщо ключі стануть відомими, вхід у обліковий запис залишається безпечним. Запити приймаються лише через HTTPS.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://socks5proxy.io/api/v1/proxies/download?protocol=http&format=ip:port:user:pass"

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://socks5proxy.io/api/v1/proxies?country=us"

import itertools, requests

API = "https://socks5proxy.io/api/v1/proxies/download"
lines = requests.get(API, params={"protocol": "http", "format": "url"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}, timeout=20).text.split()
pool = itertools.cycle(lines)

for url in ["https://example.com/a", "https://example.com/b"]:
    p = next(pool)
    print(requests.get(url, proxies={"http": p, "https": p}, timeout=20).status_code)

Як змінюється список при використанні IP-авторизації?

IP-авторизація дозволяє підключатися без пароля лише з зареєстрованих публічних IPv4-адрес вашого сервера. Максимум 10 адрес.

З IP-авторизацією ви отримуєте список у форматі ip:port, який можна використовувати без пароля. Оскільки паролі не включені у файл списку, налаштування можна ділити без ризику витоку даних. Для ноутбуків зі змінними місцями підключення зручніше використовувати ім'я користувача та пароль.

Додавайте публічні IPv4-адреси вашого сервера або комп’ютера, з яких відбувається підключення до проксі. Не плутайте з IP проксі. Вашу публічну IP можна перевірити та додати прямо в панелі керування.

Чи є поради щодо завантаження списку проксі в інструменти?

• Для керування акаунтами зручно використовувати CSV-файли, де акаунти та IP-адреси зіставлені в одній таблиці.
• Скрапери зазвичай приймають формат http:// та перемикаються на наступний проксі для кожного запиту.
• Anti-detect browsers accept the socks5:// format, one line per profile.
• Якщо ви розділяєте завдання за країнами, застосовуйте фільтр за країною та завантажуйте файли окремо для кожної.
• Новий план додає нові IP до тієї ж API-адреси, тому завантажуйте список щоразу перед початком роботи.

Яка інформація міститься у списку проксі?

У рядку містяться IP, HTTP-порт, SOCKS5-порт, ім’я користувача та пароль. У CSV та JSON також додаються код країни, місто та термін дії плану. Доступні країни: датацентрові - 47, ISP - 19.

Усі IP-адреси є IPv4 і залишаються незмінними протягом усього терміну дії плану. Тому список, отриманий один раз, можна використовувати до кінця терміну.

Кожен запис у JSON-списку містить тип тарифу, тому ви можете програмно розрізняти спільні, приватні та виділені IP. Наприклад, виділені IP можна використовувати для входу в акаунти, а спільні - лише для збору відкритих даних.

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

Як безпечно зберігати файл зі списком проксі?

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

Якщо вам потрібно зберігати дані проксі у сховищі коду, увімкніть IP-авторизацію та використовуйте формат ip:port. Без паролю, навіть якщо файл потрапить до сторонніх осіб, підключитися зможуть лише сервери, які ви зареєстрували.

Поводьтеся з API-ключами так само. Якщо ви підозрюєте, що ключ став відомим, створіть новий у панелі керування - старий ключ буде негайно заблоковано.

Як перевірити підключення після отримання списку?

Найпростіший спосіб - надсилати запити на кожен IP зі списку. Якщо відповідь містить той самий IP, з’єднання працює правильно. Ви можете перевірити сотні IP за кілька хвилин за допомогою короткого скрипту, як у прикладі з циклом cURL нижче.

Під час перевірки не відкривайте занадто багато зʼєднань одночасно. Якщо у вас спільний план, діліть перевірку між 500 одночасними зʼєднаннями. Якщо деякі рядки не працюють, спочатку перевірте, чи ви правильно вказали HTTP-порт і SOCKS5-порт, а також чи правильно налаштовано автентифікацію.

while read p; do
  echo "$p $(curl -s -m 15 -x "$p" https://api.ipify.org)"
done < proxies.txt

Що потрібно купити, щоб отримати список проксі?

Завантаження списків та API включено в усі плани. Спільні дата-центри доступні від 100 IP, ціна за один IP на місяць починається з $0.0179, ISP, приватні та виділені плани також отримують списки однаково.

Увійдіть за допомогою токену акаунту, поповніть баланс і придбайте план - список буде створено одразу. Мінімальна сума поповнення: $30.

Якщо ви купуєте кілька типів планів, всі списки зберігаються в одному місці. Якщо хочете окремо завантажити спільні датацентр списки та виділені ISP списки, застосуйте фільтр планів. Якщо хочете завантажити все одним файлом, не застосовуйте фільтр.