WSL'de gelişmiş ayarlar yapılandırması

wsl.conf ve .wslconfig dosyaları, WSL VM başlatıldığındauygulanacak WSL'de gelişmiş ayarları yapılandırmak için kullanılır. wsl.conf, WSL dağıtımı temelinde ayarları uygulamak için kullanılır ve .wslconfig genel ayarları WSL'ye uygulamak için kullanılır. Aşağıdaki farklar hakkında daha fazla bilgi edinebilirsiniz.

Görünüm	.wslconfig	wsl.conf
Kapsam	Tüm WSL için geçerli olan genel ayarlar	Yalnızca WSL dağıtımları için ayarlar
Yapılandırır	WSL'de özellik etkinleştirme, WSL 2'yi (RAM, önyükleme çekirdeği, CPU sayısı vb.) güçlendiren sanal makine ayarları	WSL'de önyükleme seçenekleri, DrvF otomatik bağlamaları, ağ, Windows sistemiyle birlikte çalışabilirlik, sistemli kullanım ve varsayılan kullanıcı gibi dağıtım ayarları
Yer	WSL dağıtımı dışında %UserProfile%\.wslconfig.	/etc/wsl.conf, WSL dağıtımının içindeyken

Şu anda tüm .wslconfig ayarları yalnızca WSL 2 dağıtımları için geçerlidir. çalıştırdığınız WSL sürümünü nasıl denetleyeceğiniziöğrenin.

Yapılandırma değişiklikleri için 8 saniyelik kural

Yapılandırma ayarı güncelleştirmelerinin görünmesi için Linux dağıtımınızı çalıştıran alt sistemin çalışmayı tamamen durdurmasını ve yeniden başlatılmasını beklemeniz gerekir. Bu işlem genellikle dağıtım kabuğunun TÜM örnekleri kapatıldıktan sonra yaklaşık 8 saniye sürer.

Bir dağıtımı başlatırsanız (örneğin Ubuntu), yapılandırma dosyasını değiştirir, dağıtımı kapatır ve sonra yeniden başlatırsanız, yapılandırma değişikliklerinizin hemen geçerli olduğunu varsayabilirsiniz. Alt sistem hala çalışıyor olabileceğinden bu durum şu anda geçerli değildir. Değişikliklerinizin alınması için yeterli zaman tanımak için yeniden başlatılmadan önce alt sistemin durmasını beklemeniz gerekir. PowerShell'de şu komutu kullanarak Linux dağıtımınızın veya kabuğunuzun hala çalışıp çalışmadığını kontrol edebilirsiniz: wsl --list --running. Hiçbir dağıtım çalışmıyorsa şu yanıtı alırsınız: "Çalışan dağıtım yok." Artık yapılandırma güncelleştirmelerinizin uygulandığını görmek için dağıtımı yeniden başlatabilirsiniz.

komut wsl --shutdown, WSL 2 dağıtımlarını yeniden başlatmanın hızlı bir yoludur, ancak çalışan tüm dağıtımları kapatır, bu nedenle akıllıca kullanın. Ayrıca, wsl --terminate <distroName> kullanarak çalışan belirli bir dağıtımı anında sonlandırabilirsiniz.

wsl.conf

WSL 1 veya WSL 2 üzerinde çalışan her Linux dağıtımı için dağıtım başına wsl.conf ile yerel ayarları yapılandırın.

• Dağıtımın /etc dizininde unix dosyası olarak depolanır.
• Ayarları dağıtım temelinde yapılandırmak için kullanılır. Bu dosyada yapılandırılan ayarlar yalnızca bu dosyanın depolandığı dizini içeren belirli Linux dağıtımına uygulanır.
• WSL 1 veya WSL 2 tarafından çalıştırılan dağıtımlar için kullanılabilir.
• Yüklü bir dağıtımın /etc dizinine ulaşmak için, kök dizine erişmek için cd / ile dağıtımın komut satırını kullanın, ardından dosyaları listelemek için ls veya Windows Dosya Gezgini'nde görüntülenecek explorer.exe .. Dizin yolu şöyle görünmelidir: /etc/wsl.conf.

Not

wsl.conf dosyasıyla dağıtım başına ayarların ayarlanması yalnızca Windows Derlemesi 17093 ve sonraki sürümlerde kullanılabilir.

wsl.conf için yapılandırma ayarları

wsl.conf dosyası, ayarları dağıtım temelinde yapılandırır. (WSL 2 dağıtımlarının genel yapılandırması için bkz. .wslconfig).

