📜 WSL — Historia, fundamentos y referencia completa de comandos#

1. 🏛️ Historia de WSL — por qué Microsoft lo creó#

El contexto: "Microsoft loves Linux"#

Cuando Satya Nadella asumió como CEO en 2014, Microsoft giró de forma radical su relación con el software libre. Ese mismo año acuñó públicamente la frase "Microsoft loves Linux" y empezó una apertura sostenida al open source: .NET pasó a ser open source, y Azure —el negocio en la nube que Nadella quería hacer crecer— empezaba a alojar muchísima carga de trabajo Linux.

El problema de negocio: se iban los desarrolladores#

Los desarrolladores web, backend y cloud necesitaban herramientas Unix en su día a día: bash, grep, ssh, git, node, python, ruby, contenedores… En Windows, conseguir eso significaba doble arranque (dual-boot) o VMs pesadas. Resultado: mucha gente se pasaba a macOS o Linux de escritorio. Windows estaba perdiendo a la comunidad dev, justo el público que decide qué plataforma usan los equipos.

La respuesta de Microsoft fue traer Linux dentro de Windows, sin dual-boot y sin la fricción de una VM tradicional.

🧱 WSL 1 — traducción de syscalls (2016)#

• Anunciado en Build 2016; llegó con **Windows 10 Anniversary Update

(agosto de 2016)**.

• Enfoque técnico: traducía las llamadas al sistema (syscalls) de Linux a NT

mediante un driver de kernel (lxcore, apoyado en el mecanismo de pico processes). No había kernel Linux: los binarios ELF de Linux corrían y sus syscalls se traducían al kernel de Windows en tiempo real.

• Sus raíces técnicas están parcialmente en Project Astoria (el intento de

correr apps Android en Windows).

• Ventaja: muy ligero e integrado, arranque casi instantáneo.
• Límite: no implementaba todas las syscalls → incompatibilidades

(por ejemplo, Docker no corría bien) y rendimiento pobre en ciertas operaciones del sistema.

🚀 WSL 2 — un kernel Linux real (2020)#

• Anunciado en 2019; general en Windows 10 versión 2004 (mayo de 2020).
• Cambio de enfoque: en lugar de traducir syscalls, WSL 2 ejecuta un **kernel

Linux real —compilado por Microsoft, bajo licencia GPL y distribuido vía Windows Update— dentro de una VM utilitaria ligera sobre Hyper-V**.

• Motivo: compatibilidad total de syscalls y un rendimiento de **E/S del

sistema de archivos Linux mucho mejor** que WSL 1.

• Trade-off: el acceso cruzado a archivos de Windows (/mnt/c/...) es

más lento que en WSL 1, porque cruza la frontera entre la VM y el host.

🖼️ WSLg y ⚙️ systemd#

• WSLg (2021–2022): soporte para ejecutar aplicaciones Linux con GUI

directamente en el escritorio de Windows.

• systemd (2022): soporte oficial para systemd, activable por distro

vía /etc/wsl.conf ([boot] systemd=true). Esto habilitó gestionar servicios con systemctl de forma nativa.

📊 Razones fundamentadas (resumen)#

🗓️ Línea de tiempo de hitos#

timeline
    title Hitos de WSL (2014 → 2026)
    2014 : Satya Nadella CEO
         : "Microsoft loves Linux"
         : .NET open source · Azure con carga Linux
    2016 : WSL 1 (Build 2016)
         : Windows 10 Anniversary Update (ago)
         : Traducción de syscalls (lxcore / pico processes)
    2019 : WSL 2 anunciado
         : Enfoque de kernel Linux real
    2020 : WSL 2 general
         : Windows 10 v2004 (may) · VM ligera sobre Hyper-V
    2021 : WSLg
         : Apps Linux con GUI en Windows
    2022 : systemd oficial
         : /etc/wsl.conf [boot] systemd=true
    2023 : Mirrored networking · Sparse VHD
         : App WSL Settings (GUI) · wsl --manage
    2025 : WSL open source (Build 2025)
         : github.com/microsoft/WSL
    2026 : WSL Containers (WSLC)
         : imágenes, volúmenes y redes nativas (wslc)

2. 🔬 WSL 1 vs WSL 2 — arquitectura#

