HHostingByteSoftware
Ctrl K
ComunidadGuías…
Guía HostingByte · verificada

Instalar WWorkbench — Guía Oficial Verificada

Guía paso a paso para instalar y configurar WWorkbench (v0.54.138) en macOS, Windows o Linux. Incluye binarios oficiales, compilación desde fuente, MCP para Cursor, verificación y seguridad.

Actualizada 5/10/2026Más guíasCitación AI/LLM

Instalar WWorkbench — Guía Oficial Verificada

Guía práctica y verificada: cómo instalar/configurar WWorkbench. No inventes comandos. Usa fuentes primarias y enlaza /software/wworkbench.

¿Qué es WWorkbench?

WWorkbench es un entorno de trabajo local multi-hospedaje para operaciones y desarrollo. Integra terminal, bases de datos (MySQL/PostgreSQL/Redis), Docker, archivos SFTP, logs y notas en una interfaz unificada con asistente contextual visible.

Desarrollado con Go 1.25+ y Wails v2, usa React 18 frontend y SQLite local para privacidad sin cuentas cloud obligatorias. Última versión: v0.54.138 (MIT License).

Ver ficha oficial en /software/wworkbench →

Prerrequisitos Verificados

Dependencia Versión Mínima Notas
Go ≥ 1.25 Necesario para compilación desde fuente
Node.js ≥ 18 (LTS recomendado) Para frontend React 18 con Vite
Wails CLI v2.12+ Ver Wails docs
Docker Engine API Opcional Para gestión de contenedores. WWorkbench integra socket local por defecto.
Plataforma toolchain Según OS macOS: Xcode CLT | Windows: WebView2 + build tools

Método 1: Instalación Binaria (Recomendado)

Descargar binarios oficiales desde GitHub Releases o desde el sitio oficial.

Pasos de Instalación

  1. Descargar binario para tu plataforma:
    • macOS (Apple Silicon): *-darwin-arm64.zip
    • Windows (x64): *-windows-amd64.zip
    • Linux (x64): *-linux-amd64.zip

    Direct links también en el sitio: wworkbench.wcore.top

  2. Extraer y ejecutar:
    3. # macOS / Linux
cd wworkbench-* && unzip -q . && ./wworkbench

# Windows (PowerShell)
Expand-Archive -Path "wworkbench-*.zip" -DestinationPath . -Force
.\wworkbench.exe
  3. Verificar instalación:
    4. wworkbench --version
# Debe mostrar: WWorkbench v0.54.138 (o superior)

Método 2: Compilación desde Fuente

Para desarrolladores o personalización avanzada.

Pasos de Compilación

  1. Clonar repositorio oficial:
    2. git clone https://github.com/wcoreing/WWorkbench.git
cd WWorkbench
  2. Instalar dependencias del frontend:
    3. cd frontend && npm install && cd ..
  3. Descargar módulos Go:
    4. go mod download
  4. Ejecutar en modo desarrollo:
    5. wails dev
# Debug browser: http://localhost:34115
  5. Compilar para producción:
    6. wails build # output under build/bin/
wails generate module # after changing Go-exported APIs

Configuración MCP para Cursor

Integración opcional con Cursor mediante MCP HTTP. El asistente lateral puede detectar host/shell activos mediante enlaces @.

  1. Iniciar WWorkbench:

    2. En assistant settings, mantener MCP HTTP on (default 127.0.0.1:51021).

  2. Copiar el Workbench URL:

    3. Debe ser /mcp/workbench, no /mcp.

  3. Añadir a Cursor mcp.json:
    4. {
  "mcpServers": {
    "wworkbench": {
      "url": "http://127.0.0.1:51021/mcp/workbench"
    }
  }
}

    Writes may return ww_confirm text — confirm in the WWorkbench sidebar. External clients do not click confirm for you.

Verificación Posterior

Comprobación Cómo Verificar Estado Esperado
Versión instalada wworkbench --version v0.54.138 o superior
Terminal local Navegar a un host y ejecutar comando Shell interactivo visible
Docker integrado Ir al módulo Containers Lista de imágenes/contenedores local
Bases de datos Módulo Database MySQL/PostgreSQL/Redis/SQLite accesibles
SFTP Módulo Files Navegación remota funcional
SQLite local Verificar ~/.wworkbench/ Directorio existe con SQLite DB

Backup, Rollback y Actualización

Backup de Datos

