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

中文文档

• 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

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

1. Copy _worker.js code from here

2. Or click the button below to deploy directly:

   

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.

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.

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
   

• 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

• 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.

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.

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

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

Set in Cloudflare Dashboard environment variables (recommended method)

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

Use the following link for auto configuration:

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

• 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]

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]

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

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

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"

Supports the following formats:

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

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

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

• Random selection
• Automatic failover
• Support mixed authentication methods

Enable SOCKS5 global relay:

SOCKS5_RELAY=true

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

• 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

Configure environment variables in Workers settings page

Configure environment variables in Pages settings page

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

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

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