Come installare Docker su Windows 11: una guida di 5 minuti (2025)

Un percorso di lancio in 5 minuti verso Docker su Windows 11

Docker è una piattaforma aperta che ha cambiato radicalmente lo sviluppo del software moderno. Sfrutta la containerizzazione per impacchettare le applicazioni e le loro dipendenze in unità leggere, isolate e portatili chiamate container. This technology elegantly solves the classic and often frustrating “it works on my machine” problem by ensuring that an application runs consistently across development, testing, and production environments. Alla fine di questa guida completa, ogni sviluppatore o appassionato di tecnologia avrà un ambiente Docker perfettamente funzionante sul proprio PC Windows 11, pronto a costruire, condividere ed eseguire applicazioni containerizzate con fiducia.   

The “5-minute” claim in the title refers specifically to the active installation and command execution time a user will spend. It is important to set realistic expectations: passive waiting periods for software downloads, system reboots, and the initial, one-time setup of the Windows Subsystem for Linux (WSL) are not included in this estimate. Questa guida è strutturata in modo da rendere il processo attivo il più rapido e privo di errori possibile, affrontando in modo approfondito i prerequisiti.  

Questa relazione fornisce una tabella di marcia completa per il processo di installazione. Inizia con un controllo critico dei requisiti di sistema prima del volo, passa all'installazione di WSL 2 e Docker Desktop, copre la verifica della configurazione e culmina con l'avvio di un contenitore di server web Nginx pratico e reale.   

Per iniziare, è utile comprendere alcuni concetti fondamentali di Docker. Un Immagine è un blueprint o modello di sola lettura che contiene il codice dell'applicazione, un runtime, strumenti di sistema e tutte le dipendenze necessarie. A   

Contenitore è un'istanza in esecuzione di un'immagine. È l'ambiente autonomo in cui viene eseguita l'applicazione.   

Desktop Docker è un'applicazione per Windows facile da installare che raggruppa il motore Docker (il servizio di base in background, o demone), l'interfaccia a riga di comando (CLI) per interagire con esso e altri strumenti essenziali in un unico pacchetto di facile utilizzo. Il vantaggio principale di questo ecosistema è la coerenza che offre, che accelera notevolmente i flussi di lavoro di sviluppo e riduce i bug legati all'ambiente.   

Lista di controllo pre-volo: Il vostro PC Windows 11 è pronto per Docker?

Dedicating a few minutes to this pre-flight checklist is the single most important step to ensure a smooth and rapid installation. This section is designed to proactively address the most common points of failure, preventing hours of troubleshooting cryptic error messages later. A significant number of installation failures are not due to Docker itself but stem from a cascade of underlying system misconfigurations. For instance, a disabled virtualization setting in the computer’s firmware will prevent the Windows Subsystem for Linux (WSL 2) from functioning correctly. This, in turn, will cause the Docker Desktop installation to fail with vague errors like “Unexpected WSL error” or “This app can’t run on your PC”. Questa lista di controllo interrompe la catena di fallimenti prima che inizi, trasformando un'esperienza potenzialmente frustrante in un'esperienza semplice.   

Approfondimento sui requisiti di sistema

Prima di procedere, è essenziale verificare che il computer host soddisfi i requisiti di sistema ufficiali per Docker Desktop su Windows 11. I requisiti più recenti sono i seguenti. I requisiti più recenti sono i seguenti :   

• Sistema operativo: È necessaria una versione di Windows 11 a 64 bit. Può essere l'edizione Home, Pro, Enterprise o Education. Si consiglia vivamente di utilizzare la versione 22H2 o superiore per ottenere la migliore compatibilità e le migliori prestazioni.
• Processore: Il sistema deve avere un processore a 64 bit con Second Level Address Translation (SLAT). Quasi tutte le moderne CPU prodotte nell'ultimo decennio includono questa funzione.
• RAM: È richiesto un minimo di 4 GB di RAM di sistema. Tuttavia, per un'esperienza fluida e reattiva, Si consiglia vivamente di utilizzare 8 GB di RAM o più. Sia Docker Desktop che i container che esegue consumano memoria e 4 GB possono diventare un collo di bottiglia significativo durante lo sviluppo.   

Il passo più critico: Abilitare la virtualizzazione dell'hardware

Docker on Windows does not run applications natively; it relies on hardware virtualization to run a lightweight Linux kernel through WSL 2. If this feature is disabled in the system’s BIOS/UEFI, Docker Desktop cannot function.   

Come verificare se la virtualizzazione è abilitata

È possibile eseguire un controllo rapido senza riavviare il sistema:

1. Stampa Ctrl + Shift + Esc per aprire il Task Manager di Windows.
2. Passare alla sezione Prestazioni scheda.
3. Selezionare CPU dal pannello di sinistra.
4. Sul lato destro, cercate la voce Virtualizzazione stato. Se si legge Abilitatonon sono necessarie ulteriori azioni per questo passaggio. Se si legge Disabiliè necessario abilitarla nelle impostazioni del BIOS/UEFI prima di procedere.   

Come abilitare la virtualizzazione nel BIOS/UEFI

Per abilitare la virtualizzazione è necessario riavviare il computer e inserire le impostazioni del firmware. I passaggi esatti possono variare a seconda dei produttori di computer, ma il processo generale è coerente.

Il metodo moderno per accedere alle impostazioni del firmware UEFI su Windows 11 è il seguente :   

1. Aprire la sezione Impostazioni navigare verso l'applicazione Sistema, quindi selezionare Recupero.
2. Under the “Advanced startup” section, click the Riavvia ora pulsante.
3. Il computer si riavvia nell'ambiente di ripristino di Windows. Da qui, selezionare Troubleshoot > Advanced options > UEFI Firmware Settings e fare clic su Riavvio.

In alternativa, il metodo tradizionale prevede la pressione di un tasto specifico durante la sequenza di avvio iniziale. Il tasto corretto dipende dal produttore.   

Once inside the BIOS/UEFI menu, the virtualization setting is typically located under an “Advanced,” “CPU Configuration,” or “Security” tab. The option will be labeled as Tecnologia di virtualizzazione Intel (VT-x), AMD-V, o Modalità SVM. Questa impostazione deve essere modificata in   

Abilitato. Dopo averla abilitata, è fondamentale salvare le modifiche e uscire dal BIOS/UEFI, il che causerà il riavvio del computer.

Per facilitare questo processo, la seguente tabella elenca le chiavi di accesso al BIOS/UEFI comuni ai principali produttori di PC.

Produttore	Chiavi comuni
Dell	F2, F12
HP	Esc, F10
Lenovo	F1, F2, Fn+F2
ASUS	F2, Del
MSI / Gigabyte	Del
Tabella 1: Chiavi di accesso al BIOS/UEFI comuni per ogni produttore, ricavate dalle guide utente e dalla documentazione di supporto.

La Fondazione: Installazione del sottosistema Windows per Linux (WSL 2)

Una volta confermati i prerequisiti, il passo successivo consiste nell'installare la base su cui girerà Docker: il Windows Subsystem for Linux, versione 2 (WSL 2). Docker Desktop utilizza WSL 2 come backend per eseguire i container Linux direttamente su Windows, offrendo prestazioni quasi native, tempi di avvio più rapidi e un'integrazione del file system superiore rispetto al vecchio backend Hyper-V.   

L'installazione con un solo comando

Microsoft ha semplificato l'installazione di WSL 2 in un unico, potente comando.

1. Aperto Windows PowerShell o Prompt dei comandi con permessi elevati facendo clic con il tasto destro del mouse sulla sua icona nel menu Start e selezionando Eseguire come amministratore.
2. Eseguire il seguente comando: frammento di codicewsl --install

