workfromhome-with-docker
Puerta de enlace de escritorio remoto HTML5 con Apache Guacamole y Traefik para acceso seguro a Windows/RDS desde cualquier navegador web, integrando autenticación LDAP Active Directory y autenticación de dos factores (2FA).
Ficha actualizada 18 sept 2026, 21:39 · upstream 28 ene 2022, 18:21 · release sin release detectada
Qué es workfromhome-with-docker
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona una solución completa para acceder a escritorios remotos Windows o RDS mediante un gateway basado en HTML5. Utiliza Apache Guacamole como cliente sin instalación, soportando protocolos RDP, VNC y SSH, lo que permite el acceso desde cualquier dispositivo con navegador web sin necesidad de software adicional en el cliente.
La arquitectura incluye Traefik como proxy inverso para gestionar terminación SSL con certificados Letsencrypt automáticos y renovación. La integración con Active Directory se realiza mediante LDAP sin modificar el esquema AD, mapeando usuarios a Guacamole y permitiendo autenticación centralizada. El sistema soporta autenticación de dos factores (2FA) usando Google Authenticator o implementaciones TOTP compatibles.
El despliegue se automatiza mediante scripts que instalan Docker, Docker Compose y clonan el repositorio en un servidor Ubuntu. La configuración requiere variables de entorno obligatorias en un archivo .env para definir credenciales, dominios LDAP y FQDN. Incluye soporte para credenciales passthrough en conexiones RDP, permitiendo usar las credenciales del usuario Guacamole directamente sin almacenar contraseñas estáticas.
- Acceso remoto seguro a escritorios Windows o RDS desde cualquier ubicación usando solo un navegador web HTML5.
- Integración con Active Directory para autenticación centralizada de usuarios corporativos sin modificar el esquema LDAP.
- Implementación de autenticación de dos factores (2FA) para aumentar la seguridad del acceso remoto a infraestructuras críticas.
- Solución ideal para entornos homelab o pequeñas oficinas que requieren acceso remoto sin instalar clientes en los dispositivos de usuario final.
- Cliente cero: Apache Guacamole permite acceso desde cualquier navegador web sin instalar software adicional en el dispositivo del usuario.
- Seguridad robusta con terminación SSL automática mediante Traefik y certificados Letsencrypt, más autenticación LDAP y 2FA.
- Integración directa con Active Directory sin modificar el esquema AD, usando mapeo de usuarios por userPrincipalName.
- Credenciales passthrough en conexiones RDP para evitar almacenar contraseñas estáticas en la configuración del gateway.
- Despliegue automatizado con scripts que instalan Docker y clonan el repositorio en un servidor Ubuntu preconfigurado.
- No escalable para miles de usuarios; recomendado para entornos de hasta 50+ usuarios según la documentación oficial.
- Dependencia de conexión a internet estable para la renovación automática de certificados SSL y autenticación LDAP.
- Requiere configuración manual de variables de entorno en .env, incluyendo FQDN, credenciales iniciales y parámetros LDAP.
- No incluye Dockerfile ni Docker Compose nativo; requiere ejecución de scripts install.sh y start.sh para el despliegue.
- El puerto 389 (LDAP) debe estar accesible desde la red interna para la autenticación con Active Directory.
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 en servidor Ubuntu con Docker. Redirige tráfico de puertos 80 y 443 del router a la IP interna del servidor. Registra un nombre DNS público (ej. desktops.yourcompany.com) apuntando a la IP externa o usa DynDNS. Ejecuta install.sh como root para instalar dependencias, luego edita .env con variables obligatorias (FQDN_HOST_NAME, LDAP_USER_BASE_DN, etc.). Inicia con start.sh. Cambia inmediatamente las credenciales por defecto (guacadmin/guacadmin). Verifica acceso interno en http://ubuntu-internal-ip:8081/guacamole si el DNS externo no responde.
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.