EDtunnel

A proxy tool based on Cloudflare Workers and Pages, supporting multiple protocols and configuration options.

中文文档

Features

• Support for Cloudflare Workers and Pages deployment
• Multiple UUID configuration support
• Custom proxy IP and port support
• SOCKS5 and HTTP proxy support
• Trojan protocol support with auto-detection
• VLESS outbound proxy with full UDP capability
• Multi-proxy rotation with automatic failover
• Automatic configuration subscription link
• URL query parameter configuration override support
• Path-based proxy parameters (/socks5://, /http://, /vless://)
• Simple and easy deployment process

Quick Deployment

Deploy on Pages.dev

1. Watch deployment tutorial video: YouTube Tutorial
2. Clone this repository and deploy in Cloudflare Pages

Deploy on Worker.dev

1. Copy _worker.js code from here

2. Or click the button below to deploy directly:

   

Configuration Guide

Environment Variables

URL Query Parameter Configuration

You can use URL query parameters to directly override environment variable configurations. These parameters have higher priority than environment variables. For security reasons, UUID cannot be set via URL query parameters.

Path-Based Proxy Parameters

You can also configure proxies directly in the URL path:

Security Note: UUID must be set via environment variables or configuration files, not through URL parameters, to prevent unauthorized identity modifications.

Usage Examples

1. Temporarily change proxy IP:

   https://your-domain.workers.dev/?proxyip=another-proxy-ip:port
   

2. Combine multiple parameters:

   https://your-domain.workers.dev/?proxyip=1.1.1.1:443&socks5_relay=true
   

3. Apply to specific paths:

   https://your-domain.workers.dev/sub/your-uuid?proxyip=1.1.1.1:443
   

Feature Notes

• Priority: URL parameters > Environment Variables > Default Values
• Temporary: These changes only apply to the current request and do not permanently modify configurations
• Combinable: Multiple parameters can be combined for complex configuration adjustments
• Use cases: Quick testing, temporary configuration switching, dynamic calls from third-party systems

URL Format Notes

• Ensure query parameters use the correct format: ?parameter=value. The question mark ? should not be URL encoded (%3F).
• If you see URLs like /%3Fproxyip=value, this won't work correctly. Use /?proxyip=value instead.
• This project now supports handling query parameters encoded in the path, but using the standard format is recommended for best compatibility.

Non-443 Port Configuration

1. Visit https://proxyip.edtunnel.best/
2. Enter ProxyIP:proxyport and click Check
3. When showing Proxy IP: true it's available
4. Configure in Worker: PROXYIP=211.230.110.231:50008

Note: Proxy IPs with ports may not work on HTTP-only Cloudflare sites.

UUID Configuration

Method 1

Set in wrangler.toml file (not recommended for public repositories)

[vars]
UUID = "your-uuid-here"

Method 2

Set in Cloudflare Dashboard environment variables (recommended method)

Important Note: Multiple Configuration Separator

All multiple configurations MUST use English comma(,) as separator, NOT Chinese comma(，)

Correct Examples:

# Multiple UUID
UUID=uuid1,uuid2,uuid3

# Multiple SOCKS5 proxies
SOCKS5=192.168.1.1:1080,192.168.1.2:1080

# Multiple PROXYIP
PROXYIP=1.1.1.1:443,2.2.2.2:443

Wrong Examples:

# Wrong: Using Chinese comma
UUID=uuid1，uuid2，uuid3

# Wrong: Using Chinese comma
SOCKS5=192.168.1.1:1080，192.168.1.2:1080

Quick Start

Auto Configuration Subscribe

Use the following link for auto configuration:

https://sub.xf.free.hr/auto

View Configuration

• Visit your domain: https://your-domain.pages.dev
• Use specific UUID: /sub/[uuid]
• View full configuration: visit domain root path
• Get subscription content: visit /sub/[uuid]

Advanced Configuration

Trojan Protocol Support

EDtunnel now supports Trojan protocol alongside VLESS, with auto-detection:

• Default password uses UUID if TROJAN_PASSWORD is not set
• Trojan subscription URLs are generated automatically on the configuration page
• Access Trojan configuration at /sub/[uuid]

HTTP Proxy Support

As an alternative to SOCKS5, you can use HTTP CONNECT proxy:

# Via URL path
https://your-domain.workers.dev/http://user:pass@proxy-host:port/sub/uuid

# Via URL parameter
https://your-domain.workers.dev/?http=user:pass@proxy-host:port

VLESS Outbound Proxy

Route traffic through an external VLESS server with full UDP support:

# Environment variable
VLESS_OUTBOUND=vless://uuid@remote-server:443?type=ws&security=tls&path=/ws

# Via URL path
https://your-domain.workers.dev/vless://uuid@host:port?type=ws&security=tls/sub/your-uuid

# Via URL parameter
https://your-domain.workers.dev/?vless=vless://uuid@host:port

Multiple UUID Support

You can configure multiple UUIDs in these ways:

1. Via environment variables:

   UUID=uuid1,uuid2,uuid3
   

2. Via configuration file:

   [vars]
   UUID = "uuid1,uuid2,uuid3"
   

SOCKS5 Proxy Configuration

Supports the following formats:

• Basic format: host:port
• Authentication format: username:password@host:port
• Multiple proxies (separated by English comma): proxy1,proxy2,proxy3

Configuration Examples

1. Single Proxy:

# Basic format
SOCKS5=192.168.1.1:1080

# With authentication
SOCKS5=user:pass@192.168.1.1:1080

2. Multiple Proxies (separated by English comma):

# Multiple basic proxies
SOCKS5=192.168.1.1:1080,192.168.1.2:1080,192.168.1.3:1080

# Multiple proxies with authentication
SOCKS5=user1:pass1@host1:port1,user2:pass2@host2:port2

# Mixed format
SOCKS5=192.168.1.1:1080,user:pass@192.168.1.2:1080,192.168.1.3:1080

SOCKS5 Proxy Load Balancing

When multiple proxies are configured, the system will automatically perform load balancing:

• Random selection
• Automatic failover
• Support mixed authentication methods

SOCKS5_RELAY Settings

Enable SOCKS5 global relay:

SOCKS5_RELAY=true

Multi-Proxy Rotation and Fallback

When configuring multiple proxy addresses, the system provides:

• Random rotation: Automatically selects from available proxies
• Connection timeout: Configurable via PROXY_TIMEOUT (default: 1500ms)
• Automatic failover: Tries next proxy on failure
• Direct fallback: Falls back to direct connection if all proxies fail (configurable via PROXY_FALLBACK)

# Configure timeout (milliseconds)
PROXY_TIMEOUT=2000

# Disable fallback to direct connection
PROXY_FALLBACK=false

Notes:

• Ensure proxy servers are stable and available
• Recommend using private proxies for better security
• Use commas to separate multiple proxies
• Support dynamic proxy addition and removal

Notes

• Proxy IPs with ports may not work on HTTP-only Cloudflare sites
• Use commas to separate multiple UUIDs
• Recommend setting sensitive information via environment variables
• Update regularly for latest features and security fixes

Environment Variable Settings

Workers.dev Settings

Configure environment variables in Workers settings page

Pages.dev Settings

Configure environment variables in Pages settings page

Get Help

• Telegram Group: EDtunnel Group
• GitHub Repository: EDtunnel
• Issue Report: Create New Issue
• Feature Request: Submit Request

Contributing

Welcome Pull Requests to improve the project! Please ensure:

1. Code follows project standards
2. Add necessary tests
3. Update relevant documentation
4. Clearly describe the reasons for changes

License

This project is licensed under the MIT License - see the LICENSE file for details

Star History