Проксі з авторизацією в Node.js: Axios, нативний fetch і Got
Від інженерної команди ProxyV4 · Updated:
Надійний спосіб використовувати проксі в Node.js з Axios — передати HttpsProxyAgent як httpsAgent разом із proxy: false. Власне налаштування Axios proxy: { host, port } не відкриває тунель HTTP CONNECT, тому видає помилку на URL-адресах https://; нативному ж fetch() натомість потрібен ProxyAgent з undici. На цій сторінці показано роботу з кожним клієнтом через URL ProxyV4 http://user:pass@ip:port та перевірку вихідної IP-адреси.
new HttpsProxyAgent('http://user:pass@ip:port')- 1 IP1,85 USD
- Від 3 IP1,70 USD
- Від 10 IP1,60 USD
- Від 25 IP1,50 USD
- Від 50 IP1,40 USD
- Від 100 IP1,30 USD
- Від 200 IP1,20 USD
- Від 500 IP1,10 USD
- 1 IP1,85 USD
- Від 3 IP1,70 USD
- Від 10 IP1,60 USD
- Від 25 IP1,50 USD
- Від 50 IP1,40 USD
- Від 100 IP1,30 USD
- Від 200 IP1,20 USD
- Від 500 IP1,10 USD
Виберіть фрагмент коду для свого HTTP-клієнта
Усі три клієнти приймають однаковий URL проксі. Сформуйте його з рядка ip:port:user:pass у вашому замовленні; схема залишається http://, оскільки клієнт звертається до проксі через HTTP і тунелює TLS крізь нього.
| Клієнт | Встановлення | Підключення проксі |
|---|---|---|
| Axios | npm i https-proxy-agent | axios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false }) |
Нативний fetch (Node 18+) | npm i undici | fetch(url, { dispatcher: new ProxyAgent('http://user:pass@ip:port') }) |
| Got | npm i hpagent | got(url, { agent: { https: new HttpsProxyAgent({ proxy: 'http://user:pass@ip:port' }) } }) |
Чому параметр `proxy: false` важливий в Axios
Axios автоматично перевіряє змінні середовища HTTP_PROXY та HTTPS_PROXY. Якщо одну з них задано на машині (типова ситуація в CI-раннерах і контейнерах) і ви водночас передаєте агент, ці дві конфігурації конфліктують. Параметр proxy: false вказує Axios ігнорувати змінні середовища та вбудовану логіку проксі, тому маршрут запиту визначає виключно агент.
Повторне використання агентів для багатьох запитів
- Створюйте один агент на кожну IP-адресу проксі за межами циклу запитів; агент утримує сокети keep-alive, тоді як створення нового агента для кожного виклику скидає їх
- Якщо проксі кілька, зберігайте
Mapвідповідності IP до агента та беріть потрібний звідти, замість створення агентів на льоту - Задавайте для кожного виклику
timeout(наприклад,timeout: 10000в Axios), щоб завислий цільовий сервер не блокував воркер назавжди - Потрібен список проксі у вигляді даних? Конвертер форматів проксі перетворює рядки
ip:port:user:passна масив JSON, який можна підключити черезrequireабоimport
Що дає стабільна IP-адреса для задач на Node.js
Приватна адреса IPv4 від ProxyV4 належить лише одному клієнту протягом усього періоду оренди та зберігає ту саму адресу при продовженні. Завдяки цьому дозволені списки API, авторизовані сесії чи ліміти запитів, прив'язані до цієї IP, залишаються дійсними між розгортаннями. Трафік не тарифікується, що робить роботу тривалих воркерів передбачуваною. Шаблони збору даних та налаштування темпу дивіться у розділі вебскрейпінг.
Покрокова інструкція
- 1
Встановіть клієнт та агент
Виконайте команду
npm install axios https-proxy-agentу проєкті (абоnpm install undici, якщо використовуєте нативнийfetch). - 2
Створіть агент один раз
Створіть
const agent = new HttpsProxyAgent('http://user:pass@ip:port');зі значеннями з вашого замовлення ProxyV4. - 3
Надішліть запит через нього
Викличте
const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });. - 4
Звірте IP-адресу
console.log(res.data)має вивести IP-адресу проксі. Якщо виводиться власна адреса вашого сервера, агент не було застосовано.
Часті запитання
Чому налаштування Axios proxy: { host, port, auth } не працює на сайтах HTTPS?
Цей параметр надсилає звичайний HTTP-запит до проксі замість попереднього запиту на тунель HTTP CONNECT, тому TLS-з'єднання з цільовим сервером не встановлюється належним чином. Використовуйте httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port') та вкажіть proxy: false.
Як додати проксі до нативного fetch() у Node 18, 20 чи 22?
Функція fetch у Node працює на базі undici, тому імпортуйте ProxyAgent з undici та передайте { dispatcher: new ProxyAgent('http://user:pass@ip:port') } у параметрах fetch().
Мій пароль містить @ або :. Чи порушить це структуру URL?
Може порушити, оскільки ці символи мають спеціальне призначення в URL. Застосуйте percent-encoding для пароля за допомогою encodeURIComponent(password) перед формуванням http://user:pass@ip:port.
Запит повертає помилку 407. Що не так?
Проксі відповів, але відхилив авторизацію. Перевірте логін і пароль зі свого замовлення; поширені причини перелічені на сторінці вирішення помилки 407.
Джерела
Статичні IPv4 для ваших воркерів Node.js
Приватні IPv4 у 7 країнах та статичні ISP у США та В'єтнамі: безлімітний трафік, один клієнт на IP. Купуйте від однієї адреси до великих пулів.
Переглянути актуальні ціни для США