https://github.com/czbix/wslhostpatcher

Dynamic patch WSL2 to listen port on any interface.
https://github.com/czbix/wslhostpatcher

wsl wsl2 wsl2-forwarding-port

Last synced: 3 days ago
JSON representation

Dynamic patch WSL2 to listen port on any interface.

• Host: GitHub
• URL: https://github.com/czbix/wslhostpatcher
• Owner: CzBiX
• License: mit
• Created: 2021-03-03T16:15:48.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2024-04-07T12:14:11.000Z (10 months ago)
• Last Synced: 2025-01-22T14:01:43.170Z (10 days ago)
• Topics: wsl, wsl2, wsl2-forwarding-port
• Language: C++
• Homepage:
• Size: 27.3 KB
• Stars: 743
• Watchers: 16
• Forks: 50
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# WSLHostPatcher

Dynamic patch WSL2 to listen port on any interfaces.

# Updates

Check out experimental bridge solution at https://github.com/microsoft/WSL/issues/4150#issuecomment-1018524753.

Also [MS official config](https://docs.microsoft.com/en-us/windows/wsl/wsl-config#configuration-setting-for-wslconfig) for WSL 2 in Windows Build 19041 and later.

# How it work

The localhost port actually forward by `wslhost.exe` on Windows, but it listen on localhost only.

WSLHostPatcher will scan all `wslhost.exe` processes, then inject into it to hook `bind` API  listen on any IP.

There is no any background processes neither cost any performance.

# How to use

Download [release](https://github.com/CzBiX/WSLHostPatcher/releases/latest) and unzip it on Windows. Run `WSLHostPatcher.exe` after WSL2 started.

This patch needs to running on every time WSL starts, and only the ports listening after running patch will work.

You can also do one of the following two things to make it run automatically:

1. put it in your `.profile` - see [#1](https://github.com/CzBiX/WSLHostPatcher/issues/1).

2. put it in `/etc/wsl.conf` (suitable for auto-run services like ssh - runs on boot):

```

[boot]

command=

```

# How to restore

`wsl --shutdown` or Reboot system.

# Security Consideration

Listen port on any interfaces may cause some security problems. You are on your own.

Anti-virus software may alert, see [discussion](https://github.com/CzBiX/WSLHostPatcher/discussions/16).