Elahe Tunnel

A censorship circumvention tool that disguises network traffic as Google search packets.

Elahe Tunnel is an experimental tool designed to bypass sophisticated Deep Packet Inspection (DPI) systems by camouflaging data packets to look like legitimate Google search queries and results. It's built for scenarios where internet access is heavily restricted or monitored.

💡 How It Works

The core idea is to create a tunnel between two servers: an internal node (inside the censored network, e.g., Iran) and an external node (with unrestricted internet access, e.g., Germany).

1. External Node (Exit Point): This server waits for incoming connections. When it receives a packet that looks like a Google search, it extracts the hidden data, forwards it to the public internet, gets the response, and then wraps that response inside a fake Google search results HTML page to send back.

2. Internal Node (Relay): This server takes TCP traffic from a local user, encrypts it, and wraps it into a packet that mimics a Google search query. It then sends this to the external node.

This masquerading technique aims to make the traffic pattern indistinguishable from regular web browsing, thus evading detection by automated censorship systems.

🚀 Getting Started

Installation

You can install and configure Elahe Tunnel with a single command. This script automatically handles dependencies, Go installation, and setup.

bash <(curl -s -L https://raw.githubusercontent.com/ehsanking/elahe-tunnel/main/install.sh)

The script will:

1. Check and install necessary dependencies (Go, unzip, curl).
2. Download the latest source code.
3. Compile the application.
4. Launch the interactive setup wizard.

Usage

After installation, you can manage the tunnel using the elahe-tunnel command:

• Run the tunnel: elahe-tunnel run
• Re-configure: elahe-tunnel setup
• Check status: elahe-tunnel status

Step 3: Check the Tunnel Status

You can check the status of the connection at any time on either server.

elahe-tunnel status

Example Output:

Checking tunnel status...
Status: Active

Commands

• elahe-tunnel setup [internal | external]: Configure the server node.
• elahe-tunnel status: Check the tunnel's connection status.
• elahe-tunnel version: Show the current version of the tool.

🤝 Contributing

This project is in its early stages (v0.0.1), and contributions are highly welcome. Feel free to open an issue to report bugs, suggest features, or submit a pull request.

Special thanks to EhsanKing for the original idea and technical analysis.

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.