wsl.conf dosyası dört bölümü destekler: automount, network, interopve user. (.ini dosya kurallarından sonra modellenir, anahtarlar .gitconfig dosyaları gibi bir bölüm altında bildirilir.) wsl.conf dosyasının depolandığı yer hakkında bilgi için bkz. wsl.conf .

systemd desteği

Birçok Linux dağıtımı varsayılan olarak "systemd" çalıştırır (Ubuntu dahil) ve WSL yakın zamanda bu sistem/hizmet yöneticisi için destek ekledi, böylece WSL, en sevdiğiniz Linux dağıtımlarını çıplak makinede kullanmaya daha da benzer. Systemd'i etkinleştirmek için WSL'nin 0.67.6+ sürümü gerekir. komut wsl --versionile WSL sürümünüzü denetleyin. Güncelleştirmeniz gerekiyorsa, Microsoft Store'da WSL'nin en sonsürümünü alabilirsiniz. blog duyurusu'de daha fazla bilgi edinebilirsiniz.

Systemd'i etkinleştirmek için, yönetici izinleri için wsl.conf kullanarak sudo dosyanızı bir metin düzenleyicisinde açın ve şu satırları /etc/wsl.confekleyin:

[boot]
systemd=true

Ardından WSL örneklerinizi yeniden başlatmak için PowerShell'den wsl.exe --shutdown kullanarak WSL dağıtımınızı kapatmanız gerekir. Dağıtımınız yeniden başlatıldıktan sonra systemd çalışıyor olmalıdır. Hizmetlerinizin durumunu gösteren systemctl list-unit-files --type=servicekomutunu kullanarak onaylayabilirsiniz.

Otomatik bağlama ayarları

wsl.conf bölüm etiketi: [automount]

Anahtar	Değer	Varsayılan	Notlar
enabled	Boolean	true	true, sabit sürücülerin (C:/ veya D:/) /mntaltında DrvFs ile otomatik olarak monte edilmesini sağlar. false, sürücülerin otomatik olarak bağlanmayacağı anlamına gelir, ancak yine de el ile veya fstabaracılığıyla takabilirsiniz.
mountFsTab	Boolean	true	true, WSL başlangıcında işlenecek şekilde /etc/fstab'i ayarlar. /etc/fstab , SMB paylaşımı gibi diğer dosya sistemlerini bildirebileceğiniz bir dosyadır. Bu nedenle, bu dosya sistemlerini başlatmada WSL'ye otomatik olarak bağlayabilirsiniz.
root	dizgi	/mnt/	Sabit sürücülerin otomatik olarak bağlanacağı dizini ayarlar. Bu varsayılan olarak olarak ayarlanır /mnt/, bu nedenle Windows dosya sisteminiz C:\ öğesine /mnt/c/bağlanır. olarak /mnt/değiştirirseniz/windir/, sabitinizin C:\ öğesine /windir/cbağlı olduğunu görmeniz gerekir.
options	uid, gid gibi değerlerin virgülle ayrılmış listesi, aşağıdaki otomatik bağlama seçeneklerine bakın	Sıfır	Otomatik bağlama seçeneği değerleri aşağıda listelenir ve varsayılan DrvF bağlama seçenekleri dizesine eklenir. Yalnızca DrvF'lere özgü seçenekler belirtilebilir.

Otomatik bağlama seçenekleri, otomatik olarak bağlanan tüm sürücüler için bağlama seçenekleri olarak uygulanır. Yalnızca belirli bir sürücünün seçeneklerini değiştirmek için bunun yerine /etc/fstab dosyasını kullanın. Bağlama ikilisinin normalde bir bayrakta ayrıştıracağı seçenekler desteklenmez. Bu seçenekleri açıkça belirtmek istiyorsanız, bunu yapmak istediğiniz her sürücüyü /etc/fstabeklemelisiniz.

Otomatik bağlama seçenekleri

Windows sürücüleri (DrvFs) için farklı bağlama seçenekleri ayarlamak, Windows dosyaları için dosya izinlerinin nasıl hesaplanmış olduğunu denetleyebilir. Aşağıdaki seçenekler kullanılabilir:

