Tutoriais de VPS
Kasm Workspaces na VPS (2026): navegador isolado, HTTPS e backup
Instale Kasm 1.17.0 no Ubuntu com pacote verificado e Caddy HTTPS. Configure Zone, MFA, grupos e navegadores descartáveis e teste backup, restauração e upgrade.

O Kasm Workspaces permite abrir um navegador ou desktop Linux descartável dentro do navegador. Aplicações rodam remotamente em contêineres sob demanda, reduzindo exposição do computador local a sites e downloads desconhecidos. A sessão pode ser destruída ao terminar. Isso reduz riscos locais, mas contêineres compartilham o kernel do servidor e não garantem proteção contra qualquer exploração; proteja o host Kasm e limite a rede dos workspaces.
Este guia completo usa Kasm Workspaces 1.17.0 no Ubuntu 24.04: instalação de servidor único, Caddy HTTPS, isolamento de navegador, usuários, políticas, recursos, monitoramento, recuperação e atualização. A versão fixada é exemplo histórico reproduzível, sem afirmar ser a mais recente ou adequada sem revisar avisos de segurança. Prefira VPS dedicada porque o instalador administra vários serviços Docker.
- Examinar links desconhecidos sem baixar diretamente ao computador local.
- Oferecer navegador/desktop controlado a funcionários temporários.
- Criar ambientes descartáveis de desenvolvimento, treinamento ou atendimento.
- Acessar servidores RDP, VNC ou SSH existentes.
- Controlar área de transferência, arquivos, áudio e duração.
- Distribuir imagens e recursos por grupo.
Para conexões fixas, Apache Guacamole pode ser mais leve. Kasm acrescenta contêineres temporários; VM Windows completa, isolamento de kernel e virtualização GPU pedem plataforma adequada.
Confira licença antes de uso comercial. A EULA incluída em 1.17.0 restringe Community Edition e exclui atividades empresariais que geram receita. Exemplos de equipe, treinamento e atendimento não significam permissão comercial gratuita. Escolha edição/licença apropriadas, confira limites de sessões e recursos de identidade/política. Use a opção que aceita EULA somente após revisar os termos.
Mínimo oficial: 2 núcleos, 4 GB RAM e 50 GB SSD. A versão suporta Ubuntu 22.04/24.04 e Debian 11/12, entre outros sistemas, sem recomendar LXC ou WSL/WSL2.
Workspaces padrão podem reservar 2 núcleos e 2768 MB por sessão. Um host de 4 GB serve a teste administrativo leve, não vários usuários padrão.
| Uso | VPS inicial sugerida | Meta aproximada de teste |
|---|---|---|
| Isolamento pessoal | 4 vCPU, 8 GB RAM, 80 GB NVMe | 1–2 sessões após dimensionar |
| Equipe pequena | 8 vCPU, 16 GB RAM, 160 GB NVMe | 4–6 sessões leves com alocações ajustadas e licença adequada |
| Treinamento ou trabalho remoto amplo | Meça e separe web, banco e agentes | Pico de sessões simultâneas |
Importam sessões ativas, não cadastros. Resolução, áudio, vídeo, abas e imagens alteram consumo. O original ilustra perfil pequeno de 0,5 núcleo, 768 MB, 1024×768 sem áudio, e perfil mais confortável perto de 1,5 núcleos/2 GB. São exemplos dependentes da carga, sem garantia de desempenho nem afirmação sobre padrões atuais. Seis reservas de 2 núcleos não cabem em agente de 8. CPU pode usar shares ou limites; confira o método, sem assumir que Cores sempre impõe teto rígido.
Veja o guia de recursos VPS e escolha região próxima dos usuários, pois sessões são sensíveis à latência.
O diagrama original encaminha navegador a Caddy, Kasm Proxy e API/Manager/PostgreSQL/Agent, que cria contêineres:
用户浏览器
|
v
Caddy :443 ---- 自动 HTTPS
|
v
Kasm Proxy :8443 ---- API / Manager / PostgreSQL / Agent
|
v
按需创建 Workspace 容器
Kasm usa 443 por padrão. Instale em 8443 para Caddy receber HTTPS público. Permita:
- 22/TCP para SSH restrito à administração.
- 80/TCP para certificados e redirecionamento HTTP.
- 443/TCP para entrada web.
Não usamos gateway RDP nativo nem precisamos de 3389. Mantenha 8443 privado; mudar porta não cria vínculo automático em loopback.
Aponte kasm.example.com com A correto e AAAA só com IPv6 funcional. Inspecione:
cat /etc/os-release
uname -m
free -h
df -h /var/lib/docker 2>/dev/null || df -h /
sudo ss -lntup | grep -E ':(80|443|8443)\b' || true
O instalador instala/usa Docker e cria serviços em /opt/kasm. Confira conflitos com Nginx, Traefik, bancos, portas, redes e disco. Host separado facilita operação.
Atualize e instale:
sudo apt update
sudo apt upgrade -y
sudo apt install -y ca-certificates curl caddy
sudo systemctl enable --now caddy
Mantenha SSH e console do provedor ao aplicar UFW:
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose
Docker pode contornar UFW INPUT. Negue 8443 público no provedor, confira vínculos reais e teste externamente. Para maior controle, use publicação privada ou política compatível de encaminhamento Docker.
URL e SHA-256 originais coincidem com documentação e pacote baixado:
cd /tmp
curl -fLO \
https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz
echo \
'22a293ea52b2adb7f3f72a2de8e9be799f443b9da040e066df403478da77f62d kasm_release_1.17.0.7f020d.tar.gz' \
| sha256sum -c -
tar -xzf kasm_release_1.17.0.7f020d.tar.gz
Continue somente após OK. Use pasta temporária limpa e não misture extrações antigas. ARM64/offline têm hashes próprios, e nem todas as imagens suportam ARM64. Confira a matriz antes de comprar VPS ARM.
Confira swap:
swapon --show
free -h
Se ausente, o exemplo cria 8 GB e usa 8443:
cd /tmp
sudo bash kasm_release/install.sh \
--accept-eula \
--swap-size 8192 \
-L 8443
Remova --swap-size 8192 com swap suficiente. A opção é em MB e não substitui RAM de sessões. Reserve espaço além dos 50 GB para imagens. Se downloads demorarem, consulte kasm_install_时间戳.log, sem reinstalar repetidamente.
Guarde senhas geradas de [email protected] e [email protected] em gerenciador; não publique capturas nem valores em comandos.
Confira serviços:
sudo docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
curl -kfsS https://127.0.0.1:8443/api/__healthcheck
sudo /opt/kasm/bin/status
Espere {"ok": true}. -k é apenas diagnóstico local do certificado interno.
Edite /etc/caddy/Caddyfile com o domínio real:
kasm.example.com {
encode zstd gzip
reverse_proxy https://127.0.0.1:8443 {
transport http {
tls_insecure_skip_verify
}
header_up Host {host}
header_up X-Real-IP {remote_host}
header_up X-Forwarded-Proto https
header_up X-Forwarded-Port 443
flush_interval -1
}
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
Referrer-Policy "same-origin"
}
}
tls_insecure_skip_verify ignora verificação só do upstream no mesmo host. Navegadores validam HTTPS público. Para upstream remoto use TLS confiável, sem copiar a exceção. Localmente pode confiar na CA interna e verificar nome. Avalie HSTS includeSubDomains.
Valide e carregue:
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -fsS https://kasm.example.com/api/__healthcheck
Caddy suporta WebSocket. flush_interval -1 desativa buffering para interação contínua. Veja o guia Caddy.
Login correto não prova conexão do workspace. Abra:
Infrastructure -> Zones -> default
Upstream Auth Address = proxy; Proxy Port = 0. Termine sessões antigas e crie outras; alterações valem para sessões novas.
Se adicionar RDP Client Workspaces nativos atrás do proxy, revise Restrict RDP Client IP Address. O guia oficial orienta desativar nessa topologia para evitar Invalid Request. Wrong client IP; compense com controle do gateway e avalie a mudança da verificação IP.
- Troque senha de
[email protected]. - Desative/exclua
[email protected]. - Habilite MFA TOTP/WebAuthn suportado para administradores.
- Separe conta administrativa diária de navegação comum.
- Considere reduzir falhas permitidas de 5 a 3 com recuperação adequada.
- Reduza inatividade e duração máxima.
- Confirme acesso anônimo desativado.
Há autenticação local e LDAP/SAML/OIDC conforme edição/versão. Integre identidade da equipe e mantenha administrador local de emergência com MFA e credenciais offline.
Crie Browser-Isolation em Access Management → Groups. Nomes e prioridades são únicos. Número menor prevalece em política simples repetida; volume_mapping e outros ajustes podem combinar entre grupos. Confira permissões efetivas.
Baseline All Users restritivo:
- Sem upload/download de arquivos.
- Sem área de transferência bidirecional.
- Sem microfone/câmera.
- Duração/inatividade limitadas.
- Sessões simultâneas limitadas.
- Sem atribuição automática de novos workspaces.
Libere itens somente nos grupos necessários. Desative adicionar Workspaces novos a All Users e atribua imagens explicitamente, evitando exposição automática de imagens privilegiadas.
Em Workspaces → Registry, adicione registro oficial e só imagens necessárias. Desktops podem ocupar vários GB; camadas antigas e novas coexistem durante atualização.
Uma seleção inicial:
- Chromium ou Firefox para links e logins temporários.
- Ubuntu Desktop para arquivos e terminal.
- Remmina para RDP, VNC e SSH autorizados.
- VS Code para desenvolvimento temporário e treinamento.
Use alocações conservadoras medidas, como 1,5 CPU e 2 GB em sessão leve, e ajuste. Vídeo e páginas simples diferem; não aplique uma cota universal.
Valide:
- Usuário vê somente imagens dos grupos.
- Navegador acessa site de teste aprovado.
- Área de transferência e arquivos obedecem política.
- Encerrar remove contêiner temporário.
- Sessão descartável nova não mantém cookies/downloads inesperados.
Para links desconhecidos, prefira temporário sem diretórios host ou perfil persistente. Persistência altera o limite:
- Extensões maliciosas, cookies e downloads sobrevivem.
- Pastas precisam de backup, cotas e controle de malware.
- Defina remoção de usuários e dados.
- Usuários distintos não compartilham perfil gravável.
Para uma consulta única, descarte costuma ser melhor. Se persistir, use caminho individual e teste restauração. Navegação remota não protege segredos digitados deliberadamente em site não confiável.
Gráficos remotos consomem CPU/tráfego. Em host pequeno, teste:
- Qualidade Low/Medium.
- Resolução máxima 1280×720.
- Sem áudio desnecessário.
- Navegador leve com 0,5–1 CPU e 1–1,5 GB medidos.
- Uma sessão por usuário.
- Descarte por inatividade.
- Baixar previamente apenas imagens usadas.
Observe por docker stats:
sudo docker stats
sudo docker system df
free -h
df -h /var/lib/docker
Teste sessões reais simultâneas por 20–30 minutos com vídeo, rolagem e área de transferência permitida. CPU sustentada acima de cerca de 80%, swap crescente ou reconexões pedem menos concorrência ou mais capacidade. Login sozinho não basta.
Imagens/camadas normalmente ficam em /var/lib/docker. Espaço em outro volume não resolve Docker cheio; confira data root personalizado.
Monitore:
- Uso dos volumes raiz e Docker.
- Inodes.
- Estado e reinícios dos contêineres principais.
- Disponibilidade de
/api/__healthcheck. - CPU, RAM, swap e tráfego de rede.
- Resultados de backup PostgreSQL.
Inspeção rápida:
sudo /opt/kasm/bin/status
curl -kfsS https://127.0.0.1:8443/api/__healthcheck
sudo docker ps --filter 'name=kasm_' \
--format 'table {{.Names}}\t{{.Status}}\t{{.RunningFor}}'
sudo docker system df
Integre com Zabbix se já estiver em uso.
PostgreSQL guarda usuários, grupos, definições e ajustes. Exemplo oficial online:
sudo mkdir -p /var/backups/kasm
STAMP="$(date -u +%Y%m%dT%H%M%SZ)"
sudo docker exec kasm_db \
pg_dump -U kasmapp -F t kasm \
| sudo tee "/var/backups/kasm/kasm-db-$STAMP.tar" >/dev/null
Configuração original:
STAMP="$(date -u +%Y%m%dT%H%M%SZ)"
sudo tar -czf "/var/backups/kasm/kasm-config-$STAMP.tar.gz" \
/opt/kasm/current/conf \
/opt/kasm/current/docker
sudo sha256sum /var/backups/kasm/kasm-* \
| sudo tee "/var/backups/kasm/SHA256SUMS-$STAMP" >/dev/null
Use pasta privada e conjunto com uma identidade. Timestamps diferentes e sumas absolutas não criam recuperação coordenada. Termine sessões e congele alterações administrativas antes de copiar banco, configuração e arquivos. A versão abaixo guarda diretório de versão, Caddy e sumas relativas:
sudo bash <<'BACKUP'
set -Eeuo pipefail
umask 077
install -d -m 0700 /var/backups/kasm
backup_dir=$(mktemp -d "/var/backups/kasm/$(date -u +%Y%m%dT%H%M%SZ)-XXXXXX")
kasm_version_dir=$(readlink -f /opt/kasm/current)
test -d "$kasm_version_dir/conf"
test -d "$kasm_version_dir/docker"
docker exec kasm_db pg_dump -U kasmapp -Fc kasm > "$backup_dir/kasm.dump"
tar -czf "$backup_dir/configuration.tar.gz" -C "$kasm_version_dir" conf docker
printf '%s\n' "$kasm_version_dir" > "$backup_dir/version-directory.txt"
cp -p /etc/caddy/Caddyfile "$backup_dir/Caddyfile"
mapfile -t kasm_ids < <(docker ps -aq --filter name=kasm_)
test "${#kasm_ids[@]}" -gt 0
docker inspect --format '{{.Name}} {{.Config.Image}} {{.Image}}' "${kasm_ids[@]}" > "$backup_dir/images.txt"
docker inspect --format '{{.Name}} {{json .Mounts}}' "${kasm_ids[@]}" > "$backup_dir/mounts.txt"
(cd "$backup_dir" && sha256sum kasm.dump configuration.tar.gz version-directory.txt Caddyfile images.txt mounts.txt > SHA256SUMS && sha256sum -c SHA256SUMS)
printf 'Backup directory: %s\n' "$backup_dir"
BACKUP
Não inclui todos os arquivos. Acrescente Persistent Profiles, Volume Mappings, compartilhamentos, NFS, objetos e certificados/chaves externos. Mantenha caminhos/proprietários compatíveis. Dump transacional não torna arquivos que continuam mudando consistentes automaticamente.
Criptografe e copie o conjunto externamente; teste restauração pelo menos mensalmente. Veja os ensaios de recuperação VPS.
pg_restore -c sobrescreve objetos. Exemplo original:
sudo docker cp kasm-db-backup.tar kasm_db:/tmp/backup.tar
sudo docker exec kasm_db \
pg_restore -d kasm /tmp/backup.tar -c -U kasmapp
Comece em destino isolado com versão correspondente e configuração, credenciais e nomes de banco conciliados. Restaure arquivos externos. Pare escritores/usuários e mantenha PostgreSQL ativo. Fase revisada:
# Run only on the isolated recovery destination with the matching Kasm version.
sudo bash <<'RESTORE'
set -Eeuo pipefail
backup_dir=/var/backups/kasm/RESTORE_POINT
(cd "$backup_dir" && sha256sum -c SHA256SUMS)
/opt/kasm/bin/stop
docker start kasm_db
until docker exec kasm_db pg_isready -U kasmapp -d kasm >/dev/null; do sleep 2; done
docker cp "$backup_dir/kasm.dump" kasm_db:/tmp/kasm-restore.dump
docker exec kasm_db pg_restore --exit-on-error -c -U kasmapp -d kasm /tmp/kasm-restore.dump
docker exec kasm_db rm -f /tmp/kasm-restore.dump
/opt/kasm/bin/start
RESTORE
Troque RESTORE_POINT pela pasta verificada. Não continue após erro. Produção exige manutenção e plano revisado porque sobrescreve dados. Valide login, grupos, imagens atribuídas, criação de sessão, políticas e arquivos, não apenas Running.
Revise requisitos de SO, Docker, imagens e migração do destino. 1.17.0 mudou caminhos; não reutilize locais antigos sem revisão.
- Avise manutenção.
- Termine workspaces ativos.
- Faça backup de banco, configuração, persistência e snapshot VPS.
- Preserve pelo menos a meta original de 50 GB livres no Docker e confira requisito real do destino.
- Baixe e verifique SHA-256.
- Use
upgrade.shoficial do destino. - Teste login, Zone, sessões, política e backup.
- Atualize imagens pelo Registry depois.
Preserve 8443:
cd /tmp
curl -fLO \
https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz
echo \
'22a293ea52b2adb7f3f72a2de8e9be799f443b9da040e066df403478da77f62d kasm_release_1.17.0.7f020d.tar.gz' \
| sha256sum -c -
tar -xzf kasm_release_1.17.0.7f020d.tar.gz
sudo bash kasm_release/upgrade.sh --proxy-port 8443
O exemplo atualiza versão antiga suportada para 1.17.0; não repita em instalação já 1.17.0. Siga guia do destino real. Reexecutar install.sh não é upgrade. Migrações exigem rollback com dados/software anteriores correspondentes.
curl -kfsS https://127.0.0.1:8443/api/__healthcheck
sudo systemctl status caddy --no-pager
sudo journalctl -u caddy -n 100 --no-pager
curl -fsS https://kasm.example.com/api/__healthcheck
8443 local falha: Kasm. Local funciona e domínio falha: Caddy, DNS e provedor.
Confira Zone proxy, porta 0 e sessão nova. Verifique upstream https://127.0.0.1:8443 e WebSocket permitido pelo CDN/proxy.
free -h
swapon --show
sudo docker stats --no-stream
sudo docker system df
Reduza alocação só quando compatível com carga medida. Host cheio ou trocando swap precisa de menos sessões ou ampliação.
Remova definições/imagens não usadas pela administração e confira:
df -h /var/lib/docker
df -i /var/lib/docker
sudo docker system df -v
Não use docker system prune -a indiscriminadamente: remove imagens previstas, força downloads ou afeta outros projetos.
cd /tmp
ls -lh kasm_install_*.log
tail -n 200 kasm_install_*.log
sudo docker info
df -h /
Confira espaço, Docker compatível, portas e acesso ao registro. Diagnostique antes de repetir.
- SO suportado em VM/bare metal adequado, não LXC.
- Edição/licença, arquitetura e concorrência revisadas.
- SHA-256 verificado.
- SSH restrito, HTTP/HTTPS públicos; 8443 negado externamente.
- Caddy e saúde funcionando.
- Zone Upstream Auth Address=proxy, Proxy Port=0.
- Usuário comum padrão desativado e MFA administrativo.
- All Users restritivo e atribuição explícita por grupo.
- Arquivos, área de transferência e descarte testados.
- Disco Docker, swap, saúde e reinícios monitorados.
- Banco, configuração e persistência em backup externo.
- Restauração cria workspace real.
- Upgrade termina sessões e mantém 8443.
Pode instalar e testar, mas uma sessão padrão pede 2 núcleos/2768 MB. Para uso pessoal contínuo, parta de cerca de 4 núcleos/8 GB e meça concorrência.
Guacamole acessa hosts RDP/VNC/SSH existentes; Kasm também cria navegadores/Linux descartáveis. Escolha por conexão fixa ou workspace temporário.
Não recomendado por redes Docker aninhadas, permissões e kernel. Prefira VM adequada ou bare metal.
Ajuste proxy e 0, termine sessão e crie outra. Confira WebSocket.
Só dados temporários. Perfis, diretórios mapeados/compartilhados e objetos persistem conforme política efetiva.
Contém definições/ajustes, não todos os perfis, NFS, objetos e caminhos mapeados. Faça backup e valide na mesma restauração.