# Прокси для fetch в Node.js

Source: https://ipvolt.com/ru/guides/nodejs-fetch-proxy
Markdown: https://ipvolt.com/ru/guides/nodejs-fetch-proxy.md
Language: ru

[ipvolt — главная](https://ipvolt.com/ru.md) / [Руководства](https://ipvolt.com/ru/guides.md) / Прокси для fetch в Node.js

Интеграция
Проверено: 2026-09-10
4 мин чтения
Автор: ipvolt

Направьте встроенный fetch в Node.js через ProxyAgent из Undici с явной аутентификацией, крайним сроком через abort и корректной очисткой ответа.

## С чего начать

Используйте dispatcher для одного вызова fetch, чтобы прокси был задан явно, а другие сетевые клиенты в вашем процессе сохранили собственную конфигурацию.

## Выберите совместимую среду выполнения и dispatcher

Этот серверный пример рассчитан на Node.js 24 и Undici 7. В отдельном примерном проекте выполните npm install undici@7. Встроенный fetch в Node принимает dispatcher, совместимый с Undici. Это отличается от fetch в браузере, где JavaScript страницы не может выбрать произвольный системный прокси.

Укажите в PROXY_URL документированный провайдером HTTP(S)-шлюз, например намеренно нерабочий https://proxy.example.invalid:8443. Передавайте PROXY_USERNAME и PROXY_PASSWORD через менеджер секретов вашего развёртывания. Не помещайте учётные данные шлюза во фронтенд-код.

## Держите аутентификацию на прокси в dispatcher

Сохраните как proxy-check.mjs и запустите node proxy-check.mjs. Токен Basic принадлежит агенту прокси, а не заголовку Authorization целевого сервера. У запроса есть 30-секундный крайний срок через abort, и он не следует редиректам автоматически.

### proxy-check.mjs · Node.js 24 + Undici 7

```javascript
import { ProxyAgent } from 'undici';

function required(name) {
  const value = process.env[name];
  if (!value) throw new Error('Missing environment variable: ' + name);
  return value;
}

const gateway = new URL(required('PROXY_URL'));
if (!['http:', 'https:'].includes(gateway.protocol) || gateway.username || gateway.password) {
  throw new Error('Use a credential-free HTTP(S) proxy URL');
}
const credentials = required('PROXY_USERNAME') + ':' + required('PROXY_PASSWORD');
const dispatcher = new ProxyAgent({
  uri: gateway.href,
  token: 'Basic ' + Buffer.from(credentials).toString('base64'),
});

try {
  const response = await fetch('https://example.com/', {
    dispatcher,
    signal: AbortSignal.timeout(30_000),
    redirect: 'manual',
  });
  await response.body?.cancel();
  if (!response.ok) throw new Error('Destination HTTP ' + response.status);
  console.log({ status: response.status });
} finally {
  await dispatcher.close();
}
```

## От диагностики к воркеру

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

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

- HTTP-ошибка — это ответ; fetch не отклоняет промис лишь потому, что статус 4xx или 5xx.
- Отказ на этапе CONNECT может проявиться как сбой fetch ещё до того, как появится Response от целевого сервера.
- Фиксируйте очищенные категории ошибок; не логируйте токен Basic или полные URL с учётными данными.

## Перед выпуском

- Используйте документированные мажорные версии Node и Undici.
- Передавайте dispatcher явно.
- Читайте или отменяйте тела ответов и закрывайте агент.

## Источники и дополнительное чтение

- [Node.js: fetch and custom dispatchers](https://nodejs.org/api/globals.html#fetch)
- [Undici 7: ProxyAgent authentication and lifecycle](https://github.com/nodejs/undici/blob/v7.16.0/docs/docs/api/ProxyAgent.md)
- [Undici: runtime support and response body handling](https://github.com/nodejs/undici)

## Связанные руководства

- [Прокси в curl: флаг -x, переменные окружения, SOCKS5, аутентификация](https://ipvolt.com/ru/guides/curl-proxy-setup.md)
- [Переменные окружения прокси: HTTP_PROXY и NO_PROXY](https://ipvolt.com/ru/guides/proxy-environment-variables.md)
- [HTTP и SOCKS5 прокси: выбирайте по типу соединения](https://ipvolt.com/ru/guides/http-vs-socks5-proxies.md)

## О ipvolt

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

[Читать оригинал на английском](https://ipvolt.com/guides/nodejs-fetch-proxy.md)

## Узнайте, когда откроется доступ.

ipvolt · В разработке

Мы строим прокси-инфраструктуру для разработчиков и команд, работающих с данными. Оставьте email, чтобы получить уведомление, когда ipvolt будет готов.

Одно письмо, когда откроется доступ. Больше ничего.

[Получить ранний доступ](https://ipvolt.com/ru/guides/nodejs-fetch-proxy#waitlist-closing)

[Конфиденциальность](https://ipvolt.com/privacy)