Saltar al contenido

Autoalojamiento

Lista de comprobación para producción

Qué revisar en una instancia autoalojada de Notifuse antes de enviar correos reales desde ella.

Repasa esta lista antes de que una instancia autoalojada envíe su primera campaña real. Parte del compose.yaml oficial de Instalación.

Red y HTTPS

  • Pon un proxy inverso con TLS delante de Notifuse. compose.yaml sirve HTTP sin cifrar en el puerto 8081, en todas las interfaces salvo que definas HTTP_BIND=127.0.0.1 en .env, algo que conviene hacer cuando el proxy está en el mismo servidor. Consulta Instalación.
  • Haz que el proxy reenvíe la cabecera Host original, o define X-Forwarded-Host. Sin ella, las versiones web de tus correos dejan de abrirse (Un endpoint de API público).
  • Define como endpoint de la API la dirección HTTPS pública, como https://emails.yourcompany.com. El asistente de configuración rellena Punto final de la API con la dirección de la página, así que revísalo si ejecutaste el asistente por HTTP sin cifrar. Notifuse escribe esta dirección en los correos, las invitaciones y los webhooks de los proveedores. Para cambiarla más adelante, sigue Cambiar tu dominio.

Secretos y base de datos

  • Genera SECRET_KEY una sola vez, con openssl rand -base64 32, y guarda una copia fuera del servidor. Cifra las credenciales almacenadas, y una clave nueva por sí sola las deja ilegibles. Para cambiarla, sigue Sustituir la clave secreta.
  • Da a PostgreSQL su propia contraseña con DB_PASSWORD en .env, como hacen los comandos de instalación. Sin ella, compose.yaml usa postgres.
  • Mantén el puerto de PostgreSQL vinculado a 127.0.0.1. El compose.yaml oficial lo publica como 127.0.0.1:5433, accesible desde el propio servidor para psql y las copias de seguridad. Si el 5433 está ocupado, define POSTGRES_HOST_PORT en .env en lugar de abrir el puerto a la red.
  • No muevas el directorio que contiene compose.yaml. Compose da su nombre al volumen de la base de datos, y un directorio renombrado inicia una nueva instalación sobre una base de datos vacía (Instalación).

Correo

  • Configura el servidor SMTP del sistema y envía una prueba desde Probar la conexión en el asistente de configuración. Notifuse envía por él los códigos de inicio de sesión y las invitaciones, así que nadie puede recibir un código de inicio de sesión hasta que funcione. Puedes cambiarlo más adelante como root en Configuración del sistema.
  • Conecta cada espacio de trabajo a su proveedor de correo. El servidor SMTP del sistema solo lleva los códigos de inicio de sesión y las invitaciones; los espacios de trabajo configuran su propio proveedor para las campañas y el correo transaccional.
  • Autentica tu dominio de envío (SPF, DKIM, DMARC) con ese proveedor antes de la primera campaña. Notifuse no comprueba estos registros, así que verifícalos en el proveedor. Consulta Autenticar tu dominio.
El panel Configuración del sistema: correo de root, punto final de la API y el SMTP del sistema usado para los códigos de inicio de sesión
El panel Configuración del sistema: correo de root, punto final de la API y el SMTP del sistema usado para los códigos de inicio de sesión

Copias de seguridad

  • Haz copias de seguridad programadas de todas las bases de datos (notifuse_system y cada base de datos notifuse_ws_…), y guarda SECRET_KEY junto a los volcados, fuera del servidor. Copias de seguridad da los comandos.
  • Restaura al menos una vez una copia en una instalación vacía e inicia sesión para revisar tus espacios de trabajo antes de confiar en ella.
  • Cuando la restauración funcione, define DB_EXPECT_EXISTING=true en .env. Notifuse se negará entonces a arrancar sobre una base de datos vacía en lugar de crear en ella una nueva instalación.

Actualizaciones y telemetría

  • Decide qué hacer con Buscar actualizaciones y Telemetría anónima, activados los dos por defecto en el asistente de configuración. La búsqueda de actualizaciones muestra las nuevas versiones y las correcciones de seguridad en la lista de espacios de trabajo. Cambia cualquiera de los dos más adelante en Configuración del sistema (Buscar actualizaciones, Telemetría), o con las variables CHECK_FOR_UPDATES y TELEMETRY, que prevalecen sobre la consola.
  • Fija la versión que ejecutas con NOTIFUSE_VERSION en .env (por ejemplo NOTIFUSE_VERSION=v44.0), para que una nueva copia de compose.yaml no te actualice por sorpresa. Cuando actualices, sigue Actualizar a una nueva versión.

Monitorización

  • Vigila GET /healthz. Responde 200 con {"status":"ok"} cuando Notifuse llega a su base de datos del sistema en menos de 2 segundos, y 503 con {"status":"unavailable"} en caso contrario. compose.yaml ya lo usa como health check del contenedor, cada 30 segundos.
  • Lee el log del servidor con docker compose logs -f api. compose.yaml lo limita a cinco archivos de 10 MB.