La diferencia central es cómo se ejecuta Linux:

• WSL 1 → no hay kernel Linux. Un driver de Windows (lxcore) **traduce

las syscalls** de Linux a llamadas del kernel NT.

• WSL 2 → hay un kernel Linux real corriendo dentro de una **VM ligera

sobre Hyper-V**; Windows habla con esa VM.

flowchart TB
    subgraph WSL1["🧱 WSL 1 · traducción de syscalls"]
        A1["Binarios ELF Linux"]
        A2["lxcore (driver)<br/>traduce syscalls Linux → NT"]
        A3["Kernel NT (Windows)"]
        A1 --> A2 --> A3
    end

    subgraph WSL2["🚀 WSL 2 · kernel real en VM"]
        B1["Binarios ELF Linux"]
        B2["Kernel Linux real<br/>(compilado por Microsoft, GPL)"]
        B3["VM utilitaria ligera"]
        B4["Hyper-V"]
        B1 --> B2 --> B3 --> B4
    end

Tabla comparativa#

3. 🖥️ WSL y la "plataforma desktop" (la brecha con Docker se está cerrando)#

Históricamente, frente a Docker —que trae Docker Desktop con GUI oficial, panel de contenedores, imágenes y volúmenes— WSL se gestionaba solo por CLI (wsl.exe + Windows Terminal), sin panel de escritorio para operar servicios de un vistazo. Eso ya no es del todo cierto: Microsoft ha ido añadiendo piezas de "plataforma".

• 🪟 App WSL Settings (GUI) — aplicación gráfica oficial para gestionar la

configuración de WSL (equivale a editar .wslconfig, pero con categorías y validación). Ya hay una interfaz de escritorio, aunque orientada a ajustes, no a operar servicios.

• 🧩 Integración con Dev Home ("Environments") para lanzar y crear entornos,

incluidas distros WSL.

• 🐳 WSL Containers (WSLC) — desde 2026, WSL trae **imágenes, volúmenes y redes

nativas con el comando wslc (ver la sección §4 más abajo). Esto acerca WSL a la paridad con Docker sin depender de Docker Desktop**.

Dónde encaja wsl-labs: WSLC cubre contenedores; lo que sigue sin tener una GUI oficial es operar servicios Linux "clásicos" (nginx, apache, postgres…) directamente sobre la distro. Ese es el hueco que llena este repo:

• 🧭 Control Center web en http://localhost:9092 para instalar, arrancar y

detener esos servicios y ver su salud (📦 Instalar → ▶ Levantar), al estilo panel.

• 🪟 Launcher de Windows (.exe) que detecta la distro, levanta el stack y

abre el navegador.

Ver el detalle en el README y en la guía docs/DASHBOARD_SETUP.md.

4. 🆕 WSL hoy (2025-2026): open source y contenedores nativos (WSLC)#

WSL dejó de ser una caja negra y se acercó mucho a Docker. Dos cambios grandes:

🔓 WSL es open source (Build 2025)#

El 19 de mayo de 2025, en Microsoft Build, WSL se liberó como open source. El código vive en github.com/microsoft/WSL.

🐳 WSL Containers (WSLC) — imágenes, volúmenes y redes nativas#

Esto es lo que probablemente escuchaste: Windows metió, dentro de WSL, un motor de contenedores tipo Docker — con imágenes, volúmenes y redes — para correr cargas Linux sin necesidad de Docker Desktop (cuyo backend WSL2 es una fuente habitual de fallos para muchos usuarios). Tiene dos caras:

• CLI wslc.exe — interfaz familiar (muy parecida a docker):

``powershell # Correr un contenedor wslc run --rm -it ubuntu:latest bash -c "echo Hola desde un contenedor WSL" # Listar imágenes wslc image ls # Servidor web publicando puerto wslc run -it --rm -d -p 8080:80 --name web nginx curl localhost:8080 # Ver y detener contenedores wslc container ps wslc container stop web ``

• API de contenedores WSL — paquete NuGet Microsoft.WSL.Containers