This one command automates several steps that previously had to be done manually. It enables the necessary “Virtual Machine Platform” and “Windows Subsystem for Linux” features, downloads the latest Linux kernel from Microsoft, sets WSL 2 as the default version, and installs the Ubuntu distribution of Linux by default.   

Riavvio e configurazione post-installazione

Al termine del comando, è necessario un riavvio del sistema per completare l'installazione delle nuove funzionalità di Windows.Al riavvio, si aprirà automaticamente una finestra di console per Ubuntu per completare la configurazione iniziale. Questo processo prevede la creazione di un nuovo nome utente e di una nuova password UNIX. È importante notare che queste credenziali sono per l'ambiente Linux e sono completamente separate dalle credenziali di accesso standard di Windows.   

L'evento principale: Installazione di Docker Desktop

Con WSL 2 al suo posto, il sistema è ora pronto per l'installazione principale di Docker Desktop.

Scaricare il programma di installazione corretto

Il programma di installazione ufficiale deve essere scaricato direttamente dal sito web di Docker per garantirne l'autenticità e ottenere la versione più recente.   

Un dettaglio critico e spesso trascurato è l'architettura del sistema. Il programma di installazione per i processori Intel e AMD standard è il programma x86_64 (o AMD64) version. Community forums are filled with reports from users who encountered an immediate “This app can’t run on your PC” error because they accidentally downloaded the ARM64 installer, which is intended for devices like the Surface Pro X. The download page’s user interface can sometimes be confusing, so it is vital to double-check that the correct version is being downloaded.   

Il processo di installazione

1. Individuare il file scaricato Docker Desktop Installer.exe file.
2. Fare doppio clic sul programma di installazione per eseguirlo. Verranno richiesti i privilegi di amministratore, necessari per l'installazione.  
3. La schermata di configurazione principale presenta una scelta cruciale. Assicuratevi che il “Use WSL 2 instead of Hyper-V”è selezionata. L'opzione di aggiungere un collegamento al desktop è una questione di preferenze dell'utente.   

Permessi post-installazione (il file utenti docker Gruppo)

Sebbene i diritti di amministratore siano necessari per l'installazione, non sono richiesti per l'uso quotidiano di Docker. Tuttavia, affinché un account utente standard (non amministratore) possa comunicare con il demone Docker, è necessario aggiungerlo al file locale utenti docker gruppo di sicurezza, che viene creato durante l'installazione.   

Per aggiungere un utente a questo gruppo:

1. Aprire la sezione Gestione del computer utilità. È possibile trovarla cercandola nel menu Start. Deve essere eseguita come amministratore.
2. Nel riquadro di sinistra, spostarsi su Local Users and Groups > Groups.
3. Individuare e fare clic con il tasto destro del mouse sulla voce utenti docker gruppo, quindi selezionare Add to Group….
4. Fare clic sul pulsante Add… digitare il nome dell'account utente a cui si vuole concedere l'accesso a Docker e fare clic su OK.
5. Dopo aver aggiunto l'utente, è essenziale uscire da Windows e rientrare. Questo passaggio è obbligatorio per rendere effettiva l'appartenenza al nuovo gruppo; un semplice riavvio non è sempre sufficiente.   

Decollo! Verifica e primo contenitore del mondo reale

Una volta completate l'impostazione e la configurazione, è il momento di verificare l'installazione e lanciare un container. Questa sezione conferma che tutti i componenti funzionano correttamente e fornisce un risultato tangibile.

La stretta di mano della riga di comando

Aprire un nuovo terminale PowerShell o Prompt dei comandi. Se l'account utente è stato aggiunto alla cartella utenti docker gruppo, questo terminale dovrebbe non deve essere eseguito come amministratore, per verificare che i permessi funzionino correttamente.

Per prima cosa, verificare che la Docker CLI possa comunicare con il demone Docker controllando la versione:

Frammento di codice

docker --versione

