1 Перед началом

В n8n прокси задаётся в двух местах, и покрывают они разный трафик. Опция Proxy внутри ноды HTTP Request действует только на эту ноду. Она есть и в n8n Cloud, и на своём сервере. Переменные окружения HTTP_PROXY, HTTPS_PROXY, ALL_PROXY и NO_PROXY накрывают все ноды, которые ходят через общий HTTP-слой n8n, но задать их можно только на self-hosted. Если есть и то и другое, побеждает нода. В документации так и написано: значение в ноде важнее глобальных настроек.

• Только HTTP-прокси. Документация описывает опцию как способ указать HTTP proxy, а SOCKS5 в n8n не упоминается вообще. Считайте, что SOCKS5 не поддерживается, с паролем или без
• Порты GeekProxy это обычные HTTP-прокси, поэтому URL начинается с http://, даже если целевой сайт на https://
• Белый список IP работает в обоих местах. Оставьте логин и пароль пустыми, и прокси пустит вас по адресу сервера

Что понадобится

• Активный план GeekProxy (ISP, датацентр или резидентские)
• Данные прокси из кабинета: хост, порт, логин, пароль
• n8n не старше середины 2025 года. Исправление для HTTPS-целей через HTTP-прокси влили 2025-06-10, а старые сборки падают с невнятной ошибкой (раздел 5)
• Docker, если вы хостите сами и хотите переменные окружения

2 Где взять данные прокси

1. Войдите в кабинет GeekProxy
2. Откройте план. У планов с оплатой за IP (датацентр, ISP) список адресов, порты, логин и пароль лежат прямо на карточке, а кнопка Export отдаёт весь список текстом
3. У резидентских и мобильных планов нажмите Options. Панель Proxy Configuration соберёт строку логина с вашей страной, городом и настройками сессии. Готовую строку копируйте из Proxy List

Воркфлоу, которому нужен один IP на весь прогон, хочет sticky-логин. На Residential Turbo это session_id и session_time от 1 до 1440 минут внутри имени пользователя, на Flex session_time до 120 минут. Панель соберёт строку сама.

n8n, вывод HTTP Request с IP

3 Прокси в одной ноде HTTP Request

Этот путь работает везде, включая Cloud. Откройте ноду HTTP Request, зайдите в Options и добавьте опцию Proxy. Она принимает адрес и порт прокси из кабинета, а также логин и пароль, если план на них. На плане с белым списком IP данные доступа оставьте пустыми.

Укажите в ноде URL https://ipinfo.io/json, метод GET, и запустите её. В панели вывода поле ip должно показать адрес прокси. Показало, значит копируйте ту же опцию в каждую ноду, которой надо выходить через прокси. Переключателя «применить ко всем» нет, так что воркфлоу с двенадцатью нодами HTTP Request означает двенадцать правок. Такова цена контроля по нодам.

n8n, нода HTTP Request, опция Proxy

4 Весь инстанс через переменные окружения

На своём сервере можно пустить через прокси все ноды разом. Это делают четыре переменные из документации по развёртыванию. HTTP_PROXY это URL прокси для незашифрованных HTTP-запросов, HTTPS_PROXY для TLS-запросов, ALL_PROXY запасной вариант, когда конкретной переменной нет. NO_PROXY это список хостов через запятую, которые идут мимо прокси. Впишите туда localhost,127.0.0.1, чтобы внутренние вызовы n8n шли напрямую.

docker run -it --rm --name n8n -p 5678:5678 \
  -e HTTPS_PROXY="http://LOGIN:PASSWORD@IP:PORT" \
  -e HTTP_PROXY="http://LOGIN:PASSWORD@IP:PORT" \
  -e NO_PROXY="localhost,127.0.0.1" \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Строка docker run это стандартная команда установки n8n плюс три флага -e. В документации значение названо просто «URL». Разбирает его пакет proxy-from-env, тот же, что в axios (мейнтейнеры назвали его в PR с исправлением), и он понимает форму http://LOGIN:PASSWORD@IP:PORT. Если заданы оба регистра, имена в нижнем регистре важнее.

