Налаштування проксі в Insomnia

Налаштування проксі в Insomnia

Вступ

Insomnia – популярний HTTP-клієнт для розробників, альтернатива Postman. Підтримка проксі в Insomnia є критично важливою для роботи в корпоративних мережах, тестування API з різних геолокацій та налагодження трафіку через проксі-перехоплювач.

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

Конфігурація в Insomnia

1. Відкрийте Insomnia
2. Перейдіть до Preferences (Ctrl+,)
3. Вкладка "General" → розділ "HTTP Network Proxy"
4. Увімкніть "Enable Proxy"
5. Введіть адресу проксі у форматі: http://proxy_ip:port
6. Для HTTPS: https://proxy_ip:port
7. Без проксі: localhost, *.local

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

Insomnia підтримує проксі з автентифікацією:
- Формат URL: http://user:pass@proxy_ip:port
- Або через змінні середовища: HTTP_PROXY, HTTPS_PROXY

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

Insomnia читає системні змінні середовища:
- HTTP_PROXY / http_proxy
- HTTPS_PROXY / https_proxy
- NO_PROXY / no_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-адресою (whitelist) — ваша IP-адреса додається до білого списку. Облікові дані надсилати не потрібно.

Перевірка

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

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

Проблеми з підключенням до проксі

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

Помилки SSL

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

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

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

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

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

Висновок

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