Tutoriales de VPS
Kasm Workspaces en VPS (2026): navegador aislado, HTTPS y copias
Instale Kasm 1.17.0 en Ubuntu con paquete verificado y Caddy HTTPS. Configure Zone, MFA, grupos y navegadores temporales y pruebe copias, recuperación y actualización.

Kasm Workspaces permite abrir un navegador o escritorio Linux desechable dentro del navegador. Las aplicaciones se ejecutan en contenedores remotos bajo demanda, reduciendo exposición del equipo local a sitios y descargas desconocidos. Al terminar puede destruirse la sesión. Esto reduce riesgos locales, pero los contenedores comparten el kernel del servidor y no garantizan protección frente a toda vulnerabilidad; proteja el host y restrinja la red de los espacios.
Esta guía completa utiliza Kasm Workspaces 1.17.0 en Ubuntu 24.04, instalación de un servidor, Caddy HTTPS, aislamiento de navegador, usuarios, políticas, recursos, supervisión, recuperación y actualización. La versión fijada es un ejemplo histórico reproducible, no una afirmación de actualidad o seguridad sin revisar avisos. Utilice preferiblemente una VPS dedicada: el instalador administra varios servicios Docker.
- Examinar enlaces desconocidos sin descargar directamente al equipo local.
- Dar navegador/escritorio controlado a personal temporal.
- Crear entornos desechables de desarrollo, formación o atención.
- Conectar a servidores RDP, VNC o SSH existentes.
- Regular portapapeles, archivos, audio y duración.
- Asignar imágenes y recursos por grupo.
Para conexiones fijas, Apache Guacamole puede ser más ligero. Kasm añade contenedores temporales; Windows VM completo, aislamiento de kernel o virtualización GPU requieren otra plataforma adecuada.
Revise la licencia antes de uso comercial. La EULA incluida en 1.17.0 limita Community Edition y excluye actividades empresariales que generan ingresos. Ejemplos de equipos, formación y atención no implican permiso comercial gratuito. Elija edición/licencia apropiadas, verifique límite de sesiones simultáneas y disponibilidad de funciones de identidad/política. Use la opción de aceptar EULA solo después de revisar sus términos.
Mínimo oficial: 2 núcleos, 4 GB RAM y 50 GB SSD. La versión admite Ubuntu 22.04/24.04 y Debian 11/12, entre otros sistemas, y no recomienda LXC ni WSL/WSL2.
Los espacios predeterminados pueden pedir 2 núcleos y 2768 MB cada uno; 4 GB sirven para una prueba administrativa, no varios usuarios normales.
| Uso | VPS sugerida | Objetivo aproximado de prueba |
|---|---|---|
| Aislamiento personal | 4 vCPU, 8 GB RAM, 80 GB NVMe | 1–2 sesiones según medición |
| Equipo pequeño | 8 vCPU, 16 GB RAM, 160 GB NVMe | 4–6 sesiones ligeras con cuotas ajustadas y licencia adecuada |
| Formación o trabajo remoto amplio | Medir y separar web, base y agentes | Concurrencia máxima |
Importan sesiones activas, no usuarios registrados. Resolución, audio, vídeo, pestañas e imágenes afectan consumo. El original ilustra 0,5 núcleo, 768 MB, 1024×768 sin audio y un perfil más cómodo de 1,5 núcleos/2 GB. Son ejemplos dependientes de la carga, no garantías ni valores predeterminados actuales. Seis reservas de 2 núcleos no caben en un agente de 8. CPU puede usar shares o límites; compruebe el método y no suponga que Cores siempre impone un máximo estricto.
Consulte la guía de recursos VPS y elija región cercana a usuarios para reducir latencia.
El diagrama original lleva navegador a Caddy, Kasm Proxy y API/Manager/PostgreSQL/Agent, que crea contenedores:
用户浏览器
|
v
Caddy :443 ---- 自动 HTTPS
|
v
Kasm Proxy :8443 ---- API / Manager / PostgreSQL / Agent
|
v
按需创建 Workspace 容器
Kasm usa 443 por defecto. Instálelo en 8443 para Caddy público. Permita:
- 22/TCP para SSH restringido a administración.
- 80/TCP para certificados y redirección HTTP.
- 443/TCP para la entrada web.
Aquí no se usa gateway RDP nativo ni se necesita 3389. Mantenga 8443 privado; cambiar puerto no lo vincula automáticamente a loopback.
Apunte kasm.example.com con A correcto y AAAA solo con IPv6 funcional. Inspeccione:
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
El instalador instala/utiliza Docker y crea servicios en /opt/kasm. Revise colisiones con Nginx, Traefik, bases, puertos, redes y espacio. Un host independiente facilita mantenimiento.
Actualice e instale:
sudo apt update
sudo apt upgrade -y
sudo apt install -y ca-certificates curl caddy
sudo systemctl enable --now caddy
Conserve SSH y consola del proveedor al aplicar UFW:
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose
Docker puede saltarse UFW INPUT. Deniegue 8443 público en el proveedor, compruebe enlaces reales y pruebe externamente. Para mayor control, configure publicación privada o política compatible de reenvío Docker.
URL y SHA-256 originales coinciden con documentación oficial y paquete descargado:
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
Continúe solo tras OK. Use carpeta temporal limpia y no mezcle extracciones antiguas. ARM64 y paquetes offline tienen hashes distintos; no todas las imágenes soportan ARM64. Revise la matriz antes de adquirir VPS ARM.
Compruebe swap:
swapon --show
free -h
Si falta, el ejemplo crea 8 GB y usa 8443:
cd /tmp
sudo bash kasm_release/install.sh \
--accept-eula \
--swap-size 8192 \
-L 8443
Quite --swap-size 8192 si ya existe swap suficiente. El valor se expresa en MB y no sustituye RAM para sesiones. Reserve espacio superior al mínimo para imágenes. Si tarda, revise kasm_install_时间戳.log en lugar de reinstalar.
Guarde contraseñas generadas de [email protected] y [email protected] en un gestor; no comparta capturas ni valores en órdenes.
Compruebe:
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 solo diagnostica el certificado interno local.
Edite /etc/caddy/Caddyfile con su dominio:
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 omite verificación solo del upstream en el mismo host. El navegador valida HTTPS público. Para upstream remoto use TLS confiable, no esta excepción. Localmente puede confiar en CA interna y verificar nombre. Revise efectos HSTS includeSubDomains.
Valide y cargue:
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 admite WebSocket; flush_interval -1 desactiva buffering para interacción continua. Consulte la guía Caddy.
Un acceso correcto no prueba conectividad del espacio. Abra:
Infrastructure -> Zones -> default
Upstream Auth Address = proxy; Proxy Port = 0. Termine sesiones antiguas y cree nuevas: el cambio no modifica conexiones existentes.
Si añade RDP Client Workspaces nativos detrás del proxy, revise Restrict RDP Client IP Address. El procedimiento oficial indica desactivarlo en esa topología para evitar Invalid Request. Wrong client IP; compense con controles del gateway y valore el cambio de validación IP.
- Cambie la contraseña de
[email protected]. - Desactive/elimine
[email protected]. - Active MFA TOTP/WebAuthn admitido para administradores.
- Cuenta administrativa diaria separada del uso de navegación.
- Considere bajar intentos fallidos de 5 a 3 con recuperación adecuada.
- Reduzca tiempos de inactividad y duración máxima.
- Verifique acceso anónimo desactivado.
Hay autenticación local y opciones LDAP/SAML/OIDC según edición/versión. Integre identidad del equipo y conserve administrador local de emergencia con MFA y credenciales offline.
Cree Browser-Isolation en Access Management → Groups. Nombres y prioridades deben ser únicos. El número menor prevalece para políticas simples duplicadas; ajustes como volume_mapping se combinan entre grupos. Revise permisos efectivos.
Baseline All Users restrictivo:
- Sin cargas/descargas de archivos.
- Sin portapapeles bidireccional.
- Sin micrófono/cámara.
- Duración e inactividad limitadas.
- Sesiones simultáneas limitadas.
- Sin asignación automática de espacios nuevos.
Abra permisos concretos en grupos específicos. Desactive añadir nuevos Workspaces a All Users y asigne imágenes explícitamente para evitar distribución automática de imágenes privilegiadas.
En Workspaces → Registry, añada registro oficial y solo imágenes necesarias. Escritorios ocupan varios GB y mantienen capas antiguas/nuevas al actualizar.
Una selección inicial:
- Chromium o Firefox para enlaces y accesos temporales.
- Ubuntu Desktop para archivos y terminal.
- Remmina para RDP, VNC y SSH aprobados.
- VS Code para desarrollo temporal o formación.
Use cuotas conservadoras medidas, como 1,5 CPU y 2 GB para espacio ligero, y ajuste. Vídeo y páginas sencillas difieren; no aplique una cuota universal.
Verifique:
- Solo imágenes del grupo visibles.
- Navegador abre sitio de prueba autorizado.
- Portapapeles y transferencias cumplen política.
- Terminar elimina contenedor temporal.
- Una sesión desechable nueva no conserva cookies/descargas inesperadas.
Para enlaces desconocidos, prefiera temporal sin directorios host ni perfil persistente. Persistencia cambia el límite:
- Extensiones maliciosas, cookies y descargas sobreviven.
- Carpetas requieren copias, cuotas y control de malware.
- Defina eliminación de usuarios/datos.
- Usuarios distintos no comparten perfil escribible.
Para una consulta puntual, destrucción suele ser preferible. Si persiste, ruta individual y restauración probada. La navegación remota no protege secretos introducidos deliberadamente en un sitio no confiable.
Gráficos remotos consumen CPU y tráfico. En host pequeño pruebe:
- Calidad Low/Medium.
- Resolución máxima 1280×720.
- Sin audio innecesario.
- Navegador ligero con 0,5–1 CPU y 1–1,5 GB medidos.
- Una sesión por usuario.
- Destrucción por inactividad.
- Descarga anticipada solo de imágenes usadas.
Observe con docker stats:
sudo docker stats
sudo docker system df
free -h
df -h /var/lib/docker
Pruebe concurrencia real 20–30 minutos con vídeo, desplazamiento y portapapeles permitido. CPU sostenida sobre aproximadamente 80 %, swap creciente o reconexión repetida exigen menos concurrencia o más capacidad. No basta el acceso inicial.
Imágenes y capas suelen estar en /var/lib/docker. Espacio libre en otro disco no resuelve Docker lleno; revise su data root si cambió.
Supervise:
- Uso de particiones raíz y Docker.
- Inodos.
- Estado y reinicios de contenedores principales.
- Disponibilidad de
/api/__healthcheck. - CPU, RAM, swap y tráfico de red.
- Resultados de copia PostgreSQL.
Inspección 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 con Zabbix si ya lo usa.
PostgreSQL conserva usuarios, grupos, definiciones y ajustes. Ejemplo 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
Configuración 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 una carpeta privada y un único punto identificado. Tiempos separados y sumas con rutas absolutas no establecen conjunto coordinado. Termine sesiones y congele cambios administrativos antes de copiar base, configuración y archivos. Esta versión guarda directorio de versión, Caddy y 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
No incluye todos los archivos. Añada Persistent Profiles, Volume Mappings, carpetas compartidas, NFS, objetos y certificados/claves externos. Mantenga rutas/propiedad compatibles. Un dump transaccional no hace coherentes archivos de usuario que siguen cambiando.
Cifre y copie todo fuera del host; pruebe recuperación al menos mensualmente. Consulte la guía de ensayos VPS.
pg_restore -c sobrescribe objetos existentes. Ejemplo 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
Empiece en destino aislado con la misma versión, configuración, credenciales y referencias de host reconciliadas. Restaure archivos externos correspondientes. Mantenga escritores y usuarios detenidos, con PostgreSQL activo. Fase de base 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
Sustituya RESTORE_POINT por carpeta verificada. No continúe tras errores. Producción exige ventana y plan revisado porque sobrescribe datos. Verifique login, grupos, asignaciones, creación de espacios, políticas y archivos, no solo Running.
Revise requisitos de SO, Docker, imágenes y migración del destino. 1.17.0 cambió rutas; no reutilice posiciones antiguas sin revisar.
- Avisar mantenimiento.
- Terminar espacios activos.
- Copiar base, configuración, persistencia y snapshot VPS.
- Mantener al menos el objetivo original de 50 GB libres en Docker y verificar requisito real del destino.
- Descargar y verificar SHA-256.
- Usar
upgrade.shoficial del destino. - Probar acceso, Zone, sesiones, política y copia.
- Actualizar imágenes Workspace desde Registry después.
Conserve 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
Es un ejemplo para pasar de versión antigua compatible a 1.17.0, no para repetir en 1.17.0 existente. Use guía del destino real. install.sh repetido no es actualización. Tras migraciones, rollback requiere datos/software previos correspondientes.
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 falla: Kasm. Local funciona y dominio falla: Caddy, DNS y proveedor.
Zone proxy, puerto 0, sesión nueva. Revise upstream https://127.0.0.1:8443 y WebSocket permitido por CDN/proxy.
free -h
swapon --show
sudo docker stats --no-stream
sudo docker system df
Baje cuotas solo si la carga lo permite. Host lleno o con swap requiere menos sesiones o ampliación.
Quite definiciones/imágenes no usadas en administración y revise:
df -h /var/lib/docker
df -i /var/lib/docker
sudo docker system df -v
No use docker system prune -a indiscriminado: borra imágenes previstas, fuerza descargas o afecta otros proyectos.
cd /tmp
ls -lh kasm_install_*.log
tail -n 200 kasm_install_*.log
sudo docker info
df -h /
Revise espacio, Docker compatible, puertos y registro; diagnostique antes de repetir.
- SO soportado en VM/bare metal apropiado, no LXC.
- Edición/licencia, arquitectura y concurrencia revisadas.
- SHA-256 verificado.
- SSH restringido, HTTP/HTTPS públicos; 8443 denegado externamente.
- Caddy y salud correctos.
- Zone Upstream Auth Address=proxy, Proxy Port=0.
- Usuario normal predeterminado desactivado y MFA administrativo.
- All Users restrictivo e imágenes explícitas por grupo.
- Archivos, portapapeles y destrucción probados.
- Disco Docker, swap, salud y reinicios supervisados.
- Base, configuración y persistencia en copia externa.
- Recuperación crea espacio real.
- Actualización termina sesiones y conserva 8443.
Permiten instalación y prueba ligera, pero la sesión predeterminada pide 2 núcleos/2768 MB. Uso personal sostenido: aproximadamente 4 núcleos/8 GB y medir.
Guacamole conecta hosts RDP/VNC/SSH existentes; Kasm además crea navegadores/Linux temporales. Elija según conexiones fijas o espacios desechables.
No recomendado por permisos, redes Docker anidadas y kernel. Prefiera VM adecuada o bare metal.
Ajuste proxy y 0, termine sesión y cree otra; revise WebSocket.
Solo datos temporales. Perfiles, directorios mapeados/compartidos y objetos persisten según política efectiva.
Incluye definiciones/ajustes, no todos los perfiles, NFS, objetos y archivos mapeados. Cópielos y pruébelos en la misma restauración.