Questo dovrebbe restituire la versione di Docker installata, ad esempio, Docker versione 25.0.3, build 4debf41.

Quindi, eseguire il comando per elencare i contenitori attivi:

Frammento di codice

docker ps

Poiché non ci sono ancora container in esecuzione, questo comando dovrebbe restituire una tabella vuota con solo le intestazioni delle colonne (ID CONTAINER, IMMAGINE, ecc.). Questa risposta vuota e di successo conferma che la CLI è connessa correttamente al motore Docker.   

The “Hello World” Ritual

Il primo passo tradizionale nel mondo di Docker è quello di eseguire il file ciao-mondo immagine. Questo serve come test definitivo dell'intero sistema.

Frammento di codice

docker run hello-world

Questo comando esegue diverse azioni: controlla la presenza di ciao-mondo image locally, downloads it from the Docker Hub image repository if it’s not found, creates a new container from that image, runs the container, and prints a confirmation message to the terminal before exiting. A successful run will display a message beginning with “Hello from Docker!”   

Applicazione pratica: Avviare un server web Nginx

Mentre ciao-mondo confirms the system works, it doesn’t demonstrate practical usage. A far more engaging and instructive first step is to launch a live web server. This introduces core concepts like port mapping and detached mode, providing an interactive result that solidifies understanding. This approach bridges the gap from a simple installation check to genuine, practical application.   

Per lanciare un contenitore di server web Nginx, eseguire il seguente comando:

Frammento di codice

docker run -d -p 8080:80 --name my-web-server nginx

Ogni parte di questo comando ha una funzione specifica:

• eseguire docker: Il comando principale per creare e avviare un nuovo contenitore.
• -d o -detach: Esegue il contenitore in background, liberando il terminale per altri comandi.
• -p 8080:80 o -pubblica 8080:80: Maps port 8080 on the host machine (the PC) to port 80 inside the container. Nginx listens on port 80 by default, so this makes it accessible from the host’s browser.
• --nome del mio server web: Assegna un nome leggibile al contenitore per facilitarne la gestione.
• nginx: Specifica l'immagine ufficiale di Nginx da utilizzare, che Docker preleverà da Docker Hub.

Per verificare che il server web sia in funzione, aprire un browser web e navigare all'indirizzo http://localhost:8080. The “Welcome to nginx!” page should be displayed, confirming the container is running and accessible.

For an even more powerful demonstration, the default page can be customized using a bind mount. This links a directory on the host machine directly into the container’s filesystem.

1. Per prima cosa, fermate e rimuovete il contenitore esistente: docker stop my-web-server seguito da docker rm my-web-server.
2. Creare una nuova cartella sul Desktop denominata il mio sito.
3. All'interno di questa cartella, creare un nuovo file di testo chiamato indice.html.
4. Aperto indice.html e aggiungere il seguente contenuto: <h1>Ciao dal mio primo contenitore Docker!</h1>.
5. Ora, eseguire un nuovo contenitore con un volume (-v) per montare la directory locale. Il percorso deve essere un percorso assoluto.Frammento di codicedocker run -d -p 8080:80 --name my-web-server -v C:\UsersYourUsername\Desktop\my-site:/usr/share/nginx/html nginx (Sostituire Nome utente con il nome utente effettivo di Windows).
6. Aggiornare il browser a http://localhost:8080. It will now display the custom “Hello from my first Docker container!” message. This demonstrates the power of bind mounts for live development.   

Il vostro kit di comandi Docker essenziali

Ora che un container è in esecuzione, sono necessari alcuni comandi essenziali per gestirlo. Questa sezione funge da guida rapida per le operazioni quotidiane più comuni di Docker, consentendo agli utenti di interagire immediatamente con il loro nuovo ambiente containerizzato e di controllarlo.   

