Konfigurasi pengaturan tingkat lanjut di WSL

File wsl.conf dan .wslconfig digunakan untuk mengonfigurasi pengaturan lanjutan di WSL yang akan diterapkan saat memulai VM WSL. wsl.conf digunakan untuk menerapkan pengaturan berdasarkan distro per WSL, dan .wslconfig digunakan untuk menerapkan pengaturan global ke WSL. Anda dapat membaca lebih lanjut tentang perbedaan di bawah ini.

Aspek	`.wslconfig`	`wsl.conf`
Ruang lingkup	Pengaturan umum yang berlaku untuk semua WSL	Pengaturan untuk distribusi WSL saja
Mengonfigurasi	Pengaktifan fitur di WSL, pengaturan untuk komputer virtual yang mendukung WSL 2 (RAM, kernel untuk boot, jumlah CPU, dll.)	Pengaturan distribusi di WSL seperti opsi boot, automount DrvFs, jaringan, interoperabilitas dengan sistem Windows, penggunaan sistem, dan pengguna default
Tempat	`%UserProfile%\.wslconfig`, di luar distribusi WSL	`/etc/wsl.conf`, saat berada dalam distribusi WSL

Saat ini, semua pengaturan .wslconfig hanya berlaku untuk distribusi WSL 2. Pelajari cara memeriksa versi WSL yang sedang Anda gunakan.

Aturan 8 detik untuk perubahan konfigurasi

Anda harus menunggu hingga subsistem yang menjalankan distribusi Linux Anda benar-benar berhenti berjalan dan memulai ulang agar pembaruan pengaturan konfigurasi muncul. Ini biasanya membutuhkan waktu sekitar 8 detik setelah menutup SEMUA instans shell distribusi.

Jika Anda meluncurkan distribusi (misalnya Ubuntu), ubah file konfigurasi, tutup distribusi, lalu luncurkan kembali, Anda mungkin berasumsi bahwa perubahan konfigurasi Anda telah segera berlaku. Ini saat ini tidak terjadi karena subsistem masih dapat berjalan. Anda harus menunggu subsistem berhenti sebelum Anda meluncurkannya kembali untuk memberikan cukup waktu agar perubahan Anda diperbarui. Anda dapat menggunakan PowerShell untuk memeriksa apakah distribusi Linux (shell) Anda masih berjalan setelah menutupnya dengan perintah: wsl --list --running. Jika tidak ada distribusi yang berjalan, Anda akan menerima respons: "Tidak ada distribusi yang berjalan." Anda sekarang dapat memulai ulang distribusi untuk melihat pembaruan konfigurasi Anda diterapkan.

Perintah wsl --shutdown adalah jalur cepat untuk memulai kembali distribusi WSL 2, tetapi akan menghentikan semua distribusi yang sedang berjalan, jadi gunakan dengan bijak. Anda juga dapat menggunakan wsl --terminate <distroName> untuk mengakhiri distribusi tertentu yang berjalan segera.

wsl.conf

Konfigurasikan pengaturan lokal dengan wsl.conf per-distribusi untuk setiap distribusi Linux yang berjalan di WSL 1 atau WSL 2.

Disimpan dalam /etc direktori distribusi sebagai file unix.
Digunakan untuk mengonfigurasi pengaturan berdasarkan per distribusi. Pengaturan yang dikonfigurasi dalam file ini hanya akan diterapkan ke distribusi Linux tertentu yang berisi direktori tempat file ini disimpan.
Dapat digunakan untuk distribusi yang dapat dijalankan pada salah satu versi, WSL 1 atau WSL 2.
Untuk masuk ke /etc direktori untuk distribusi yang diinstal, gunakan baris perintah distribusi dengan cd / untuk mengakses direktori akar, lalu gunakan ls untuk mencantumkan file atau explorer.exe . untuk melihat di Windows File Explorer. Jalur direktori seharusnya terlihat seperti: /etc/wsl.conf.

Catatan

Menyesuaikan pengaturan per distribusi dengan file wsl.conf hanya tersedia di Windows Build 17093 dan yang lebih baru.

Pengaturan konfigurasi untuk wsl.conf