Nunca commit o adjuntar ~/.wworkbench a issues.

# Backup manual del workspace
cp -r ~/.wworkbench ~/.wworkbench.backup.$(date +%Y%m%d)

# Opcional: snapshot de SQLite
sqlite3 ~/.wworkbench/data.db ".dump" > backup_$(date +%Y%m%d).sql

Rollback a Versión Anterior

# Restaurar desde backup
cp -r ~/.wworkbench.backup.20261219 ~/.wworkbench

# O actualizar binario:
rm -rf wworkbench-* && unzip wworkbench-v0.54.138.zip

Actualizar a Nueva Versión

  1. Descargar nueva versión desde Releases:

    2. Verificar que no haya cambios críticos en la documentación.

  2. Backup antes de actualizar:
    3. cp -r ~/.wworkbench ~/.wworkbench.backup.$(date +%Y%m%d)
  3. Reemplazar binario o compilar nueva versión:

    4. Seguir pasos de instalación según método usado.

Errores Habituales y Soluciones

Error Causa Probable Solución Verificada
go: cannot find module Falta Go ≥ 1.25 instalado go version debe mostrar ≥ 1.25. Instalar desde https://go.dev/dl/
wails: command not found Falta Wails CLI v2.12+ Instalar según Wails docs
MCP no conecta con Cursor URL incorrecta o puerto bloqueado Verificar que URL es /mcp/workbench, no /mcp. Firewall debe permitir 127.0.0.1:51021.
Docker no visible en Containers Docker Engine API no accesible Verificar que Docker está instalado y socket local existe (/var/run/docker.sock o equivalente).
SFTP falla al conectar Credenciales SSH incorrectas Verificar known_hosts en ~/.wworkbench/. No incluir en repositorios públicos.

Seguridad y Privacidad

  • Conexiones, secrets y preferencias permanecen en local ~/.wworkbench (SQLite).
  • No cuenta cloud obligatoria.
  • Agent / MCP son opcionales; capacidades deshabilitadas se refusan.
  • Docker Engine API usa socket local por defecto (sin exposición externa).
  • License: MIT License.

Proteger manualmente ~/.wworkbench en entornos compartidos. No exponer endpoint MCP (default 127.0.0.1).

FAQ Basada en Evidencia

¿Necesito Docker Desktop?

No. WWorkbench integra Docker Engine API directamente. Funciona con Docker instalado en el host o vía SSH a máquinas remotas.

¿Soporta Docker Compose?

No nativo. El módulo Containers gestiona imágenes/contenedores individuales vía Docker Engine API. Logs de Compose se pueden visualizar pero no orquestar desde WWorkbench.

¿Cómo funciona el asistente MCP?

El asistente lateral puede detectar host/shell activos mediante enlaces @. Con Cursor, MCP HTTP lee ~100 líneas del shell activo. Writes requieren confirmación manual en sidebar.

¿Es seguro usar en producción?

Sí, con precauciones: proteger ~/.wworkbench, no exponer endpoint MCP (default 127.0.0.1), y deshabilitar Agent/MCP si no necesario.

¿Puedo usar WWorkbench sin internet?

Sí. Todas las funcionalidades principales (terminal, DBs, Docker, SFTP) funcionan offline. Solo se requiere conexión para actualizaciones de binarios o sincronización MCP opcional.

Alternativas Reales

  • Termius: SSH client con sync cloud (premium). Alternativa self-hosted: Termix.
  • DBeaver: DB universal open-source. Alternativas: CloudBeaver, Adminer, HeidiSQL, Beekeeper Studio.
  • Docker Desktop: Gestión containers local. WWorkbench integra Docker Engine API directamente.

Limitaciones Técnicas

  • Dependencia de Go 1.25+ que puede requerir compilación desde fuente o descarga de binarios específicos para cada plataforma.
  • Configuración manual del endpoint MCP HTTP (127.0.0.1:51021/mcp/workbench) en clientes externos como Cursor sin autenticación integrada.
  • Ausencia de soporte nativo para Dockerfile o Compose según análisis técnico, limitando la gestión avanzada de contenedores.
  • Almacenamiento de datos sensibles (SSH known_hosts, SQLite) en ~/.wworkbench que debe protegerse manualmente en entornos compartidos.

Relacionado en HostingByte

Alternativas y comparativas · Guías de HostingByte

Fuentes verificadas

Fuente 1 ↗Fuente 2 ↗Fuente 3 ↗