Что это накрывает: все ноды на общем HTTP-слое, ноду HTTP Request без собственного прокси и запросы токенов OAuth. С PR #37124 (влит 2026-08-27) переменные читают и процессы воркеров с вебхуками в queue mode. Что не накрывает: community-ноды со своим HTTP-клиентом, ноду Execute Command и входящие вебхуки. Последнее вообще про reverse proxy, другая тема.

Терминал, docker run с переменными прокси

5 Баг с HTTPS в старых n8n

Около двух лет n8n не умела ходить на https:// через http:// прокси. Вместо CONNECT-туннеля она слала прокси GET https://... прямым текстом, а прокси отвечали 400, 503 или запоминающимся Parse Error: Expected HTTP/. Issues #6554, #7992, #7037 и #15789 это один и тот же баг. Мейнтейнер в 2023 году писал, что https_proxy работает, только если прокси сам говорит по SSL. Порты GeekProxy так не делают, и старые сборки просто падали.

Виноват был axios, а не код n8n. PR #16092, влитый 2025-06-10, отключил встроенный прокси axios, заставил опцию в ноде и четыре переменные работать во всех нодах и сохранил прокси при редиректах. Два дополнения важны, если у вас queue mode или прокси с https:// в URL: PR #35518 (2026-08-11) починил https:// прокси, PR #37124 (2026-08-27) научил воркеров читать переменные.

Что делать. Ставить свежую n8n. Писать прокси с http://. Добавлять NO_PROXY. Если по какой-то причине вы застряли на старой версии, обходных путей было два: нода Code с https-proxy-agent или нода Execute Command с curl -x. Оба некрасивые. Лучше обновиться.

6 Проверка работы

Пусть нода HTTP Request запросит https://ipinfo.io/json, и посмотрите на её вывод. Поле ip должно показать адрес прокси, а не вашего сервера. На ISP или датацентре это адрес из кабинета, на Residential или Turbo любой адрес из пула в выбранной стране. Запустите ноду дважды на ротируемом логине, и адреса могут оказаться разными. Так и задумано.

Для варианта с переменными окружения делайте проверку в ноде, у которой нет собственной опции Proxy. Если она по-прежнему показывает IP сервера, переменные не дошли до процесса n8n. Первым делом смотрите окружение контейнера.

n8n, вывод ноды с IP прокси

7 Какой продукт GeekProxy подходит

Большинство воркфлоу в n8n дёргают сторонние API, которые держат адрес в белом списке или считают лимиты по IP. Это работа для одного постоянного адреса: статический ISP или датацентр IPv4 в HTTPS_PROXY, и никакого счётчика трафика. Парсящим воркфлоу (HTTP Request плюс HTML extract), которые упираются в лимиты, нужна опция Proxy в ноде с логином Residential Turbo или Residential Flex: по умолчанию ротация, sticky, когда несколько нод должны держаться одного IP. Flex работает только по TCP, n8n этого даже не заметит. Всё здесь по протоколу HTTP, так что мобильные планы подключаются так же, если цель лояльнее к операторским адресам.

8 Частые проблемы

Parse Error: Expected HTTP/ или 400 от прокси на https:// URL

У вас сборка n8n старше исправления июня 2025 года. Обновляйтесь. Настройки, которая лечит это на старом коде, не существует.

407 Proxy Authentication Required

Не сходятся логин или пароль, либо план в режиме белого списка, а публичного IP сервера в нём нет. Контейнер на облачной VM выходит с адреса этой VM, так что в список нужен он, а не ваш ноутбук.

После переменных n8n не достучится до самой себя

Внутренние вызовы тоже ушли в прокси. Добавьте NO_PROXY=localhost,127.0.0.1 и перезапустите контейнер. Переменная действует только на новые процессы.

Нода игнорирует глобальный прокси

Либо у ноды задана своя опция Proxy, и она важнее, либо это community-нода со своим HTTP-клиентом, которая переменных не видит. В queue mode воркеры до PR #37124 тоже их игнорировали. Проверьте версию.

Адрес SOCKS5 ничего не делает

n8n документирует только HTTP-прокси. Берите HTTP-порт того же плана с логином и паролем или с вашим IP в белом списке.