Anahtar	Açıklama	Varsayılan
uid	Tüm dosyaların sahibi için kullanılan Kullanıcı Kimliği	WSL dağıtımınızın varsayılan Kullanıcı Kimliği (ilk yüklemede varsayılan olarak 1000)
gid	Tüm dosyaların sahibi için kullanılan Grup Kimliği	WSL dağıtımınızın varsayılan grup kimliği (ilk yüklemede varsayılan olarak 1000)
umask	Tüm dosyalar ve dizinler için hariç tutulacak izinlerin sekizli maskesi	022
fmask	Tüm dosyalar için dışlanması gereken sekizli bir izin maskesi	000
dmask	Tüm dizinler için hariç tutulacak izinlerin sekizli maskesi	000
metadata	Linux sistem izinlerini desteklemek için Windows dosyalarına meta veri eklenip eklenmediği	disabled
case	Büyük/küçük harfe duyarlı olarak ele alınan dizinleri ve WSL ile oluşturulan yeni dizinlerde bayrak ayarlanıp ayarlanmayacağını belirler. Seçeneklerin ayrıntılı açıklaması için bkz. büyük harf/küçük harf duyarlılığı. Seçenekler arasında off, dirveya forcebulunur.	off

Varsayılan olarak, WSL ve uid değerini varsayılan kullanıcının değerine ayarlargid. Örneğin, Ubuntu'da varsayılan kullanıcı şeklindediruid=1000. gid=1000 Bu değer farklı gid bir veya uid seçenek belirtmek için kullanılırsa, varsayılan kullanıcı değerinin üzerine yazılır. Aksi takdirde, varsayılan değer her zaman eklenir.

Yukarıdaki umask, fmask vb. seçenekler yalnızca Windows sürücüsü meta verilerle bağlandığında uygulanır. Varsayılan olarak meta veriler etkin değildir. Bu konu hakkında daha fazla bilgiyi burada bulabilirsiniz.

Not

İzin maskeleri, dosyalara veya dizinlere uygulanmadan önce mantıksal bir OR işlemi aracılığıyla konur.

DrvF nedir?

DrvFs, WSL ile Windows dosya sistemi arasındaki birlikte çalışma desteği için tasarlanmış bir WSL dosya sistemi eklentisidir. DrvFs, WSL'nin /mnt/c, /mnt/d gibi /mnt altında desteklenen dosya sistemlerine sahip sürücüleri bağlamasını sağlar. Windows veya Linux sürücülerini veya dizinlerini bağlarken varsayılan büyük/küçük harf duyarlılığı davranışını belirtme hakkında daha fazla bilgi için büyük/küçük harf duyarlılığı sayfasına bakın.

Ağ ayarları

wsl.conf bölüm etiketi: [network]

Anahtar	Değer	Varsayılan	Notlar
generateHosts	Boolean	true	true WSL'yi /etc/hostsoluşturacak şekilde ayarlar. hosts dosyası, ilgili bir IP adresine karşılık gelen konak adlarının statik haritasını içerir.
generateResolvConf	Boolean	true	true WSL'yi /etc/resolv.confoluşturacak şekilde ayarlar. resolv.conf, belirli bir ana bilgisayar adını IP adresine çözümleyebilecek bir DNS listesi içerir.
hostname	dizgi	Windows ana bilgisayar adı	WSL dağıtımı için kullanılacak ana makine adını ayarlar.

Birlikte çalışma ayarları

wsl.conf bölüm etiketi: [interop]

Bu seçenekler Insider Derlemesi 17713 ve sonraki sürümlerde kullanılabilir.

Anahtar	Değer	Varsayılan	Notlar
enabled	Boolean	true	Bu anahtarın ayarlanması, WSL'nin Windows işlemlerini başlatmayı destekleyip desteklemeyeceğini belirler.
appendWindowsPath	Boolean	true	Bu anahtarın ayarlanması, WSL'nin ortam değişkenine $PATH Windows yol öğeleri ekleyip eklemeyeceğini belirler.

Kullanıcı ayarları

wsl.conf bölüm etiketi: [user]

Bu seçenekler Yapı 18980 ve sonraki sürümlerde kullanılabilir.

Anahtar	Değer	Varsayılan	Notlar
default	dizgi	İlk çalıştırmada oluşturulan ilk kullanıcı adı	Bu anahtarın ayarlanması, WSL oturumu ilk başlatıldığında hangi kullanıcı olarak çalıştırılacağını belirtir.

Önyükleme ayarları

Önyükleme ayarı yalnızca Windows 11 ve Server 2022'de kullanılabilir.

wsl.conf bölüm etiketi: [boot]

