vuzon
Interfaz web ligera para gestionar reglas de reenvío de correo y direcciones destino en Cloudflare Email Routing. Diseñada para uso personal o homelab, no como SaaS público.
Ficha actualizada 25 sept 2026, 7:20 · upstream 25 sept 2026, 7:16 · release v2.0.5
Qué es vuzon
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
vuzon es una interfaz web ligera construida con Next.js, React y Node.js que permite gestionar las reglas de reenvío de correo electrónico y las direcciones destino a través de la API de Cloudflare Email Routing. Proporciona un panel de control para crear, pausar o eliminar alias, cambiar sus destinos sin borrarlos y decidir si el correo se reenvía a una dirección verificada o se descarta. Incluye generador de alias aleatorios seguros y gestión de direcciones destino con estado verificado/pendiente.
El sistema no utiliza base de datos; toda la persistencia reside en un volumen Docker que almacena credenciales hash (scrypt), clave de firma de cookies y marca de revocación de sesión. Soporta despliegue único mediante imagen Docker multi-architectura (amd64/arm64) publicada en GHCR. La autenticación se configura la primera vez al acceder al panel, almacenando las credenciales en el servidor, no en variables de entorno.
La interfaz soporta inglés y español, con mensajes de error localizados. Requiere una zona de Cloudflare con Email Routing habilitado y un token de API con permisos específicos (Edición de direcciones y reglas de reenvío, Lectura de zona). No incluye telemetría ni servicios de terceros; todo funciona contra la cuenta del usuario.
- Centralizar la gestión de alias de correo electrónico para múltiples servicios (Netflix, tienda online) en un solo dominio.
- Pausar reglas de reenvío temporalmente sin borrarlas para evitar spam o errores de configuración.
- Generar alias aleatorios seguros para pruebas o uso único sin riesgo de adivinación.
- Gestionar una dirección catch-all que descarte el correo no solicitado sin perder la funcionalidad.
- Verificar direcciones destino antes de asignarlas a un alias para evitar reenvíos fallidos.
- Sin base de datos: persistencia en volumen Docker con hash scrypt, sin texto plano.
- Autenticación segura: credenciales configuradas en el navegador la primera vez, no en .env.
- Multi-architectura: imagen única compatible con amd64 y arm64 para homelab.
- Validación estricta de destinos: solo direcciones verificadas pueden ser destino de alias.
- Sin telemetría ni dependencias externas: todo contra la API de Cloudflare del usuario.
- Generador de alias criptográficamente seguro usando crypto.getRandomValues.
- Uso exclusivo para homelab o redes privadas; no apto como SaaS multi-tenant público.
- Requiere configuración manual de DOMAIN y CF_API_TOKEN en el archivo .env.
- No permite borrar la regla catch-all mediante API, solo pausarla o cambiar su acción.
- Actualizaciones desde 1.x a 2.x reinician sesión y requieren reconfiguración de credenciales.
- Dependencia obligatoria de Cloudflare: no funciona sin zona habilitada para Email Routing.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Docker Compose. Crear carpeta, descargar docker-compose.yml y .env.example, copiar .env.example a .env y rellenar DOMAIN y CF_API_TOKEN. Ejecutar docker compose pull && docker compose up -d. Puerto por defecto 8001 (configurable con VUZON_PORT). Tras el primer acceso, configurar usuario y contraseña en el panel; las credenciales se hashan en el volumen vuzon-data. Para actualizar, ejecutar docker compose pull && docker compose up -d. Eliminar AUTH_USER, AUTH_PASS y SESSION_SECRET de .env si actualiza desde 1.x.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.