tun2socks

module

v2.0.0 Latest Latest Go to latest Published: Oct 6, 2025 License: MIT

Details

Universal Proxying: Transparently routes all network traffic from any application through a proxy.
Multi-Protocol: Supports HTTP/SOCKS4/SOCKS5/Shadowsocks proxies with optional authentication.
Cross-Platform: Runs on Linux/macOS/Windows/FreeBSD/OpenBSD with platform-specific optimizations.
Gateway Mode: Acts as a Layer 3 gateway to route traffic from other devices on the same network.
Full IPv6 Compatibility: Natively supports IPv6; seamlessly tunnels IPv4 over IPv6 and vice versa.
User-Space Networking: Leverages the gVisor network stack for enhanced performance and flexibility.

benchmark

For all scenarios of usage, tun2socks performs best. See benchmarks for more details.

Full documentation and technical guides can be found at Wiki.

Welcome and feel free to ask any questions at Discussions.

All versions starting from v2.6.0 are available under the terms of the MIT License.

Path	Synopsis
buffer Package buffer provides a pool of []byte.	Package buffer provides a pool of []byte.
allocator
core
adapter
device
device/channel
device/fdbased
device/iobased Package iobased provides the implementation of io.ReadWriter based data-link layer endpoints.	Package iobased provides the implementation of io.ReadWriter based data-link layer endpoints.
device/tun Package tun provides TUN which implemented device.Device interface.	Package tun provides TUN which implemented device.Device interface.
option
dialer
dns
engine
internal
pool Package pool provides internal pool utilities.	Package pool provides internal pool utilities.
version
log Package log is a thin wrapper based on "go.uber.org/zap".	Package log is a thin wrapper based on "go.uber.org/zap".
metadata
proxy Package proxy provides implementations of proxy protocols.	Package proxy provides implementations of proxy protocols.
proto
restapi
transport
internal/bufferpool
shadowsocks/core
shadowsocks/shadowaead
shadowsocks/shadowstream
simple-obfs Package obfs provides obfuscation functionality for Shadowsocks protocol.	Package obfs provides obfuscation functionality for Shadowsocks protocol.
socks4 Package socks4 provides SOCKS4/SOCKS4A client functionalities.	Package socks4 provides SOCKS4/SOCKS4A client functionalities.
socks5 Package socks5 provides SOCKS5 client functionalities.	Package socks5 provides SOCKS5 client functionalities.
tunnel
statistic