Recursos · Integración n8n

Nodo Local File Trigger n8nConfigura Local File Trigger en n8n.

Algo cambia en el disco y el flujo arranca solo. El nodo Local File Trigger n8n vigila un archivo concreto o una carpeta entera, reacciona a altas, cambios y borrados, y ofrece 8 parámetros para filtrar el ruido. Pensado para equipos que siguen trabajando con archivos.

Probar el nodo Local File Trigger en n8nVer los 8 parámetros

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué vigila el nodo Local File Trigger n8n?

Local File Trigger es un trigger, es decir, un nodo que abre el flujo de trabajo en lugar de colocarse en medio. Escucha el sistema de archivos de la máquina donde corre n8n y lanza una ejecución cuando un archivo o una carpeta se añade, cambia o desaparece. No hay cuenta que enlazar ni URL que registrar: indicas una ruta, marcas los eventos y el flujo arranca por su cuenta.

Primer caso, un archivo de configuración que no debería cambiar en silencio. Trigger On se pone en Changes to a Specific File, Watch for deja solo File Changed y el aviso llega a un canal de Slack. Cada edición deja rastro, incluidas las que se hacen directamente en el servidor.

Segundo caso, la carpeta de administración. Un proveedor deja su factura en PDF, el nodo salta con File Added y el resto del flujo la renombra y anota la referencia en Google Sheets. Nadie vuelve a repasar la carpeta a final de mes.

Tercer caso, una carpeta de exportación que se llena durante todo el día. Aquí el problema es el ruido: Ignore descarta los archivos temporales, Ignore Existing Files/Folders evita que el histórico dispare en la primera activación y un nodo If reparte lo que queda según la extensión.

¿Cuándo conviene otra cosa? Este nodo solo ve lo que ve la máquina de n8n. Un documento que vive detrás de una API no es un evento del sistema de archivos: ahí entra un nodo dedicado, o HTTP Request cuando ningún nodo dedicado cubre esa llamada. HTTP Request es el recurso para un endpoint HTTP, nunca para un protocolo que no lo sea.

Conviene conocer los límites antes de montar nada. La documentación oficial avisa del riesgo de seguridad en instancias abiertas a usuarios no fiables: el nodo viene desactivado por defecto desde n8n 2.0 y se describe como exclusivo del autoalojamiento. La versión máxima del nodo es la versión 1, así que un flujo antiguo muestra el mismo panel. En una unidad de red suele hacer falta Use Polling, y los patrones regex de Ignore pueden fallar en macOS. Si todavía estás eligiendo plataforma, la Reseña n8n repasa los criterios.

Parámetros

¿Cómo se ajusta cada parámetro?

El nodo Local File Trigger tiene 8 parámetros. Para cada uno: el nodo tal como lo configuras en n8n, qué cambia el parámetro y nuestras notas de campo.

01

Trigger On

triggerOn

Lo que ves en n8n

Notas y casos de uso

Este selector obligatorio define la forma entera del nodo: un archivo bajo vigilancia, o una carpeta y todo lo que ocurre dentro. Se decide primero, porque los campos siguientes cambian según la respuesta.

Parámetros clave

  • Trigger On: file (Changes to a Specific File) o folder (Changes Involving a Specific Folder).
  • File to Watch: la ruta que se sigue, al estilo de /data/invoices/1.pdf.
  • Watch for: la lista obligatoria de eventos, add (File Added), change (File Changed), unlink (File Deleted), addDir (Folder Added), unlinkDir (Folder Deleted).
Casos de uso
una carpeta vigilada solo con File Added, para que un depósito de facturas lance una ejecución por documento nuevo y no repita con cada retoque posterior.
02

Await Write Finish

options.awaitWriteFinish

Lo que ves en n8n

Notas y casos de uso

Un archivo grande no aparece de golpe. Con esta opción activada, n8n espera a que termine la escritura antes de lanzar la ejecución, y así no se lee un documento copiado a medias.

Parámetros clave

  • Await Write Finish: una casilla, añadida con Add option dentro de la colección Options igual que el resto de opciones del nodo.
Casos de uso
un escáner que escribe un PDF pesado directamente en la carpeta vigilada. Sin la espera, el nodo siguiente abre a veces un archivo truncado y el fallo parece aleatorio.
04

Ignore

options.ignored

Lo que ves en n8n

Notas y casos de uso

