windtf /wireproxy

Wireguard client that exposes itself as a socks5 proxy

★ 5,897⑂ 417👁 32⑃ 86● 135▤ 14
GoISCCreated 2022-03-11
下载:v1.1.3v1.1.3 ↓1.1.32026-07-16
+2
日增长
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
 PersistentK

Top issues

Latest release

v1.1.3 v1.1.3 2026-07-16
Changelog
 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON