Lokalne wdrożenie n8n

Wdróż n8n lokalnie na Linux/macOS, zainstaluj węzeł społecznościowy CometAPI i skonfiguruj dane uwierzytelniające API, aby uruchamiać zautomatyzowane workflow na swoim komputerze.

Wdróż n8n na własnym komputerze i połącz je z CometAPI za pomocą węzła społecznościowego, aby lokalnie uruchamiać zautomatyzowane workflow.

​

Wymagania wstępne

• Linux (Ubuntu/Debian/CentOS itp.) lub macOS
• 2 GB+ RAM, 10 GB+ wolnego miejsca na dysku
• Dostęp do powłoki z połączeniem do publicznego rejestru npm
• Node.js 18.x lub 20.x LTS (zobacz Krok 1)
• Konto CometAPI z aktywnym kluczem API — pobierz tutaj

1. Pobierz swój klucz API CometAPI

   Zaloguj się do konsoli CometAPI. Kliknij Add API Key i skopiuj swój klucz sk-xxxxx.

   

   
2. Zainstaluj Node.js przez nvm

   n8n 1.x wymaga Node.js 18.x lub 20.x. Zalecanym podejściem jest 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
   

   Jeśli później zobaczysz n8n: command not found, uruchom ponownie terminal lub upewnij się, że katalog globalnego bin npm zarządzanego przez nvm znajduje się w twoim PATH.

3. Zainstaluj i uruchom n8n

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

   Jeśli port 5678 jest już zajęty:

   export N8N_PORT=5679
   n8n start
   

   Aby n8n działał dalej po zamknięciu terminala:

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

   

   
4. Utwórz swoje konto ownera

   Otwórz http://localhost:5678/ w przeglądarce. Przy pierwszym uruchomieniu kreator konfiguracji poprosi cię o utworzenie konta Owner (email + hasło). Uzupełnij ten krok i zaloguj się.

   
5. Zainstaluj community node CometAPI

   1. Przejdź do Settings (lewy dolny róg) → Community nodes
   2. Kliknij Install a community node
   3. Wprowadź nazwę pakietu: @cometapi-dev/n8n-nodes-cometapi
   4. Zaznacz pole akceptacji ryzyka i kliknij Install

   Po instalacji możesz wyszukać CometAPI w panelu node’ów.

   

   

   Jeśli sekcja Community Nodes nie jest widoczna: upewnij się, że jesteś zalogowany jako konto Owner, i sprawdź w Settings → Security, czy instalacja community node’ów jest włączona.

6. Utwórz workflow i skonfiguruj credentials

   1. Kliknij + New u góry, aby utworzyć workflow.
   2. Kliknij + na canvasie i wyszukaj CometAPI, aby dodać node.

   

   

   3. Dodaj node Manual Trigger i połącz go z node’em CometAPI.
   4. W node’zie CometAPI, w sekcji Credential to connect with, wybierz Create new. Wklej swój klucz sk-xxxxx do pola CometAPI Key i kliknij Save. Base URL domyślnie ma wartość https://api.cometapi.com i zwykle nie wymaga zmiany.

   

   5. Skonfiguruj node:

   • Model: wpisz aktualny identyfikator modelu, którego chcesz użyć
   • Messages: ustaw Role na user, a Content na swój testowy prompt (np. Hello)
   • Opcjonalnie: dodaj wiadomość system, ustaw Max Tokens, Temperature itp.

   6. Kliknij Execute step, aby uruchomić node. Panel Output pokaże odpowiedź JSON.

   

Rozwiązywanie problemów

• Błędy node-gyp lub natywnego buildu — zainstaluj narzędzia build: sudo apt install build-essential python3 (Debian/Ubuntu) lub Xcode Command Line Tools (macOS).
• Błędy uprawnień npm (EACCES) — użyj nvm do instalacji Node.js na poziomie użytkownika; sudo nie jest potrzebne.
• Konflikt portu (localhost:5678 niedostępny) — ustaw N8N_PORT=5679 (lub inny wolny port) przed uruchomieniem n8n start.
• Brak sekcji Community Nodes — zaloguj się jako konto Owner i sprawdź Settings → Security.
• npm install nie działa w sieciach korporacyjnych — skonfiguruj proxy: npm config set proxy http://user:pass@host:port
• Node CometAPI zwraca 401/403 — sprawdź swój klucz API i upewnij się, że model jest dostępny w twoim planie CometAPI.
• Puste odpowiedzi lub błędy limitu tokenów — zwiększ Max Tokens; w razie potrzeby dostosuj Temperature i Top P.
• n8n zatrzymuje się po zamknięciu terminala — użyj pm2: pm2 start "n8n" --name n8n && pm2 save.