(proyecciones C, C# y C++/WinRT) para que apps de Windows usen contenedores Linux programáticamente (objetos WslcService, Session, Container, Process; soporta montajes de archivos, red, GPU y stdin/stdout).

Capacidades (preview): imágenes (build, pull, push, import, save, inspect, prune) · contenedores (create/run/start/kill/export con límites --cpus, --memory, --shm-size) · redes (crear/gestionar, alias, publicar puertos) · volúmenes respaldados por VHD.

📦 Distros desde imágenes de contenedor#

También puedes construir una distro WSL a partir de una imagen Docker/OCI: exportas el rootfs de un contenedor a un .tar (gzip) y lo importas con wsl --import. Ver Build a Custom Linux Distro for WSL en la documentación de Microsoft.

🌐 Otras mejoras recientes#

5. ⌨️ Referencia completa de comandos WSL (wsl.exe desde Windows)#

📦 Instalación y actualización#

# Instalar WSL 2 + Ubuntu (reinicia si es la primera vez)
wsl --install

# Instalar una distro específica
wsl --install -d Debian

# Actualizar el kernel de WSL
wsl --update

🗂️ Gestión de distribuciones#

wsl -l -v
wsl --set-default Ubuntu
wsl --set-version Ubuntu 2
wsl --set-default-version 2

🔄 Ciclo de vida#

wsl -d Ubuntu                 # shell en Ubuntu
wsl --shutdown                # apaga todo WSL (libera RAM)
wsl --terminate Ubuntu        # detiene solo Ubuntu
wsl -u root -d Ubuntu         # shell como root
wsl -d Ubuntu -e uname -a     # ejecuta un comando y sale
wsl --cd ~ -d Ubuntu          # abre en el home de Linux

💾 Backup y portabilidad#

# Backup completo de la distro
wsl --export Ubuntu .\ubuntu-backup.tar

# Restaurar como una distro nueva en WSL 2
wsl --import Ubuntu-Lab .\Ubuntu-Lab .\ubuntu-backup.tar --version 2

Más detalle en el cheatsheet de comandos WSL.

🧭 Ejemplos reales de wsl-labs#

El Control Center invoca la distro desde Windows con esta forma —usuario root, shell de login, comando entre comillas— para instalar y levantar servicios:

# Patrón que usa el Control Center para operar la distro
wsl -d Ubuntu -u root -- bash -lc "systemctl start nginx && ss -tlnp | grep :8080"

# Levantar el stack y comprobar salud de un servicio
wsl -d Ubuntu -u root -- bash -lc "service postgresql start && pg_isready"

6. 🐧 Comandos dentro de la distro (Linux) útiles en WSL#

Una vez dentro de la distro, la gestión es Linux estándar:

7. ⚙️ Configuración: .wslconfig y /etc/wsl.conf#

Hay dos archivos de configuración con ámbitos distintos:

.wslconfig — límites globales de la VM#

Controla memoria, CPU, swap y red de la VM utilitaria de WSL 2.

# %UserProfile%\.wslconfig
[wsl2]
memory=4GB              # RAM máxima para la VM
processors=2            # núcleos asignados
swap=2GB                # tamaño del swap
vmIdleTimeout=60000     # ms de inactividad antes de suspender la VM
networkingMode=mirrored # modo de red (p. ej. mirrored)

/etc/wsl.conf — ajustes por distro#

Configura systemd, montajes automáticos, red y usuario por defecto de esa distro.

# /etc/wsl.conf (dentro de la distro)
[boot]
systemd=true            # habilita systemd (systemctl, journalctl)

[automount]
enabled=true            # monta discos de Windows en /mnt
options=metadata        # permite permisos/propietario en /mnt

[network]
generateHosts=true      # gestiona /etc/hosts

[user]
default=vlad            # usuario por defecto al entrar

8. 🔗 Ver también#

• docs/00-que-es-wsl.md — Fundamentos de WSL
• docs/01-instalacion-wsl.md — Instalación paso a paso
• docs/02-comandos-basicos.md — Comandos básicos
• docs/03-wsl-vs-docker-vs-vm.md — Comparativa con la línea
• cheatsheets/comandos-wsl.md — Cheatsheet de wsl.exe
• docs/DASHBOARD_SETUP.md — Montar el Control Center
• docs/DOCUMENTATION_INDEX.md — Índice maestro de la documentación
• ../README.md — Visión general del repo