Postal: plataforma SMTP autoalojada para agencias

Por qué las agencias necesitan una plataforma SMTP completa

Lo que Postal aporta a tu agencia

• Interfaz web multi-servidor: crea un servidor de envío aislado por cliente o proyecto, con sus propias credenciales SMTP y clave API.
• Estadísticas por servidor de envío: volumen entrante y saliente y rebotes, en gráficos de 24 h, 48 h o 30 días — un servidor por cliente te da una vista por cliente.
• Gestión de rebotes en tiempo real: cada fallo de entrega queda registrado y clasificado (SoftFail temporal, HardFail definitivo), cada rebote recibido se vincula al mensaje original, visible en la interfaz y enviado via webhook a tu aplicación.
• API REST y webhooks: integra Postal con tu CRM, plataforma de e-commerce o herramienta de facturación.
• Colas de mensajes: los envíos se ponen en cola y son trazables hasta el acuse de recibo o el error final, sin caja negra.
• Aislamiento de clientes: cada servidor Postal puede recibir su propio pool de IP (opción use_ip_pools) y su propio límite de envío — con IP distintas, un cliente en dificultades no afecta a la reputación de los demás.
• Licencia MIT: código abierto, sin coste por correo, sin dependencia de terceros.

Requisitos previos: VPS, puerto 25 e IPv4 dedicada

Instalación de Postal en un VPS

1. 01

   Preparar el servidor e instalar Docker

   Conéctate como root en tu VPS Ubuntu 24.04, actualiza los paquetes e instala Docker Engine y el plugin Compose:

   apt update && apt upgrade -y
   curl -fsSL https://get.docker.com | sh
   apt install -y git curl jq
   docker --version && docker compose version

   Verifica que el puerto 25 saliente esté abierto: nc -zv smtp.gmail.com 25. Si falla, contacta con tu proveedor para desbloquearlo.

2. 02

   Configurar DNS para el servidor Postal

   Antes del bootstrap, crea los registros DNS para el dominio de tu instalación Postal (p.ej. postal.tu-agencia.com):

   - Registro A: postal.tu-agencia.com → IP del VPS
   - rDNS (PTR): configúralo en tu panel de control
   - SPF global (TXT en spf.postal.tu-agencia.com): v=spf1 ip4:<IP_VPS> ~all
   - Return path: rp.postal.tu-agencia.com con un registro A hacia la IP, un MX 10 postal.tu-agencia.com, un TXT v=spf1 a mx include:spf.postal.tu-agencia.com ~all y, tras el bootstrap, el DKIM que muestra postal default-dkim-record en postal._domainkey.rp.postal.tu-agencia.com

   Espera la propagación DNS (15 a 30 minutos) antes de continuar.

3. 03

   Bootstrap de la configuración de Postal

   Clona el repositorio de instalación oficial, que proporciona el comando postal, y genera la configuración:

   git clone https://github.com/postalserver/install /opt/postal/install
   ln -s /opt/postal/install/bin/postal /usr/bin/postal
   postal bootstrap postal.tu-agencia.com

   Esto genera en /opt/postal/config los ficheros postal.yml, signing.key y Caddyfile, además de un docker-compose.yml (en /opt/postal/install) fijado en la última versión publicada. Abre postal.yml e introduce las credenciales de MariaDB, el SMTP de notificación y los nombres DNS de tu instalación (sección dns).

4. 04

   Iniciar MariaDB e inicializar la base de datos

   Lanza un contenedor MariaDB dedicado, accesible solo en local y protegido por una contraseña generada, y luego inicializa el esquema de Postal:

   openssl rand -hex 24 > /root/postal-db.pass && chmod 600 /root/postal-db.pass
   docker run -d --name postal-mariadb \
     -p 127.0.0.1:3306:3306 \
     -e MARIADB_ROOT_PASSWORD="$(cat /root/postal-db.pass)" \
     -e MARIADB_DATABASE=postal \
     --restart always mariadb:10.11
   
   postal initialize

   Copia esta contraseña en las secciones main_db y message_db de postal.yml antes de ejecutar postal initialize.

5. 05

   Crear el primer usuario administrador

   Crea tu cuenta de administrador para acceder a la interfaz web:

   postal make-user

   Introduce el correo electrónico, el nombre y la contraseña del administrador.

6. 06

   Iniciar Postal y configurar el proxy inverso

   Lanza todos los servicios de Postal (web, workers, SMTP):

   postal start
   postal status

   Postal expone la interfaz web en 127.0.0.1:5000, inaccesible desde Internet. Coloca un proxy inverso (Caddy o nginx) delante para terminar TLS y accede a https://postal.tu-agencia.com.

7. 07

   Crear una organización y el primer servidor de envío

   En la interfaz de Postal, crea una organización (tu agencia) y luego un servidor de envío para tu primer cliente. Cada servidor tiene sus propias credenciales SMTP, su propia clave API y sus propios dominios de envío — es la unidad de aislamiento por cliente.

   Anota el hostname SMTP, el puerto (25 por defecto, configurable con smtp_server.default_port) y las credenciales generadas: son los datos que deberás facilitar a la aplicación cliente.

Configuración de un dominio remitente

v=spf1 include:spf.postal.tu-agencia.com ~all

postal-XXXXXX._domainkey.dominio-cliente.com  TXT  "v=DKIM1; t=s; h=sha256; p=<clave pública>"

psrp.dominio-cliente.com  CNAME  rp.postal.tu-agencia.com

Gestión de rebotes y estadísticas

[2026-10-15 09:14:22] Delivery attempt to mx1.example.com (203.0.113.10:25)
[2026-10-15 09:14:22] << 550 5.1.1 <[email protected]> User unknown
[2026-10-15 09:14:22] Message marked as HardFail (permanent)

Postal vs soluciones SaaS vs relay Postfix

Desplace la tabla

Una infraestructura de correo bajo tu control