Skip to content

smartethnet/rustun

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

81 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌐 Rustun

AI-Driven Intelligent VPN Tunnel


License: MIT Rust Build Status Release Downloads Stars

🌐 Website Β· δΈ­ζ–‡ζ–‡ζ‘£ Β· πŸ› Issues

iOS macOS Android Windows Linux


Status: Beta 🚧

An AI-driven VPN tunnel written in Rust with automatic path selection: IPv6 direct β†’ STUN hole punching β†’ relay fallback.

✨ Features

  • 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

πŸš€ Quick Start

Server (one-click install)

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-server

Client

sudo ./client -s SERVER_IP:8080 -i client-identity

Try the Demo Server

  1. Login at rustun.beyondnetwork.cn and create a client identity
  2. Download the binary from GitHub Releases
  3. Connect:
    sudo ./client -s rustun.demo.beyondnetwork.cn:18080 -i <your-identity> -c xor:rustun@smartethnet.github.io

Mobile: iOS/macOS TestFlight

Architecture

πŸ“š Documentation

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

πŸ—ΊοΈ Roadmap

  • 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

πŸ‘₯ Contributors

Thanks to everyone who has contributed to Rustun!

Contributors

Contributions are welcome β€” see CONTRIBUTING.md to get started.

πŸ™ Acknowledgments

Built with Tokio, RustCrypto, and tun-rs.


Note: This is an experimental project. Use at your own risk in production.

About

AI-Driven VPN Tunnels

Topics

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors