n2n6 - A Peer-to-Peer VPN

July 2, 2026 · View on GitHub

English | 中文版

n2n6 is forked from mxre's n2n, adding STUN hole-punching, bypass proxy, WebSocket transport, traffic statistics and control, optimized transfer speed, and simplified usage.

Quick Start

Supernode server (support for IPv4/IPv6 dual-stack is required)

supernode -l 1234

Edge node 1

edge -a 10.64.0.2 -c mynetwork -k secret -A4 -l supernode.example.com:1234

Edge node 2

edge -a 10.64.0.3 -c mynetwork -k secret -A4 -l supernode.example.com:1234

That's it — node 1 and node 2 can now communicate. By default, P2P direct connection is preferred; if that fails, traffic automatically falls back to relay through the supernode. If UDP is blocked on your network, add -w to enable WebSocket relay.

Key Features

FeatureDescription
WebSocket mode (-w)Connect via supernode over TCP/WS, bypass NAT
Multiple ciphers-A1 (none), -A2 (Twofish), -A3 (AES), -A4 (ChaCha20), -A5 (Speck)
Peer-to-PeerDirect connection after hole-punching (default)
IPv4/IPv6 dual stackTransport and inner addressing
Auto IP assignmentPer-community IP pool (10.64.0.x), no DHCP needed
Packet forwarding (-r)Route traffic through the n2n community
Traffic stats & rate limiting (-L)Supernode per-community 24h/30d stats

Management Interface

Edge (default port 5664)

edge -Q 5664 # or nc -u 127.0.0.1 5664

Supernode (default port 5646)

supernode -Q 5646 # or nc -u 127.0.0.1 5646

Build from Source

git clone https://github.com/lucktu/n2n6.git
cd n2n6 && mkdir build && cd build
cmake -G 'Unix Makefiles' -DCMAKE_BUILD_TYPE=Release ../
make
sudo make install

Platform Notes

Linux

  • Drop privileges with -u <uid> -g <gid>
  • Systemd service examples in packages/systemd/
  • Foreground: -f; daemon logs go to syslog

Windows

macOS

  • Uses built-in utun interface, no extra TAP driver needed
  • setcap not supported on macOS; requires root

Android

Documentation

  • Man pages: doc/edge.8, doc/supernode.1, doc/n2n_v2.7
  • Changelog: NEW_FEATURES.md