Protege el editor
Coloca el editor detrás de HTTPS y de una autenticación compatible. Restringe el acceso administrativo y evita el registro público cuando no sea necesario. Las rutas de webhook necesitan sus propias decisiones de exposición y autenticación.
Conservar la clave de credencial
Respalda la clave de cifrado configurada con la protección adecuada. Restaurar una base de datos sin la clave correcta puede dejar las credenciales guardadas inutilizables. Mantén la clave fuera de capturas de pantalla, repositorios y registros sin filtrar.
Escala la ruta de ejecución de forma deliberada
Para una configuración con mucha carga, revisa el modelo de base de datos, cola y trabajadores compatibles. Redis y los trabajadores separados añaden sus propios requisitos de acceso y persistencia. Limita los trabajos concurrentes para que un pico no agote el VPS ni un presupuesto externo de API.
Conservar solo datos de ejecución útiles
Los flujos de trabajo pueden manejar tokens, registros personales y documentos. Configure la depuración del historial de ejecución, redacte los valores sensibles y defina los reintentos con cuidado. Un webhook duplicado no debe provocar un segundo pago o mensaje no deseado.
Trata la clave de cifrado como parte de la base de datos
Las credenciales guardadas dependen de la clave de cifrado de n8n. Conserva el directorio de estado que contiene una clave generada automáticamente o establece N8N_ENCRYPTION_KEY desde un almacén de secretos privado. Todos los workers de la cola necesitan la misma clave que el proceso principal. Prueba la restauración con una credencial desechable; una base de datos restaurada por sí sola puede parecer saludable mientras sus credenciales siguen siendo ilegibles.
- Mantén la clave fuera del directorio público y del repositorio
- Realice copias de seguridad de la base de datos de forma consistente
- Usa PostgreSQL compatible para el despliegue de producción previsto
Documentación oficial: configuración de clave de cifrado n8n
Dale a los webhooks su dirección pública
Un proxy inverso como Caddy puede terminar HTTPS mientras n8n escucha internamente. La documentación actual usa N8N_WEBHOOK_URL para el origen externo del webhook y reemplaza el nombre anterior WEBHOOK_URL desde la versión 2.35.0. Establece el número de saltos de proxy de confianza según la ruta real; un único proxy usa N8N_PROXY_HOPS=1. Conserva el host, el protocolo y la información del cliente reenviados. Prueba un webhook desde fuera del servidor y verifica su URL de producción.
- Define la zona horaria del flujo de trabajo de forma deliberada
- Purga el historial de ejecuciones que contenga entradas sensibles
- Usa trabajadores de cola y Redis solo con los controles de acceso privado requeridos
# Example: one HTTPS reverse proxy
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1Documentación oficial: n8n detrás de un proxy inverso
Define la carga de trabajo y las integraciones permitidas
Enumera los desencadenantes, las cuentas externas, el volumen de ejecución previsto y el gasto máximo o efecto secundario que puede crear cada flujo de trabajo. Consulta la licencia de n8n para el uso real, especialmente si lo ofreces como servicio a terceros. Un pequeño flujo de trabajo programado y un procesador de webhooks público tienen necesidades de recursos distintas. Empieza con una versión compatible, estado persistente privado, un nombre de TLS y una base de datos adecuada al despliegue; evita exponer los puertos de la base de datos con el editor.
- Utilice credenciales restringidas independientes para cada integración.
- Configura la zona horaria prevista del flujo de trabajo y la retención del historial de ejecución.
- Mantenga los flujos de trabajo exportados libres de secretos reales incrustados.
Documentación oficial: n8n Despliegue con Docker
Establece el origen público del webhook para la versión instalada
Un proxy inverso como Caddy llega a n8n internamente mientras los servicios externos llaman a su origen de webhook HTTPS. Usa la variable de webhook URL documentada para la versión instalada; la documentación actual la denomina N8N_WEBHOOK_URL, mientras que las versiones anteriores usaban WEBHOOK_URL. Establece el número real de saltos de proxy en lugar de confiar en cabeceras reenviadas arbitrarias. Mantén la política de acceso al editor separada de la autenticación del webhook y verifica que la devolución de llamada de producción no contenga un host o puerto interno.
# Example values for a supported current release, behind one proxy:
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1Documentación oficial: n8n ajustes del proxy inverso de webhook
Probar un flujo de trabajo inofensivo antes de conceder acceso de escritura
Comienza con una solicitud de solo lectura o un registro de prueba desechable. Prueba el webhook de producción desde fuera del VPS, el rechazo de autenticación y un reintento deliberado. Una solicitud repetida no debe crear accidentalmente una segunda acción con consecuencias. Revisa los registros de ejecución en busca de entradas filtradas y luego aplica una política de retención. Si un webhook solo funciona en el modo de prueba del editor, comprueba si el flujo de trabajo está publicado/activo y si las rutas de producción y de prueba llegan al proceso correcto.
- Usa una credencial de integración desechable para probar una restauración.
- Conserva una copia cifrada independiente de N8N_ENCRYPTION_KEY o del estado de clave generado.
- No envíes contraseñas de ejemplo ni tokens de API a salidas de depuración que se conserven.
Documentación oficial: clave de cifrado de n8n
Escale solo después de observar el cuello de botella de ejecución
El modo cola añade Redis, trabajadores y una base de datos compartida; el proceso principal recibe los disparadores mientras los trabajadores realizan las ejecuciones. Todos los trabajadores deben usar la misma clave de cifrado de credenciales. Sigue los requisitos actuales de almacenamiento de datos binarios antes de mover un flujo de trabajo con archivos al modo cola. Limita la concurrencia y los presupuestos de API del upstream, y supervisa la antigüedad de la cola y los fallos. Haz copia de seguridad de la base de datos, el estado y la clave juntos; reiniciar un contenedor no es un plan de recuperación para credenciales guardadas ilegibles.
Documentación oficial: modo cola de n8n · Ajustes de purga de ejecuciones