Skip to content

Enable TLS tunnel to bypass UDP blockings in restricted regions#91

Closed
amirhmoradi wants to merge 98 commits into
NOXCIS:bug-huntingfrom
amirhmoradi:claude/issue-63-wiregate-011CUojiMSEFd7Dk6nbaCrhn
Closed

Enable TLS tunnel to bypass UDP blockings in restricted regions#91
amirhmoradi wants to merge 98 commits into
NOXCIS:bug-huntingfrom
amirhmoradi:claude/issue-63-wiregate-011CUojiMSEFd7Dk6nbaCrhn

Conversation

@amirhmoradi

Copy link
Copy Markdown

The TLS tunnel feature allows WireGuard traffic to be wrapped in TLS encryption, helping bypass UDP blockings and Deep Packet Inspection (DPI) in restrictive network environments. This is particularly useful in regions where UDP traffic is blocked or heavily throttled.

NOXCIS and others added 24 commits March 11, 2025 02:27
-no one ever reads the commit notes
Added details about unsafe inline CSS and public keys to the Traffic Shaping bug fixes entry.
Added details for sol-beta-v2.5.3 release including theme updates, logo update, UI bug fixes, and Tor Protocol Badge.
Added warning for beta version and updated theme, logo, and UI.
Added details for flat-bridge-v0.0.1 release including Dockerfile updates, security enhancements, and frontend improvements.
Added release notes for versions v0.0.2, v0.0.3, and v1.5.0.
Implements optional TLS tunneling using udptlspipe to wrap WireGuard
UDP traffic in TLS encryption, helping bypass DPI and UDP restrictions
in censored environments.

Key Features:
- Optional TLS tunnel via udptlspipe container
- Docker profile-based activation (backward compatible)
- Interactive configuration in Advanced installation mode
- Password-protected TLS connections
- Configurable TLS port (default: 443)
- Comprehensive client setup documentation

Changes:
- docker-compose.yml: Add udptlspipe service with profile support
- install.sh: Add TLS environment variables and profile handling
- WG-Dash-ENV-setup.sh: Add TLS configuration functions with
  interactive prompts for enabling, port, and password setup
- README.md: Add TLS feature announcement and documentation links
- Docs/TLS-TUNNEL-SETUP.md: Complete setup guide covering server
  and client configuration for multiple platforms

Implementation Details:
- Uses ghcr.io/ameshkov/udptlspipe:latest Docker image
- Deployed at 10.2.0.5 in private_network
- Only starts when WGD_TLS_ENABLED=true
- Forwards to first WireGuard port (WGD_PORT_RANGE_STARTPORT)
- Environment variables saved to .env file
- Non-invasive design preserving existing UDP functionality

Client Support:
- Docker-based setup (recommended)
- Standalone binary installation
- Android via Termux
- MTU=1280 requirement documented
- Server IP exclusion from tunnel explained

Addresses issue NOXCIS#63: UDP traffic blocking in restrictive regions

Co-authored-by: amirhmoradi
@NOXCIS

NOXCIS commented Nov 5, 2025

Copy link
Copy Markdown
Owner

@amirhmoradi Cool I'll review and take a look this weekend.

@amirhmoradi amirhmoradi force-pushed the claude/issue-63-wiregate-011CUojiMSEFd7Dk6nbaCrhn branch from 0a5cb61 to 3ce7f19 Compare November 6, 2025 22:06
@NOXCIS NOXCIS changed the base branch from main to bug-hunting November 7, 2025 00:10
@amirhmoradi

Copy link
Copy Markdown
Author

Closing in favor of #101 which is correctly based on bug-hunting.

@amirhmoradi amirhmoradi deleted the claude/issue-63-wiregate-011CUojiMSEFd7Dk6nbaCrhn branch November 11, 2025 16:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants