WSL Settings: network mode is not synchronized after mirrored-to-NAT fallback
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 45/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- cpp, linux
- Domain
- networking
Research direction
Start by tracing where WSL selects mirrored or NAT networking when IPv6 is disabled, then follow how that selected mode reaches the WSL Settings app and .wslconfig. The issue gives no source files or tests, so first locate those entry points and any existing fallback tests. Done means the unavailable mirrored mode is reported clearly or both configuration views reflect the actual NAT mode.
Written by the indexing model from the issue text.
Description
Windows Version
Microsoft Windows [版本 10.0.26100.4946]
WSL Version
2.7.10.0
Are you using WSL 1, WSL 2, or WSLC?
- WSL 2
- WSL 1
- WSLC
Kernel Version
6.18.33.2-2
Distro Version
Ubuntu-22.04 (默认值)
Other Software
No response
Repro Steps
Set the WSL networking mode to mirrored in .wslconfig and/or the WSL Settings app.
Disable IPv6 on Windows (for example, set DisabledComponents=0xff under HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip6\Parameters).
Restart WSL.
Observe the actual WSL networking mode and check the corresponding configuration in the WSL Settings app and .wslconfig.
Expected Behavior
When mirrored mode cannot be used because IPv6 is disabled, WSL should either clearly report that mirrored mode is unavailable or fall back to NAT mode while keeping the WSL Settings app and .wslconfig synchronized with the actual networking mode in use.
Actual Behavior
Actual Behavior
When the networking mode is set to mirrored and IPv6 is disabled, WSL silently falls back to NAT mode. However, the configuration in the WSL Settings app and .wslconfig is not synchronized or updated, so they still show mirrored instead of reflecting the actual NAT mode.
Diagnostic Logs
No response
- Dominant language
- C++
- Stars
- 34.4k
- Forks
- 1.9k
- Avg merge
- 1d 23h
- Merged PRs (30d)
- 166
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from microsoft/WSL
-
feature wsl2
Difficulty 2/5 1-3 hours Newbie friendliness 80/100
microsoft/WSL#42306 · 3 comments ·
Maintainers usually reply within 1 day
-
feature
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
microsoft/WSL#42114 · 3 comments ·
Maintainers usually reply within 1 day
-
feature kernel wsl2
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
microsoft/WSL#41107 · 3 comments · 1 reaction ·
Maintainers usually reply within 1 day
-
feature kernel
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
microsoft/WSL#41054 · 9 comments · 1 reaction ·
Maintainers usually reply within 1 day
-
feature GPU
Difficulty 1/5 1-3 hours Newbie friendliness 70/100
microsoft/WSL#13592 · 4 comments ·
Maintainers usually reply within 1 day
Similar issues
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
nextcloud/passman-android#214 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 1-3 hours Newbie friendliness 62/100
Maintainers usually reply within 1 day
-
2026.11.0 fails to install on Intel macOS: requirements.txt pins cryptography==50.0.2 for Darwin x86_64May be free again A pull request for this issue was closed without being merged. Open
Difficulty 1/5 Under an hour Newbie friendliness 87/100
esphome/esphome#22892 · 1 comment ·
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
distante/esphome-components#50 · 1 comment ·
Maintainers usually reply within 1 day
-
arch-based hyprland
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
noctalia-dev/noctalia#5423 ·
Maintainers usually reply within 1 day