Налаштування проксі для npm, yarn та p

Налаштування проксі для npm, yarn та pnpm

Вступ

Менеджери пакетів Node.js (npm, yarn, pnpm) завантажують пакети з реєстру npm. У корпоративній мережі або при використанні проксі для анонімності необхідно налаштувати проксі для коректної роботи цих менеджерів пакетів.

Базова конфігурація

npm

npm config set proxy http://proxy_ip:port
npm config set https-proxy http://proxy_ip:port

З автентифікацією:
npm config set proxy http://user:pass@proxy_ip:port

Перевірка:
npm config get proxy

Видалення:
npm config delete proxy
npm config delete https-proxy

yarn

yarn config set proxy http://proxy_ip:port
yarn config set https-proxy http://proxy_ip:port

pnpm

pnpm config set proxy http://proxy_ip:port
pnpm config set https-proxy http://proxy_ip:port

Альтернативно, через змінні середовища: HTTP_PROXY, HTTPS_PROXY — це працює для всіх трьох менеджерів.

Розширена конфігурація

Змінні середовища

Більшість інструментів підтримують стандартні змінні середовища для проксі:
- HTTP_PROXY / http_proxy — проксі для HTTP-запитів
- HTTPS_PROXY / https_proxy — проксі для HTTPS-запитів
- NO_PROXY / no_proxy — список винятків (адреси, що обходять проксі)
- ALL_PROXY / all_proxy — проксі для всіх протоколів

SSL та самопідписані сертифікати

Корпоративні проксі часто використовують власні SSL-сертифікати. Для роботи через них необхідно:
1. Отримати CA-сертифікат проксі у адміністратора
2. Додати його до сховища сертифікатів вашої системи
3. Або вимкнути перевірку SSL (тільки для тестування)

Автентифікація

Підтримуються два основні методи автентифікації:

Ім'я користувача та пароль — стандартна HTTP Basic автентифікація. Облікові дані надсилаються з кожним запитом. Формат URL: http://user:pass@proxy_ip:port

За IP-адресою (білий список) — ваша IP-адреса додається до білого списку. Облікові дані надсилати не потрібно.

Перевірка налаштування

Після конфігурації перевірте:
1. Виконайте тестовий запит через проксі
2. Переконайтеся, що ваша IP-адреса змінилася
3. Перевірте швидкість з'єднання
4. Підтвердьте відсутність витоків DNS

Усунення несправностей

Проксі не підключається

• Перевірте правильність адреси та порту
• Переконайтеся, що ваш брандмауер не блокує з'єднання
• Перевірте доступність проксі з вашої мережі

Помилки SSL

• Для корпоративних проксі додайте CA-сертифікат
• Для тестування тимчасово вимкніть перевірку SSL
• Оновіть бібліотеки SSL до останньої версії

Помилки автентифікації

• Перевірте ваше ім'я користувача та пароль
• Переконайтеся, що формат облікових даних правильний
• Спробуйте URL-кодування спеціальних символів у паролі

Найкращі практики

1. Використовуйте змінні середовища — для гнучкості та безпеки
2. Уникайте жорсткого кодування облікових даних — використовуйте змінні середовища або файли конфігурації
3. Налаштуйте виключення — не проксуйте localhost та внутрішні адреси
4. Документуйте налаштування — у README вашого проєкту або командній вікі
5. Тестуйте після змін — будь-яка зміна конфігурації вимагає перевірки

Висновок

Правильна конфігурація проксі забезпечує стабільну роботу інструментів та безпечні з'єднання. Дотримуйтесь рекомендацій у цьому посібнику та завжди перевіряйте функціональність після налаштування.