🪟 Instalador Windows — WSL Container Center#

Versión: 0.3.0 Última actualización: 2026-07-06 Audiencia: usuarios finales de Windows, mantenedores, revisores técnicos Distribución: GitHub Releases (el binario no se incluye en el repositorio)

🗺️ Descripción general#

WSL Container Center incluye un instalador nativo para Windows (wsl-labs-setup-{version}.exe) para usuarios que prefieren una instalación con un clic en lugar de clonar el repositorio a mano. El instalador está construido con Inno Setup, empaqueta el launcher compilado con Go e instala el workspace en %LOCALAPPDATA%\WSLLabs.

A diferencia de un instalador tradicional, no instala el motor de contenedores: se apoya en WSLC, incluido en WSL 2.9+ (preview), que debe estar disponible por separado. El launcher lo verifica antes de arrancar nada.

🗺️ Esquema#

flowchart LR
    Version["version.txt"]
    Version --> BuildL["build-launcher.ps1 (Go)"]
    BuildL --> Exe["wsl-labs-launcher.exe"]
    Exe --> BuildI["build-installer.ps1 (Inno Setup)"]
    Version --> BuildI
    BuildI --> Setup["dist/wsl-labs-setup-{ver}.exe"]

🧱 Requisitos previos (usuario final)#

📥 Instalación#

1. Descarga wsl-labs-setup-{version}.exe desde GitHub Releases.
2. Ejecuta el instalador.
3. Aparecerá un aviso de binario sin firma (diálogo del propio instalador) → clic en Sí para continuar.
4. Si Windows SmartScreen muestra una advertencia → ver ¿Por qué no se usa firma digital?.
5. Acepta el directorio de instalación (%LOCALAPPDATA%\WSLLabs por defecto).
6. Opcionalmente marca "Crear acceso directo en el escritorio" (desmarcado por defecto).
7. Clic en Instalar → Iniciar WSL Container Center.

El instalador no requiere permisos de administrador (PrivilegesRequired=lowest): instala en el espacio del usuario.

✅ Qué hace el instalador#

🚫 Qué NO hace el instalador#

• No instala WSL ni el motor WSLC (usa wsl --update --pre-release).
• No instala Node.js (el panel lo necesita en el PATH).
• No requiere permisos de administrador (instala en el espacio del usuario).
• No modifica el PATH del sistema ni el registro más allá de las entradas estándar de Inno Setup.
• No contiene firma digital en v0.x/v1.x (ver más abajo).

🚀 El launcher (wsl-labs-launcher.exe)#

El launcher es un binario Go compilado (launcher/windows/main.go) que sirve de punto de entrada principal para usuarios de Windows. Solo usa la biblioteca estándar de Go — sin dependencias externas.

Qué hace#

1. Muestra el banner de inicio con la versión y el aviso de binario sin firma.
2. Verifica WSL (wsl.exe --status); si falta, guía con wsl --install / wsl --update --pre-release.
3. Detecta la distro (wsl.exe -l -q, limpiando los bytes nulos del UTF-16).
4. Localiza la raíz del workspace (variable WSL_LABS_HOME, directorio del .exe o cwd; válida si contiene dashboard-server/).
5. Verifica Node.js (node --version).
6. Arranca el panel en segundo plano: node dashboard-server/server.js (puerto 9092), con la raíz del repo como directorio de trabajo.
7. Hace polling a http://localhost:9092/api/wslc/overview hasta 90 s (cada 3 s).
8. Abre http://localhost:9092 en el navegador por defecto (rundll32, con fallback a cmd /c start).
9. Muestra el resumen de URLs. La ventana se puede cerrar; el panel sigue corriendo.

Si algún paso falla, el launcher imprime un mensaje de error claro con instrucciones de solución y mantiene la consola abierta.

Código fuente#

launcher/
  windows/
    main.go   # Fuente Go — stdlib pura, sin dependencias externas

Compilar localmente#

# Desde la raíz del repo
.\scripts\windows\build-launcher.ps1 -Version 0.3.0

El script inyecta la versión con -ldflags "-X main.launcherVersion=..." y lee version.txt si no se pasa -Version. Salida: launcher\windows\wsl-labs-launcher.exe.

🔨 Compilar el instalador localmente#

Requisitos (máquina de build)#

Pasos#

# 1. Clonar el repositorio
git clone https://github.com/vladimiracunadev-create/wsl-labs.git
cd wsl-labs

# 2. Compilar el launcher (Go)
.\scripts\windows\build-launcher.ps1 -Version 0.3.0

# 3. Compilar el instalador (Inno Setup)
.\scripts\windows\build-installer.ps1 -Version 0.3.0

# Resultado: dist\wsl-labs-setup-0.3.0.exe

build-installer.ps1 localiza ISCC.exe automáticamente (o acepta -InnoSetupPath), invoca Inno Setup con /DAppVersion=$Version y deja el .exe en dist\.

📦 Qué contiene el instalador#

El script de Inno Setup (installer/wsl-labs.iss, sección [Files]) empaqueta:

🗑️ Desinstalación#

Desde Configuración de Windows → Aplicaciones → WSL Container Center → Desinstalar (o el acceso directo "WSL Container Center — Uninstall" del menú Inicio).

El desinstalador:

1. Elimina todos los archivos instalados en %LOCALAPPDATA%\WSLLabs.
2. Elimina los accesos directos del menú Inicio y del escritorio.
3. Elimina la entrada de registro del desinstalador.

🔏 ¿Por qué no se usa firma digital en esta fase?#

La decisión#

WSL Container Center v0.x/v1.x no usa firma digital de código para el instalador ni el launcher. Es una decisión de producto intencional y explícita, no un descuido. El .iss ya deja la directiva SignTool comentada, lista para activarse.

Razones#

Impacto para el usuario final#

Al ejecutar el instalador sin firma, Microsoft SmartScreen puede mostrar:

Este comportamiento es normal para software nuevo o descargado con poca frecuencia. No indica que el software sea malicioso.

Cómo GitHub Releases mitiga el riesgo#

• Descargas verificadas con TLS servidas por GitHub.
• El release está etiquetado a un commit específico (vX.Y.Z).
• El código fuente es públicamente auditable y el build es reproducible.
• Cualquiera puede reconstruir el instalador con build-launcher.ps1 + build-installer.ps1.

Hoja de ruta para la firma#

Se considerará firmar cuando el proyecto alcance una base de usuarios mayor, cuando un certificado Azure Code Signing ($99/año) sea factible, o cuando lo adopte una organización que pueda proveer un certificado EV. El .iss ya tiene el hueco:

; No signing en v0.x/v1.x
; SignTool=...

🩺 Solución de problemas de instalación#

🎤 Presentación en demos y portfolio#

Esta capa de distribución Windows demuestra:

• Pensamiento de producto: diseñar para el usuario final más allá del git clone.
• Dominio de Go: binario nativo Windows sin dependencias en runtime.
• Puente Windows ↔ WSLC: el launcher valida wsl.exe, detecta la distro y orquesta el arranque del panel de contenedores.
• Packaging Windows: Inno Setup para una instalación profesional sin admin.
• CI/CD: build automatizado vía GitHub Actions al pushear un tag.
• Conciencia de seguridad: política explícita de binario sin firma con medidas compensatorias.

🔗 Documentos relacionados#

• github-releases-distribution.md
• technical-audit.md
• wslc-contenedores.md
• ../README.md
• ../CHANGELOG.md