Resum ràpid: Executar n8n localment requereix npm (Node.js 20.19-24.x) o Docker. El mètode més ràpid utilitza npx n8n per a proves immediates sense instal·lació, mentre que Docker proporciona millor aïllament i preparació per a la producció. Ambdues opcions us ofereixen accés complet a les capacitats d'automatització de fluxos de treball d'n8n sense costos recurrents al núvol.
Configurar n8n en una màquina local elimina les tarifes de subscripció recurrents alhora que proporciona un control complet sobre l'automatització del flux de treball. Segons la documentació oficial d'n8n, la plataforma requereix una versió de Node.js entre 20.19 i 24.x per a les instal·lacions npm, o Docker per a desplegaments contenitzats.
La decisió entre allotjament local i serveis al núvol afecta tant el pressupost com la flexibilitat. Segons les discussions de la comunitat, les instal·lacions locals gestionen fluxos de treball il·limitats, mentre que els plans al núvol inclouen preus basats en l'execució (a partir de 24 $/mes per a 2.500 execucions segons alguns informes d'usuaris).
Prerrequisits per a la instal·lació local
Abans d'instal·lar n8n localment, el sistema necessita programari específic depenent del mètode escollit.
La versió de Node.js requerida per a una instal·lació npm depèn completament dels requisits específics de la versió d'n8n que esteu desplegant, ja que npm mateix és compatible amb totes les versions LTS de Node.js actualment compatibles. La documentació oficial especifica aquest rang exacte de versions per a la compatibilitat. Comproveu la versió actual executant node --version al terminal.
Les instal·lacions de Docker requereixen Docker Engine o Docker Desktop. L'equip d'n8n recomana Docker per a la majoria de necessitats d'autoallotjament, ja que proporciona un aïllament net i evita incompatibilitats amb el sistema operatiu.
Requisits del sistema
Les instàncies locals d'n8n s'executen en sistemes Windows, macOS i Linux. No hi ha cap especificació mínima de RAM a la documentació oficial, però la complexitat del flux de treball determina les necessitats reals de recursos.
La instal·lació consumeix un espai mínim al disc inicialment. Els requisits d'emmagatzematge creixen en funció de les dades del flux de treball, l'historial d'execució i els paquets de nodes personalitzats.
Mètode 1: Execució d'n8n amb npm
La instal·lació npm proporciona el camí més ràpid per executar n8n localment. Aquest mètode funciona directament al sistema host sense contenització.
Arrencada ràpida amb npx
L'enfocament més senzill utilitza npx sense instal·lació permanent. Obriu un terminal i executeu:
| npx n8n |
Aquest comandament descarrega tot el necessari i inicia n8n automàticament. La interfície es torna accessible a localhost:5678 en qüestió de segons.
El mètode npx funciona perfectament per a proves i avaluació. No requereix paquets npm globals ni canvis permanents al sistema.
Instal·lació global npm
Per a una instal·lació permanent, el paquet npm global proporciona accés consistent:
| npm install n8n -g |
Un cop completada la instal·lació, inicieu n8n en qualsevol moment executant:
| n8n |
La versió estable principal actual d'n8n és la 2.x (per exemple, 2.10.4). Les versions beta poden contenir funcions inestables i s'han d'evitar per a fluxos de treball de producció.
Configuració i emmagatzematge de dades
Les instal·lacions npm emmagatzemen les dades del flux de treball al directori ~/.n8n per defecte. Aquesta ubicació conté credencials, definicions de fluxos de treball i historial d'execució.
Les variables d'entorn controlen el comportament d'n8n. Estableix la variable N8N_PORT per canviar el port 5678 per defecte. Altres variables configuren connexions de base de dades, URLs de webhook i configuracions d'autenticació.
Mètode 2: Execució d'n8n amb Docker
La instal·lació de Docker representa l'enfocament recomanat per a l'allotjament local d'n8n. La documentació oficial emfatitza Docker per a les necessitats d'autoallotjament de producció.
Comandament bàsic de Docker Run
Inicieu n8n amb un sol comandament de Docker:
| docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Aquest comandament crea un contenidor anomenat n8n, mapeja el port 5678 a l'host i persisteix les dades al directori ~/.n8n.
El contenidor s'executa de manera interactiva amb la flag -it. Elimineu --rm per mantenir el contenidor després d'aturar-lo.
Docker Compose per a la configuració de producció
Les configuracions de Docker Compose proporcionen un millor control per a entorns de producció. El repositori n8n-hosting a GitHub conté fitxers Docker Compose llestos per a utilitzar per a diverses arquitectures.
Una configuració bàsica de docker-compose.yml té aquest aspecte:
| 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 |
Inicieu la pila amb:
| docker-compose up -d |
La flag -d executa els contenidors en mode desvinculat, permetent l'ús del terminal per a altres tasques.
Configuració inicial i accés
Després d'iniciar n8n a través de qualsevol dels mètodes, navegueu a localhost:5678 en un navegador web. La pantalla de configuració inicial demana una adreça de correu electrònic i una contrasenya per al compte d'administrador.
Aquest primer usuari esdevé el propietari de la instància amb privilegis administratius complets. Es poden afegir usuaris addicionals més tard a través de la interfície de gestió d'usuaris.
Configuració d'autenticació
Per seguretat, activeu l'autenticació fins i tot en instal·lacions locals. Les configuracions de Docker Compose accepten variables d'entorn d'autenticació directament:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=password |
Aquestes variables activen l'autenticació bàsica HTTP, que requereix credencials per a tots els intents d'accés.
Proves de nodes personalitzats localment
La documentació oficial explica com provar nodes personalitzats durant el desenvolupament. Primer, instal·leu n8n globalment, després compileu i enllaceu el paquet de node personalitzat.
Al directori del node personalitzat, executeu:
| npm run build npm link |
Després, navegueu al directori de nodes d'n8n (normalment ~/.n8n/custom/) i enllaceu el paquet:
| npm link <nom-paquet-node> |
El node personalitzat apareixerà a la interfície d'n8n després de reiniciar la instància.
Recursos d'automatització útils per utilitzar amb n8n
Si esteu aprenent a executar n8n localment i a provar fluxos de treball a la vostra màquina, també us poden ser útils ajudants i plantilles externes que faciliten l'automatització de tasques comunes. Get AI Perks ofereix una biblioteca de plantilles de fluxos de treball i eines assistides per IA que podeu utilitzar juntament amb n8n o per prototipar idees d'automatització abans de crear-les vosaltres mateixos.
Amb Get AI Perks, podeu:
- Començar amb plantilles de fluxos de treball preconstruïdes
- Obtenir assistència d'IA per a lògica i contingut rutinaris
- Explorar patrons d'automatització comuns abans d'implementar-los a n8n
- Combinar plantilles amb la vostra configuració local d'n8n
Descobriu Get AI Perks per trobar ajudes d'automatització que admetin els vostres fluxos de treball d'n8n.
Solució de problemes d'incidències comunes
Els conflictes de ports representen el problema d'instal·lació més freqüent. Si el port 5678 ja està en ús, atureu el servei conflictiu o canvieu el port d'n8n utilitzant la variable d'entorn N8N_PORT.
Incompatibilitat de la versió del node
L'ús de versions de Node.js fora del rang 20.19-24.x causa errors d'instal·lació. El repositori GitHub d'n8n documenta incidències quan els desenvolupadors intenten entorns de desenvolupament locals, destacant la importància de la compatibilitat de la versió de Node.
Verifiqueu la compatibilitat de la versió de Node abans de resoldre altres incidències. Canvieu les versions de Node utilitzant nvm (Node Version Manager) si cal.
Errors de permís de volum de Docker
Els problemes de permisos amb el muntatge de volum ~/.n8n impedeixen la persistència de dades. Els contenidors de Docker s'executen com a usuari node, que podria no tenir accés d'escriptura al directori host.
Creeu el directori amb els permisos adequats abans d'iniciar el contenidor:
| mkdir ~/.n8n chmod 777 ~/.n8n |
Preguntes freqüents
Pot n8n executar-se sense accés a Internet?
Sí, n8n funciona completament fora de línia per als fluxos de treball locals. La connectivitat a Internet només és necessària quan els fluxos de treball interactuen amb API externes o serveis al núvol.
Quant costa executar n8n localment?
Les instal·lacions locals són gratuïtes. L'edició comunitària proporciona totes les funcions principals sense tarifes de llicència. L'allotjament al núvol comença amb límits d'execució i costos mensuals, però l'allotjament local elimina aquestes restriccions completament segons les discussions de la comunitat.
Els principiants haurien d'utilitzar npm o Docker?
Els principiants que provin n8n haurien de començar amb npx per a un accés immediat. Docker té més sentit per a un ús continu ja que proporciona millor aïllament i actualitzacions més fàcils.
On emmagatzema n8n les dades del flux de treball localment?
El directori de dades per defecte és ~/.n8n a la carpeta d'inici de l'usuari. Aquesta ubicació conté fitxers de base de dades SQLite, credencials i registres d'execució, tret que es configuri d'una altra manera.
Es poden executar múltiples instàncies d'n8n en una sola màquina?
Sí, però cada instància necessita un port únic. Establiu ports diferents utilitzant la variable d'entorn N8N_PORT per a cada instància. Docker facilita això a través del mapeig de ports en contenidors separats.
Com funcionen les actualitzacions per a les instal·lacions locals?
Les instal·lacions npm s'actualitzen mitjançant npm update -g n8n o npm install -g n8n@latest. Els usuaris de Docker extreuen la darrera imatge amb docker pull n8nio/n8n, i després reconstrueixen els contenidors. Sempre feu una còpia de seguretat del directori ~/.n8n abans d'actualitzar.
Consideracions de producció
La documentació oficial d'n8n emfatitza que l'autoallotjament requereix coneixements tècnics. Configurar servidors, gestionar recursos i assegurar aplicacions requereix experiència en administració de sistemes.
Per a desplegaments de producció, Docker Compose proporciona la base. Afegiu un proxy invers com nginx o Caddy per a suport HTTPS. El repositori n8n-hosting inclou configuracions de Caddy llestes per a desplegar.
La selecció de la base de dades és important per a càrregues de treball pesades. La base de dades SQLite per defecte funciona per a ús moderat, però PostgreSQL ofereix millor rendiment per a automatització d'alt volum segons la guia oficial.
Prendre la decisió: Local vs. al núvol
L'allotjament local d'n8n s'adapta a equips amb capacitats tècniques i requisits de seguretat específics. Les dades romanen en infraestructura controlada i els límits d'execució desapareixen.
Tanmateix, l'allotjament local requereix manteniment, còpies de seguretat i monitoratge. L'allotjament al núvol transfereix aquestes responsabilitats a l'equip d'infraestructura d'n8n. Consulteu el lloc web oficial per obtenir preus actuals al núvol i comparacions de funcions.
Executar n8n localment proporciona un control complet sobre la infraestructura d'automatització de fluxos de treball. Tant si s'utilitza npm per a proves ràpides com Docker per a desplegaments de producció, ambdós mètodes ofereixen la plataforma completa sense costos recurrents. Comenceu amb npx per a una exploració immediata, i després passeu a Docker quan els fluxos de treball s'aproximin a l'ús de producció.
