Skip to content

High-performance multi-path covert channel over DNS in Rust with vibe coding

License

Notifications You must be signed in to change notification settings

Fox-Fig/slipstream-rust-plus

 
 

🚀 Slipstream Rust Plus

License Build Status Version

🇮🇷 فارسی (Persian) | 🤝 Contributing | 🐛 Report Bug

The Ultimate Anti-Censorship DNS Tunnel.
Bypass strict firewalls and enjoy high-speed internet using the power of QUIC over DNS.


⚡ What is this?

Imagine your internet traffic is a letter. Firewalls read the envelope and throw it away if they don't like the address.
Slipstream Rust Plus puts your letter inside a "DNS Envelope". Firewalls think it's just a normal address lookup (like asking "where is google.com?") and let it pass. Inside that envelope is your high-speed internet connection!

📈 Why "Plus"?

We took the original Slipstream and gave it superpowers:

  • 🚀 50x Faster: Optimized for blazing fast speeds up to 4Gbps!
  • 🛡️ Unblockable: Uses Multi-Resolver technology to dodge censorship.
  • 🧠 Smart: Automatically adjusts to your network quality (Adaptive MTU).
%%{init: {'theme': 'dark'}}%%
xychart-beta
    title "Download Speed Comparison (MB/s)"
    x-axis ["dnstt", "Slipstream (C)", "Rust (Auth)", "Rust Plus"]
    y-axis "MB/s"
    bar [4.01, 9.12, 24.57, 512]
Loading

🛠️ Easy Installation (Beginner Friendly)

Follow these simple steps to get started. You don't need to be a coding wizard! 🧙‍♂️

1. Install Requirements

Open your Terminal (Ctrl+Alt+T) and run this command to install the necessary tools:

# Ubuntu / Debian
sudo apt update && sudo apt install -y build-essential cmake pkg-config libssl-dev git rustc cargo

# Arch Linux
sudo pacman -S base-devel cmake openssl git rust

2. Download the Project

Now, let's get the code:

git clone https://github.com/Fox-Fig/slipstream-rust-plus.git
cd slipstream-rust-plus
git submodule update --init --recursive

3. Build It!

Turn the code into a working program (this might take a few minutes for the first time):

cargo build -p slipstream-client -p slipstream-server --release

🚀 How to Run

Client (Your Computer)

To bypass censorship effectively, we use multiple DNS servers (Resolvers). This makes your connection rock solid! 💪

Run this command:

./target/release/slipstream-client \
  --domain example.com \
  --resolver 1.1.1.1 \
  --resolver 8.8.8.8 \
  --resolver 9.9.9.9 \
  --tcp-listen-port 5201

🔍 What do these mean?

  • --domain: The fake domain we use for the tunnel (match this with your server).
  • --resolver: The DNS servers we talk to. The more, the better!
  • --tcp-listen-port: The port where your high-speed internet will appear locally.

Server (Remote VPS)

On your server outside the firewall:

./target/release/slipstream-server \
  --domain example.com \
  --target-address 127.0.0.1:5201 \
  --cert ./cert.pem \
  --key ./key.pem \
  --reset-seed ./reset-seed

📐 How it Works (Visualized)

graph LR
    User[👤 You] --> Client[My Computer]
    Client --> R1[DNS 1.1.1.1]
    Client --> R2[DNS 8.8.8.8]
    Client --> R3[DNS 9.9.9.9]
    R1 --> Server[☁️ Remote VPS]
    R2 --> Server
    R3 --> Server
    Server --> World[🌍 The Internet]
Loading

⚖️ License

This project is licensed under the GNU General Public License v3.0 (GPLv3).
Portions of this software are based on work originally licensed under the Apache License 2.0.

License Exception for Upstream Contribution:
Although this project is licensed under GPLv3, the author grants the maintainers of the original upstream project (Mygod/slipstream-rust) the right to include, distribute, and modify the contributions made in this fork under the terms of the Apache License 2.0.


Made with ❤️ at FoxFig

Dedicated to all people of Iran 🇮🇷

About

High-performance multi-path covert channel over DNS in Rust with vibe coding

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 74.7%
  • Shell 12.2%
  • Python 7.9%
  • C 5.2%