40 lines
1.9 KiB
Markdown
40 lines
1.9 KiB
Markdown
# wireguard-proxy
|
|
|
|
Proxy wireguard UDP packets over TCP/TLS
|
|
|
|
`wireguard-proxy` has 2 modes:
|
|
- server-side daemon to accept TCP connections from multiple clients and pipe data to and from the specified UDP port
|
|
- client-side daemon that accepts UDP packets on a local port from a single client, connects to a single remote TCP port, and pipes data between them
|
|
|
|
Testing:
|
|
|
|
- `udp-test` is a utility to send a UDP packet and then receive a UDP packet and ensure they are the same, this verifies packets sent through proxy server/client are unmolested
|
|
- `udp-test -s` runs udp-test against itself through proxy server/client by spawning actual binaries
|
|
- `udp-test -is` runs udp-test against itself through proxy server/client in same executable by using library, so does not test command line parsing etc
|
|
- `test.sh` runs udp-test against itself, the udp-test self tests above, and through proxy server/client in the shell script
|
|
|
|
Testing with GNU netcat:
|
|
|
|
- `nc -vulp 51820` listen on udp like wireguard would
|
|
- `nc -u -p 51821 127.0.0.1 51820` connect directly to local udp wireguard port to send data to 51820 from port 51821
|
|
- `nc -vlp 5555` listen on tcp like wireguard-proxy would
|
|
- `nc 127.0.0.1 5555` connect directly to local tcp wireguard-proxy port to send/recieve data
|
|
- so to test through wireguard-proxy run first and last command while it's running, type in both places
|
|
|
|
# License
|
|
|
|
This project is licensed under either of
|
|
|
|
* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or
|
|
http://www.apache.org/licenses/LICENSE-2.0)
|
|
* MIT license ([LICENSE-MIT](LICENSE-MIT) or
|
|
http://opensource.org/licenses/MIT)
|
|
|
|
at your option.
|
|
|
|
### Contribution
|
|
|
|
Unless you explicitly state otherwise, any contribution intentionally submitted
|
|
for inclusion in die by you, as defined in the Apache-2.0 license, shall be
|
|
dual licensed as above, without any additional terms or conditions.
|