Configurazione delle impostazioni avanzate in WSL

I file wsl.conf e .wslconfig vengono usati per configurare le impostazioni avanzate in WSL che verranno applicate all'avvio della macchina virtuale WSL. wsl.conf viene usato per applicare le impostazioni per ogni distribuzione WSL e .wslconfig viene usato per applicare le impostazioni globali a WSL. Per altre informazioni sulle differenze, vedere di seguito.

Attualmente, tutte le impostazioni di .wslconfig si applicano solo alle distribuzioni WSL 2. Informazioni su come verificare la versione di WSL in esecuzione.

La regola degli 8 secondi per le modifiche alla configurazione

Per visualizzare gli aggiornamenti delle impostazioni di configurazione, è necessario attendere che il sottosistema che esegue la distribuzione Linux si arresti completamente e si riavvii. Questa operazione richiede in genere circa 8 secondi dopo la chiusura di TUTTE le istanze della shell di distribuzione.

Se si avvia una distribuzione (ad esempio Ubuntu), si modifica il file di configurazione, si chiude la distribuzione e poi la si riavvia, si potrebbe pensare che le modifiche alla configurazione siano entrate immediatamente in vigore. Al momento non è così, perché il sottosistema potrebbe essere ancora in esecuzione. È necessario attendere che il sottosistema si arresti prima di riavviarlo, in modo da avere il tempo sufficiente per recepire le modifiche. È possibile verificare se la distribuzione Linux (shell) è ancora in esecuzione dopo la chiusura usando PowerShell con il comando: wsl --list --running. Se non ci sono distribuzioni in esecuzione, si riceverà la risposta: "Non ci sono distribuzioni in esecuzione". È ora possibile riavviare la distribuzione per vedere applicati gli aggiornamenti della configurazione.

Il comando wsl --shutdown è un metodo rapido per riavviare le distribuzioni WSL 2, ma arresta tutte le distribuzioni in esecuzione, quindi usalo con cautela. È anche possibile utilizzare wsl --terminate <distroName> per terminare immediatamente una distribuzione specifica in esecuzione.

wsl.conf

Configurare le impostazioni locali con wsl.conf per distribuzione per ogni distribuzione Linux in esecuzione in WSL 1 o WSL 2.

• Archiviato nella directory /etc della distribuzione come file unix.
• Usato per configurare le impostazioni per ogni distribuzione. Le impostazioni configurate in questo file saranno applicate solo alla distribuzione Linux specifica che contiene la directory in cui è archiviato il file.
• Può essere usato per le distribuzioni eseguite da entrambe le versioni, WSL 1 o WSL 2.
• Per accedere alla directory di una distribuzione installata, usa la riga di comando della distribuzione con per entrare nella directory radice, quindi per elencare i file oppure per visualizzare in Esplora file di Windows. Il percorso della directory dovrebbe assomigliare a: /etc/wsl.conf.

Impostazioni di configurazione per wsl.conf

Il file wsl.conf configura le impostazioni in base alla distribuzione. (Per la configurazione globale delle distribuzioni WSL 2, vedere .wslconfig).

