Локальне розгортання n8n

Розгорніть n8n локально на Linux/macOS, встановіть community node CometAPI та налаштуйте API-облікові дані для запуску автоматизованих workflow на вашій машині.

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

​

Передумови

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

1. Отримайте свій CometAPI API key

   Увійдіть до консолі 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. Створіть свій обліковий запис owner

   Відкрийте http://localhost:5678/ у браузері. Під час першого запуску майстер налаштування запропонує створити обліковий запис Owner (email + password). Завершіть цей крок і виконайте вхід.

   
5. Встановіть community node CometAPI

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

   Після встановлення ви зможете знайти CometAPI у панелі node.

   

   

   Якщо розділ Community Nodes відсутній: переконайтеся, що ви ввійшли під обліковим записом Owner, і перевірте в Settings → Security, що встановлення community node увімкнено.

6. Створіть workflow і налаштуйте credentials

   1. Натисніть + New угорі, щоб створити workflow.
   2. Натисніть + на полотні та знайдіть CometAPI, щоб додати node.

   

   

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

   

   5. Налаштуйте node:

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

   6. Натисніть Execute step, щоб запустити node. На панелі 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
• Node CometAPI повертає 401/403 — перевірте свій API key і переконайтеся, що модель доступна у вашому тарифному плані CometAPI.
• Порожні відповіді або помилки ліміту token — збільште Max Tokens; за потреби скоригуйте Temperature і Top P.
• n8n зупиняється після закриття термінала — використовуйте pm2: pm2 start "n8n" --name n8n && pm2 save.