web-terminal
Terminal web autohospedada móvil-first impulsada por Ghostty WASM con sesiones que sobreviven a desconexiones, explorador de archivos e integración herdr. Requiere Bun ≥1.4.
Ficha actualizada 26 sept 2026, 12:18 · upstream 26 sept 2026, 12:09 · release v0.1.0
Qué es web-terminal
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
web-terminal es una terminal web autohospedada diseñada para dispositivos móviles, construida sobre el motor VT de Ghostty compilado a WebAssembly. Su arquitectura centraliza la propiedad del terminal en el servidor, no en la conexión WebSocket, lo que permite sesiones que sobreviven a caídas de red o cambios entre redes (Wi-Fi/LTE). El cliente renderiza mediante ghostty-web con soporte para truecolor, clusters de grafemas complejos, anchos CJK y TUIs en pantalla alternativa.
- Acceso remoto seguro a servidores desde dispositivos móviles sin instalar clientes nativos
- Continuar sesiones interrumpidas tras desconexiones de red o cierres del navegador
- Gestión de archivos remotos con explorador integrado y operaciones CRUD bajo jail root
- Monitoreo de agentes herdr en tiempo real mediante socket NDJSON local
- Despliegue rápido en infraestructura existente sin contenedores Docker
- Motor VT completo compilado a WASM (~400 KB) con soporte para truecolor y TUIs complejos
- Sesiones que sobreviven a desconexiones mediante PTY en servidor y buffer de reproducción acotado
- Autenticación segura con argon2id (64 MiB, t=3) y limitación de tasa 5 intentos/5 min por IP
- Explorador de archivos bajo jail root con validación de rutas reales contra escapes de symlink
- Integración nativa con herdr para visualización de workspaces y estados de agentes en tiempo real
- Requiere Bun runtime ≥1.4 (canary) — no compatible con Node.js estándar ni otros runtimes
- Sin Dockerfile o compose nativo — despliegue manual mediante scripts proporcionados
- Autenticación obligatoria en listener público; bypass solo disponible con WT_TRUSTED_BIND configurado correctamente
- Shell fish no soportado por problemas de consulta de capacidades VT durante inicialización
- No incluye persistencia de datos automática — sesiones dependen de buffer de reproducción en memoria
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Ejecutar detrás de proxy inverso (Cloudflare/Tailscale) con WT_PASSWORD configurado. Para despliegue LAN, usar WT_HOST=0.0.0.0 y exponer puerto 7777. Nunca exponer listener público sin autenticación. Configurar WT_FILES_ROOT para restringir acceso a directorio específico. Usar cloudflared apuntando solo al listener loopback, nunca al trusted bind.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.