🥑 Instalar y configurar Apache Guacamole en Proxmox paso a paso

 Que es Apache Guacamole?

Acceder de forma remota a nuestros servidores, escritorios o equipos de trabajo se ha vuelto esencial, ya sea en entornos domésticos, profesionales o educativos. La mayoría de las veces dependemos de clientes pesados como Remote Desktop, VNC Viewer o PuTTY, que requieren instalación, configuración y mantenimiento en cada dispositivo desde el que nos conectamos.

Aquí es donde entra en juego Apache Guacamole, un proyecto open-source desarrollado por la Fundación Apache, que permite acceder a escritorios y servidores directamente desde el navegador, sin necesidad de instalar nada más que un navegador moderno.

Con Guacamole puedes:

• Conectarte por RDP, VNC o SSH desde cualquier dispositivo.

• Centralizar todas tus conexiones en una sola interfaz web.

• Olvidarte de instalaciones pesadas: solo entras con tu usuario y contraseña.

• Usarlo como una pasarela de acceso remoto centralizada y segura.

En este tutorial veremos cómo desplegar Apache Guacamole en un servidor Proxmox VE, aprovechando la flexibilidad de los contenedores (LXC) o máquinas virtuales, y con soporte para Docker y Docker Compose. Al final tendrás un servicio completamente funcional, accesible vía navegador y listo para añadir tus conexiones remotas.

🧱 Instalación paso a paso en Proxmox (LXC)

Vamos a aprovechar un script automático mantenido por la comunidad para instalar Guacamole sin complicaciones.
👉 Enlace oficial del script:
https://community-scripts.github.io/ProxmoxVE/scripts?id=apache-guacamole

1️⃣ Crear el contenedor LXC

Desde la consola de tu Proxmox, ejecuta:

bash -c "$(wget -qLO - https://community-scripts.github.io/ProxmoxVE/scripts/setup.sh)"

Esto abrirá el menú interactivo del Proxmox Helper-Scripts.

El script se encargará de crear un contenedor LXC basado en Debian 12, instalar Docker y desplegar Apache Guacamole con todo configurado.

Durante el proceso te pedirá algunos datos, o si hemos escogido la opción por "default" nos lo rellenará todo automáticamente.

🚀 Configuración inicial y primer acceso

Abre el navegador y entra a la dirección del contenedor o servidor.
Por ejemplo:

http://TU_IP:8080/guacamole


Verás la pantalla de inicio de sesión.

Credenciales por defecto:

Usuario: guacadmin
Contraseña: guacadmin

➡️ Una vez dentro, lo primero que deberías hacer es cambiar la contraseña de guacadmin:

1. Clic en tu nombre (arriba a la derecha).

2. “Preferences” → “Change Password”

🔌 Añadir conexiones (RDP, SSH, VNC)

Desde el panel principal:

1. Ve a Settings → Connections → New Connection.

2. Rellena los campos según el tipo de conexión:

🖥️ RDP (Windows)

• Protocol: RDP

• Hostname: IP o nombre del equipo Windows

• Port: 3389

• Username / Password: credenciales del usuario

• (Opcional) Marca Enable clipboard o Full screen

💻 SSH (Linux)

• Protocol: SSH

• Hostname: IP del equipo

• Port: 22

• Username / Password o clave privada.

🧩 VNC (Escritorio remoto genérico)

• Protocol: VNC

• Hostname: IP del equipo

• Port: 5900

💡 Cada conexión que crees aparecerá como un icono en la pantalla de inicio.

---

🛡️ Buenas prácticas y seguridad

Antes de dejarlo en producción o abrirlo a Internet, revisa esto:

• 🔐 Cambia la contraseña de guacadmin (¡en serio!).

• ⚙️ Usa HTTPS (por ejemplo, con un proxy inverso Nginx o Caddy).

• 🧱 Si lo expones fuera, usa fail2ban o firewall.

• 📦 Haz copia de seguridad del volumen /config o del contenedor entero.

• 🚪 Cambia el puerto 8080 si lo deseas (en Docker o LXC).

---

🧭 Conclusión

Con esto ya tienes tu propio portal de acceso remoto vía web funcionando, sin dependencias de clientes ni software adicional.

Puedes conectar a servidores, PCs, Raspberry Pi o incluso otros contenedores, todo desde una única página web.

💬 Y listo, Guacamole funcionando y accesible desde cualquier navegador.

Nos leemos en el próximo post 👋