EDtunnel

January 26, 2026 · View on GitHub

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

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

Deploy on Worker.dev

Copy _worker.js code from here
Or click the button below to deploy directly:

Configuration Guide

Environment Variables

Variable	Required	Example	Description
`UUID`	No	Single: `12345678-1234-1234-1234-123456789012` Multiple: `uuid1,uuid2,uuid3`	User identification
`PROXYIP`	No	`1.1.1.1` or `example.com` Multiple: `1.1.1.1:9443,2.2.2.2:8443`	Custom proxy IP and port
`SOCKS5`	No	`user:pass@host:port` Multiple: `user1:pass1@host1:port1,user2:pass2@host2:port2`	SOCKS5 proxy configuration
`SOCKS5_RELAY`	No	`true` or `false`	Enable SOCKS5 traffic relay
`TROJAN_PASSWORD`	No	`your-password`	Trojan password (defaults to UUID if not set)
`VLESS_OUTBOUND`	No	`vless://uuid@host:port?type=ws&security=tls`	VLESS outbound proxy URL
`PROXY_TIMEOUT`	No	`1500`	Proxy connection timeout in ms (default: 1500)
`PROXY_FALLBACK`	No	`true` or `false`	Fallback to direct connection if proxies fail (default: true)

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.

Query Parameter	Corresponding ENV	Example	Description
`proxyip`	`PROXYIP`	`?proxyip=1.1.1.1:443`	Override proxy IP and port
`socks5`	`SOCKS5`	`?socks5=user:pass@host:port`	Override SOCKS5 proxy configuration
`http`	-	`?http=user:pass@host:port`	HTTP CONNECT proxy configuration
`vless`	`VLESS_OUTBOUND`	`?vless=vless://uuid@host:port`	Override VLESS outbound proxy
`globalproxy`	-	`?globalproxy`	Enable global proxy mode (route all traffic)

Path-Based Proxy Parameters

You can also configure proxies directly in the URL path:

Path Format	Example	Description
`/proxyip=`	`/proxyip=1.1.1.1:443`	Set proxy IP via path
`/socks5://`	`/socks5://user:pass@host:port`	SOCKS5 proxy via path
`/http://`	`/http://user:pass@host:port`	HTTP CONNECT proxy via path
`/vless://`	`/vless://uuid@host:port?...`	VLESS outbound via path
`/gvless=`	`/gvless=base64-encoded-url`	VLESS outbound (global, base64 encoded)

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

Usage Examples

Temporarily change proxy IP:

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

Combine multiple parameters:

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

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

Visit https://proxyip.edtunnel.best/
Enter ProxyIP:proxyport and click Check
When showing Proxy IP: true it's available
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

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:

Via environment variables:
```
UUID=uuid1,uuid2,uuid3
```
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

Single Proxy:

# Basic format
SOCKS5=192.168.1.1:1080

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

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 workers

Pages.dev Settings

Configure environment variables in Pages settings page pages

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:

Code follows project standards
Add necessary tests
Update relevant documentation
Clearly describe the reasons for changes

License

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