Локальное развертывание n8n

Разверните n8n локально на Linux/macOS, установите community node CometAPI и настройте учетные данные API, чтобы запускать автоматизированные workflows на своем компьютере.

Разверните n8n на своем компьютере и подключите его к CometAPI через community node, чтобы локально запускать автоматизированные AI workflows.

​

Предварительные требования

• Linux (Ubuntu/Debian/CentOS и т. д.) или macOS
• 2 ГБ+ RAM, 10 ГБ+ свободного места на диске
• Доступ к shell с выходом в публичный npm registry
• Node.js 18.x или 20.x LTS (см. Шаг 1)
• Аккаунт CometAPI с активным API-ключом — получите его здесь

1. Получите ваш API-ключ CometAPI

   Войдите в консоль CometAPI. Нажмите Add API Key и скопируйте ваш ключ sk-xxxxx.

   

   
2. Установите Node.js через nvm

   n8n 1.x требует Node.js 18.x или 20.x. Рекомендуемый способ — nvm:

   # Install nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   
   # Reload your shell profile
   source ~/.bashrc   # or ~/.zshrc on macOS
   
   # Install and activate the LTS version
   nvm install --lts
   nvm use --lts
   
   # Verify
   node -v
   npm -v
   

   Если позже вы увидите n8n: command not found, перезапустите терминал или убедитесь, что каталог глобальных bin-файлов npm, управляемый nvm, находится в вашем PATH.

3. Установите и запустите n8n

   npm install -g n8n
   n8n -v       # verify the installed version
   n8n start    # runs on http://localhost:5678/
   

   Если порт 5678 уже используется:

   export N8N_PORT=5679
   n8n start
   

   Чтобы n8n продолжал работать после закрытия терминала:

   npm install -g pm2
   pm2 start "n8n" --name n8n
   pm2 save
   pm2 status
   

   

   
4. Создайте аккаунт владельца

   Откройте http://localhost:5678/ в браузере. При первом запуске мастер настройки попросит вас создать аккаунт Owner (email + пароль). Завершите этот шаг и войдите в систему.

   
5. Установите community node CometAPI

   1. Перейдите в Settings (слева внизу) → Community nodes
   2. Нажмите Install a community node
   3. Введите имя пакета: @cometapi-dev/n8n-nodes-cometapi
   4. Установите флажок подтверждения риска и нажмите Install

   После установки вы сможете найти CometAPI в панели узлов.

   

   

   Если раздел Community Nodes отсутствует: убедитесь, что вы вошли под аккаунтом Owner, и проверьте в Settings → Security, что установка community node включена.

6. Создайте workflow и настройте credentials

   1. Нажмите + New вверху, чтобы создать workflow.
   2. Нажмите + на холсте и найдите CometAPI, чтобы добавить узел.

   

   

   3. Добавьте узел Manual Trigger и соедините его с узлом CometAPI.
   4. В узле CometAPI в разделе Credential to connect with выберите Create new. Вставьте ваш ключ sk-xxxxx в поле CometAPI Key и нажмите Save. Base URL по умолчанию — https://api.cometapi.com, и обычно его не нужно менять.

   

   5. Настройте узел:

   • Model: введите текущий ID модели, которую хотите использовать
   • Messages: установите Role в user, а Content — в ваш тестовый prompt (например, Hello)
   • Необязательно: добавьте сообщение system, задайте Max Tokens, Temperature и т. д.

   6. Нажмите Execute step, чтобы запустить узел. Панель Output покажет JSON-ответ.

   

Устранение неполадок

• Ошибки node-gyp или нативной сборки — установите build tools: sudo apt install build-essential python3 (Debian/Ubuntu) или Xcode Command Line Tools (macOS).
• Ошибки прав доступа npm (EACCES) — используйте nvm для пользовательской установки Node.js; sudo не требуется.
• Конфликт порта (localhost:5678 недоступен) — задайте N8N_PORT=5679 (или другой свободный порт) перед запуском n8n start.
• Раздел Community Nodes отсутствует — войдите под аккаунтом Owner и проверьте Settings → Security.
• npm install не работает в корпоративных сетях — настройте proxy: npm config set proxy http://user:pass@host:port
• Узел CometAPI возвращает 401/403 — проверьте ваш API-ключ и убедитесь, что модель доступна в вашем тарифном плане CometAPI.
• Пустые ответы или ошибки лимита token — увеличьте Max Tokens; при необходимости скорректируйте Temperature и Top P.
• n8n останавливается при закрытии терминала — используйте pm2: pm2 start "n8n" --name n8n && pm2 save.