File wsl.conf mengonfigurasi pengaturan berdasarkan per distribusi. (Untuk konfigurasi global distribusi WSL 2, lihatlah .wslconfig).

File wsl.conf mendukung empat bagian: automount, network, interop, dan user. (Dirancang mengikuti konvensi file .ini, pengaturan dideklarasikan dalam sebuah bagian, seperti file .gitconfig.) Untuk informasi tentang lokasi penyimpanan file wsl.conf, lihat wsl.conf.

dukungan systemd

Banyak distribusi Linux menjalankan "systemd" secara default (termasuk Ubuntu) dan WSL baru-baru ini menambahkan dukungan untuk sistem/manajer layanan ini sehingga WSL bahkan lebih mirip dengan menggunakan distribusi Linux favorit Anda pada mesin bare metal. Anda akan memerlukan WSL versi 0.67.6+ untuk mengaktifkan systemd. Periksa versi WSL Anda dengan perintah wsl --version. Jika Anda perlu memperbarui, Anda bisa mendapatkan WSL versi terbaru di Microsoft Store. Pelajari lebih lanjut di pengumuman blog.

Untuk mengaktifkan systemd, buka file wsl.conf Anda di editor teks menggunakan sudo untuk izin admin dan tambahkan baris ini ke /etc/wsl.conf:

[boot]
systemd=true

Anda kemudian perlu menutup distribusi WSL Anda menggunakan wsl.exe --shutdown dari PowerShell untuk memulai ulang instans WSL Anda. Setelah distribusi Anda dijalankan ulang, harusnya systemd berjalan. Anda dapat mengonfirmasi menggunakan perintah: systemctl list-unit-files --type=service, yang akan menampilkan status layanan Anda.

Pengaturan pemasangan otomatis

Label bagian sektsi wsl.conf: [automount]

