# xjasonlyu/tun2socks

tun2socks - powered by gVisor TCP/IP stack

Repository: https://github.com/xjasonlyu/tun2socks
Canonical: https://ross.abutalabs.com/products/tun2socks
Homepage: https://github.com/xjasonlyu/tun2socks/wiki
Language: Go
License: MIT
License Family: permissive
Topics: golang, tun2socks, socks5, gvisor, tcpip-stack, shadowsocks, go, tun-device, wireguard, udp, socks4, nat, tor, proxy, ssh-tunnel, http-proxy, ssh, proxifier
Last push: 2026-08-08T01:50:04+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 60, longevity 100
- inputs: {"age_days": 2605, "days_push": 26, "days_rel": 52, "gap_med": 399, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5461, forks 644 (observed 2026-08-28T04:09:19.522972+00:00)

## What it is
A Go-based tool that transparently routes all network traffic from any application through a proxy (SOCKS4/5, HTTP, Shadowsocks, SSH, WireGuard) using a TUN device and the gVisor user-space TCP/IP stack. It runs cross-platform and can act as a Layer 3 gateway for other devices on the network.

## Use cases
- route all system traffic through a socks5 proxy
- force applications without proxy support through a proxy
- tunnel traffic through shadowsocks or ssh
- share a proxy connection with other devices on the LAN
- proxy UDP and TCP traffic over a TUN interface
- set up a transparent proxy gateway on linux

## When to choose
- you need transparent, system-wide proxying across Linux, macOS, Windows, or BSD
- you want to proxy apps that don't natively support proxies
- you need a Layer 3 gateway to share a proxy with other devices
- you need IPv6 support and user-space networking without kernel modules

## When to avoid
- you only need per-application proxy configuration rather than system-wide routing
- you need a full VPN solution with encryption and key management rather than proxy tunneling
- you want a GUI-based proxy client
- you need deep packet inspection or traffic filtering rules

## Facets
- artifact type: cli-tool
- maturity: active
- function: proxy, networking, vpn, routing
- domain: networking, privacy, security
- platform: windows, bsd, go, cli
- tags: tun2socks, gvisor, socks5, shadowsocks, wireguard, transparent-proxy, tun-device, gateway-mode, ipv6, command-line, linux, macos, docker

## Member repositories
- xjasonlyu/tun2socks (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:19.522972+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:56:46.706571+00:00, confidence not recorded.
  - readme: https://github.com/xjasonlyu/tun2socks (fetched 2026-08-28T04:09:19.522972+00:00, sha 872b3e3cb708)
  - homepage: https://github.com/xjasonlyu/tun2socks/wiki (fetched 2026-08-29T08:51:46.814115+00:00, sha fd69df5429f3)
- Data as of 2026-08-30T08:39:29.467469+00:00.