spoke-protonmail
Módulo Spoke que expone Proton Mail Bridge como servicio SMTP/IMAP mediante Docker, integrando autenticación GPG y pasarela de puertos para compatibilidad con aplicaciones empresariales.
Ficha actualizada 28 sept 2026, 0:44 · upstream 28 sept 2026, 0:32 · release v1.0.0
Qué es spoke-protonmail
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio implementa un módulo Spoke diseñado para exponer Proton Mail Bridge como servicio de correo electrónico SMTP e IMAP. El contenedor utiliza una imagen personalizada construida desde el código fuente, integrando herramientas como mailutils, ssmtp y socat para facilitar la configuración y pruebas de conectividad. La arquitectura incluye pasarela de puertos que mapea los puertos internos del puente a los estándares externos (25, 143, 465, 587, 993) a través de una red troxy.
- Integración de ProtonMail como servidor SMTP/IMAP para aplicaciones empresariales que requieren autenticación GPG
- Sincronización bidireccional de correo entre servidores locales y la nube de ProtonMail
- Pruebas de conectividad SMTP/IMAP en entornos de desarrollo con soporte para herramientas de testeo integradas
- Implementación de pasarela de correo segura con almacenamiento persistente de claves GPG y caché
- Imágenes Docker personalizadas construidas desde el código fuente con soporte multi-etapa (Go builder + Debian slim)
- Integración automática de claves GPG Ed25519/Curve25519 para gestión segura de credenciales pass
- Pasarela de puertos socat que mapea puertos internos a estándares SMTP/IMAP sin modificar aplicaciones cliente
- Almacenamiento persistente para configuración, caché y claves GPG mediante mounts bind en /appdata
- Herramientas de testeo integradas (mailutils + ssmtp) para validación de conectividad SMTP
- Ejecución no root con configuración flexible de UID/GID vía argumentos de construcción
- Requiere plan ProtonMail Mail Plus o superior para compatibilidad con el puente
- Configuración manual obligatoria en primera ejecución mediante CLI proton-bridge --cli
- Dependencia de red troxy preconfigurada en el hub Spoke para funcionamiento correcto
- Necesidad de generar secretos externos (proton_bridge_password) fuera del contenedor
- Requiere Docker con BuildKit habilitado para construcción desde código fuente
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.
Despliegue requiere hub Spoke con red troxy. Copiar .env.example, editar con identidad GPG y crear secretos en ${SECRETS_DIR}/proton/. Construir con docker compose build y ejecutar inicial sin --noninteractive para autenticación CLI. Actualizar secreto con password generado antes de reiniciar en modo no interactivo. Montar /appdata persistente para supervivencia de datos entre reinicios.
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.