From 71097ab851a1a87222542185b050f6813087660a Mon Sep 17 00:00:00 2001 From: chanpreetdhanjal <68442928+chanpreetdhanjal@users.noreply.github.com> Date: Wed, 20 Mar 2024 11:55:13 -0700 Subject: [PATCH] User/chdhan/wsl troubleshooting doc update 3 18 23 (#1936) * Signed-off-by: Chanpreet Dhanjal Upating pages to reflect support for IPV4 and IPV6 * Updated text * Minor editorial update We try to only use "note:" to indicate actual formatted notes. * Minor editorial updates --------- Co-authored-by: Matt Wojciakowski --- WSL/networking.md | 2 +- WSL/wsl-config.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/WSL/networking.md b/WSL/networking.md index c9ea6eb0..849f95c7 100644 --- a/WSL/networking.md +++ b/WSL/networking.md @@ -79,7 +79,7 @@ You can [set `networkingMode=mirrored` under `[wsl2]` in the `.wslconfig` file]( Here are the current benefits to enabling this mode: - IPv6 support -- Connect to Windows servers from within Linux using the localhost address `127.0.0.1` +- Connect to Windows servers from within Linux using the localhost address `127.0.0.1`. IPv6 localhost address `::1` is not supported - Improved networking compatibility for VPNs - Multicast support - Connect to WSL directly from your local area network (LAN) diff --git a/WSL/wsl-config.md b/WSL/wsl-config.md index eed2f91b..0fb8ec78 100644 --- a/WSL/wsl-config.md +++ b/WSL/wsl-config.md @@ -249,7 +249,7 @@ These settings are opt-in previews of experimental features that we aim to make |`bestEffortDnsParsing`**| bool | false | Only applicable when `wsl2.dnsTunneling` is set to true. When set to true, Windows will extract the question from the DNS request and attempt to resolve it, ignoring the unknown records. | |`initialAutoProxyTimeout`*| string | 1000 | Only applicable when `wsl2.autoProxy` is set to true. Configures how long (in milliseconds) WSL will wait for retrieving HTTP proxy information when starting a WSL container. If proxy settings are resolved after this time, the WSL instance must be restarted to use the retrieved proxy settings. | |`ignoredPorts`**| string | null | Only applicable when `wsl2.networkingMode` is set to `mirrored`. Specifies which ports Linux applications can bind to, even if that port is used in Windows. This enables applications to listen on a port for traffic purely within Linux, so those applications are not blocked even when that port is used for other purposes on Windows. For example, WSL will allow binding to port 53 in Linux for Docker Desktop, as it is listening only to requests from within the Linux container. Should be formatted in a comma separated list, e.g: `3000,9000,9090` | -|`hostAddressLoopback`**| bool | false | Only applicable when `wsl2.networkingMode` is set to `mirrored`. When set to True, will allow the Container to connect to the Host, or the Host to connect to the Container, by an IP address that's assigned to the Host. Note that the 127.0.0.1 loopback address can always be used - this option allows for all additionally assigned local IP addresses to be used as well. | +|`hostAddressLoopback`**| bool | false | Only applicable when `wsl2.networkingMode` is set to `mirrored`. When set to `True`, will allow the Container to connect to the Host, or the Host to connect to the Container, by an IP address that's assigned to the Host. The `127.0.0.1` loopback address can always be used,this option allows for all additionally assigned local IP addresses to be used as well. Only IPv4 addresses assigned to the host are supported. | Entries with an * after the value type are only available on Windows 11. @@ -284,7 +284,7 @@ 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 +# Turn on default connection to bind WSL 2 localhost to Windows localhost. Setting is ignored when networkingMode=mirrored localhostforwarding=true # Disables nested virtualization