atreoAGENT
Daemon autoalojado en Go que conecta servidores locales con usuarios remotos mediante túneles WireGuard cifrados, mapeo de puertos automático y gestión de ACLs por aplicación.
Ficha actualizada 26 sept 2026, 17:54 · upstream 26 sept 2026, 17:46 · release v1.2.4
Qué es atreoAGENT
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
atreoAGENT es un daemon escrito en Go diseñado para funcionar como puente seguro entre una infraestructura self-hosted local (como Jellyfin, Immich o Home Assistant) y usuarios remotos. Utiliza WireGuard para establecer túneles punto a punto cifrados de extremo a extremo, garantizando que el tráfico no sea legible por terceros ni por la propia plataforma de coordinación atreoLINK.
El sistema automatiza tareas complejas como el mapeo de puertos mediante UPnP, NAT-PMP y PCP (soportando IPv4 e IPv6), eliminando la necesidad de configuración manual de firewall. Además, gestiona certificados TLS automáticos vía Let's Encrypt para subdominios gestionados o dominios personalizados, asegurando una conexión segura sin intervención del usuario.
Incluye capacidades avanzadas de seguridad como listas de control de acceso (ACLs) granulares que permiten restringir el acceso a aplicaciones específicas por miembro familiar. También ofrece un gateway SMTP opcional que transforma alertas de correo en notificaciones push cifradas, y utiliza pinning de identidad criptográfica para verificar la autenticidad de los mensajes entre pares.
- Acceso remoto seguro a servicios self-hosted desde dispositivos móviles o TV sin abrir puertos manualmente en el router.
- Gestión centralizada de notificaciones push cifradas para alertas de aplicaciones locales (ej. anillos de puerta, copias de seguridad).
- Implementación de políticas de acceso granulares donde diferentes miembros de la familia acceden a subconjuntos distintos de aplicaciones.
- Conversión de alertas SMTP tradicionales en notificaciones push cifradas sin necesidad de un servidor de correo externo.
- Túneles WireGuard punto a punto con cifrado de extremo a extremo, donde atreoLINK solo coordina metadatos y no lee el tráfico.
- Automatización completa del mapeo de puertos (UPnP, NAT-PMP, PCP) para IPv4 e IPv6, eliminando configuraciones manuales de firewall.
- Gestión automática de certificados TLS con Let's Encrypt para subdominios atreoLINK y dominios personalizados.
- ACLs granulares que permiten restringir el acceso a aplicaciones específicas por miembro familiar en el nivel del proxy.
- Gateway SMTP-to-push opcional que cifra alertas de correo y las enruta como notificaciones push seguras.
- Dependencia de un servicio externo (atreoLINK) para la coordinación, relaying de mensajes y gestión de identidad.
- Requiere kernel Linux 5.6+ con módulo WireGuard integrado o compilado externamente.
- Necesita permisos de sistema específicos en Docker: capacidad NET_ADMIN y acceso al dispositivo /dev/net/tun.
- El gateway SMTP opcional requiere configuración adicional (puerto 2525, autenticación) y no es funcional por defecto.
- La integración con aplicaciones locales puede requerir apuntar explícitamente a la IP del agente o usar el proxy.
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 un host Linux con Docker y kernel 5.6+. Ejecutar con `docker compose up -d` usando `network_mode: host`, capacidad `NET_ADMIN` y dispositivo `/dev/net/tun`. Montar volumen de datos en `./data`. Para usar nombres de contenedor como destinos, montar el socket Docker en modo lectura. Asegurar que el servicio atreoLINK esté activo para la aprobación del emparejamiento inicial.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.