Stručné zhrnutie: Spustenie n8n lokálne vyžaduje buď npm (Node.js 20.19-24.x) alebo Docker. Najrýchlejšou metódou je použitie npx n8n na okamžité testovanie bez inštalácie, zatiaľ čo Docker poskytuje lepšiu izoláciu a pripravenosť na produkciu. Oba spôsoby vám poskytnú plný prístup k možnostiam automatizácie pracovných postupov n8n bez opakujúcich sa nákladov na cloud.
Nastavenie n8n na lokálnom počítači eliminuje opakujúce sa poplatky za predplatné a zároveň poskytuje úplnú kontrolu nad automatizáciou pracovných postupov. Podľa oficiálnej dokumentácie n8n platforma vyžaduje verziu Node.js medzi 20.19 a 24.x pre inštalácie pomocou npm, alebo Docker pre kontajnerizované nasadenia.
Rozhodnutie medzi lokálnym hostingom a cloudovými službami ovplyvňuje rozpočet aj flexibilitu. Podľa diskusných fór komunít lokálne inštalácie zvládajú neobmedzený počet pracovných postupov, zatiaľ čo cloudové plány zahŕňajú ceny založené na počte vykonaní (začínajúce na 24 $/mesiac za 2 500 vykonaní podľa niektorých správ používateľov).
Predpoklady pre lokálnu inštaláciu
Pred inštaláciou n8n lokálne potrebuje systém špecifický softvér v závislosti od zvolenej metódy.
Požadovaná verzia Node.js pre inštaláciu pomocou npm závisí výlučne od špecifických požiadaviek verzie n8n, ktorú nasadzujete, pretože samotné npm je kompatibilné so všetkými aktuálne podporovanými LTS verziami Node.js. Oficiálna dokumentácia špecifikuje tento presný rozsah verzií pre kompatibilitu. Aktuálnu verziu skontrolujete spustením príkazu node –version v termináli.
Inštalácie Docker vyžadujú Docker Engine alebo Docker Desktop. Tím n8n odporúča Docker pre väčšinu potrieb samoobsluhy, pretože poskytuje čistú izoláciu a zabraňuje nekompatibilitám operačného systému.
Systémové požiadavky
Lokálne inštancie n8n bežia na systémoch Windows, macOS a Linux. V oficiálnej dokumentácii sa neuvádza žiadna minimálna špecifikácia RAM, ale zložitosť pracovného postupu určuje skutočné potreby zdrojov.
Inštalácia spočiatku spotrebuje minimálne miesto na disku. Požiadavky na úložisko rastú na základe údajov pracovných postupov, histórie vykonaní a vlastných balíkov uzlov.
Metóda 1: Spustenie n8n pomocou npm
Inštalácia npm poskytuje najrýchlejší cestu k spusteniu n8n lokálne. Táto metóda funguje priamo na hostiteľskom systéme bez kontajnerizácie.
Rýchly štart s npx
Najjednoduchší prístup používa npx bez trvalej inštalácie. Otvorte terminál a spustite:
| npx n8n |
Tento príkaz stiahne všetko potrebné a automaticky spustí n8n. Rozhranie bude dostupné na localhost:5678 v priebehu niekoľkých sekúnd.
Metóda npx funguje perfektne na testovanie a vyhodnocovanie. Nevyžaduje globálne balíky npm ani trvalé zmeny systému.
Globálna inštalácia npm
Pre trvalú inštaláciu poskytuje globálny balík npm konzistentný prístup:
| npm install n8n -g |
Po dokončení inštalácie spustite n8n kedykoľvek zadaním:
| n8n |
Aktuálnou hlavnou stabilnou verziou n8n je 2.x (napr. 2.10.4). Beta verzie môžu obsahovať nestabilné funkcie a mali by sa vyhýbať pri produkčných pracovných postupoch.
Konfigurácia a ukladanie dát
Inštalácie npm štandardne ukladajú dáta pracovných postupov do adresára ~/.n8n. Toto umiestnenie obsahuje poverenia, definície pracovných postupov a históriu vykonaní.
Premenné prostredia riadia správanie n8n. Nastavte premennú N8N_PORT na zmenu predvoleného portu 5678. Ostatné premenné konfigurujú pripojenia k databáze, URL adresy webhookov a nastavenia autentizácie.
Metóda 2: Spustenie n8n pomocou Dockeru
Inštalácia Docker predstavuje odporúčaný prístup pre lokálny hosting n8n. Oficiálna dokumentácia zdôrazňuje Docker pre potreby samoobsluhy v produkcii.
Základný príkaz Docker Run
Spustite n8n jedným príkazom Docker:
| docker run -it –rm –name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Tento príkaz vytvorí kontajner s názvom n8n, namapuje port 5678 na hostiteľa a zachováva dáta v adresári ~/.n8n.
Kontajner beží interaktívne s príznakom -it. Odstráňte –rm, ak chcete kontajner po zastavení ponechať.
Docker Compose pre nastavenie produkcie
Konfigurácie Docker Compose poskytujú lepšiu kontrolu pre produkčné prostredia. Repozitár n8n-hosting na GitHub obsahuje súbory Docker Compose pripravené na použitie pre rôzne architektúry.
Základná konfigurácia docker-compose.yml vyzerá takto:
| version: ‘3.8’ services: n8n: image: n8nio/n8n restart: always ports: – “5678:5678” environment: – N8N_BASIC_AUTH_ACTIVE=true – N8N_BASIC_AUTH_USER=admin – N8N_BASIC_AUTH_PASSWORD=password volumes: – ~/.n8n:/home/node/.n8n |
Spustite stack pomocou:
| docker-compose up -d |
Príznak -d spustí kontajnery v odpojenom režime, čo umožňuje používať terminál na iné úlohy.
Počiatočná konfigurácia a prístup
Po spustení n8n ktoroukoľvek z metód prejdite na localhost:5678 vo webovom prehliadači. Na úvodnej obrazovke nastavenia sa žiada e-mailová adresa a heslo pre administrátorský účet.
Tento prvý používateľ sa stane vlastníkom inštancie s plnými administratívnymi oprávneniami. Ďalší používatelia môžu byť pridaní neskôr prostredníctvom rozhrania na správu používateľov.
Nastavenie autentizácie
Pre bezpečnosť povoľte autentizáciu aj pri lokálnych inštaláciách. Konfigurácie Docker Compose prijímajú premenné prostredia autentizácie priamo:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=password |
Tieto premenné aktivujú HTTP základnú autentizáciu, ktorá vyžaduje poverenia pre všetky pokusy o prístup.
Testovanie vlastných uzlov lokálne
Oficiálna dokumentácia vysvetľuje, ako testovať vlastné uzly počas vývoja. Najprv nainštalujte n8n globálne, potom zostavte a prepojte balík vlastného uzla.
V adresári vlastného uzla spustite:
| npm run build npm link |
Potom prejdite do adresára uzlov n8n (zvyčajne ~/.n8n/custom/) a prepojte balík:
| npm link <node-package-name> |
Vlastný uzol sa zobrazí v rozhraní n8n po reštartovaní inštancie.
Užitočné zdroje pre automatizáciu, ktoré môžete použiť s n8n
Ak sa učíte, ako spustiť n8n lokálne a testujete pracovné postupy na svojom počítači, môžu vám byť nápomocné aj externé pomôcky a šablóny, ktoré uľahčujú automatizáciu bežných úloh. Get AI Perks ponúka knižnicu šablón pracovných postupov a nástrojov s asistenciou AI, ktoré môžete použiť spolu s n8n alebo na prototypovanie nápadov na automatizáciu predtým, ako si ich sami vytvoríte.
S Get AI Perks môžete:
- Začať s predpripravenými šablónami pracovných postupov
- Získať pomoc AI pri rutinných logických úlohách a obsahu
- Preskúmať bežné vzory automatizácie pred ich implementáciou v n8n
- Kombinovať šablóny s vaším lokálnym nastavením n8n
Objavte Get AI Perks a nájdite pomôcky na automatizáciu, ktoré podporujú vaše pracovné postupy n8n.
Riešenie bežných problémov
Najčastejším problémom pri inštalácii sú konflikty portov. Ak je port 5678 už obsadený, zastavte konfliktujúcu službu alebo zmeňte port n8n pomocou premennej prostredia N8N_PORT.
Nekompatibilita verzií Node
Použitie verzií Node.js mimo rozsahu 20.19-24.x spôsobuje zlyhanie inštalácie. Repozitár n8n na GitHub dokumentuje problémy, keď sa vývojári pokúšajú o lokálne vývojové prostredia, čím zdôrazňuje dôležitosť kompatibility verzií Node.
Pred riešením iných problémov overte kompatibilitu verzií Node. V prípade potreby prepnite verzie Node pomocou nvm (Node Version Manager).
Chyby oprávnení Docker Volume
Problémy s oprávneniami pri pripojení objemu ~/.n8n bránia perzistencii dát. Kontajnery Dockeru bežia ako používateľ node, ktorý nemusí mať prístup na zápis do adresára hostiteľa.
Pred spustením kontajnera vytvorte adresár s príslušnými oprávneniami:
| mkdir ~/.n8n chmod 777 ~/.n8n |
Často kladené otázky
Môže n8n bežať bez prístupu na internet?
Áno, n8n funguje úplne offline pre lokálne pracovné postupy. Internetové pripojenie sa stáva nevyhnutným iba vtedy, keď pracovné postupy interagujú s externými API alebo cloudovými službami.
Koľko stojí spustenie n8n lokálne?
Lokálne inštalácie sú zadarmo. Komunitná edícia poskytuje všetky základné funkcie bez licenčných poplatkov. Cloud hosting začína s limitmi vykonaní a mesačnými nákladmi, ale lokálny hosting úplne odstraňuje tieto obmedzenia podľa diskusií komunity.
Mali by začiatočníci používať npm alebo Docker?
Začiatočníci testujúci n8n by mali začať s npx pre okamžitý prístup. Docker dáva väčší zmysel pre dlhodobé používanie, pretože poskytuje lepšiu izoláciu a jednoduchšie aktualizácie.
Kam n8n lokálne ukladá dáta pracovných postupov?
Predvolený dátový adresár je ~/.n8n v domovskom adresári používateľa. Toto umiestnenie obsahuje súbory databázy SQLite, poverenia a protokoly vykonaní, pokiaľ nie je nakonfigurované inak.
Môže na jednom stroji bežať viacero inštancií n8n?
Áno, ale každá inštancia potrebuje jedinečný port. Nastavte rôzne porty pomocou premennej prostredia N8N_PORT pre každú inštanciu. Docker to uľahčuje pomocou mapovania portov v samostatných kontajneroch.
Ako fungujú aktualizácie pre lokálne inštalácie?
Inštalácie npm sa aktualizujú pomocou npm update -g n8n alebo npm install -g n8n@latest. Používatelia Dockeru sťahujú najnovší obraz pomocou príkazu docker pull n8nio/n8n a následne znovu vytvárajú kontajnery. Pred aktualizáciou vždy zálohujte adresár ~/.n8n.
Úvahy pre produkciu
Oficiálna dokumentácia n8n zdôrazňuje, že samoobsluha vyžaduje technické znalosti. Nastavenie serverov, správa zdrojov a zabezpečenie aplikácií si vyžadujú skúsenosti so správou systémov.
Pre produkčné nasadenia poskytuje Docker Compose základ. Pridajte reverzný proxy, ako je nginx alebo Caddy, pre podporu HTTPS. Repozitár n8n-hosting obsahuje konfigurácie Caddy pripravené na nasadenie.
Výber databázy je dôležitý pre veľké pracovné zaťaženia. Predvolená databáza SQLite funguje pre mierne použitie, ale PostgreSQL ponúka lepší výkon pre vysokofrekvenčnú automatizáciu podľa oficiálnych pokynov.
Rozhodovanie: Lokálne vs. Cloud
Lokálny hosting n8n je vhodný pre tímy s technickými možnosťami a špecifickými bezpečnostnými požiadavkami. Dáta zostávajú na kontrolovanej infraštruktúre a obmedzenia vykonaní miznú.
Lokálny hosting si však vyžaduje údržbu, zálohovanie a monitorovanie. Cloud hosting prenáša tieto zodpovednosti na tím infraštruktúry n8n. Aktuálne ceny a porovnanie funkcií nájdete na oficiálnej webovej stránke.
Spustenie n8n lokálne poskytuje úplnú kontrolu nad infraštruktúrou automatizácie pracovných postupov. Či už používate npm na rýchle testovanie alebo Docker na produkčné nasadenia, oba spôsoby poskytujú plnú platformu bez opakujúcich sa nákladov. Začnite s npx na okamžité preskúmanie, potom prejdite na Docker, keď sa pracovné postupy blížia k produkčnému používaniu.
