Cómo instalar el agente Nod de n8n en tu VPS
Instala Nod, el agente Apache-2.0 de n8n, con Docker Compose en un VPS. Mantén el puerto 4310 privado y respalda la clave Vault antes de usarlo.
Qué es Nod y qué va a crear
Nod es un agente de IA personal del equipo que creó n8n. Puede ejecutarlo en un VPS con el kit de Docker Compose de su propio repositorio. Esta guía fija el kit en la etiqueta nod-v0.8.1 y mantiene la aplicación en un puerto privado. Puede acceder a ella mediante un túnel SSH o a través de HTTPS. El paso de copia de seguridad forma parte de la instalación porque las credenciales guardadas no se pueden recuperar sin una clave.
El README describe Nod como un agente con su propio equipo y navegador: "Persigue facturas, prepara sus llamadas y cancela periodos de prueba en sitios web reales. Se ejecuta en su máquina con el modelo que elija y le pregunta antes de actuar en su nombre." Puede hablar con él en un único chat. Tiene su propio espacio de trabajo Linux y un navegador, y se conecta a Gmail, Calendar, Slack, Notion y la web.
Dos aspectos permiten establecer expectativas antes de instalar nada. Primero, el README etiqueta Nod como una "vista previa de investigación". El sitio de documentación también muestra un aviso de "Vista previa inicial" que indica: "Espere aspectos sin pulir y cambios incompatibles." Segundo, el README indica que la comprobación de seguridad de Nod "es el juicio de un modelo". Trátelo como una herramienta en vista previa. Concédale acceso sólo a las cuentas con las que esté dispuesto a hacer pruebas.
Un VPS es adecuado para Nod por una razón sencilla. La documentación indica que las tareas programadas sólo se ejecutan mientras está encendida la máquina donde se ejecuta Nod. Un portátil entra en suspensión. Un servidor no.
En qué se diferencia Nod de un flujo de trabajo con un agente de IA de n8n
Nod no es n8n AI Assistant y no necesita n8n para ejecutarse. El README responde a la pregunta «¿Necesito n8n?» con: «No. Nod es una aplicación independiente, creada por el equipo responsable de n8n. No es n8n AI Assistant».
La documentación de n8n describe el nodo AI Agent así: «Conecte un modelo de chat y una o varias herramientas, y el agente decidirá qué herramientas debe llamar para completar una tarea». Este agente se crea dentro del editor de n8n y es obligatorio conectarle al menos un subnodo de herramienta. Si esa es la tarea que necesita realizar, crear un flujo de trabajo con un nodo AI Agent en n8n explica cómo hacerlo. Alojar n8n en un VPS con Docker y HTTPS proporciona el servidor n8n donde puede crearlo.
Esta es nuestra interpretación de los dos conjuntos de documentación. Un nodo AI Agent es un agente que se diseña nodo a nodo dentro de n8n. Nod es una aplicación de chat terminada, con su propio espacio de trabajo y navegador, a la que se asignan tareas en lenguaje natural. Ninguna página del proveedor compara ambos productos, así que considérelo un resumen, no una postura oficial.
Los dos pueden funcionar juntos. La página de Nod sobre n8n indica: «Conecte n8n una vez y después solicítelo por su nombre en el chat». Nod puede crear entonces «un agente de n8n con las herramientas y el canal que indique». Si la solicitud no menciona n8n, Nod utiliza sus propias tareas y programaciones.
La licencia: Nod usa Apache-2.0; n8n no
El repositorio de Nod, github.com/n8n-io/nod, se distribuye bajo Apache License 2.0 y el titular de los derechos de autor es n8n GmbH. El pie del README indica: «Copyright 2026 n8n GmbH · Apache License 2.0». Los recursos de terceros incluidos, como la fuente Geist, los logotipos de los proveedores y los componentes del runtime de escritorio, mantienen sus propias condiciones.
n8n utiliza una licencia diferente. Su código, excepto los archivos marcados con .ee., se distribuye bajo Sustainable Use License. Su principal limitación se expresa así: «Sólo puede usar o modificar el software para sus propios fines empresariales internos o para usos no comerciales o personales». Apache-2.0 no impone una limitación de este tipo sobre el uso de Nod. Si está decidiendo qué puede crear sobre n8n, lea la explicación de Sustainable Use License de n8n antes de planificar un producto basado en él.
Requisitos de la VPS para ejecutar Nod
La documentación de instalación autónoma indica que se necesita Docker Engine 25 o posterior con Compose v2, OpenSSL y sha256sum o shasum. Una compilación desde el código fuente también necesita Git. Los hosts compatibles son Linux en AMD64 o ARM64, o un Mac con Docker Desktop.
En cuanto al tamaño, la documentación indica: "Empiece con 2 núcleos de CPU, 8 GB de memoria y 50 GB de disco." Es una recomendación inicial, no un mínimo medido. La documentación añade que las tareas simultáneas del navegador y los modelos locales necesitan más capacidad. El archivo compose.yaml del kit explica la mayor parte de la cifra de memoria. Limita el contenedor del servidor a 2 GB, el navegador a 3 GB y el espacio de trabajo a 2 GB. Puede cambiar estos límites con NOD_SERVER_MEMORY, NOD_BROWSER_MEMORY y NOD_WORKSPACE_MEMORY en .env. Postgres y Caddy no tienen límite.
No necesita una clave de API de modelo para instalarlo. Conecta un modelo en la aplicación después de iniciarla.
Instale Docker primero si el servidor no lo tiene. Conceptos básicos de Docker Compose en una VPS explica el procedimiento. Después, compruebe las versiones y añada las demás herramientas:
docker version
docker compose version
sudo apt update && sudo apt install -y git opensslLa sección Server: de docker version debe mostrar la versión 25 o posterior, y docker compose version debe ejecutarse correctamente. Los comandos siguientes presuponen que el usuario puede ejecutar docker sin sudo. Si no puede, añada sudo delante de cada comando docker y sh.
Clonar el repositorio de Nod en una etiqueta fijada
El kit se encuentra en deployment/self-host/ y crea sus imágenes de Nod a partir de la copia de trabajo local. No se descarga nada específico de Nod de un registro, por lo que la etiqueta que extraiga determina la versión que ejecutará.
git clone https://github.com/n8n-io/nod.git
cd nod
git checkout nod-v0.8.1
cd deployment/self-host
lsls debería mostrar setup.sh, compose.yaml, Caddyfile, backup.sh y restore.sh, entre otros archivos. Las etiquetas nod-v0.8.0 y nod-v0.8.1 se crearon el 16 de noviembre de 2026. No son las más recientes. A fecha del 21 de noviembre de 2026, nod-v0.9.1 (20 de noviembre) aparece marcada como Latest. Esta guía se comprobó con el kit nod-v0.8.1, por lo que fija esa etiqueta. La sección de actualización siguiente explica cómo avanzar a una versión posterior.
Las imágenes de terceros de compose.yaml están fijadas mediante un digest, no mediante :latest: postgres:17-alpine, node:24.21.0-bookworm-slim y caddy:2.11.7-alpine. Las imágenes de Nod usan la etiqueta local de forma predeterminada, mediante NOD_IMAGE_TAG. Establecer esa variable no descarga una versión publicada.
Generar los secretos con setup.sh
sh setup.shsetup.sh no acepta opciones. Copia .env.example en un .env privado y completa cuatro valores generados: un nombre de proyecto de Compose, NOD_AUTH_TOKEN (a partir de openssl rand -hex 32), NOD_VAULT_KEY (a partir de openssl rand -base64 32) y NOD_POSTGRES_PASSWORD. Después ejecuta chmod 600 .env, de modo que sólo su usuario pueda leer el archivo.
Al final muestra Ready. Run: docker compose --file compose.yaml --env-file .env up -d --build --wait. Si .env ya existe, lo conserva y muestra Using the existing .env. Its keys and data are unchanged. Se niega a ejecutarse cuando NOD_AUTH_TOKEN, NOD_VAULT_KEY o NOD_POSTGRES_PASSWORD ya está definida en su shell. Si exportó alguna de ellas, elimínela primero con unset. En una versión antigua de Docker se detiene con Use Docker Engine 25 or newer.
Compilar e iniciar la pila
docker compose up -d --build --wait
docker compose psLa primera compilación es lenta porque el kit compila las imágenes de Nod desde el código fuente. Mantenga el terminal abierto hasta que el comando termine. --wait espera hasta que los servicios con comprobaciones de estado informen que están saludables, por lo que una ejecución sin errores significa que la pila está activa. docker compose ps debería mostrar server, postgres, browser y los demás servicios en ejecución, con server marcado como saludable.
Si ejecuta docker compose up antes de setup.sh, Compose se niega a iniciar e imprime Run sh setup.sh first. Esto ocurre porque compose.yaml marca NOD_AUTH_TOKEN como obligatorio, y sólo setup.sh lo escribe.
Para leer el registro del servidor:
docker compose logs --tail 100 serverLa documentación indica que el token nunca se muestra en los registros de inicio.
El puerto 4310 permanece en loopback, y ufw no es lo que lo protege
El servidor publica su puerto del host de esta forma en compose.yaml:
'${NOD_BIND_ADDRESS:-127.0.0.1}:${PORT:-4310}:${PORT:-4310}'Por tanto, Nod escucha en el puerto 4310, y el lado del host está enlazado a 127.0.0.1. Sólo los procesos del propio servidor pueden conectarse. Manténgalo así.
Esto es más importante de lo que parece, porque los puertos publicados por Docker omiten ufw. La documentación de Docker indica que el tráfico dirigido a un puerto publicado del contenedor «se desvía antes de pasar por la configuración del firewall de ufw» y «en la práctica ignora la configuración del firewall». Una regla ufw deny 4310 no protegería un puerto publicado en todas las interfaces. El enlace a loopback es lo que mantiene privado el puerto 4310. Por qué los puertos de Docker omiten ufw muestra el mecanismo y cómo comprobarlo en su propio servidor.
Docker añade una salvedad relacionada con la versión. En releases anteriores a 28.0.0, los hosts del mismo segmento de red de capa 2 pueden acceder a los puertos publicados en localhost. En un VPS, ese segmento es la red del proveedor. Por tanto, use Docker 28 o una versión posterior si es posible.
No cambie NOD_BIND_ADDRESS por 0.0.0.0 para acceder remotamente a la aplicación. La documentación indica: «Nunca exponga PostgreSQL, el navegador, el workspace ni la conexión de Docker». Use una de las dos vías de acceso siguientes.
Abrir Nod mediante un túnel SSH
El túnel no necesita ningún dominio ni puertos abiertos adicionales aparte de SSH. Ejecute esto en su propio equipo, no en el servidor:
ssh -L 4310:127.0.0.1:4310 user@203.0.113.10Mantenga abierta esa sesión y visite http://localhost:4310 en el navegador local. Para esta configuración, deje NOD_PUBLIC_URL en su valor predeterminado local, http://localhost:4310. Si cambió PORT, cambie ambos extremos del túnel y la dirección del navegador para que coincidan.
La aplicación solicita el token de acceso. Muéstrelo en el servidor:
grep NOD_AUTH_TOKEN .envPegue el valor después de = en el formulario de acceso. A continuación, complete la configuración inicial y conecte un modelo. El token es obligatorio incluso a través del túnel.
Si accede a sus servidores mediante Tailscale, lea Tailscale Serve frente a Funnel antes de poner cualquier elemento delante de Nod, porque Funnel publica un servicio en Internet público.
O servir Nod mediante HTTPS con el perfil de Caddy
Para una dirección pública, el kit incluye un perfil https. Añade un contenedor de Caddy que obtiene y renueva el certificado TLS (seguridad de la capa de transporte) y reenvía el tráfico al servidor. Necesita un dominio cuyo registro DNS apunte al VPS. También necesita permitir las conexiones TCP entrantes en 80 y 443 en el firewall de red de su proveedor, si dispone de uno.
Edite .env y establezca el origen exacto:
NOD_PUBLIC_URL=https://nod.example.comNOD_PUBLIC_URL es «el origen exacto en el que abre Nod». Escriba sólo el esquema y el host. Las rutas, las cadenas de consulta y los fragmentos se rechazan. El perfil requiere un origen https:// en el puerto 443 con un nombre DNS o un host IPv4. A continuación, inicie la pila con el perfil:
docker compose --profile https up -d --build --waitSiga añadiendo --profile https a los comandos posteriores de inicio, parada y consulta de estado; de lo contrario, Compose omitirá el contenedor de Caddy. Abra https://nod.example.com y pegue el token como se indicó arriba.
Tenga claro qué puertos se exponen. El servicio de Caddy publica 80:80, 443:443 y 443:443/udp sin una dirección de enlace, por lo que esos puertos escuchan en todas las interfaces. Siempre usa los puertos del host 80 y 443, independientemente de lo que indique PORT. Debido al bypass de Docker descrito arriba, ufw no los cerrará. Si ya ejecuta un reverse proxy, omita el perfil. Apunte el proxy a 127.0.0.1:4310 y establezca NOD_PUBLIC_URL en el origen HTTPS del proxy.
Datos de uso y comentarios: compruebe qué está habilitado
La documentación indica: «El uso compartido está habilitado para los propietarios nuevos». Los datos se envían al proyecto de PostHog del equipo de Nod, alojado en la UE, también desde instalaciones independientes. La implementación también debe permitirlo, y NOD_ANALYTICS_ENABLED=false siempre lo deshabilita.
El kit de nod-v0.8.1 incluye NOD_ANALYTICS_ENABLED=false en .env.example, y setup.sh copia esa línea en su .env. Por tanto, una instalación nueva siguiendo esta guía comienza con los análisis deshabilitados a nivel del servidor. Compruébelo:
grep -n NOD_ANALYTICS_ENABLED .envSi falta la línea o está vacía, el servidor considera que los análisis están permitidos cuando se ejecuta en modo de producción. Esto puede ocurrir con un .env antiguo o escrito manualmente. En ese caso, establezca usted mismo la línea en false.
El recopilador de comentarios es independiente. NOD_FEEDBACK_ENABLED no está en .env.example, y la documentación indica que está habilitado de forma predeterminada. La documentación describe una exclusión completa: establezca los análisis y los comentarios en false y deje NOD_ONBOARDING_EMAIL_URL vacío.
echo 'NOD_FEEDBACK_ENABLED=false' >> .env
grep -n -e NOD_ANALYTICS_ENABLED -e NOD_FEEDBACK_ENABLED -e NOD_ONBOARDING_EMAIL_URL .env
docker compose up -d --wait serverEl último comando vuelve a crear el servidor con los valores nuevos. Añada --profile https si lo utiliza. Los propietarios también pueden cambiar el uso compartido en la aplicación, en Settings, Privacy & data, Share usage data. Detener el uso compartido no elimina los datos que ya se hayan enviado.
Haz una copia de seguridad de la clave de Vault y de los datos: este paso no es opcional
NOD_VAULT_KEY es "una clave de 32 bytes codificada en base64 que cifra las credenciales guardadas". Se encuentra en .env, fuera de la base de datos. La documentación de Vault indica: "Las credenciales guardadas no se pueden leer sin ella". Nod nunca genera un reemplazo cuando ya existen datos cifrados. La página de instalación autónoma indica: "La base de datos por sí sola no puede recuperar las credenciales guardadas". Si pierdes la clave, se pierden todos los inicios de sesión que hayas proporcionado a Nod, incluso con un volcado perfecto de la base de datos.
Por tanto, guarda primero la clave por separado, en un gestor de contraseñas o en otro lugar seguro fuera del servidor:
grep NOD_VAULT_KEY .envDespués, haz una copia de seguridad completa con el script del kit. El destino debe ser una ruta absoluta que todavía no exista:
mkdir -p "$HOME/nod-backups"
chmod 700 "$HOME/nod-backups"
sh backup.sh "$HOME/nod-backups/nod-2026-11-21"El script detiene el servidor, el navegador y el espacio de trabajo mientras realiza la copia. Después, vuelve a iniciarlos. Muestra Backup saved: y la ruta. El directorio contiene .env, source-commit, un postgres.dump, archivos de los datos del servidor, el espacio de trabajo, las herramientas y el navegador, además de un archivo indicador complete. Comprueba que el indicador esté presente antes de confiar en la copia de seguridad.
La documentación indica: "La copia de seguridad contiene secretos". Incluye todos los secretos generados, incluida la clave de Vault. Guárdala cifrada y restringe quién puede leerla. Cópiala fuera del servidor, porque una copia de seguridad en el mismo disco se pierde si falla ese disco. Los certificados TLS no están incluidos.
Restaurar Nod en un checkout nuevo
La restauración se realiza en una carpeta nueva y en un proyecto Compose nuevo. Consulte el commit desde el que se creó la copia de seguridad y haga checkout exactamente de ese commit:
commit="$(cat "$HOME/nod-backups/nod-2026-11-21/source-commit")"
git clone https://github.com/n8n-io/nod.git nod-restored
cd nod-restored
git checkout "$commit"
cd deployment/self-host
sh restore.sh "$HOME/nod-backups/nod-2026-11-21" nod-restoredNo ejecute setup.sh primero. restore.sh necesita un checkout sin .env y un source-commit que coincida con la revisión seleccionada. Crea volúmenes nuevos, restaura la base de datos y no inicia la aplicación. Termina con Restored into a new project. Review .env before starting Nod.
Detenga el servidor original antes de iniciar el restaurado. Después, ejecute docker compose up -d --build --wait con --profile https para una dirección pública. No ejecute nunca docker compose down --volumes en un servidor cuyos datos quiera conservar. Elimina los volúmenes de datos.
Actualizar Nod a una etiqueta más reciente
Primero, haga una copia de seguridad. Después, desde nod/deployment/self-host:
docker compose stop
git fetch origin --tags
git checkout nod-v0.9.1
docker compose up -d --build --waitLas migraciones de la base de datos se ejecutan cuando Nod se inicia, por lo que no puede deshacer una actualización recuperando la etiqueta anterior. La documentación indica: «No apunte una versión anterior de la aplicación a una base de datos que ya se haya actualizado». Para revertir el cambio, restaure la copia de seguridad anterior a la actualización en una copia nueva del repositorio. Lea las notas de la versión antes de cada salto, porque la etiqueta de vista previa indica que se esperan cambios incompatibles. No cambie COMPOSE_PROJECT_NAME durante una actualización.
Para rotar el token de acceso, ejecute openssl rand -hex 32, sustituya el valor NOD_AUTH_TOKEN en .env y ejecute docker compose up -d --wait server. El token anterior dejará de funcionar. Nunca sustituya NOD_VAULT_KEY para rotar el acceso.
FAQ
¿Necesito n8n para ejecutar Nod?
No. El README indica que Nod es una aplicación independiente, desarrollada por el equipo responsable de n8n, y que no es n8n AI Assistant. Se ejecuta en su propia pila de Docker Compose. Puede conectar después una instancia de n8n y pedir a Nod que la use por nombre, pero la instalación no depende de n8n.
¿Nod es de código abierto con la misma licencia que n8n?
No. Nod utiliza Apache License 2.0, con copyright de n8n GmbH, y los recursos de terceros incluidos mantienen sus propias condiciones. El código de n8n que no está incluido en sus archivos .ee. utiliza Sustainable Use License, que limita el uso a fines empresariales internos, no comerciales o personales. Apache-2.0 no impone esa limitación de uso.
¿Cómo abro Nod en un VPS sin un dominio?
Use un túnel SSH desde su propio equipo: ssh -L 4310:127.0.0.1:4310 user@203.0.113.10. Manténgalo abierto, visite http://localhost:4310 y pegue NOD_AUTH_TOKEN del .env del servidor. Deje NOD_PUBLIC_URL con su valor local predeterminado. El puerto 4310 sigue enlazado a loopback en el servidor, por lo que no se expone nada nuevo.
¿Qué ocurre si pierdo NOD_VAULT_KEY?
Las credenciales guardadas no se pueden volver a leer. La clave las cifra y se almacena en .env, fuera de la base de datos. Nod no genera una clave de sustitución cuando ya existen datos cifrados, por lo que un volcado de la base de datos no basta. Guarde una copia de la clave fuera del servidor. Ejecute también sh backup.sh con una ruta absoluta, porque la copia de seguridad incluye .env junto con la clave.
¿ufw protege los puertos de Nod?
No los puertos que Docker publica. Docker envía tráfico a los puertos publicados de los contenedores sin aplicar las reglas de ufw. El puerto 4310 sólo es privado porque compose.yaml lo enlaza a 127.0.0.1. El perfil https publica 80, 443 y 443/udp en todas las interfaces, por lo que ufw no puede cerrarlos. En versiones de Docker anteriores a 28.0.0, los hosts del mismo segmento de capa 2 también pueden acceder a los puertos publicados en localhost.