Comando	Descrizione	Esempio di utilizzo
docker ps	Elenca tutti i contenitori in esecuzione.	docker ps
docker ps -a	Elenca tutti i contenitori, compresi quelli fermi.	docker ps -a
docker stop	Arresta un contenitore in esecuzione con garbo.	docker stop my-web-server
docker start	Avvia un contenitore precedentemente interrotto.	docker avvia il mio server web
docker rm	Rimuove un elemento fermato contenitore in modo permanente.	docker rm my-web-server
immagini docker	Elenca tutte le immagini Docker memorizzate localmente sulla macchina.	immagini docker
docker rmi	Rimuove un'immagine locale (solo se nessun contenitore la sta usando).	docker rmi nginx
registri docker	Recupera i registri di output standard da un contenitore.	docker logs my-web-server
docker logs -f	Segue l'output del registro in tempo reale, con lo streaming di nuovi registri.	docker logs -f my-web-server
docker exec -it	Esegue un comando all'interno di un contenitore in esecuzione (ad esempio, apre una shell).	docker exec -it my-web-server bash
Tabella 2: Un elenco di comandi Docker essenziali per i principianti.

Risoluzione dei problemi: Guida agli errori comuni di installazione e di esecuzione

Anche con un'accurata preparazione, possono verificarsi dei problemi. Questa sezione funge da kit di pronto soccorso e affronta gli errori di installazione e di esecuzione più comuni. Le domande sono formulate in modo da corrispondere esattamente ai messaggi di errore che gli utenti potrebbero cercare, rendendo questa guida una risorsa preziosa durante la risoluzione dei problemi.

FAQ 1: Why am I getting an “Unexpected WSL error”?

• Sintomi: Docker Desktop non riesce ad avviarsi e visualizza un popup con questo errore, spesso menzionando problemi di diritti di accesso o suggerendo una wsl -spegnimento comando.   
• Soluzioni: Questi passaggi devono essere eseguiti in ordine sparso.
  1. Reset semplice: Aprire PowerShell ed eseguire wsl -spegnimento. Questo comando arresta completamente la macchina virtuale WSL 2. Attendere qualche secondo e poi provare a riavviare Docker Desktop. Questa operazione spesso risolve i problemi di stato transitorio.   
  2. Reset dello stack di rete: Se il problema persiste, potrebbe essere dovuto a un danneggiamento dello stack di rete di Windows che facilita la comunicazione con WSL. Aprire PowerShell come amministratore ed eseguire netsh winsock reset. Dopo questo comando è necessario un riavvio del sistema.   
  3. Controllare il tipo di lancio dell'Hypervisor: Assicurarsi che l'hypervisor Windows sia configurato per l'avvio automatico. Aprite un PowerShell da amministratore ed eseguite bcdedit /set hypervisorlaunchtype Auto, quindi riavviare.   
  4. Ciclo di riattivazione completo: Come ultima risorsa, è possibile reinstallare completamente i componenti di virtualizzazione. In un PowerShell amministratore, eseguite i seguenti comandi per disabilitare le funzioni: DISM /Online /disable-Feature /FeatureName:VirtualMachinePlatform DISM /Online /disable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux Riavviare il computer. Quindi, aprire un altro PowerShell da amministratore e riabilitarli: DISM /Online /enable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux DISM /Online /abilita la caratteristica /Nome della caratteristica:VirtualMachinePlatform Riavviare un'ultima volta.   

FAQ 2: Docker Desktop won’t start after I close it or restart my PC. What’s wrong?

• Sintomi: L'applicazione ha funzionato perfettamente dopo l'installazione iniziale, ma ora non si avvia. L'icona di Docker può apparire nella barra delle applicazioni e poi scomparire, oppure non succede nulla.
• Soluzione: Questo problema è spesso causato da processi in background che non sono stati terminati correttamente.
  1. Aperto Gestione attività (Ctrl + Shift + Esc).
  2. Vai al sito Dettagli scheda.
  3. Ordinare per nome e cercare i processi denominati Docker Desktop.exe o che coinvolge il backend di Docker.
  4. Selezionare ciascuno di questi processi e fare clic su Fine attività.
  5. Una volta terminati tutti i processi correlati, provare a lanciare nuovamente Docker Desktop.   