Il file wsl.conf supporta quattro sezioni: automount, network, interop, e user. (Ispirato alle convenzioni dei file .ini, le chiavi vengono dichiarate all'interno di una sezione come nei file .gitconfig) Vedere wsl.conf per informazioni su dove archiviare il file wsl.conf.

supporto systemd

Molte distribuzioni Linux eseguono "systemd" per impostazione predefinita (incluso Ubuntu) e WSL ha recentemente aggiunto il supporto per questo system/service manager, in modo che WSL sia ancora più simile all'uso delle distribuzioni Linux preferite in un computer bare metal. Per abilitare systemd è necessaria la versione 0.67.6+ di WSL. Controlla la tua versione di WSL con il comando wsl --version. Se hai bisogno di aggiornare, puoi scaricare la versione più recente di WSL dal Microsoft Store. Per altre informazioni, vedere l'annuncio del blog.

Per abilitare systemd, aprire il file wsl.conf in un editor di testo usando sudo per le autorizzazioni di amministratore e aggiungere queste righe a /etc/wsl.conf:

[boot]
systemd=true

Sarà quindi necessario chiudere la distribuzione WSL usando wsl.exe --shutdown da PowerShell per riavviare le istanze WSL. Una volta riavviata la distribuzione, systemd dovrebbe essere in esecuzione. È possibile confermare usando il comando: systemctl list-unit-files --type=service, che mostrerà lo stato dei vostri servizi.

Impostazioni di montaggio automatico

Etichetta della sezione wsl.conf: [automount]

Le opzioni di montaggio automatico vengono applicate come opzioni di montaggio per tutte le unità montate automaticamente. Per modificare le opzioni solo per un'unità specifica, utilizzare il file /etc/fstab invece. Le opzioni che il file binario di montaggio analizza normalmente in un flag non sono supportate. Se si desidera specificare esplicitamente queste opzioni, è necessario includere ogni unità per cui lo si desidera in /etc/fstab.

Opzioni di montaggio automatico

L'impostazione di opzioni di montaggio diverse per le unità Windows (DrvFs) consente di controllare la modalità di calcolo delle autorizzazioni per i file di Windows. Di seguito vengono illustrate le opzioni disponibili.

Per impostazione predefinita, WSL imposta e uidgid sul valore dell'utente predefinito. Ad esempio, in Ubuntu, l'utente predefinito è uid=1000, gid=1000. Se questo valore viene usato per specificare un'opzione o uid diversagid, il valore utente predefinito verrà sovrascritto. In caso contrario, il valore predefinito verrà sempre accodato.

Le opzioni precedenti di umask, fmask e così via verranno applicate solo quando l'unità Windows viene montata con i metadati. Per impostazione predefinita, i metadati non sono abilitati. Altre informazioni su questo argomento sono disponibili qui.

Che cos'è DrvFs?

DrvFs è un plug-in per il filesystem di WSL, progettato per supportare l'interoperabilità tra WSL e il filesystem di Windows. DrvFs consente a WSL di montare le unità con i file system supportati in /mnt, come /mnt/c, /mnt/d, e così via. Per altre informazioni su come specificare il comportamento predefinito di distinzione tra maiuscole e minuscole durante il montaggio di unità o directory Windows o Linux, vedere la pagina sulla distinzione tra maiuscole e minuscole.

Impostazioni di rete

Etichetta della sezione wsl.conf: [network]

Impostazioni di interoperabilità

Etichetta della sezione wsl.conf: [interop]

Queste opzioni sono disponibili in Insider build 17713 e versioni successive.

Impostazioni utente

Etichetta della sezione wsl.conf: [user]

Queste opzioni sono disponibili nella build 18980 e versioni successive.

Impostazioni di avvio

L'impostazione di avvio è disponibile solo in Windows 11 e Server 2022.

Etichetta della sezione wsl.conf: [boot]

Impostazioni GPU

Etichetta della sezione wsl.conf: [gpu]

Impostazioni ora

Etichetta della sezione wsl.conf: [time]

File wsl.conf di esempio

Il file di esempio wsl.conf riportato di seguito mostra alcune delle opzioni di configurazione disponibili. In questo esempio, la distribuzione è Ubuntu-20.04 e il percorso del file è \\wsl.localhost\Ubuntu-20.04\etc\wsl.conf.

# Automatically mount Windows drive when the distribution is launched
[automount]

# Set to true will automount fixed drives (C:/ or D:/) with DrvFs under the root directory set above. Set to false means drives won't be mounted automatically, but need to be mounted manually or with fstab.
enabled=true

# Sets the directory where fixed drives will be automatically mounted. This example changes the mount location, so your C-drive would be /c, rather than the default /mnt/c.
root = /

# DrvFs-specific options can be specified.
options = "metadata,uid=1003,gid=1003,umask=077,fmask=11,case=off"

# Sets the `/etc/fstab` file to be processed when a WSL distribution is launched.
mountFsTab=true

# Network host settings that enable the DNS server used by WSL 2. This example changes the hostname, sets generateHosts to false, preventing WSL from the default behavior of auto-generating /etc/hosts, and sets generateResolvConf to false, preventing WSL from auto-generating /etc/resolv.conf, so that you can create your own (ie. nameserver 1.1.1.1).
[network]
hostname=DemoHost
generateHosts=false
generateResolvConf=false

# Set whether WSL supports interop processes like launching Windows apps and adding path variables. Setting these to false will block the launch of Windows processes and block adding $PATH environment variables.
[interop]
enabled=false
appendWindowsPath=false

# Set the user when launching a distribution with WSL.
[user]
default=DemoUser

# Set a command to run when a new WSL instance launches. This example starts the Docker container service.
[boot]
command=service docker start

.wslconfig

Configurare le impostazioni globali con .wslconfig su tutte le distribuzioni installate su WSL.

• Il file con estensione wslconfig non esiste per impostazione predefinita. Deve essere creato e salvato nella directory %UserProfile% per applicare queste opzioni di configurazione.
• Usato per configurare le impostazioni a livello globale in tutte le distribuzioni Linux installate in esecuzione come versione WSL 2.
• Può essere usato solo per le distribuzioni eseguite da WSL 2. Le distribuzioni in esecuzione come WSL 1 non saranno interessate da questa configurazione, perché non sono in esecuzione come macchina virtuale.
• Per accedere alla directory %UserProfile%, in PowerShell, usa cd ~ per accedere alla tua directory principale (che in genere è il tuo profilo utente, C:\Users\<UserName>) oppure puoi aprire Esplora File di Windows e inserire %UserProfile% nella barra degli indirizzi. Il percorso della directory dovrebbe assomigliare a: C:\Users\<UserName>\.wslconfig.

WSL rileverà l'esistenza di questi file, ne leggerà il contenuto e applicherà automaticamente le impostazioni di configurazione a ogni avvio di WSL. Se il file è mancante o non valido (formattazione non corretta del markup), WSL continuerà ad avviarsi normalmente senza applicare le impostazioni di configurazione.

Impostazioni di configurazione per .wslconfig

Il file .wslconfig configura le impostazioni a livello globale per tutte le distribuzioni Linux in esecuzione con WSL 2. (Per la configurazione per distribuzione, vedere wsl.conf).

Consultare .wslconfig per informazioni su dove archiviare il file .wslconfig.

Questo file può contenere le opzioni seguenti che influiscono sulla macchina virtuale che alimenta qualsiasi distribuzione di WSL 2:

Impostazioni principali di WSL

Etichetta della sezione .wslconfig: [wsl2]

Le voci con il valore "path" devono essere percorsi di Windows con barre rovesciate di escape, ad esempio: C:\\Temp\\myCustomKernel

Le voci con il size valore predefinito sono B (byte) e l'unità è omissibile. Per usare altre unità, è necessario aggiungere l'unità di misura, ad esempio o 8GB512MB.

¹: disponibile solo in Windows 11.

²: richiedere Windows 11 versione 22H2 o successiva.

Impostazioni sperimentali

Queste impostazioni sono anteprime esplicite di funzionalità sperimentali che verranno rese predefinite in futuro.

Etichetta della sezione .wslconfig: [experimental]

¹: disponibile solo in Windows 11.

²: richiedere Windows 11 versione 22H2 o successiva.

File di esempio .wslconfig

Il file di esempio .wslconfig riportato di seguito mostra alcune delle opzioni di configurazione disponibili. In questo esempio, il percorso del file è %UserProfile%\.wslconfig.

# Settings apply across all Linux distros running on WSL 2
[wsl2]

# Limits VM memory to use no more than 4 GB, this can be set as whole numbers using GB or MB
memory=4GB

# Sets the VM to use two virtual processors
processors=2

# Specify a custom Linux kernel to use with your installed distros. The default kernel used can be found at https://github.com/microsoft/WSL2-Linux-Kernel
kernel=C:\\temp\\myCustomKernel

# Specify the modules VHD for the custum Linux kernel to use with your installed distros.
kernelModules=C:\\temp\\modules.vhdx

# Sets additional kernel parameters, in this case enabling older Linux base images such as Centos 6
kernelCommandLine = vsyscall=emulate

# Sets amount of swap storage space to 8GB, default is 25% of available RAM
swap=8GB

# Sets swapfile path location, default is %UserProfile%\AppData\Local\Temp\swap.vhdx
swapfile=C:\\temp\\wsl-swap.vhdx

# Disable page reporting so WSL retains all allocated memory claimed from Windows and releases none back when free
pageReporting=false

# Turn on default connection to bind WSL 2 localhost to Windows localhost. Setting is ignored when networkingMode=mirrored
localhostforwarding=true

# Disables nested virtualization
nestedVirtualization=false

# Turns on output console showing contents of dmesg when opening a WSL 2 distro for debugging
debugConsole=true

# Sets the maximum number of crash dump files to retain (default is 5)
maxCrashDumpCount=10

# Enable experimental features
[experimental]
sparseVhd=true

Risorse aggiuntive

• Blog della riga di comando di Windows: configurazione automatica di WSL
• Blog della riga di comando di Windows: Chmod/Chown, DrvFs, metadati di file