Kunci	Nilai	Bawaan	Catatan
`enabled`	Boolean	`true`	`true` menyebabkan drive tetap (yaitu `C:/` atau `D:/`) dipasang secara otomatis dengan DrvF di bawah `/mnt`. `false` berarti drive tidak akan dipasang secara otomatis, tetapi Anda masih dapat memasangnya secara manual atau melalui `fstab`.
`mountFsTab`	Boolean	`true`	`true` mengatur `/etc/fstab` untuk diproses pada saat WSL dimulai. `/etc/fstab` adalah file di mana Anda dapat mendeklarasikan sistem file lain, seperti berbagi SMB. Dengan demikian, Anda dapat memasang sistem file ini secara otomatis di WSL saat memulai.
`root`	string	`/mnt/`	Mengatur direktori tempat hard drive akan dipasang secara otomatis. Secara default ini diatur ke `/mnt/`, sehingga sistem `C:\` file Windows Anda dipasang ke `/mnt/c/`. Jika Anda mengubah `/mnt/` ke `/windir/`, Anda harus berharap untuk melihat pemasangan tetap `C:\` Anda ke `/windir/c`.
`options`	daftar nilai yang dipisahkan koma, seperti uid, gid, dll, lihat opsi automount di bawah ini	Nol	Nilai opsi automount tercantum di bawah ini dan ditambahkan ke string opsi pemasangan DrvFs bawaan. Hanya opsi khusus DrvFs yang dapat ditentukan.

Opsi automount digunakan sebagai opsi pemasangan untuk semua drive yang terpasang secara otomatis. Untuk mengubah opsi untuk drive tertentu saja, gunakan file /etc/fstab sebagai gantinya. Opsi yang biasanya akan diurai biner pemasangan menjadi bendera tidak didukung. Jika Anda ingin secara eksplisit menentukan opsi tersebut, Anda harus menyertakan setiap drive yang opsi tersebut ingin Anda tetapkan di /etc/fstab.

Opsi pemasangan otomatis

Mengatur opsi pemasangan yang berbeda untuk drive Windows (DrvFs) dapat mengontrol cara perhitungan izin file untuk file Windows. Pilihan berikut tersedia:

Kunci	Deskripsi	Bawaan
`uid`	ID Pengguna yang digunakan untuk pemilik semua file	ID Pengguna default distro WSL Anda (pada penginstalan pertama ini default ke `1000`)
`gid`	ID Grup yang digunakan untuk pemilik semua file	ID grup default distro WSL Anda (pada penginstalan pertama ini default ke `1000`)
`umask`	Masker oktal izin yang harus dikecualikan dari semua file dan direktori	`022`
`fmask`	Masker oktal izin yang dikecualikan untuk semua file	`000`
`dmask`	Masker oktal izin yang harus dikecualikan di semua direktori	`000`
`metadata`	Apakah metadata ditambahkan ke file Windows untuk mendukung izin sistem Linux	`disabled`
`case`	Menentukan direktori yang diperlakukan sebagai peka huruf besar/kecil dan apakah direktori baru yang dibuat dengan WSL akan memiliki set bendera. Lihat kepekaan huruf untuk penjelasan terperinci tentang opsi. Opsi termasuk `off`, `dir`, atau `force`.	`off`

Secara default, WSL mengatur uid dan gid ke nilai pengguna default. Misalnya, di Ubuntu, pengguna defaultnya adalah uid=1000, gid=1000. Jika nilai ini digunakan untuk menentukan opsi atau gid yang berbedauid, nilai pengguna default akan ditimpa. Jika tidak, nilai default akan selalu ditambahkan.

Opsi umask, fmask, dll. di atas hanya akan berlaku ketika drive Windows dipasang dengan metadata. Secara default metadata tidak diaktifkan. Anda dapat menemukan informasi selengkapnya tentang ini di sini.

Catatan

Masker izin dimasukkan melalui operasi OR logis sebelum diterapkan ke file atau direktori.

Apa itu DrvFs?

DrvFs adalah plugin sistem file ke WSL yang dirancang untuk mendukung interop antara WSL dan sistem file Windows. DrvFs memungkinkan WSL mengaitkan drive dengan sistem file yang didukung di bawah /mnt, seperti /mnt/c, /mnt/d, dll. Untuk informasi selengkapnya tentang menentukan perilaku sensitivitas huruf besar-kecil default saat mengaitkan drive atau direktori Windows atau Linux, lihat halaman sensitivitas huruf besar-kecil.

Pengaturan jaringan

Label bagian sektsi wsl.conf: [automount]

Kunci	Nilai	Bawaan	Catatan
`generateHosts`	Boolean	`true`	`true` mengatur WSL untuk menghasilkan `/etc/hosts`. File `hosts` berisi peta statis nama host yang sesuai dengan alamat IP.
`generateResolvConf`	Boolean	`true`	`true` mengatur WSL untuk menghasilkan `/etc/resolv.conf`. `resolv.conf` berisi daftar DNS yang mampu menyelesaikan nama host tertentu ke alamat IP-nya.
`hostname`	string	Nama host Windows	Mengatur nama host yang akan digunakan untuk distribusi WSL.

Pengaturan interoperabilitas

Label bagian sektsi wsl.conf: [automount]

Opsi ini tersedia di Insider Build 17713 dan yang lebih baru.

Kunci	Nilai	Bawaan	Catatan
`enabled`	Boolean	`true`	Mengatur kunci ini akan menentukan apakah WSL akan mendukung peluncuran proses Windows.
`appendWindowsPath`	Boolean	`true`	Mengatur kunci ini akan menentukan apakah WSL akan menambahkan elemen jalur Windows ke `$PATH` variabel lingkungan.

Pengaturan pengguna

Label bagian sektsi wsl.conf: [automount]

Opsi ini tersedia di Build 18980 dan yang lebih baru.

Kunci	Nilai	Bawaan	Catatan
`default`	string	Nama pengguna awal yang dibuat saat pertama kali dijalankan	Menetapkan kunci ini menentukan pengguna mana yang akan digunakan saat pertama kali memulai sesi WSL.

Pengaturan saat mulai

Pengaturan Boot hanya tersedia di Windows 11 dan Server 2022.

Label bagian sektsi wsl.conf: [automount]

Kunci	Nilai	Bawaan	Catatan
`command`	string	Nol	String perintah yang ingin Anda jalankan saat instans WSL dimulai. Perintah ini dijalankan sebagai pengguna root. misalnya: `service docker start`.
`protectBinfmt`	Boolean	`true`	Mencegah WSL menghasilkan unit systemd ketika systemd diaktifkan.

Pengaturan GPU

Label bagian sektsi wsl.conf: [automount]

Kunci	Nilai	Bawaan	Catatan
`enabled`	Boolean	`true`	Izinkan aplikasi Linux mengakses GPU Windows melalui para-virtualisasi.

Pengaturan waktu

Label bagian sektsi wsl.conf: [automount]

Kunci	Nilai	Bawaan	Catatan
`useWindowsTimezone`	Boolean	`true`	Mengatur kunci ini akan membuat WSL menggunakan dan menyinkronkan ke zona waktu yang diatur di Windows.

Contoh file wsl.conf

File wsl.conf sampel di bawah ini menunjukkan beberapa opsi konfigurasi yang tersedia. Dalam contoh ini, distribusinya adalah Ubuntu-20.04 dan jalur filenya adalah \\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

Mengonfigurasi pengaturan global menggunakan .wslconfig pada semua distribusi terinstal yang dijalankan di WSL.

File .wslconfig tidak ada secara default. Ini harus dibuat dan disimpan di direktori Anda %UserProfile% untuk menerapkan pengaturan konfigurasi ini.
Digunakan untuk mengonfigurasi pengaturan secara global di semua distribusi Linux yang diinstal yang berjalan sebagai versi WSL 2.
Hanya dapat digunakan untuk distribusi yang dijalankan oleh WSL 2. Distribusi yang berjalan sebagai WSL 1 tidak akan terpengaruh oleh konfigurasi ini karena tidak berjalan sebagai komputer virtual.
Untuk masuk ke direktori Anda %UserProfile%, di PowerShell, gunakan cd ~ untuk mengakses direktori home Anda (yang biasanya merupakan profil pengguna Anda, C:\Users\<UserName>) atau Anda dapat membuka Windows File Explorer dan memasukkan %UserProfile% di bilah alamat. Jalur direktori seharusnya terlihat seperti: C:\Users\<UserName>\.wslconfig.

WSL akan mendeteksi keberadaan file-file ini, membaca konten, dan secara otomatis menerapkan pengaturan konfigurasi setiap kali Anda meluncurkan WSL. Jika file hilang atau salah bentuk (pemformatan markup yang tidak tepat), WSL akan terus diluncurkan seperti biasa tanpa pengaturan konfigurasi diterapkan.

Pengaturan konfigurasi untuk .wslconfig

File .wslconfig mengonfigurasi pengaturan secara global untuk semua distribusi Linux yang berjalan dengan WSL 2. (Untuk konfigurasi per distribusi, lihat wsl.conf).

Lihat .wslconfig untuk informasi tentang lokasi menyimpan file .wslconfig.

Catatan

Mengonfigurasi pengaturan global dengan .wslconfig hanya tersedia untuk distribusi yang berjalan sebagai WSL 2 di Windows Build 19041 dan yang lebih baru. Perlu diingat bahwa Anda mungkin perlu menjalankan wsl --shutdown untuk mematikan WSL 2 VM dan kemudian menghidupkan ulang instance WSL Anda agar perubahan ini berlaku.

Petunjuk / Saran

Disarankan untuk memodifikasi konfigurasi WSL langsung di Pengaturan WSL, daripada mengedit file .wslconfig secara manual. Pengaturan WSL dapat ditemukan di menu Mulai. Subsistem Windows untuk Pengaturan Linux

File ini dapat berisi opsi berikut yang memengaruhi VM yang mendukung distribusi WSL 2 apa pun:

Pengaturan WSL utama

Label bagian .wslconfig: [wsl2]

Kunci	Nilai	Bawaan	Catatan
`kernel`	jalan	Kotak masuk yang disediakan kernel bawaan Microsoft	Jalur Windows absolut ke kernel Linux kustom.
`kernelModules`	jalan	Jalur absolut Windows ke modul kustom kernel Linux VHD.
`memory`	ukuran	50% dari total memori pada Windows	Berapa banyak memori yang harus dialokasikan ke VM WSL 2.
`processors`	nomor	Jumlah prosesor logis yang sama di Windows	Berapa banyak prosesor logis yang akan ditetapkan ke VM WSL 2.
`localhostForwarding`	Boolean	`true`	Boolean yang menentukan apakah port yang terikat ke kartu liar atau localhost di VM WSL 2 dapat diakses dari host melalui `localhost:port`.
`kernelCommandLine`	string	Tidak ada	Argumen baris perintah kernel tambahan.
`safeMode`	Boolean	`false`	Jalankan WSL dalam "Mode Aman" yang menonaktifkan banyak fitur dan dimaksudkan untuk digunakan untuk memulihkan distribusi yang berada dalam status buruk. Hanya tersedia untuk Windows 11 dan WSL versi 0.66.2+.
`swap`	ukuran	25% dari ukuran memori pada Windows dibulatkan ke atas menjadi GB terdekat	Berapa banyak ruang swap yang ingin ditambahkan ke WSL 2 VM, masukkan 0 jika tidak ingin menggunakan file swap. Penyimpanan swap adalah RAM berbasis disk yang digunakan ketika permintaan memori melebihi batas pada perangkat keras.
`swapFile`	jalan	`%Temp%\swap.vhdx`	Jalur Windows absolut ke hard disk virtual swap.
`guiApplications`	Boolean	`true`	Boolean untuk menghidupkan atau mematikan dukungan aplikasi GUI (WSLg) di WSL.
`debugConsole`¹	Boolean	`false`	Boolean untuk menyalakan jendela konsol output yang menampilkan konten `dmesg` saat instans distro WSL 2 dimulai.
`maxCrashDumpCount`	nomor	`10`	Atur jumlah maksimum file crash dump yang akan dipertahankan untuk tujuan penelusuran kesalahan. Nomor default yang dipertahankan oleh WSL adalah 10. Ketika batas ini terlampaui, crash dump yang lebih lama akan dihapus secara otomatis untuk memberi ruang bagi yang baru. Mengatur maks dapat membantu mengurangi jumlah ruang disk yang digunakan oleh file crash ini.
`nestedVirtualization`¹	Boolean	`true`	Boolean untuk mengaktifkan atau menonaktifkan virtualisasi berlapis, memungkinkan VM berlapis lainnya berjalan di dalam WSL 2.
`vmIdleTimeout`¹	nomor	`60000`	Jumlah milidetik yang diam VM, sebelum dimatikan.
`dnsProxy`	Boolean	`true`	Hanya berlaku untuk `networkingMode = NAT`. Boolean untuk memberi tahu WSL untuk mengonfigurasi Server DNS di Linux ke NAT pada host. Pengaturan ke `false` akan mencerminkan server DNS dari Windows ke Linux.
`networkingMode`¹²	string	`NAT`	Nilai yang tersedia adalah: `none`, , `natbridged` (tidak digunakan lagi), `mirrored`, dan `virtioproxy`. Jika nilainya adalah `none`, jaringan WSL terputus. Jika nilainya atau `nat` nilai yang tidak diketahui, mode jaringan NAT digunakan (mulai dari WSL 2.3.25, jika mode jaringan NAT gagal, mode jaringan NAT akan kembali menggunakan mode jaringan VirtioProxy). Jika nilainya adalah `bridged`, mode jaringan yang dijembatani digunakan (mode ini telah ditandai sebagai tidak digunakan lagi sejak WSL 2.4.5). Jika nilainya adalah `mirrored`, mode jaringan cermin digunakan. Jika nilainya adalah `virtioproxy`, mode jaringan VirtioProxy digunakan.
`firewall`¹²	Boolean	`true`	Mengaktifkan ini akan mengizinkan aturan Windows Firewall, serta aturan khusus untuk lalu lintas Hyper-V, untuk memfilter lalu lintas jaringan WSL.
`dnsTunneling`¹²	Boolean	`true`	Mengubah cara permintaan DNS diproksi dari WSL ke Windows
`autoProxy`¹	Boolean	`true`	Memaksa WSL untuk menggunakan informasi proksi HTTP dari Windows
`defaultVhdSize`	ukuran	`1099511627776` (1 TB)	Atur ukuran Virtual Hard Disk (VHD) yang menyimpan sistem file distribusi Linux (misalnya, Ubuntu). Dapat digunakan untuk membatasi ukuran maksimum yang diizinkan oleh sistem file distribusi.

Entri dengan nilai "jalur" harus berupa jalur Windows dengan garis miring terbalik yang lolos, misalnya: C:\\Temp\\myCustomKernel

Entri dengan size nilai default ke B (byte), dan unit dihilangkan. Untuk menggunakan unit lain, unit ukuran harus ditambahkan, misalnya: 8GB atau 512MB.

¹: Hanya tersedia di Windows 11.

²: Memerlukan Windows 11 versi 22H2 atau yang lebih tinggi.

Pengaturan eksperimental

Pengaturan ini adalah pratinjau opsional dari fitur eksperimen yang kami bertujuan untuk menjadikannya sebagai default di masa depan.

Label bagian .wslconfig: [experimental]

Kunci	Nilai	Bawaan	Catatan
`autoMemoryReclaim`	string	`dropCache`	Nilai yang tersedia adalah: `disabled`, `gradual`, dan `dropCache`. Jika nilainya adalah `disabled`, reklamasi memori otomatis WSL akan dinonaktifkan. Jika nilainya adalah `gradual`, memori yang di-cache akan diklaim kembali secara perlahan dan otomatis. Jika nilainya adalah `dropCache` atau nilai yang tidak diketahui, memori yang di-cache akan segera diklaim kembali.
`sparseVhd`	bool	`false`	Ketika diatur ke `true`, setiap VHD yang baru dibuat akan diatur ke jarang secara otomatis.
`bestEffortDnsParsing`¹²	bool	`false`	Hanya berlaku ketika `wsl2.dnsTunneling` diatur ke `true`. Ketika diatur ke `true`, Windows akan mengekstrak pertanyaan dari permintaan DNS dan mencoba mengatasinya, mengabaikan catatan yang tidak diketahui.
`dnsTunnelingIpAddress`¹²	string	`10.255.255.254`	Hanya berlaku ketika `wsl2.dnsTunneling` diatur ke `true`. Menentukan server nama yang akan dikonfigurasi dalam file Linux `resolv.conf` saat penerowongan DNS diaktifkan.
`initialAutoProxyTimeout`¹	string	`1000`	Hanya berlaku ketika `wsl2.autoProxy` diatur ke `true`. Mengonfigurasi berapa lama (dalam milidetik) WSL akan menunggu pengambilan informasi proksi HTTP saat memulai kontainer WSL. Jika pengaturan proksi diselesaikan setelah waktu ini, instans WSL harus dimulai ulang untuk menggunakan pengaturan proksi yang diambil.
`ignoredPorts`¹²	string	Nol	Hanya berlaku ketika `wsl2.networkingMode` diatur ke `mirrored`. Menentukan port mana yang dapat diikat aplikasi Linux, bahkan jika port tersebut digunakan di Windows. Ini memungkinkan aplikasi untuk mendengarkan port untuk lalu lintas murni dalam Linux, sehingga aplikasi tersebut tidak diblokir bahkan ketika port tersebut digunakan untuk tujuan lain di Windows. Misalnya, WSL akan memungkinkan pengikatan ke port 53 di Linux untuk Docker Desktop, karena hanya mendengarkan permintaan dari dalam kontainer Linux. Harus diformat dalam daftar yang dipisahkan koma, misalnya: `3000,9000,9090`
`hostAddressLoopback`¹²	bool	`false`	Hanya berlaku ketika `wsl2.networkingMode` diatur ke `mirrored`. Ketika diatur ke `true`, akan memungkinkan Kontainer untuk terhubung ke Host, atau Host untuk terhubung ke Kontainer, menggunakan alamat IP yang telah ditetapkan ke Host. Alamat `127.0.0.1` loopback selalu dapat digunakan, opsi ini memungkinkan semua alamat IP lokal tambahan yang ditetapkan juga dapat digunakan. Hanya alamat IPv4 yang ditetapkan ke host yang didukung.

¹: Hanya tersedia di Windows 11.

²: Memerlukan Windows 11 versi 22H2 atau yang lebih tinggi.

Contoh file .wslconfig

File .wslconfig sampel di bawah ini menunjukkan beberapa opsi konfigurasi yang tersedia. Dalam contoh ini, jalur file adalah %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

Sumber Daya Tambahan:

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-08-15