Anahtar	Değer	Varsayılan	Notlar
command	dizgi	Sıfır	WSL örneği başlatıldığında çalıştırmak istediğiniz komutun dizesi. Bu komut kök kullanıcı olarak çalıştırılır. Örneğin: service docker start.
protectBinfmt	Boolean	true	Systemd etkinleştirildiğinde WSL'nin sistemli birimler oluşturmasını engeller.

GPU ayarları

wsl.conf bölüm etiketi: [gpu]

Anahtar	Değer	Varsayılan	Notlar
enabled	Boolean	true	Linux uygulamalarının para-sanallaştırma yoluyla Windows GPU'ya erişmesine izin verin.

Zaman ayarları

wsl.conf bölüm etiketi: [time]

Anahtar	Değer	Varsayılan	Notlar
useWindowsTimezone	Boolean	true	Bu anahtarın ayarlanması WSL'nin windows'da ayarlanan saat dilimini kullanmasını ve eşitlemesini sağlar.

Örnek wsl.conf dosyası

Aşağıdaki wsl.conf örnek dosyası kullanılabilir yapılandırma seçeneklerinden bazılarını gösterir. Bu örnekte dağıtım Ubuntu-20.04 ve dosya yolu \\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

WSL üzerinde çalışan tüm yüklü dağıtımlarda .wslconfig ile genel ayarları yapılandırın.

• .wslconfig dosyası varsayılan olarak mevcut değildir. Bu yapılandırma ayarlarını uygulamak için %UserProfile% dizininizde oluşturulup depolanmalıdır.
• WSL 2 sürümü olarak çalışan tüm yüklü Linux dağıtımlarında ayarları genel olarak yapılandırmak için kullanılır.
• yalnızca WSL 2tarafından çalıştırılan dağıtımlar için kullanılabilir. WSL 1 olarak çalışan dağıtımlar, sanal makine olarak çalışmadıkları için bu yapılandırmadan etkilenmez.
• %UserProfile% dizininize ulaşmak için PowerShell'de cd ~ kullanarak giriş dizininize (genellikle kullanıcı profiliniz C:\Users\<UserName>) erişebilir veya Windows Dosya Gezgini'ni açıp adres çubuğuna %UserProfile% girebilirsiniz. Dizin yolu şöyle görünmelidir: C:\Users\<UserName>\.wslconfig.

WSL bu dosyaların varlığını algılar, içeriği okur ve WSL'yi her başlattığınızda yapılandırma ayarlarını otomatik olarak uygular. Dosya eksikse veya hatalı biçimlendirilmişse (yanlış işaretleme biçimlendirmesi), yapılandırma ayarları uygulanmadan WSL normal şekilde başlatılmaya devam eder.

.wslconfig için yapılandırma ayarları

.wslconfig dosyası, WSL 2 ile çalışan tüm Linux dağıtımları için ayarları genel olarak yapılandırıyor. (Dağıtım başına yapılandırma için bkz. wsl.conf).

.wslconfig dosyasının depolandığı yer hakkında bilgi için bkz. .wslconfig .

Not

genel ayarları .wslconfig ile yapılandırma yalnızca Windows Derleme 19041 ve sonraki sürümlerde WSL 2 olarak çalışan dağıtımlar için kullanılabilir. WSL 2 VM'sini kapatmak için wsl --shutdown çalıştırmanız ve ardından bu değişikliklerin etkili olması için WSL örneğinizi yeniden başlatmanız gerekebileceğini unutmayın.

Tavsiye

.wslconfig dosyasını el ile düzenlemek yerine WSL yapılandırmalarını doğrudan WSL Ayarları'nda değiştirmeniz önerilir. WSL Ayarları Başlat menüsünde bulunabilir.

Bu dosya, herhangi bir WSL 2 dağıtımını destekleyen VM'yi etkileyen aşağıdaki seçenekleri içerebilir:

Ana WSL ayarları

.wslconfig bölüm etiketi: [wsl2]

