К содержимому

Прокси для pnpm: httpsProxy, а также Yarn и Bun за прокси

Откуда pnpm, Yarn и Bun берут прокси и что в официальных страницах не описано.

Что описано у каждого инструмента

Что описано у каждого инструмента
ПунктpnpmYarn Berry (2+)Bun
Настройки или переменныеhttpsProxy, httpProxy, noProxy; читается и .npmrchttpProxy и httpsProxy в .yarnrc.ymlfetch() читает HTTP_PROXY, HTTPS_PROXY, ALL_PROXY и NO_PROXY
Порядок подстановкиhttpsProxy: proxy, затем HTTPS_PROXY; httpProxy: httpsProxy, затем HTTP_PROXY; noProxy: noproxy, затем NO_PROXYВ документации нетHTTP_PROXY для адресов http:, HTTPS_PROXY для https:; ALL_PROXY, если нужная переменная не задана
Список исключенийnoProxy, домены через запятуюnoProxy в документации нетNO_PROXY, через запятую или пробел
Логин в адресеНа прочитанных страницах не сказаноНе сказано; в примерах http://proxy:4040Для адреса прокси не показан; заголовок Proxy-Authorization перекрывает логин из адреса
SOCKSНе упоминаетсяНе упоминаетсяЗначения socks5:// в ALL_PROXY игнорируются

Источники: страницы pnpm про настройки и .npmrc, справочник Yarn по .yarnrc и страница Bun про fetch, все прочитаны 16 ноября 2026. «Не сказано» значит, что на прочитанных страницах этого нет, а не что это не работает; проверьте на своём прокси.

pnpm: три настройки и где они хранятся

В сетевых настройках pnpm перечислены httpsProxy, httpProxy и noProxy. httpsProxy по умолчанию null и при отсутствии берёт устаревшую настройку proxy, затем переменную HTTPS_PROXY или https_proxy. httpProxy, если не задан, берёт значение httpsProxy, затем HTTP_PROXY или http_proxy. noProxy это строка доменных суффиксов через запятую, для которых прокси не нужен; при отсутствии берётся noproxy, затем NO_PROXY или no_proxy.

pnpm читает настройки прокси и из файлов .npmrc. На странице про .npmrc есть ограничение: в .npmrc проекта адреса registry и прокси (registry, proxy, https-proxy, http-proxy) не могут ссылаться на переменные окружения; pnpm игнорирует такую настройку и выводит предупреждение. Пишите там полный адрес или задайте переменную окружения вместо файла. Файл с паролем не коммитьте.

pnpm: переменные окружения и .npmrc, пример

# одна сессия терминала: pnpm берёт эти переменные
export HTTPS_PROXY="http://LOGIN:PASSWORD@HOST:PORT"
export HTTP_PROXY="http://LOGIN:PASSWORD@HOST:PORT"
export NO_PROXY="localhost,127.0.0.1"
pnpm install

# или в ~/.npmrc (полный адрес, без ${ПЕРЕМЕННОЙ})
https-proxy=http://LOGIN:PASSWORD@HOST:PORT
proxy=http://LOGIN:PASSWORD@HOST:PORT

Только пример: замените подстановки. Здесь не запускалось; названия настроек и порядок подстановки взяты со страниц pnpm. На страницах не сказано, принимает ли pnpm логин в адресе прокси, поэтому проверьте тестом curl ниже и закодируйте спецсимволы пароля.

Yarn Berry: .yarnrc.yml

В документации Yarn 2 и новее описаны httpProxy (прокси для HTTP-запросов) и httpsProxy (прокси для HTTPS-запросов), оба задаются в .yarnrc.yml, пример вида http://proxy:4040. В справочнике нет noProxy, не упомянуты ни SOCKS, ни логин в адресе. В networkSettings httpProxy можно задать для отдельного хоста.

Этот раздел только про Yarn Berry. Страницы настройки Yarn 1 мы не читали, поэтому если yarn --version начинается с 1, смотрите документацию этой версии.

Yarn Berry: .yarnrc.yml, пример

httpProxy: "http://LOGIN:PASSWORD@HOST:PORT"
httpsProxy: "http://LOGIN:PASSWORD@HOST:PORT"

Только пример: замените подстановки. Здесь не запускалось; имена ключей взяты из справочника Yarn по .yarnrc, в его примере адрес http://proxy:4040 без логина.

Bun: что описано

На странице Bun про fetch сказано: если параметр proxy не передан, Bun при каждом вызове fetch читает HTTP_PROXY, HTTPS_PROXY и ALL_PROXY (в верхнем или нижнем регистре). ALL_PROXY используется, когда нужная переменная не задана, а значение с другим видом прокси, например socks5://, игнорируется. NO_PROXY перечисляет хосты без прокси и действует и на явный параметр proxy; respectNoProxy: false и proxy: false это меняют.

Страница относится к fetch() в вашем коде. На прочитанных нами страницах про bun install и .npmrc настройки прокси не упомянуты, поэтому как ведёт себя bun install, мы сказать не можем. Задайте переменные в том же терминале, поставьте небольшой пакет и подтвердите тестом curl и статистикой трафика у прокси, прежде чем использовать в CI.

Bun: fetch() через прокси, пример

// fetch() в вашем скрипте
const res = await fetch("https://registry.npmjs.org/left-pad", {
  proxy: "http://LOGIN:PASSWORD@HOST:PORT",
});
console.log(res.status);

Только пример для скриптов, не для bun install. Здесь не запускалось; параметр proxy взят со страницы Bun про fetch, где логин внутри адреса прокси не показан.

