windtf /wireproxy
Wireguard client that exposes itself as a socks5 proxy
★ 5,897⑂ 417👁 32⑃ 86● 135▤ 14
+2
Daily
5,897
stars
417
forks
32
watchers
86
prs
135
issues
14
releases
README
wireproxy
A wireguard client that exposes itself as a socks5/http proxy or tunnels.
What is this
wireproxy is a completely userspace application that connects to a wireguard peer,
and exposes a socks5/http proxy or tunnels on the machine. This can be useful if you need
to connect to certain sites via a wireguard peer, but can't be bothered to setup a new network
interface for whatever reasons.
Why you might want this
- You simply want to use wireguard as a way to proxy some traffic.
- You don't want root permission just to change wireguard settings.
Currently, I'm running wireproxy connected to a wireguard server in another country,
and configured my browser to use wireproxy for certain sites. It's pretty useful since
wireproxy is completely isolated from my network interfaces, and I don't need root to configure
anything.
Users who want something similar but for Amnezia VPN can use this fork
of wireproxy by @artem-russkikh.
Feature
- TCP static routing for client and server
- SOCKS5/HTTP proxy (currently only CONNECT is supported)
- Transparent TLS (SNI) proxy
TODO
- UDP Support in SOCKS5
- UDP static routing
Usage
bash
./wireproxy [-c path to config]
bash
usage: wireproxy [-h|--help] [-c|--config ""] [-s|--silent]
[-d|--daemon] [-i|--info ""] [-v|--version]
[-n|--configtest]
Userspace wireguard client for proxying
Arguments:
-h --help Print help information
-c --config Path of configuration file
Default paths: /etc/wireproxy/wireproxy.conf, $HOME/.config/wireproxy.conf
-s --silent Silent mode
-d --daemon Make wireproxy run in background
-i --info Specify the address and port for exposing health status
-v --version Print version
-n --configtest Configtest mode. Only check the configuration file for
validity.
Build instruction
bash
git clone https://github.com/octeep/wireproxy
cd wireproxy
make
Install
bash
go install github.com/windtf/wireproxy/cmd/[email protected] or @latest
Use with VPN
Instructions for using wireproxy with Firefox container tabs and auto-start on MacOS can be found here.
Sample config file
ini
The [Interface] and [Peer] configurations follow the same semantics and meaning
of a wg-quick configuration. To understand what these fields mean, please refer to:
https://wiki.archlinux.org/title/WireGuardPersistent_configuration
https://www.wireguard.com/simple-network-interface
[Interface]
Address = 10.200.200.2/32 The subnet should be /32 and /128 for IPv4 and v6 respectively
MTU = 1420 (optional)
PrivateKey = uCTIK+56CPyCvwJxmU5dBfuyJvPuSXAq1FzHdnIxe1Q=
PrivateKey = $MY_WIREGUARD_PRIVATE_KEY Alternatively, reference environment variables
DNS = 10.200.200.1
[Peer]
PublicKey = QP+A67Z2UBrMgvNIdHv8gPel5URWNLS4B3ZQ2hQIZlg=
PresharedKey = UItQuvLsyh50ucXHfjF0bbR4IIpVBd74lwKc8uIPXXs= (optional)
Endpoint = my.ddns.example.com:51820
PersistentKTop issues
#30UDP Support14 comments · 2022-04-02#33Forward Wireguard traffic to SOCKS server11 comments · 2022-04-05#15Change Socks5 Server Library10 comments · 2022-03-27#54Question about getting started8 comments · 2023-01-13#8Multi-topic: Usage clarification, SOCKS5 auth, rotation policy feature, relatability to Gost7 comments · 2022-03-27#221UDP support desparately needed6 comments · 2026-08-29#84Stops receiving handshake responses5 comments · 2023-08-17#57can it run with command line5 comments · 2023-02-06
Latest release
v1.1.3 v1.1.3 2026-07-16Changelog 10f4bba Add SNI Proxy support (210) eac2e52 Bump golang.org/x/crypto from 0.51.0 to 0.52.0 (214) 27edc92 Bump golang.org/x/net from 0.47.0 to 0.55.0 (212) 31a9a34 Now adds certificate files to the landlock riles (213) 7e755db Resolve bare WGConfig filenames relative to parent config directory. (204) 55dea16 Update sponsor sections in README.md 724aad3 Upgrade golang.zx2c4.com/wireguard to 0.0.20250522 snapshot. (203) b200992 [upd] Update README.md (206) 3f5a95b add assets 4d5d08c fix README 3b5a208 update sponsor aa3aac3 update sponsor