opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2025-10-13 01:06:10 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #26785 from Luap99/user-mode-docs

Browse Source 
make machine --user-mode-networking docs more clear
This commit is contained in:
openshift-merge-bot[bot]
2025-08-11 21:13:50 +00:00
committed by GitHub
parent 55996138fa 5706d2a61e
commit a9e80f9d6d
1 changed files with 11 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
docs/source/markdown/options/user-mode-networking.md
View File

@ -4,18 +4,21 @@
####> are applicable to all of those. ####> are applicable to all of those.
#### **--user-mode-networking** #### **--user-mode-networking**
Indicates that this machine relays traffic from the guest through a user-space This option can only be used for the WSL provider on Windows. On all other
process running on the host. In some VPN configurations the VPN may drop platforms this option is ignored and user mode networking will always be
traffic from alternate network interfaces, including VM network devices. By `true` there because these providers always depend on gvproxy (our user
enabling user-mode networking (a setting of `true`), VPNs observe all mode networking tool for the VMs)
podman machine traffic as coming from the host, bypassing the problem.
When the qemu backend is used (Linux, Mac), user-mode networking is In contrast, The Windows/WSL backend defaults to `false`, and follows the
mandatory and the only allowed value is `true`. In contrast, The Windows/WSL standard WSL network setup.
backend defaults to `false`, and follows the standard WSL network setup.
Changing this setting to `true` on Windows/WSL informs Podman to replace Changing this setting to `true` on Windows/WSL informs Podman to replace
the WSL networking setup on start of this machine instance with a user-mode the WSL networking setup on start of this machine instance with a user-mode
networking distribution. Since WSL shares the same kernel across networking distribution. Since WSL shares the same kernel across
distributions, all other running distributions reuses this network. distributions, all other running distributions reuses this network.
Likewise, when the last machine instance with a `true` setting stops, the Likewise, when the last machine instance with a `true` setting stops, the
original networking setup is restored. original networking setup is restored.
In some VPN configurations the VPN may drop traffic from alternate network
interfaces, including VM network devices. By enabling user-mode networking
VPNs observe all podman machine traffic as coming from the host, bypassing
the problem.