GonkaGate Настройка n8n

Подключите self-hosted n8n к GonkaGate через официальный community node package.

Подключите self-hosted n8n к GonkaGate через официальный community node package @gonkagate/n8n-nodes-gonkagate. Самый короткий путь: Community Nodes UI, затем root node GonkaGate для List Models и Chat Completion. К GonkaGate Chat Model переходите только после того, как root node уже работает.

Если вне n8n вам нужны только общие OpenAI-compatible значения API, используйте OpenAI SDK Compatibility.

Что даёт этот пакет

Root node GonkaGate
Additive AI model node GonkaGate Chat Model
Общий credential GonkaGate API
GonkaGate-first path для GET /v1/models и POST /v1/chat/completions

Канонический base URL зафиксирован как https://api.gonkagate.com/v1. В обычном сценарии n8n чаще всего достаточно просто вставить API key в GonkaGate API.

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

Используйте self-hosted n8n. Для этого пакета пока нет обещания по n8n Cloud.
Подготовьте API-ключ GonkaGate в формате gp-....
Если вы запускаете n8n через Docker, держите user data directory в persistent storage.
Для production пиньте точную npm-версию или Docker tag, а не полагайтесь на latest.

Выберите путь установки

Путь	Когда выбирать	Что делать
Community Nodes UI	У вас уже есть обычный self-hosted `n8n` с доступом к UI	Установите `@gonkagate/n8n-nodes-gonkagate` через `Settings -> Community Nodes`
Ручной `npm` install	Вы сами управляете хостом или уже запущенным контейнером	Установите пакет в папку `n8n` nodes и перезапустите `n8n`
Published Docker image	Нужен Docker-путь с уже предустановленным GonkaGate	Запустите `ghcr.io/gonkagate/n8n-nodes-gonkagate` или возьмите публичный Compose example

Самая быстрая установка: Community Nodes UI

Выбирайте этот путь, если пакет уже опубликован в npm и ваш self-hosted n8n показывает обычный owner/admin UI.

Откройте свой self-hosted n8n.
Перейдите в Settings -> Community Nodes.
Нажмите Install.
Введите одно из значений пакета:

Самая быстрая установка: Community Nodes UI

@gonkagate/n8n-nodes-gonkagate
@gonkagate/n8n-nodes-gonkagate@<version>

Подтвердите prompt про community node, если n8n его показывает.
Дождитесь завершения установки.
Перезапустите n8n, если ваша схема деплоя этого требует.
Откройте node picker и найдите GonkaGate.

Ручной `npm` install

Выбирайте этот путь, если вы управляете хостом или работающим контейнером напрямую и хотите shell-first установку.

Host-based `n8n`

Команда

mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm install @gonkagate/n8n-nodes-gonkagate@<version>

Если у вас используется N8N_USER_FOLDER, устанавливайте в $N8N_USER_FOLDER/nodes. После этого перезапустите n8n и найдите GonkaGate в node picker.

Запущенный Docker container

Установите пакет в обычную user-folder директорию контейнера, затем перезапустите контейнер:

Запущенный Docker container

docker exec -it n8n sh
mkdir -p /home/node/.n8n/nodes
cd /home/node/.n8n/nodes
npm install @gonkagate/n8n-nodes-gonkagate@<version>
exit
docker restart n8n

Docker path

Используйте published image, если хотите самый короткий Docker-путь с уже установленным GonkaGate.

Published image:

Docker path

ghcr.io/gonkagate/n8n-nodes-gonkagate

Пример через docker run:

Пример через docker run

docker volume create n8n_data

docker run -d \
  --name n8n \
  -p 5678:5678 \
  -e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" \
  -e TZ="<YOUR_TIMEZONE>" \
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
  -v n8n_data:/home/node/.n8n \
  ghcr.io/gonkagate/n8n-nodes-gonkagate:latest

Для production лучше использовать точный image tag вместо latest. Если вам удобнее Docker Compose, возьмите self-hosted Docker example из публичного репозитория.

Первый рабочий запрос в n8n

После установки сначала проверьте самый маленький рабочий путь.

Откройте n8n и нажмите Start from scratch.
Добавьте Manual Trigger.
Нажмите + и найдите gonka или GonkaGate.
Если picker открылся на AI Nodes, посмотрите Results in other categories.
Для первой проверки выберите обычный node GonkaGate.
Установите Operation в List Models.
Создайте GonkaGate API, вставьте API key и сохраните.
Запустите node через Execute step или Execute workflow.

Если List Models сработал, переключите этот же node на Chat Completion, выберите модель и отправьте короткое сообщение, например Hello from n8n.

Какой node выбрать?

Начните с…	Когда использовать	Почему
`GonkaGate`	Нужен самый быстрый первый запрос, `List Models` или более простая отладка	Минимальная поверхность настройки и прямой request/response path
`GonkaGate Chat Model`	Вы строите `AI Agent` или другой `AiLanguageModel` workflow	Это additive AI-model surface для более широких AI-сценариев `n8n`

Не начинайте первую проверку с GonkaGate Chat Model. Если в поиске также виден GonkaGate Tool, для первого чека его тоже пропустите.

Частые первые ошибки

Node не появляется после установки

Перезапустите n8n.
Если у вас queue mode, workers или webhook runners, убедитесь, что одна и та же версия пакета установлена на всех runtime-процессах.

В live-списке нет моделей

/v1/models может вернуть пустой набор.
Переключите поле модели в режим ID и введите model ID вручную.

Вы ожидали visible streaming в root node

Root node GonkaGate возвращает один финальный JSON-ответ.
Если нужен visible live streaming, используйте GonkaGate Chat Model внутри streaming-capable AI workflow.

Credential падает сразу

Пересоздайте credential, если он был создан ещё до добавления hidden base URL по умолчанию.
Ожидаемый base URL: https://api.gonkagate.com/v1.

Текущие границы

Только self-hosted posture, без обещания по n8n Cloud.
Нет blanket-обещания совместимости со всеми версиями n8n.
Текущий package scope: GET /v1/models и POST /v1/chat/completions.
Поддержки /v1/responses пока нет.

См. также

Гайды по фреймворкам и инструментам для общего community hub
Claude Code, Cursor и OpenClaw для agent-owned setup paths
Аутентификация и API-ключи для создания и ротации ключей
Get models для актуальных model ID, когда live picker пуст
Репозиторий n8n-пакета

Настройка n8n

On this page