Instale Docker en Windows con WSL 2 y ejecute su primer contenedor
Docker en Windows funciona mejor en un kernel de Linux real y WSL 2 le ofrece exactamente eso. Esta guía instala las cosas en el orden que evita los errores clásicos: WSL 2 primero, Docker Desktop después y un pequeño contenedor de prueba para demostrar que toda la cadena funciona.
✍️ Technical Anshu🪟 Windows 10 / 11⏱️ 10 minute setup and read
🎥 Mire la instalación completa en el vídeo: configuración de WSL 2 y el primer contenedor, paso a paso
La mayoría de las instalaciones fallidas de Docker en Windows fallan por una razón aburrida: el orden era incorrecto. Docker Desktop espera un WSL 2 funcional debajo, por lo que primero construimos la base, la verificamos y solo luego instalamos Docker. Al final ejecutarás hello-world, un pequeño contenedor que demuestra que el cliente, el motor, la red y el almacén de imágenes funcionan. Siga el vídeo de arriba para ver el tutorial en pantalla; Esta página es la lista de verificación escrita con las advertencias honestas incluidas.
Windows PowerShell - the two commands that prove the install (real output style)
PS C:\Users\Anshu> docker --version
Docker version 27.x, build xxxxxxx
PS C:\Users\Anshu> docker run hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
Hello from Docker!
This message shows that your installation appears
to be working correctly.
Cómo se ve realmente el éxito: la línea de la versión, la primera extracción y el mensaje de confirmación del propio Docker
1
Primero verifique que su PC pueda hacer esto
Docker Desktop con el backend WSL 2 necesita tres cosas. Saltarse este control es como la gente pierde una noche.
Windows 10 versión 2004 o posterior, o Windows 11: consulte con winver
Virtualización activada en BIOS o UEFI: abra el Administrador de tareas, vaya a Rendimiento, luego a CPU y busque Virtualización: habilitada. Si dice Desactivado, ninguna configuración de software lo salvará; habilite Intel VT-x o AMD SVM en el BIOS primero
Aproximadamente 4 GB de RAM libre y unos pocos GB de disco: WSL 2 y Docker comparten su máquina, no la reemplazan
Nota honesta: en las ediciones de Windows Home, esta ruta WSL 2 no es una solución alternativa, es la ruta prevista. No se requiere Hyper-V para ello.
2
Instale WSL 2 antes que nada
Abra PowerShell como administrador y ejecute un comando:
wsl --install
Deje que termine, luego reinicie la PC; este paso no es opcional, el reinicio carga los componentes de virtualización.
Después del reinicio, Ubuntu (la distribución predeterminada) finaliza su propia configuración y le pide que cree un nombre de usuario y contraseña de Linux. Esa contraseña es solo para Linux sudo; elija una que recuerde, porque no se muestra nada en la pantalla mientras la escribe.
Confirme la base con wsl --status y wsl -l -v; su distribución debería mostrar la VERSIÓN 2. Si muestra 1, ejecute wsl --set-default-version 2 y convierta la distribución como sugiere el resultado del comando
Hay una página completa en este conjunto sobre por qué es importante este orden y qué se interrumpe cuando Docker entra primero.
3
Instale Docker Desktop en la parte superior
Descargue Docker Desktop solo desde docker.com: los sitios de descarga de terceros incluyen basura con instaladores populares
Ejecute el instalador y mantenga marcada la opción Usar WSL 2 en lugar de Hyper-V; en la mayoría de las PC, está marcada de forma predeterminada.
Cuando el instalador lo solicite, déjelo cerrar y cierre su sesión o reinícielo si se le solicita. Docker agrega su cuenta de Windows al grupo local docker-users y la membresía del grupo solo entra en vigor al iniciar sesión de nuevo.
Inicie Docker Desktop y espere a que se establezca el icono de ballena en la bandeja del sistema y el panel informe Motor en funcionamiento. El primer comienzo es lento; dale un par de minutos
Acepte honestamente la pantalla del Acuerdo de servicio de suscripción de Docker: es una licencia real y la página de licencia de este conjunto explica cuándo Docker Desktop es gratuito y cuándo una empresa debe pagar.
4
Pruébalo con Hola Mundo
Abra una nueva ventana de PowerShell o Terminal y ejecute:
docker --version: demuestra que el cliente está instalado y en su RUTA
docker run hello-world: prueba todo lo demás. Docker no puede encontrar la imagen localmente, la descarga de Docker Hub, crea un contenedor a partir de ella, la ejecuta e imprime su mensaje.
Si aparece el mensaje, su cadena funciona de extremo a extremo: terminal, cliente, motor dentro de WSL 2, red y registro.
Nota honesta: la primera ejecución necesita Internet para realizar la extracción. Si falla, no lo reinstale a ciegas: la página de escalera que no se inicia en este conjunto analiza las causas en orden.
5
Dos advertencias honestas antes de seguir adelante
usuarios de Docker significa poder. Cualquiera en ese grupo puede ejecutar contenedores, y un contenedor puede montar toda la unidad de Windows; trate la membresía de usuarios de Docker como confianza a nivel de administrador y solo agregue cuentas a las que le entregaría la máquina.
Mantenga los archivos de proyecto dentro de Linux. El código almacenado en el sistema de archivos WSL (su carpeta de inicio de Ubuntu) es dramáticamente más rápido para los contenedores que los mismos archivos alcanzados a través de /mnt/c. Mueva los proyectos activos a Linux y ábralos desde allí.
🔴 Docker Desktop es gratuito para uso personal y pequeñas empresas según los umbrales de tamaño publicados de Docker, y una suscripción paga por usuario para empresas más grandes. Si está instalando esto en una máquina de oficina, lea la página de licencias de este conjunto antes de que su equipo de TI o de auditoría haga la pregunta primero.
🎥 Mira el proceso completo en el vídeo
Vea la configuración completa en el video: instalación de WSL 2, instalación de Docker Desktop y el primer contenedor ejecutándose en vivo.
Para uso personal, educación y pequeñas empresas bajo los umbrales de ingresos y empleados publicados por Docker, sí, Docker Desktop es gratuito. Las empresas más grandes necesitan una suscripción paga por usuario. Docker Engine en un servidor Linux es una ruta independiente de código abierto y se trata en la página de licencias de este conjunto.
¿Necesito Windows 11 Pro o Hyper-V para Docker con WSL 2?
No. El backend de WSL 2 también funciona en Windows 10 Home y Windows 11 Home. Necesita la virtualización habilitada en el BIOS y una compilación de Windows lo suficientemente reciente. Hyper-V solo es necesario para el backend de Hyper-V anterior, que esta guía no utiliza.
Docker Desktop se atasca al iniciarse. ¿Qué debo comprobar primero?
Verifique en este orden: la virtualización se muestra Habilitada en el Administrador de tareas, wsl --status se ejecuta limpiamente y su distribución es la versión 2, el servicio de escritorio Docker se ejecuta en services.msc y usted cerró sesión y volvió a iniciar sesión desde la instalación, por lo que se aplica el grupo de usuarios de Docker. La página de escalera de reparación de este conjunto recorre cada paso.
Esta guía está basada en el vídeo Anshu técnico Docker en WSL 2 • ¿Atascado en algún paso? Pregunte en los comentarios del video; allí recibirá una respuesta 🙏