El filtro de todo lo que no debe despertar al flujo. n8n comprueba la ruta completa, no solo el nombre del archivo, y el campo acepta sintaxis Anymatch, del tipo **/*.txt or ignore-me/subfolder.

Parámetros clave

  • Ignore: los archivos o rutas que se descartan. Los patrones regex pueden fallar en macOS, y la coincidencia por subcadena pasa por la opción Ignore Mode puesta en Contain.
Casos de uso
una carpeta de exportación donde la herramienta escribe un archivo temporal antes de renombrarlo. Descartar ese patrón elimina las ejecuciones duplicadas sin tocar el resto del ajuste.
05

Ignore Existing Files/Folders

options.ignoreInitial

Lo que ves en n8n

Notas y casos de uso

Cuando empieza la escucha, todo lo que ya estaba en la carpeta puede contar como algo que avisar. Esta opción le dice a n8n que deje quieto ese contenido previo y reaccione solo a lo que venga después.

Parámetros clave

  • Ignore Existing Files/Folders: una casilla que impide que los archivos y carpetas ya presentes disparen un evento.
Casos de uso
activar un flujo sobre un directorio de archivo histórico bien lleno. Sin ella, la primera activación inunda la lista de ejecuciones y los eventos útiles quedan enterrados.
06

Max Folder Depth

options.depth

Lo que ves en n8n

Notas y casos de uso

En modo carpeta, la vigilancia puede bajar tanto como permita el árbol. Este selector pone el techo, para que una unidad compartida no acabe seguida rama por rama sin que nadie lo haya pedido.

Parámetros clave

  • Max Folder Depth: 0 (Top Folder Only), de 1 a 5 (1 Levels Down hasta 5 Levels Down), o -1 (Unlimited).
Casos de uso
un directorio de clientes con una subcarpeta por cuenta. Top Folder Only detecta las cuentas nuevas, y 1 Levels Down detecta además los documentos guardados dentro.
07

Use Polling

options.usePolling

Lo que ves en n8n

Notas y casos de uso

La vigilancia corre normalmente a cargo del propio sistema de archivos. En red suele no informar de nada, y esta opción pasa el nodo a polling, es decir, una comprobación periódica de la ruta en lugar de esperar un aviso.

Parámetros clave

  • Use Polling: una casilla, normalmente necesaria para vigilar archivos a través de la red.
Casos de uso
una carpeta montada desde un NAS. Los eventos llegan bien en la prueba local y dejan de llegar en cuanto la misma ruta es un montaje de red, y este ajuste es el que lo arregla.
08

Ignore Mode

options.ignoreMode

Lo que ves en n8n

Notas y casos de uso

Este selector decide cómo se lee el valor de Ignore: como un patrón que debe coincidir, o como un texto que debe aparecer en la ruta. Es la opción compañera que se olvida cuando un filtro no atrapa nada.

Parámetros clave

  • Ignore Mode: match (Match) para patrones regex como **/*.txt, no compatible con macOS, o contain (Contain) para ignorar los archivos cuya ruta contiene el valor.
Casos de uso
un equipo en macOS que quiere descartar todo lo guardado en un directorio de borradores. Contain con una palabra sencilla resuelve lo que un patrón no consigue.
Necesitas ayuda

¿Necesitas ayuda para automatizar Local File Trigger con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Local File Trigger y n8n, dudas frecuentes

01¿El nodo Local File Trigger n8n viene incluido?
Sí. Es un nodo core, incluido con n8n: nada que instalar y ningún coste extra por el lado de n8n. Hay un detalle que conviene tener claro antes de planificar: la documentación oficial indica que este nodo no está disponible en n8n Cloud y que viene desactivado por defecto desde n8n 2.0, porque vigilar un sistema de archivos se vuelve arriesgado en una instancia abierta a usuarios no fiables. En la práctica funciona sobre una instancia autoalojada, levantada con Docker o con npm. El flujo que montas allí sigue siendo un flujo de n8n normal, lo que cambia es el acceso a los archivos.
02¿Qué credenciales necesita Local File Trigger?
Ninguna. Este nodo no tiene credential, es decir, ningún acceso guardado dentro de n8n, ni selector Authentication: no hay nada que configurar en la cuenta ni nada que renovar más adelante. Lo que sí necesita es acceso. La ruta que escribes tiene que ser visible para la máquina que ejecuta n8n, así que hablamos de un volumen montado en el contenedor y no de una carpeta que solo existe en tu portátil. La otra condición es el estado del flujo: en el editor, la ejecución de prueba abre una escucha puntual para comprobar el ajuste, y en producción el flujo tiene que estar activo para que el nodo siga escuchando.
03¿Qué límites tiene el nodo Local File Trigger?
El primero es de alcance: el nodo ve el sistema de archivos de su propia máquina y nada más. La versión máxima del catálogo es la versión 1, así que no hay un panel más reciente con opciones adicionales esperando. Las unidades de red son la segunda trampa, porque los eventos se pierden con frecuencia a través de un montaje y Use Polling es la respuesta documentada. En macOS, los patrones regex de Ignore pueden fallar, lo que empuja hacia Ignore Mode en Contain. Suma la restricción de alojamiento de la documentación, solo autoalojado y desactivado por defecto desde n8n 2.0.
04¿Cuándo usar este nodo en lugar de HTTP Request?
Local File Trigger cuando el evento es un archivo que aparece, cambia o desaparece en un disco al que llega la máquina de n8n. HTTP Request cuando el dato vive detrás de un endpoint HTTP y ningún nodo dedicado cubre esa llamada. No se sustituyen entre sí, porque HTTP Request es el recurso para una API HTTP y nunca una forma de alcanzar un protocolo que no sea HTTP. La prueba es sencilla. Si encontrarías el archivo con un explorador en el servidor, este nodo es la puerta de entrada correcta. Si lo encontrarías con una URL, no lo es.
05¿n8n o Make para vigilar archivos?
Depende de dónde vivan los archivos. Make es una plataforma de automatización alojada, sin opción de autoalojamiento y facturada por operación, así que una carpeta que está en tu propio servidor no es algo que pueda vigilar de forma directa. n8n corre sobre tu infraestructura cuando tú lo decides, que es justo lo que este nodo da por hecho, y una carpeta muy activa no se convierte en una factura por contador. Make conserva sus ventajas, empezando por una lógica visual que muchos equipos leen rápido. Si los documentos no salen de tu red, el autoalojamiento es la opción coherente.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.

Misma plataforma

Otros docs útiles sobre este stack.

Ver todas las integraciones