Status: Beta 🚧
An AI-driven VPN tunnel written in Rust with automatic path selection: IPv6 direct → STUN hole punching → relay fallback.
- Dual-Path P2P — IPv6 direct + STUN hole punching with auto-fallback to relay
- Smart Routing — automatic path selection, no manual configuration needed
- Multi-Tenant — cluster-based isolation for teams and environments
- Encryption — ChaCha20-Poly1305 (default), AES-256-GCM, XOR
- CIDR Mapping — resolve overlapping subnets (Linux only)
- Cross-Platform — Linux, macOS, Windows
curl -fsSL https://raw.githubusercontent.com/smartethnet/rustun/main/install.sh | sudo bash
sudo vim /etc/rustun/server.toml
sudo vim /etc/rustun/routes.json
sudo systemctl enable --now rustun-serversudo ./client -s SERVER_IP:8080 -i client-identity- Login at rustun.beyondnetwork.cn and create a client identity
- Download the binary from GitHub Releases
- Connect:
sudo ./client -s rustun.demo.beyondnetwork.cn:18080 -i <your-identity> -c xor:rustun@smartethnet.github.io
Mobile: iOS/macOS TestFlight
| Topic | File |
|---|---|
| Configuration (server.toml, routes.json, multi-tenant) | doc/CONFIGURATION.md |
| Usage (client options, encryption, P2P, Windows) | doc/USAGE.md |
| Build from source & cross-compilation | BUILD.md |
| Protocol & architecture | PROTOCOL.md |
| Contributing | CONTRIBUTING.md |
- IPv6 P2P direct connection
- STUN hole punching (NAT traversal)
- Dual-path networking with intelligent failover
- Real-time connection monitoring
- Dynamic route updates (no restart needed)
- Web-based management dashboard
- Mobile & Desktop clients (Android/iOS/Windows/macOS)
- QUIC protocol support
- Docker images & Kubernetes operator
- Windows service support
- Auto-update mechanism
Thanks to everyone who has contributed to Rustun!
Contributions are welcome — see CONTRIBUTING.md to get started.
Built with Tokio, RustCrypto, and tun-rs.
Note: This is an experimental project. Use at your own risk in production.