Anahtar	Değer	Varsayılan	Notlar
kernel	yol	Microsoft tarafından geliştirilen çekirdeğin sağladığı kutu	Özel bir Linux çekirdeğinin mutlak Windows yolu.
kernelModules	yol	Özel Linux çekirdek modülleri VHD'sine yönelik mutlak bir Windows yolu.
memory	boyut	Windows'ta toplam belleğin 50%'ı	WSL 2 VM'sine atanacak bellek miktarı.
processors	sayı	Windows'ta aynı sayıda mantıksal işlemci	WSL 2 VM'sine kaç mantıksal işlemci atanacak?
localhostForwarding	Boolean	true	WSL 2 VM'sindeki joker karaktere veya localhost'a bağlı bağlantı noktalarının localhost:portaracılığıyla konaktan bağlanabilmesini belirten Boolean değeri.
kernelCommandLine	dizgi	Hiç kimse	Ekstra çekirdek komut satırı bağımsız değişkenleri.
safeMode	Boolean	false	WSL'yi birçok özelliği devre dışı bırakır ve hatalı durumlardaki dağıtımları kurtarmak için kullanılması amaçlanan "Güvenli Mod"da çalıştırın. Yalnızca Windows 11 ve WSL sürüm 0.66.2+ için kullanılabilir.
swap	boyut	Windows'ta en yakın GB'a yuvarlanmış 25% bellek boyutu	WSL 2 VM'sine ne kadar takas alanı ekleneceğini belirtin; takas dosyası istemiyorsanız 0. Takas belleği, bellek talebi donanım aygıtında sınırı aştığında kullanılan disk tabanlı RAM'dir.
swapFile	yol	%Temp%\swap.vhdx	Bir swap sanal sabit disk için mutlak bir Windows yolu.
guiApplications	Boolean	true	WSL'de GUI uygulamaları (WSLg) desteğini açmak veya kapatmak için Boole.
debugConsole¹	Boolean	false	WSL 2 dağıtım örneği başlatıldığında dmesg içeriğini gösteren bir çıktı konsolu penceresini açmak için Boole değeri.
maxCrashDumpCount	sayı	10	Hata ayıklama amacıyla tutulacak en fazla kilitlenme dökümü dosyası sayısını ayarlayın. WSL tarafından tutulan varsayılan sayı 10'dur. Bu sınır aşıldığında, yenilerine yer açmak için eski çökme dökümleri otomatik olarak silinir. Maksimum bir değer ayarlamak, bu kilitlenme dosyaları tarafından kullanılan disk alanı miktarını azaltmaya yardımcı olabilir.
nestedVirtualization¹	Boolean	true	İç içe sanallaştırmayı açıp kapatan Boolean, diğer iç içe VM'lerin WSL 2 içinde çalışmasını sağlar.
vmIdleTimeout¹	sayı	60000	Vm'nin kapatılmadan önce boşta olduğu milisaniye sayısı.
dnsProxy	Boolean	true	Yalnızca için networkingMode = NATgeçerlidir. WSL'ye Linux'taki DNS Sunucusunu konaktaki NAT'ye yapılandırma konusunda bilgi vermek için Boole değeri. ayarı, false DNS sunucularını Windows'tan Linux'a yansıtır.
networkingMode¹²	dizgi	NAT	Kullanılabilir değerler şunlardır: none, nat, bridged (kullanım dışı), mirroredve virtioproxy. değeri ise noneWSL ağının bağlantısı kesilir. Değer veya bilinmeyen bir değerse nat NAT ağ modu kullanılır (WSL 2.3.25'ten başlayarak, NAT ağ modu başarısız olursa VirtioProxy ağ modunu kullanmaya geri döner). değeri ise bridged, köprülenmiş ağ modu kullanılır (bu mod, WSL 2.4.5'ten bu yana kullanım dışı olarak işaretlenmiştir). değeri ise mirrored, yansıtılmış ağ modu kullanılır. değer ise virtioproxy, VirtioProxy ağ modu kullanılır.
firewall¹²	Boolean	true	Bunu true olarak ayarlamak, Windows Güvenlik Duvarı kurallarının yanı sıra Hyper-V trafiğine özgü kuralların WSL ağ trafiğini filtrelemesine olanak tanır.
dnsTunneling¹²	Boolean	true	DNS isteklerinin WSL'den Windows'a nasıl iletileceğini değiştirir
autoProxy¹	Boolean	true	Windows'un HTTP proxy bilgilerini kullanmak için WSL'yi zorlar
defaultVhdSize	boyut	1099511627776 (1 TB)	Linux dağıtım (örneğin, Ubuntu) dosya sistemini depolayan Sanal Sabit Disk (VHD) boyutunu ayarlayın. Bir dağıtım dosyası sisteminin almasına izin verilen en büyük boyutu sınırlamak için kullanılabilir.