Сначала проверьте прокси, потом виним менеджер пакетов

  1. Шаг 1: проверьте прокси через curl

    Выполните команду curl ниже с теми же HOST, PORT, LOGIN и PASSWORD. Статус 200 или 301 значит, что прокси достаёт до реестра.

    Ожидаемый результат Ожидаемый результат: строка статуса HTTP от реестра, а не ошибка прокси.

  2. Шаг 2: установите что-нибудь небольшое

    В пустой папке выполните pnpm install, yarn install или bun install для проекта с одной зависимостью, задав прокси так, как описано выше.

  3. Шаг 3: меняйте по одному

    Если curl работает, а установка нет, меняйте что-то одно: имя переменной, формат адреса или файл, где лежит настройка.

Проверка прокси: пример

curl -I -x "http://LOGIN:PASSWORD@HOST:PORT" https://registry.npmjs.org/

Только пример: замените подстановки. curl -x с адресом http:// это обычное использование curl; на реальном прокси здесь не запускалось.

Если установка за прокси не проходит

curl работает, установка зависает

Проверьте Инструмент не использует прокси: настройка лежит в файле, который он не читает, или неверно имя переменной (регистр имён подбирается, а у pnpm есть свой порядок подстановки).

Решение Задайте переменную в том же терминале или впишите полный адрес в тот файл, который назван в документации. В .npmrc проекта не используйте ${ПЕРЕМЕННАЯ} для адресов прокси.

Когда остановиться Если не работает сам curl, сначала почините прокси, см. руководство по авторизации на прокси.

407 Proxy Authentication Required

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

Решение Сверьте LOGIN и PASSWORD в «Мои активы» и закодируйте спецсимволы в адресе через проценты.

Когда остановиться Не повторяйте бесконечно: повторные неудачные входы ничего не дадут.

Перестали открываться внутренние или частные реестры

Проверьте Их адреса тоже уходят через прокси.

Решение Добавьте их в noProxy (pnpm) или NO_PROXY, учитывая формат каждого инструмента.

Когда остановиться В документации Yarn Berry noProxy нет; если нужно исключение, проверьте его на практике или используйте вариант с переменными окружения.

Какой продукт Proxy302 подходит для установки пакетов

Установке пакетов обычно всё равно, в какой стране выходной IP, поэтому самый простой вариант это IP дата-центра с арендой за IP: $0,25 за 1 день, $0,75 за 3 дня, $1,75 за 7 дней и $3,99 за 30 дней, одинаково в любой стране, с HTTP на порту 2222 или SOCKS5 на порту 3333 по выбору при покупке. Список стран и наличие показаны на странице заказа. Для перечисленных инструментов берите HTTP-актив.

Бесплатного теста нет. Минимальная покупка это один IP на один день, поэтому сначала попробуйте на одном проекте.

Прокси для pnpm, Yarn и Bun: частые вопросы

Как задать прокси для pnpm?

Через настройки httpsProxy и httpProxy, через https-proxy и proxy в .npmrc или через переменные HTTPS_PROXY и HTTP_PROXY в терминале. Порядок подстановки у pnpm: httpsProxy, proxy, HTTPS_PROXY.

Поддерживает ли pnpm SOCKS-прокси?

На прочитанных страницах pnpm SOCKS не упоминается. Берите адрес HTTP-прокси.

Как сказать Yarn Berry не использовать прокси для части хостов?

В справочнике по .yarnrc есть только httpProxy и httpsProxy, noProxy нет, то есть задокументированного переключателя для этого нет.

Использует ли bun install переменную HTTP_PROXY?

На прочитанной странице Bun HTTP_PROXY, HTTPS_PROXY и NO_PROXY описаны для fetch(). Официального заявления про bun install мы не нашли, поэтому проверьте тестом.

Можно ли писать логин прямо в адресе прокси?

Это обычная запись, и примеры здесь её используют, но ни одна из трёх прочитанных страниц не подтверждает её для менеджеров пакетов. Проверьте через curl и небольшую установку.

Ссылки и источники

5
  1. pnpm: network settings (httpsProxy, httpProxy, noProxy)

    Официальная документация · Проверено:

    Прочитано 16 ноября 2026: значения по умолчанию и порядок подстановки httpsProxy, httpProxy и noProxy.

  2. pnpm: .npmrc

    Официальная документация · Проверено:

    Прочитано 16 ноября 2026: настройки прокси читаются из .npmrc; адреса registry и прокси в .npmrc проекта не могут ссылаться на переменные окружения, pnpm игнорирует их с предупреждением.

  3. Yarn: .yarnrc.yml settings

    Официальная документация · Проверено:

    Прочитано 16 ноября 2026: httpProxy и httpsProxy с примером http://proxy:4040; записи noProxy нет; networkSettings для отдельного хоста.

  4. Bun: fetch

    Официальная документация · Проверено:

    Прочитано 16 ноября 2026: параметр proxy, обработка HTTP_PROXY, HTTPS_PROXY, ALL_PROXY и NO_PROXY, заголовок Proxy-Authorization; значения socks5:// в ALL_PROXY игнорируются.

    О fetch() в скриптах. Страницы Bun про install и .npmrc, прочитанные в тот же день, прокси не упоминают.

  5. Продуктовые факты и прайс Proxy302

    Наблюдение за продуктом · Проверено:

    Информация о продуктах Proxy302, проверена 16 ноября 2026: цены за IP для статического ISP и дата-центра в US$, сроки аренды, протоколы и порты (HTTP 2222, SOCKS5 3333), бесплатного теста нет.

Готовы попробовать?

Создайте аккаунт, пополните баланс и выберите ротируемый резидентный, статический ISP или дата-центр IP — настроить его в браузере можно за несколько минут.