FAQ 3: The installer says “This app can’t run on your PC.” How do I fix it?

• Sintomi: Il Docker Desktop Installer.exe fallisce subito dopo l'esecuzione con questo messaggio di errore generico di Windows.
• Soluzione:
  1. Causa primaria: Il motivo più comune di questo errore è una mancata corrispondenza dell'architettura. L'utente ha probabilmente scaricato la versione ARM64 per un PC standard con processore Intel o AMD. Tornate al sito ufficiale di Docker e assicuratevi che il file x86_64 / AMD64 versione viene scaricata.   
  2. Causa secondaria: Se è stato utilizzato il programma di installazione corretto, questo errore indica che un prerequisito del sistema centrale non è soddisfatto. Tornare alla Sezione 1 di questa guida e verificare che la virtualizzazione hardware sia abilitata nel BIOS/UEFI.

FAQ 4: L'installazione non è riuscita con un errore relativo alla virtualizzazione o al WSL.

• Sintomi: The installer shows an error message such as “WSL 2 installation is incomplete,” “Docker Desktop requires a WSL 2 backend,” or another message explicitly mentioning virtualization.
• Soluzione: Questo è un chiaro indicatore che un prerequisito è stato saltato o non è configurato correttamente.
  1. Riavviare e accedere al BIOS/UEFI per confermare che Intel VT-x o AMD-V è Abilitato. Questo è il punto di guasto più comune.
  2. Ensure the “Virtual Machine Platform” Windows feature is turned on. To be certain, run dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart in un PowerShell amministratore e riavviare.   

FAQ 5: I’m getting “permission denied” or “daemon is not running” errors when I run dockercomandi.

• Sintomi: In un terminale non amministratore, comandi come docker ps fallisce con un errore che indica che il client non può connettersi al demone Docker.
• Soluzione: Si tratta di un classico problema di autorizzazioni.
  1. Confermare che l'account utente corrente è un membro dell'organizzazione utenti docker gruppo locale, come illustrato nella Sezione 3.
  2. In particolare, l'utente deve uscire da Windows e rientrare per applicare la modifica dell'appartenenza al gruppo al proprio token di sicurezza. Il semplice riavvio o la chiusura e riapertura del terminale non sono sufficienti.

Conclusione: Il vostro viaggio in Docker inizia ora

Seguendo questa guida, l'utente ha preparato con successo il proprio sistema Windows 11, ha installato i prerequisiti necessari come WSL 2, ha installato e configurato Docker Desktop, ha verificato l'installazione completa e ha lanciato un contenitore Nginx reale. Questo risultato fornisce una base potente e stabile per lo sviluppo di software moderno.

Con un ambiente Docker funzionante, il viaggio nella containerizzazione ha veramente inizio. I passi logici successivi per espandere questa base includono:

• Imparare Docker Compose: Per le applicazioni composte da più servizi (come un'applicazione web, un database e un livello di caching), Docker Compose è lo strumento standard. Consente di definire e gestire un intero stack di applicazioni multi-container utilizzando un singolo file di configurazione YAML, semplificando le distribuzioni complesse in un unico comando.   
• Scrivere un file Docker: La vera potenza di Docker si realizza quando si confezionano applicazioni personalizzate. Il passo successivo è quello di imparare a scrivere un file Profilo Docker, which is a text file containing step-by-step instructions for building a custom Docker image from an application’s source code.   
• Esplorare Docker Hub: Docker Hub è un vasto registro pubblico che contiene migliaia di immagini precostruite per varie applicazioni e servizi. È una risorsa preziosa per trovare immagini ufficiali ed è anche la piattaforma per condividere immagini personalizzate con la comunità o con un team privato.