"path" değerine sahip girişler, kaçış ters eğik çizgileri olan Windows yolları olmalıdır, örneğin: C:\\Temp\\myCustomKernel

Varsayılan değeri B (bayt) olan size girişler ve birim kabul edilemez. Diğer birimleri kullanmak için boyut birimi eklenmelidir; örneğin: 8GB veya 512MB.

¹: Yalnızca Windows 11'de kullanılabilir.

²: Windows 11 sürüm 22H2 veya üzerini gerektir.

Deneysel ayarlar

Bu ayarlar, gelecekte varsayılan hale getirmeyi hedeflediğimiz deneysel özelliklerin kabul önizlemeleridir.

.wslconfig bölüm etiketi: [experimental]

Anahtar	Değer	Varsayılan	Notlar
autoMemoryReclaim	dizgi	dropCache	Kullanılabilir değerler şunlardır: disabled, gradualve dropCache. Değer ise disabled, WSL otomatik bellek geri kazanma devre dışı bırakılır. değeri ise gradual, önbelleğe alınan bellek yavaş ve otomatik olarak geri kazanılır. Değer veya bilinmeyen bir değerse dropCache , önbelleğe alınan bellek hemen geri kazanılır.
sparseVhd	Boolean	false	olarak trueayarlandığında, yeni oluşturulan tüm VHD'ler otomatik olarak seyrek olarak ayarlanır.
bestEffortDnsParsing¹²	Boolean	false	Yalnızca wsl2.dnsTunnelingtrueolarak ayarlandığında geçerlidir. olarak ayarlandığında trueWindows, DNS isteğindeki soruyu ayıklar ve bilinmeyen kayıtları yoksayarak çözmeyi dener.
dnsTunnelingIpAddress¹²	dizgi	10.255.255.254	Yalnızca wsl2.dnsTunnelingtrueolarak ayarlandığında geçerlidir. DNS tüneli etkinleştirildiğinde Linux resolv.conf dosyasında yapılandırılacak ad sunucusunu belirtir.
initialAutoProxyTimeout¹	dizgi	1000	Yalnızca wsl2.autoProxytrueolarak ayarlandığında geçerlidir. WSL kapsayıcısını başlatırken WSL'nin HTTP proxy bilgilerini almak için ne kadar süre bekleyeceğini (milisaniye cinsinden) yapılandırır. Ara sunucu ayarları bu süreden sonra çözülürse, alınan proxy ayarlarını kullanmak için WSL örneğinin yeniden başlatılması gerekir.
ignoredPorts¹²	dizgi	Sıfır	Yalnızca wsl2.networkingModemirroredolarak ayarlandığında geçerlidir. Bu bağlantı noktası Windows'ta kullanılıyor olsa bile Linux uygulamalarının bağlanabileceği bağlantı noktalarını belirtir. Bu, uygulamaların yalnızca Linux içinde trafik için bir bağlantı noktasında dinlemesini sağlar, bu nedenle bu uygulamalar Windows'ta başka amaçlar için kullanıldığında bile engellenmez. Örneğin, WSL yalnızca Linux kapsayıcısından gelen istekleri dinlediğinden Docker Desktop için Linux'ta 53 numaralı bağlantı noktasına bağlamaya izin verir. Virgülle ayrılmış bir listede biçimlendirilmelidir, örneğin: 3000,9000,9090
hostAddressLoopback¹²	Boolean	false	Yalnızca wsl2.networkingModemirroredolarak ayarlandığında geçerlidir. trueolarak ayarlandığında, Kapsayıcının Ana Bilgisayara veya Ana Bilgisayarın Kapsayıcıya atanmış bir IP adresiyle bağlanmasına izin verir. 127.0.0.1 geri döngü adresi her zaman kullanılabilir, bu seçenek ek olarak atanan tüm yerel IP adreslerinin de kullanılmasını sağlar. Yalnızca konağa atanan IPv4 adresleri desteklenir.

¹: Yalnızca Windows 11'de kullanılabilir.

²: Windows 11 sürüm 22H2 veya üzerini gerektir.

Örnek .wslconfig dosyası

Aşağıdaki .wslconfig örnek dosyası kullanılabilir yapılandırma seçeneklerinden bazılarını gösterir. Bu örnekte dosya yolu %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

# 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

Ek kaynaklar

• Windows Komut Satırı Blogu: WSL Otomatik Olarak Yapılandırma
• Windows Komut Satırı Blogu: Chmod/Chown, DrvFs, dosya meta verileri