Официальная документация GeekProxy
Добро пожаловать в документацию GeekProxy! Здесь вы найдете всю необходимую информацию для начала работы с нашими резидентскими прокси.
Наша надежная сеть отлично подходит для веб-скрапинга, автоматизации и поддержания безопасности при мультиаккаунтинге. Если вам нужна помощь, не стесняйтесь обращаться в нашу службу поддержки через круглосуточный онлайн-чат на сайте или по электронной почте.
1. Типы подключений и протоколы
Мы предлагаем два основных типа подключений: Ротационные (Rotating) и Статические (Sticky). Наша сеть поддерживает протоколы HTTP, HTTPS и SOCKS5.
Ротационные прокси
При использовании ротационного подключения ваш IP-адрес автоматически меняется при каждом отправляемом запросе.
- HTTP/HTTPS: Используйте порт
823 - SOCKS5: Используйте порт
824
Примеры ротационных подключений:
HTTP: curl -x "http://login:[email protected]:823" https://api.ipify.org/
SOCKS5: curl -x "socks5://login:[email protected]:824" https://api.ipify.org/
Статические прокси
Статические прокси работают на основе портов, что означает привязку IP-адреса к определенному порту на заданный период времени.
- Вы можете использовать порты в диапазоне от
10000до20000для статических сессий. - Интервал ротации можно настроить в пределах от 1 до 120 минут.
- Если интервал ротации не указан (или установлен на "0"), продолжительность по умолчанию составляет 30 минут.
Примеры статических подключений (с использованием порта 10000):
HTTP: curl -x "http://login:[email protected]:10000" https://api.ipify.org/
SOCKS5: curl -x "socks5://login:[email protected]:10000" https://api.ipify.org/
2. Хосты для подключения
У вас есть два варианта подключения к нашей прокси-сети:
- DNS-хост (
rs.geekproxy.io): Мы настоятельно рекомендуем использовать формат DNS для большей стабильности. Система автоматически направит ваши запросы через оптимальный сервер на основе вашего местоположения и настроек таргетинга. - IP-хост (
67.213.121.89): Вы можете подключиться напрямую по IP. Ваше соединение все равно будет направлено на лучший доступный сервер в зависимости от выбранной вами страны.
3. Таргетинг и настройка
Вы можете настроить параметры прокси как непосредственно в Панели управления (не забудьте нажать «Сохранить конфигурацию», чтобы применить изменения), так и Вручную, добавив определенные параметры после имени пользователя, разделенные двойным подчеркиванием (__). Ключи и значения разделяются точкой (.), а несколько параметров разделяются точкой с запятой (;).
Базовый таргетинг (включен в базовую стоимость)
Эти опции уже включены в базовую стоимость прокси и дополнительно не тарифицируются.
- Выбор страны (
cr): Укажите страну для запроса. Пример для Германии:__cr.de. Для нескольких стран:__cr.de,au. - Исключение страны (
nocr): Исключение определенных стран при использовании пула "Все страны". Пример исключения Германии:__nocr.de. - Исключение ASN (
noasn): Исключение ASN определенного провайдера из ответа. Пример:__noasn.as20947.
Целевые фильтры (Тарифицируются по двойной ставке)
Трафик, проходящий через фильтры штата, города, почтового индекса (ZIP) и ASN, тарифицируется по двойной ставке. Выбор страны (cr) обязателен при использовании этих фильтров. Если для вашей целевой локации в данный момент нет доступных IP, вы получите ошибку 400 NO_RAY.
- Штат (
state/nostate): Выбор или исключение определенного штата США. Пример для Аризоны:__cr.us;state.arizona. - Город (
city/nocity): Выбор или исключение определенных городов. Пример для Берлина:__cr.de;city.berlin. - Почтовый индекс (
zip/nozip): Выбор или исключение 5-значного почтового индекса. Пример:__cr.us;zip.10001. - ASN (
asn): Выбор определенных провайдеров. Пример для ASN 39603 в Польше:__cr.pl;asn.39603.
Управление сессиями и анонимностью
- ID сессии (
sessid): Подключение к определенному IP-адресу в среднем на 30 минут с использованием произвольной строки или числа. Пример:__cr.au;sessid.123. - Интервал сессии (
sessttl): Управление частотой ротации (в минутах) для статических прокси. Пример 60-минутной ротации во Франции:__cr.fr;sessttl.60. - Анонимность (
anon): Получение исключительно высокоанонимных прокси из пула. (Примечание: включение этой опции может уменьшить общий размер пула). Пример:__anon.
4. Аутентификация, лимиты и порты
Методы аутентификации
- Логин и пароль: Стандартная аутентификация
User:pass. Учетные данные автоматически генерируются в разделе "Доступ к прокси" после покупки плана. - Белый список IP: Привяжите свой статический IP-адрес для беспрепятственного доступа к сети без ввода логина и пароля для каждого запроса. (Примечание: один и тот же IP нельзя добавить в белый список на нескольких тарифных планах одновременно).
Системные лимиты
- Потоки: Каждый план ограничен 2000 активными потоками (одновременными соединениями). Превышение этого лимита возвращает ошибку
407 THREADS_EXHAUSTED. Чтобы увеличить этот лимит, обратитесь в поддержку (требуется проверка KYC). - UDP-подключения: Мы поддерживаем UDP-подключения; по умолчанию они отключены для всех пользователей. Для включения UDP необходимо предоставить подробное описание вашего сценария использования и пройти проверку KYC.
Доступ к портам
- Доступные порты (по умолчанию):
80,443,5228,53,5060,8080,8090,8443,853. - Ограниченные порты: Порты, связанные с рассылками и сообщениями (например, SMTP, IMAP), строго заблокированы.
- Процедура разблокировки: Свяжитесь с поддержкой, четко описав сценарий использования и целевое назначение, чтобы запросить разблокировку порта. В целях безопасности может потребоваться проверка KYC.
5. Коды ошибок
Ошибки отображаются либо в HTTP-ответе прокси-сервера, либо через коды состояния подключения SOCKS5. Вы можете отслеживать все ошибки прямо в панели управления аккаунтом.
- HTTP-код Описание
- 400 Bad Request Запрос CONNECT к прокси-серверу сформирован неверно.
- 403 PORT_BLOCKED Попытка подключения к заблокированным портам.
- 403 SITE_PERMANENTLY_BLOCKED Доступ к указанному сайту заблокирован навсегда.
- 403 HOST_BLOCKED Доступ к указанному сайту заблокирован пользователем в настройках текущего плана.
- 407 NO_USER План пользователя не существует.
- 407 TRAFFIC_EXHAUSTED Превышен лимит трафика по тарифному плану.
- 407 THREADS_EXHAUSTED Превышен лимит потоков по тарифному плану.
- 407 PORT_NOT_ALLOWED Используемый порт статической сессии не разрешен настройками текущего плана.
- 407 USER_BLOCKED Текущий план пользователя заблокирован.
- 500 INTERNAL_SERVER_ERROR Сервер столкнулся с непредвиденным условием, которое не позволило выполнить запрос.
- 502 NO_HOST_CONNECTION Нет подключения к хосту, указанному в запросе CONNECT.
- 503 NO_RAY Нет доступных прокси в соответствии с параметрами таргетинга, указанными в запросе.
Особенности SOCKS5:
- Для ошибок, связанных с лимитами (
NO_USER,TRAFFIC_EXHAUSTED,THREADS_EXHAUSTED), при неудачной аутентификации будет возвращен статус Denied (Отказано). - Для ошибок маршрутизации и подключения (
PORT_BLOCKED,NO_RAY,NO_HOST_CONNECTION) аутентификация пройдет успешно, но сразу после этого соединение будет сброшено. - UDP_BIND_FAILED: Не удалось привязать локальный UDP-порт (это эквивалент ошибки 502 NO_HOST_CONNECTION для UDP).