¿Docker lento en Windows?: Multiplica el rendimiento usando WSL 2

1. ¿Por qué Docker suele ir lento en Windows?

Por defecto, muchos desarrolladores montan sus volúmenes de Docker desde rutas de Windows (C:\Users\..). Esto obliga a Docker a realizar una traducción constante entre el sistema de archivos de Linux (dentro del contenedor) y el de Windows (donde está el código).

• En Windows (NTFS): Docker debe usar el protocolo 9P para traducir cada lectura/escritura entre Windows y el contenedor Linux. Esto añade una latencia enorme.
• En WSL 2 (ext4): El acceso es directo al Kernel de Linux.

El impacto: En proyectos con muchas operaciones de I/O, la diferencia de velocidad puede ser de 5x a 10x superior si usamos el sistema de archivos de WSL.

2. Requisitos previos

Instalar y configurar WSL 2

Antes de migrar tu código, asegúrate de tener el entorno listo. Abre PowerShell como administrador y ejecuta:

wsl --install

Tras reiniciar, verifica que usas la versión 2:

wsl -l -v

Ejemplo de output:     

Si muestra versión 1, actualiza con:

wsl --set-version <name> 2

# <name> → valor de la columna NAME (por ejemplo: Ubuntu-22.04)
# Solo necesario si la VERSION es 1

Configurar Docker Desktop

1. Ve a Settings > General y marca: Use the WSL 2 based engine.
2. En Settings > Resources > WSL Integration:

• Activa Enable integration with my default WSL distro.
• Activa el interruptor de tu distribución específica (ej. Ubuntu).

3. La Regla de Oro: ubicación del código

Para que el rendimiento de Docker en Windows sea óptimo, el código NUNCA debe estar en carpetas de Windows.

4. Flujo de trabajo recomendado

Este flujo de trabajo evita completamente el acceso de Docker a sistemas de archivos NTFS y elimina el principal cuello de botella de rendimiento en Windows.

📥 Clonar el proyecto

No uses Git Bash o PowerShell. Abre tu terminal de Ubuntu y hazlo ahí:

cd ~  # Vas a tu home de Linux
mkdir desarrollo && cd desarrollo # carpeta para nuestro proyecto/s
git clone <tu-repositorio>

Ejemplo de como se ve la ruta en el explorador de archivos de windows

\\wsl.localhost\Ubuntu-22.04\home\german\desarrollo
# "german" es el usuario de ejemplo

💻 Abrir con VS Code

Asegúrate de tener instalada la extensión Remote - WSL en VS Code. Una vez instalada:

1. En tu terminal de Ubuntu, entra a la carpeta del proyecto.
2. Escribe: code .
3. VS Code se conectará a WSL y verás en la esquina inferior izquierda: WSL: Ubuntu

🐳 Levantar Docker

Simplemente ejecuta tus comandos habituales dentro de la terminal de WSL:

docker compose up -d

5. Resultado

Si sigues este flujo, Docker en Windows alcanzará un rendimiento comparable a Linux nativo, mejorando la velocidad de respuesta entre 5x y 10x en tiempo de ejecución.

Este es el escenario final que has configurado:

• WSL 2 es el motor
• ext4 (dentro de /home/..) es el combustible
• VS Code Remote es el puente