A high-performance intranet penetration platform

README  |  简体中文  |  Documentation

Introduction

etp (Easy Tunnel Proxy) is a high-performance intranet penetration platform.

• 🚀 Support for TCP and HTTP protocol proxying
• ⚡ Data compression transmission, reducing bandwidth consumption
• 🔄 TCP multiplexing stream transmission, multiple requests over single physical connection
• 🔒 mTLS mutual authentication for secure data transmission
• 🛡️ IP CIDR access control (whitelist/blacklist)
• 🔑 HTTP BasicAuth authentication, Token-based identity verification
• 📉 Fine-grained bandwidth rate limiting and traffic management
• ⚖️ Load balancing and cluster proxy support, enhancing system availability
• 🌐 Custom domain and subdomain routing support
• 📊 Built-in modern Web UI dashboard for visual management and operational monitoring
• 🔌 Spring Boot integration, reducing development and testing costs
• 💻 Compatible with Windows, Linux, and macOS for cross-platform deployment
• 📚 Client-autonomous + server-centralized management configuration rules for simplified administration

Quick Start

Server Installation

Requirements:

• Docker 20+
• Linux x86_64

One-command Docker startup for etps server:

curl -fsSL https://raw.githubusercontent.com/xiaoniucode/etp/main/scripts/install.sh -o install.sh
chmod +x install.sh
sudo sh install.sh

Management dashboard access: http://server_ip:8020 (admin: 123456)

Client Installation

Download the latest version from the GitHub Releases page and select the binary file for your operating system.

After extracting locally, edit the configuration file etpc.toml:

server_addr = "etps server IP or domain"
[auth]
token = "authentication token"

Run the client:

./etpc -c etpc.toml # Linux / MacOS

etpc.exe -c etpc.toml # Windows

For more usage details, please refer to the documentation website.

Feedback

Report issues: issues

Project Trends