Руководство по настройке прокси: как подключить резидентные прокси

Создайте аккаунт на странице регистрации, и вы получите один токен доступа в формате pm_XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX. Этот же токен служит для входа на сайт и работает как пароль прокси.

Сервер хранит только хеш токена и его последние 4 символа. Сохраните его в менеджере паролей или другом надежном месте, прежде чем покинуть страницу.

Потерянный токен восстановить нельзя. В коде читайте его из переменной окружения, чтобы он никогда не попал в репозиторий.

С одного IP-адреса можно создать до 3 аккаунтов, а для входа доступно 10 попыток за 10 минут.

Прокси списываются с баланса, поэтому сначала пополните его. Один баланс покрывает ротируемые резидентные прокси, статические ISP прокси, серверные прокси и мобильные прокси.

Трафик ротируемых резидентных стоит от $0.80/GB, мобильный трафик от $4.00/GB, оплата за использованное. Например, $100 на ротируемые резидентные дают трафик объемом $100, деленные на $0.80/GB. Суммы пополнения и бонусы на странице цен.

Имя пользователя начинается с user и дополняется необязательными частями через -. Пароль всегда ваш токен доступа. Без дополнительных частей вы получаете ротируемый резидентный IP без выбора страны.

Если писать части в порядке тип, страна, город, сессия, их легко читать. user-country-jp-city-tokyo-session-shop1 означает IP в Токио, удерживаемый под именем сессии shop1.

Мобильные прокси таргетируются только по стране, поэтому не указывайте город при использовании type-mobile. Коды стран и списки городов на странице локаций.

HTTP и SOCKS5 используют один и тот же хост gate.proxymay.com и порт 7000. Выберите тот из трех форматов, который принимает ваш инструмент.

http://user-country-jp:[email protected]:7000
socks5://user-country-jp:[email protected]:7000
gate.proxymay.com:7000:user-country-jp:YOUR_TOKEN

Панель формирует те же строки, чтобы вы могли их скопировать. Первые две строки в формате URL; последняя для инструментов, которые ожидают host:port:user:password.

Прежде чем писать код, проверьте из терминала. Так проблемы быстро сужаются. Убедитесь, что ip, country и city в ответе соответствуют вашему имени пользователя.

curl -x http://user-country-us:[email protected]:7000 https://ipinfo.io/json

# Same check over SOCKS5
curl -x socks5h://user-country-us:[email protected]:7000 https://ipinfo.io/json

С socks5h DNS-запросы тоже идут через прокси.

В requests укажите один и тот же URL для http и https в словаре proxies. Этот пример удерживает японский IP в сессии shop1.

import requests

proxy = "http://user-country-jp-session-shop1:[email protected]:7000"
proxies = {"http": proxy, "https": proxy}

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

Для SOCKS5 выполните pip install requests[socks] и смените схему на socks5h://.

В Scrapy укажите proxy в meta запроса, и встроенный middleware выполнит аутентификацию. Дайте каждому запросу свое имя сессии, если нужен другой IP для каждой страницы.

import scrapy

class IpSpider(scrapy.Spider):
    name = "ipcheck"

    def start_requests(self):
        proxy = "http://user-country-gb:[email protected]:7000"
        yield scrapy.Request("https://ipinfo.io/json", meta={"proxy": proxy})

    def parse(self, response):
        yield response.json()

В Node.js 18 и новее передайте ProxyAgent из undici как dispatcher для fetch. Если вы используете axios, передайте тот же URL пакету https-proxy-agent.

// npm install undici
import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://user-country-de:[email protected]:7000");
const res = await fetch("https://ipinfo.io/json", { dispatcher: agent });
console.log(await res.json());

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

// Playwright
const { chromium } = require("playwright");

const browser = await chromium.launch({
  proxy: {
    server: "http://gate.proxymay.com:7000",
    username: "user-country-fr-city-paris-session-web1",
    password: "YOUR_TOKEN",
  },
});
const page = await browser.newPage();
await page.goto("https://ipinfo.io/json");

// Puppeteer
const browser2 = await puppeteer.launch({ args: ["--proxy-server=http://gate.proxymay.com:7000"] });
const page2 = await browser2.newPage();
await page2.authenticate({ username: "user-country-fr", password: "YOUR_TOKEN" });

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

Без части session каждый запрос получает новый IP. Это подходит для независимых запросов, таких как проверка позиций или сбор цен.

Вход в аккаунт, корзины и многошаговые сценарии могут ломаться при смене IP. Добавьте session-name, чтобы сохранить тот же IP до 120 минут.

• Дайте каждой задаче свое имя сессии (например cart1, cart2).
• Чтобы сменить IP, просто измените имя сессии.
• Если один и тот же IP нужен на целый месяц, лучше подойдут статические ISP прокси.

• 407 Proxy Authentication Required: неверный формат имени пользователя или токен. Проверьте, что имя начинается с user, части разделены -, а в токене нет лишних пробелов.
• Подключение отклонено или тайм-аут: перепроверьте хост gate.proxymay.com и порт 7000 и убедитесь, что файрвол не блокирует исходящие подключения к этому порту. Также проверьте, что на балансе остались средства.
• Показывается не та страна: проверьте, что код страны из двух букв, а город написан строчными буквами с _. Сначала выполните проверку curl, затем ищите кеширование или другую настройку прокси в коде.
• Сессия сменилась через 120 минут: это ожидаемо, потому что фиксированная сессия длится до 120 минут. Разделите работу так, чтобы она укладывалась в это окно, или начните заново с новым именем сессии.

Больше ответов собрано в разделе вопросов и ответов.

Используйте ProxyMay для сбора открытых данных, проверки рекламы, проверки позиций в поиске, мониторинга цен, тестирования сайтов и локализации и управления собственными аккаунтами. Несанкционированный доступ к чужим аккаунтам, спам, мошенничество, атаки, незаконный контент и все, что нарушает закон или права целевого сайта, запрещены.

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