![\"Mascote](\"\/wp-content\/uploads\/2026\/10\/goguacamole-rdp-ssh-vnc-navegador-go.webp\")
<\/p>\n<\/p>\n
Quien ya haya subido el Apache Guacamole<\/a> conoce el paquete: Tomcat, el Esta entrada cubren la versi\u00f3n 0.6.2<\/strong> (30 de octubre de 2026): qu\u00e9 hace el proyecto, c\u00f3mo encaja en guacd, c\u00f3mo levantarlo en un minuto con una sola imagen, c\u00f3mo colocarlo detr\u00e1s de nginx, c\u00f3mo grabar y auditar sesiones y c\u00f3mo migrar desde el cliente Java. El c\u00f3digo est\u00e1 en github.com\/jniltinho\/go-guacamole<\/a>, bajo licencia MIT.<\/p>\n Apache Guacamole tiene dos mitades. El guacd<\/strong> es el demonio en C que habla RDP, SSH y VNC con los servidores y lo traduce todo al protocolo Guacamole. El guacamole-client<\/strong> es la aplicaci\u00f3n web en Java que autentica al usuario, guarda las conexiones y los permisos y entrega la pantalla al navegador. GoGuacamole reescribe solo la segunda mitad:<\/p>\n Usuarios, grupos, carpetas de conexiones, permisos heredados, historial, grabaci\u00f3n, auditor\u00eda, inicio de sesi\u00f3n externo y MFA vienen listos, sin extensiones separadas. La interfaz tiene 16 temas y est\u00e1 en ingl\u00e9s y portugu\u00e9s de Brasil.<\/p>\n El navegador solo se comunica con goguacamole, mediante HTTPS y WebSocket. goguacamole habla el protocolo Guacamole con guacd, que permanece en una red privada, y guacd abre la conexi\u00f3n RDP, SSH o VNC con el servidor de destino. El host, el usuario y la contrase\u00f1a de la conexi\u00f3n permanecen en el servidor, cifrados con AES-256-GCM; el navegador nunca los ve.<\/p>\n La apertura de una sesi\u00f3n sigue este camino:<\/p>\n Si se revoca el permiso a mitad del proceso, el t\u00fanel se cierra al instante. Los cambios realizados por otro proceso (la CLI o el importador) se detectan en un plazo de hasta 5 segundos.<\/p>\n Desde la versi\u00f3n 0.6.0, cada versi\u00f3n publica en GHCR una imagen que re\u00fane guacd, goguacamole y Redis en un contenedor, con SQLite en el volumen Para fijar la versi\u00f3n, usa la etiqueta Dentro del contenedor, supervisord mantiene los tres procesos en ejecuci\u00f3n como el usuario Este modo HTTP es para evaluaci\u00f3n local. Para producci\u00f3n, consulta la lista de verificaci\u00f3n m\u00e1s abajo.<\/p>\n Para ver una sesi\u00f3n real sin tocar ning\u00fan servidor, coloca GoGuacamole y un OpenSSH desechable en la misma red Docker. El guacd de la imagen all-in-one resuelve el destino por nombre de contenedor. Si el contenedor de la secci\u00f3n anterior sigue en ejecuci\u00f3n, elim\u00ednalo antes ( En la interfaz, en Conexiones \u2192 Nueva conexi\u00f3n<\/strong>, elige SSH, host Al terminar, elimina el laboratorio:<\/p>\n Para un entorno duradero, el repositorio incluye un guacamole-client<\/code> en Java, una extensi\u00f3n JDBC para la base de datos, otra para LDAP, otra para TOTP, otra para grabaciones, cada una con su archivo de configuraci\u00f3n. El GoGuacamole<\/strong> es mi nuevo proyecto para sustituir esa parte por un \u00fanico binario Go<\/strong>, con la interfaz en Vue 3 integrada, manteniendo el mismo guacd<\/code> de Apache por debajo. Sigues accediendo a servidores mediante RDP, SSH y VNC desde el navegador<\/strong>, pero obtienes grabaci\u00f3n de sesi\u00f3n, auditor\u00eda, SSO y MFA configurados en la propia interfaz, adem\u00e1s de poder importar la base de datos de Guacamole que ya tienes.<\/p>\nQu\u00e9 es GoGuacamole<\/h2>\n
\n
\/api\/v1<\/code>, t\u00fanel WebSocket compatible con el guacamole-common-js<\/code> y el protocolo Guacamole implementado directamente, incluido el handshake con guacd (por TCP o TLS).<\/li>\nembed<\/code>, la misma t\u00e9cnica que la parte 5 de la serie Vue.js + Go con Echo v5<\/a>.<\/li>\nguacamole\/guacd<\/code> 1.6 sigue haciendo el trabajo pesado de los protocolos.<\/li>\n<\/ul>\n![\"Painel](\"\/wp-content\/uploads\/2026\/10\/goguacamole-painel.webp\")
<\/p>\nArquitectura: qui\u00e9n habla con qui\u00e9n<\/h2>\n
![\"Diagrama](\"\/wp-content\/uploads\/2026\/10\/goguacamole-arquitetura.webp\")
<\/p>\n\n
POST \/api\/v1\/sessions<\/code> con el ID de la conexi\u00f3n. El servidor comprueba la sesi\u00f3n, las restricciones del usuario (validez de la cuenta, ventana de acceso) y el permiso efectivo de lectura.<\/li>\n\/api\/v1\/tunnel?ticket=\u2026<\/code> enviando solo par\u00e1metros de pantalla (anchura, altura, DPI, zona horaria). El servidor valida el origen, recupera el ticket y vuelve a autorizar.<\/li>\nLevant\u00e1ndolo en un minuto: la imagen all-in-one<\/h2>\n
\/data<\/code>:<\/p>\ndocker run -d --name goguacamole -p 8080:8080 \\\n -v goguacamole-data:\/data ghcr.io\/jniltinho\/go-guacamole:allinone\n\n# a senha gerada do admin aparece uma \u00fanica vez no log\ndocker logs goguacamole 2>&1 | grep 'bootstrap administrator'<\/code><\/pre>\n0.6.2-allinone<\/code> (o 0.6-allinone<\/code>). Abra http:\/\/localhost:8080<\/code>, entre como admin<\/code> con la contrase\u00f1a del log y el sistema pide una contrase\u00f1a nueva en el primer acceso. La disponibilidad se puede comprobar mediante la API:<\/p>\ncurl -s http:\/\/localhost:8080\/ready\n# {\"db\":\"up\",\"guacd\":\"up\",\"queue\":\"up\"}<\/code><\/pre>\nguacd<\/code> (uid 1000), propietario de los archivos en \/data<\/code>. Por eso, los comandos de la CLI se ejecutan como -u guacd<\/code>:<\/p>\ndocker exec goguacamole supervisorctl status # guacd, redis, goguacamole\ndocker exec -u guacd goguacamole goguacamole user passwd admin\ndocker exec goguacamole goguacamole version<\/code><\/pre>\nProb\u00e1ndolo con un servidor SSH de laboratorio<\/h2>\n
docker rm -f goguacamole<\/code>), porque el laboratorio utiliza el mismo nombre y el mismo puerto:<\/p>\ndocker network create guac-lab\ndocker run -d --name goguacamole --network guac-lab -p 8080:8080 \\\n -v goguacamole-data:\/data ghcr.io\/jniltinho\/go-guacamole:allinone\ndocker run -d --name ssh-alvo --network guac-lab \\\n -e USER_NAME=demo -e USER_PASSWORD='troque-esta-senha' -e PASSWORD_ACCESS=true \\\n lscr.io\/linuxserver\/openssh-server:latest<\/code><\/pre>\nssh-alvo<\/code>, puerta 2222<\/code> (la puerta de esta imagen), usuario demo<\/code> y la contrase\u00f1a. Antes de guardar, usa Probar conexi\u00f3n<\/strong>: GoGuacamole abre una conexi\u00f3n real mediante guacd con los valores del formulario e indica si el host respondi\u00f3 y si el inicio de sesi\u00f3n funcion\u00f3. En mi prueba, la contrase\u00f1a correcta volvi\u00f3 como \u00e9xito en unos 200 ms, y la incorrecta volvi\u00f3 como fallo de autenticaci\u00f3n, sin guardar nada. Despu\u00e9s solo hay que guardar y hacer clic en Conectar<\/strong>: la terminal se abre en una pesta\u00f1a del navegador.<\/p>\ndocker rm -f goguacamole ssh-alvo\ndocker volume rm goguacamole-data\ndocker network rm guac-lab<\/code><\/pre>\nDocker Compose con servicios separados<\/h2>\n
docker-compose.yml<\/code> con goguacamole, guacd y Redis en contenedores separados, y perfiles para MariaDB, PostgreSQL y servidores de prueba:<\/p>\ngit clone https:\/\/github.com\/jniltinho\/go-guacamole.git\ncd go-guacamole\ncp .env.example .env\n# no .env, defina APP_ADMIN_PASSWORD (8+ caracteres); a chave pode ser gerada assim:\nprintf 'APP_SECRET_KEY=%s\\n' \"$(openssl rand -hex 32)\" >> .env\nmake up # app + guacd + Redis, SQLite \u2192 http:\/\/localhost:8080<\/code><\/pre>\n
![\"Player](\"\/wp-content\/uploads\/2026\/10\/goguacamole-player-gravacao.webp\")
<\/p>\n