Skip to content
egorlepaPublic

About

selective traffic routing through transparent proxy

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

165 Commits

Folders and files

Repository files navigation

netshunt

Selective traffic routing through a transparent proxy for Keenetic routers.

netshunt routes specific domains, IPs, and CIDRs through a transparent proxy while everything else uses the default connection. It runs on Keenetic routers with Entware and manages the entire split-tunneling pipeline: DNS resolution, ipset population, and iptables redirection.

Features

  • Shunt-based routing - organize domains, IPs, and CIDRs into named shunts, enable/disable entire shunts at once
  • Geosite integration - import curated domain categories from the v2fly domain-list-community (google, netflix, facebook, and 1400+ more)
  • Web dashboard - manage shunts, browse geosite categories, view status, adjust settings, run diagnostics
  • HTTP API - full API for scripting and automation
  • Encrypted DNS - the built-in forwarder resolves over DNS-over-HTTPS (Google, Cloudflare and Quad9 by default, queried in parallel, first answer wins) with a response cache; no separate resolver to install
  • Automatic IP tracking - DNS forwarder populates ipset in real-time; tracked IPs persist until the domain is removed or the daemon restarts
  • TCP + UDP - NAT REDIRECT for TCP, TPROXY for UDP. IPv4 only (AAAA queries are answered with an empty answer to prevent IPv6 bypass)
  • Keenetic integration - NDM hooks restore rules on reboots, WAN changes, interface restarts
  • Multi-interface / road-warrior - apply the same shunt routing to extra ingress interfaces (e.g. an AmneziaWG/WireGuard TUN) via network.additional_interfaces, so remote VPN clients hit the same bypass list as the LAN
  • Proxy-agnostic - redirects to a local port, any transparent proxy works

How It Works

flowchart LR
    Client([LAN Client])
    Client -->|DNS query| forwarder[netshunt forwarder :53]
    forwarder -->|DoH| upstream((DoH Upstreams))
    forwarder -.->|matched| ipset4[(ipset bypass)]

    Client -->|TCP / UDP| iptables{iptables}
    iptables -->|match ipset| proxy[Transparent Proxy :1080]
    iptables -->|no match| direct((Default Route))
    proxy -->|tunnel| internet((Internet))
Loading

Quick Start

# Download the latest IPK from GitHub Releases
opkg install netshunt_x.x.x_aarch64.ipk

# Run the interactive setup wizard
netshunt setup

# Open the web UI at http://<router-ip>:8765 to add domains

Requirements

  • Keenetic router with Entware (aarch64)
  • A transparent proxy listening on a local port (e.g. Shadowsocks, xray, sing-box, Hysteria 2)
  • SSH access to the router

System dependencies (ipset, iptables, conntrack) are installed automatically as opkg dependencies.

Known Limitations

  • DNS that bypasses the router is invisible. Routing decisions are made from the DNS answers the built-in forwarder sees. A client that resolves names elsewhere (browser or OS DNS-over-HTTPS, Android Private DNS, a hard-coded resolver over IPv6, applications with pinned IP addresses) connects to addresses netshunt never learned about, and that traffic goes direct. Blocking port 853 or known DoH endpoints on the router would only cover part of it, so netshunt does not try; disable private DNS on the clients instead, or add the addresses as static IP/CIDR entries. The forwarder does answer Mozilla's canary domain use-application-dns.net with NXDOMAIN, which keeps Firefox from switching DNS over HTTPS on by itself; DoH enabled by hand in the browser ignores the canary. Symptom of a client on its own DoH: sites behind a shunt work on some devices and not on others, or only sometimes, because the addresses enter the ipset only when another client resolves them.
  • IPv4 only. AAAA queries are answered empty on purpose; a network with global IPv6 would route around the proxy.

Building from Source

Requires Go 1.25+ and Mage.

# Build for host platform
mage build

# Cross-compile for router (aarch64)
mage buildRouter

# Build IPK package
mage package

# Run tests
mage test

License

MIT

About

selective traffic routing through transparent proxy

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages