Guacamole na VPS: acesso remoto pelo navegador
Guacamole 1.6.0 com Docker: licença Apache 2.0, guacd e aplicação web, PostgreSQL, Nginx com HTTPS, troca da senha padrão, 2FA com TOTP, conexões RDP e SSH e atualização.
Por Redação Eleven Host · @robson.direitodigital · 14 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Guacamole na VPS: acesso remoto pelo navegador Arte: Eleven Host
Guacamole na VPS é um gateway de área de trabalho remota que abre RDP, VNC e SSH no navegador, sem plugin nem programa instalado no computador de quem acessa. A equipe monta o serviço num servidor e alcança as máquinas da empresa de qualquer lugar.
Atualizado em 14/11/2026. Os comandos abaixo são exemplos: confira cada um no seu servidor antes de usar. O artigo O que é servidor VPS: guia simples para iniciantes explica o que é uma VPS.
O que é o Guacamole
O Apache Guacamole é um projeto da Apache Software Foundation, com licença Apache 2.0. A página oficial o descreve como um gateway de área de trabalho remota sem cliente, que suporta protocolos padrão como VNC, RDP e SSH. Graças ao HTML5, depois de instalado no servidor, o acesso às máquinas é feito pelo navegador.
São duas peças. O guacd fala RDP, VNC e SSH com os computadores de destino. A aplicação web, que roda no Tomcat, é o que o navegador acessa e conversa com o guacd na porta 4822.
Em 14/11/2026, a versão estável do Guacamole é a 1.6.0, de 22/06/2025. Os exemplos abaixo fixam as imagens guacamole/guacamole:1.6.0 e guacamole/guacd:1.6.0, as duas na mesma versão, sem a tag latest.
Por que a versão importa
Muitos tutoriais antigos usam a série 1.5.x. A página de segurança do projeto lista a CVE-2024-35164, que afeta a 1.5.5 e as anteriores e foi corrigida na 1.6.0. Em linguagem simples, um usuário mal-intencionado com acesso a uma conexão de texto, como o SSH, podia executar código com os privilégios do processo guacd.
A 1.6.0 reúne as correções publicadas na página de segurança, e por isso é a usada aqui.
A 1.6.0 também trocou nomes de variáveis do Docker. A POSTGRESQL_USER virou POSTGRESQL_USERNAME, e a GUACD_LOG_LEVEL deu lugar à LOG_LEVEL. Copiar variáveis de um tutorial antigo pode quebrar a subida, então os exemplos abaixo usam os nomes novos.
Antes de começar
O caminho aqui é o Docker, com um banco PostgreSQL para a autenticação. Instale o Docker pelo método oficial, seguindo a página de instalação do Docker para o seu sistema (docs.docker.com/engine/install). Os comandos de Docker abaixo pressupõem um usuário que consiga rodá-lo; se o seu não pode, use sudo. Se ainda não sabe o que muda entre as opções de servidor, VPS gerenciada ou não gerenciada: qual a diferença ajuda a decidir.
Faixa de entrada na loja: VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Escolha um subdomínio para o acesso, como acesso.exemplo.com.br, e crie um registro A no DNS apontando para o IP da VPS. As portas 80 e 443 precisam estar abertas para o certificado HTTPS. Abra o DNS e as portas antes de pedir o certificado.
Rede e banco de dados
Os três contêineres conversam por uma rede Docker própria. Um exemplo de comando:
docker network create guacnet
Em seguida, o PostgreSQL. Com a imagem oficial postgres, a variável POSTGRES_USER define o usuário dedicado. Troque TROQUE_A_SENHA por uma senha forte e VERSAO pela versão do PostgreSQL escolhida, com a tag fixa (confira na página da imagem o caminho dos dados dessa versão, usado no -v). Um exemplo:
docker run --network=guacnet --name guac-postgres -d \
-e POSTGRES_USER=guacamole_user \
-e POSTGRES_PASSWORD=TROQUE_A_SENHA \
-e POSTGRES_DB=guacamole_db \
-v guac-dados:/var/lib/postgresql/data \
postgres:VERSAO
O Guacamole não cria as próprias tabelas, mas a imagem traz um script que gera o SQL do schema inicial. Gere o arquivo e carregue-o no banco, depois que o PostgreSQL terminar de iniciar (veja docker logs guac-postgres). Um exemplo de comandos:
docker run --rm guacamole/guacamole:1.6.0 /opt/guacamole/bin/initdb.sh --postgresql > initdb.sql
docker exec -i guac-postgres psql -U guacamole_user -d guacamole_db -f - < initdb.sql
guacd e aplicação web
O guacd entra na mesma rede, sem publicar porta nenhuma. O manual alerta que ele é um proxy passivo e não exige autenticação, então terceiros poderiam usá-lo para alcançar outros sistemas se ele ficasse exposto. Um exemplo de comando:
docker run --network=guacnet --name guacd -d guacamole/guacd:1.6.0
Depois, a aplicação web. GUACD_HOSTNAME recebe o nome do contêiner do guacd (aqui, guacd), e POSTGRESQL_HOSTNAME, o nome do contêiner do banco. A REMOTE_IP_VALVE_ENABLED=true serve para o Guacamole enxergar o IP real de quem acessa atrás do proxy, desde que a válvula aceite o proxy: com o Nginx no host e o Guacamole no Docker, o proxy chega por um endereço da rede do Docker, o que pode exigir ajustar a PROXY_ALLOWED_IPS_REGEX, então confira nos registros qual IP aparece. A TOTP_ENABLED=true liga o segundo fator, que só funciona com autenticação por banco. A porta 8080 fica presa ao 127.0.0.1. Um exemplo de comando:
docker run --network=guacnet --name guacamole \
-e GUACD_HOSTNAME=guacd \
-e POSTGRESQL_HOSTNAME=guac-postgres \
-e POSTGRESQL_DATABASE=guacamole_db \
-e POSTGRESQL_USERNAME=guacamole_user \
-e POSTGRESQL_PASSWORD=TROQUE_A_SENHA \
-e REMOTE_IP_VALVE_ENABLED=true \
-e TOTP_ENABLED=true \
-d -p 127.0.0.1:8080:8080 guacamole/guacamole:1.6.0
Se algo não subir, o manual manda olhar o docker logs.
Docker e ufw: portas publicadas
O -p 8080:8080 do manual publica a porta em todas as interfaces. A documentação do Docker diz que publicar portas é inseguro por padrão e que o Docker e o ufw usam regras de firewall incompatíveis entre si: os pacotes são roteados antes das regras do ufw, que acabam ignoradas. Por isso o exemplo usa 127.0.0.1:8080:8080 e não publica a 4822. Não conte com o ufw para fechar uma porta publicada pelo Docker.
Nginx e HTTPS
Instale o Nginx pelo gerenciador de pacotes do seu sistema e crie um bloco server para o subdomínio, com o location abaixo, que segue o do manual com o proxy_pass apontando para a porta 8080 do próprio servidor. O proxy_buffering off está no bloco do manual porque, sem ele, o Guacamole pode não funcionar: o túnel HTTP depende de dados em fluxo. Os cabeçalhos Upgrade e Connection precisam ser definidos de forma explícita para o WebSocket. Um exemplo:
server {
listen 80;
server_name acesso.exemplo.com.br;
location /guacamole/ {
proxy_pass http://127.0.0.1:8080;
proxy_buffering off;
proxy_http_version 1.1;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $http_connection;
access_log off;
}
}
Para enviar arquivos pelo navegador, o manual indica pôr client_max_body_size 1g; dentro do location.
Salve o bloco e recarregue o Nginx; um exemplo é sudo nginx -t seguido de sudo systemctl reload nginx. O certificado HTTPS vem de outra ferramenta, o Certbot, que precisa estar instalado (siga a documentação dele para o seu sistema). Um exemplo de comando, para conferir no seu servidor:
sudo certbot --nginx -d acesso.exemplo.com.br
sudo certbot renew --dry-run
O segundo comando só simula a renovação e não garante as futuras.
Primeiro acesso: senha, usuário e 2FA
Abra https://acesso.exemplo.com.br/guacamole/. Os scripts do banco criam o usuário guacadmin com a senha guacadmin, e com o endereço público esse par é conhecido. O manual diz que a senha deve ser trocada logo, assim que a autenticação por banco estiver funcionando. Troque-a no primeiro acesso.
Recomendamos ir além: criar um administrador com nome próprio e desativar ou apagar o guacadmin.
Com o TOTP_ENABLED=true, depois da senha o usuário sem chave vê um QR code para ler no aplicativo de autenticação. Se alguém perder o celular, o administrador marca "Clear TOTP secret" no usuário e salva, e no próximo login ele cadastra de novo.
O bloqueio de tentativas já vem ligado na imagem Docker: depois de 5 falhas (BAN_MAX_INVALID_ATTEMPTS), o IP fica bloqueado por 300 segundos (BAN_ADDRESS_DURATION). Ele usa o IP do cliente, e por isso o REMOTE_IP_VALVE_ENABLED=true importa atrás do Nginx. Sem o IP real, é possível que as falhas de uma pessoa bloqueiem outras que entram pelo mesmo proxy.
Criar uma conexão RDP ou SSH
Na tela de configurações, abra "Connections" e clique em "New Connection". Uma conexão nova só pode ser usada por administradores e por quem a criou: as outras pessoas precisam receber acesso nas configurações de usuário ou de grupo. Os nomes abaixo são os parâmetros técnicos da documentação de configuração.
- RDP:
hostname,port(padrão 3389), e, se necessário,username,passwordedomain. Osecurityvem emany, que negocia com o servidor. - SSH:
hostname,port(padrão 22) eusername. Compasswordem branco, a senha é perguntada na hora. Aprivate-keyrecebe o conteúdo completo da chave no formato OpenSSH, e apassphraseem branco também é perguntada.
Duas opções pedem atenção. No RDP, o ignore-cert com valor true faz o certificado do servidor ser ignorado mesmo quando não pode ser validado. No SSH, sem a host-key (uma linha no formato known_hosts), a identidade do servidor não é verificada.
Recomendamos também não deixar o RDP, o VNC ou o SSH dos computadores de destino abertos na internet, mantendo-os acessíveis só pela rede privada ou por VPN a partir da VPS do Guacamole. Para outra ferramenta de acesso pelo navegador no mesmo servidor, veja code-server na VPS: VS Code no navegador.
Atualização e backup do banco
Como as conexões, os usuários e as chaves do TOTP ficam no banco, recomendamos copiar o banco e os arquivos de configuração antes de atualizar. Um exemplo:
docker exec guac-postgres pg_dump -U guacamole_user -d guacamole_db -Fc > guacamole.dump
Quem vem da 1.5.x precisa rodar o upgrade-pre-1.6.0.sql no banco por causa da nova permissão AUDIT. Os scripts de atualização ficam em postgresql/schema/upgrade/, no guacamole-auth-jdbc-1.6.0.tar.gz da página de release, são incrementais e precisam rodar em ordem. Um exemplo para rodar o script, no mesmo psql usado para o initdb.sql: docker exec -i guac-postgres psql -U guacamole_user -d guacamole_db -f - < upgrade-pre-1.6.0.sql. No PostgreSQL, depois de rodar, reconceda as permissões, também pelo psql:
GRANT SELECT,INSERT,UPDATE,DELETE ON ALL TABLES IN SCHEMA public TO guacamole_user;
GRANT SELECT,USAGE ON ALL SEQUENCES IN SCHEMA public TO guacamole_user;
Uma ordem possível: copiar o banco, parar os contêineres, aplicar o script, trocar a tag das duas imagens para a mesma versão e subir de novo. O initdb.sh gera só o schema inicial, não o de atualização. Troque também POSTGRESQL_USER por POSTGRESQL_USERNAME e GUACD_LOG_LEVEL por LOG_LEVEL.
Endereço do painel
O acesso fica num subdomínio de um domínio que você já tem ou vai registrar.
Um nome livre pode ser buscado na loja da Eleven Host, entre centenas de extensões. Buscar domínio
Perguntas frequentes
O Guacamole é gratuito?
O projeto, da Apache Software Foundation, usa a licença Apache 2.0.
Qual versão instalar?
Em 14/11/2026, a 1.6.0, de 22/06/2025, que corrige as falhas publicadas na página de segurança do projeto. Versões 1.5.x de tutoriais antigos ficam de fora.
Posso usar o 2FA sem banco de dados?
Não. O TOTP precisa de uma extensão que guarde dados por usuário, e hoje só as de banco fazem isso.
Preciso abrir a porta 4822?
Não. O guacd fica na rede Docker, sem porta publicada, porque não tem autenticação e não deve ficar exposto.