Panduan Konfigurasi Mode Jaringan WSL mirrored

Panduan Konfigurasi Pengupgradean Mode Jaringan WSL 2.6.0

Persyaratan Versi

Status versi saat ini:

  • Versi stabil terbaru: 2.5.9 (ada kekurangan konfigurasi jaringan)
  • Versi yang direkomendasikan: 2.6.0 pratinjau (mendukung mode mirrored lengkap)

Analisis Perbandingan Mode

Fiturmode bridge (sudah tidak digunakan lagi)mode mirrored (direkomendasikan)
Arsitektur tumpukan protokolTumpukan protokol gandaTumpukan protokol bersama
Alokasi alamat IPIP terpisah (Windows+WSL)IP host bersama
Sumber daya portDigunakan terpisahPort bersama (perlu menghindari benturan)
Kinerja jaringanRelatif beratRingan dan efisien
Tingkat kompleksitas konfigurasiSederhanaMemerlukan konfigurasi kebijakan firewall yang mendalam

Langkah Konfigurasi Standar

1. Pengaturan Mode Jaringan

Melalui aplikasi WSL Settings, atur mode dasar:

  1. Buka aplikasi pengaturan
  2. Pilih tab “Network”
  3. Atur mode jaringan ke “Mirrored”
  4. Terapkan konfigurasi dan restart WSL

2. Konfigurasi Kebijakan Firewall

Perlu melakukan konfigurasi kebijakan lengkap melalui PowerShell:

# Definisikan GUID VM WSL
$wslGuid = '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}'

# Konfigurasikan kebijakan firewall (jalankan berurutan)
Set-NetFirewallHyperVVMSetting -Name $wslGuid -Enabled True
Set-NetFirewallHyperVVMSetting -Name $wslGuid -DefaultInboundAction Allow
Set-NetFirewallHyperVVMSetting -Name $wslGuid -DefaultOutboundAction Allow
Set-NetFirewallHyperVVMSetting -Name $wslGuid -LoopbackEnabled True
Set-NetFirewallHyperVVMSetting -Name $wslGuid -AllowHostPolicyMerge True

# Verifikasi hasil konfigurasi
Get-NetFirewallHyperVVMSetting -Name $wslGuid

3. Verifikasi Pemetaan Port

# Contoh: Periksa penggunaan port 80
Get-NetTCPConnection -LocalPort 80

Penanganan Masalah Umum

Masalah 1: Tidak dapat membangun koneksi eksternal

  • Langkah pemeriksaan: semua bidang dalam output Get-NetFirewallHyperVVMSetting harus True/Allow
  • Solusi: Jalankan ulang konfigurasi kebijakan firewall berurutan

Masalah 2: Benturan port

  • Metode verifikasi: Lihat penggunaan port dengan netstat -ano
  • Saran penanganan: Prioritaskan melepaskan port yang digunakan di sisi Windows, atau ubah port pemrosesan layanan WSL

Metode Verifikasi

  1. Mulai layanan WSL (misalnya Nginx/Apache)
  2. Akses http://localhost:<port> dari host Windows
  3. Akses http://<host-ip>:<port> dari perangkat jaringan lokal

Referensi

  1. Dokumentasi jaringan resmi WSL
  2. Catatan rilis WSL 2.6.0