# wangyu-/udp2raw

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/wangyu-udp2raw).**

8,505 stars · 1,276 forks · C++ · MIT

## Links

- GitHub: https://github.com/wangyu-/udp2raw
- awesome-repositories: https://awesome-repositories.com/repository/wangyu-udp2raw.md

## Topics

`bypass-firewall` `fake-header` `faketcp` `icmp` `icmp-tunnel` `icmptunnel` `raw-socket` `raw-tunnel` `tcp` `tunnel` `udp` `udp-tunnel`

## Description

udp2raw is a network tunneling tool designed to bypass firewalls and obfuscate UDP traffic. It wraps UDP packets in alternative headers and utilizes raw socket networking to move data through networks that otherwise block or throttle UDP traffic.

The project distinguishes itself by simulating TCP connections, mimicking the three-way handshake and sequence numbering to trick firewalls into treating UDP streams as TCP traffic. It further stabilizes these connections through heartbeat-driven port rotation, which automatically switches ports to recover sessions after detected failures.

The tool provides a comprehensive security suite including symmetric-key encryption, HMAC-based traffic authentication, and sliding-window replay protection. It also supports UDP connection multiplexing to route multiple independent conversations through a single shared raw tunnel.

Operational control is managed via a command-line interface and a FIFO-pipe for asynchronous process management, supported by a configurable system logging utility.

## Tags

### Networking & Communication

- [UDP Tunneling](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-proxying-tools/network-proxies/udp-tunneling.md) — Wraps UDP packets in alternative headers to tunnel traffic through firewalls and restrictive NAT environments. ([source](https://github.com/wangyu-/udp2raw#readme))
- [Firewall Bypass Utilities](https://awesome-repositories.com/f/networking-communication/firewall-bypass-utilities.md) — Circumvents local packet filters and firewall rules by sending packets at the OSI link level. ([source](https://github.com/wangyu-/udp2raw#readme))
- [Raw Socket Injection](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-routing-traffic-management/packet-capture-utilities/raw-socket-injection.md) — Utilizes raw socket networking to bypass system firewalls and standard transport socket limitations. ([source](https://github.com/wangyu-/udp2raw/blob/unified/pcap_wrapper.cpp))
- [Packet Authentication](https://awesome-repositories.com/f/networking-communication/packet-engines/packet-authentication.md) — Ensures data integrity and authenticity by appending HMAC cryptographic hashes to every tunneled packet.
- [Packet Injection Engines](https://awesome-repositories.com/f/networking-communication/packet-injection-engines.md) — Utilizes raw sockets to construct and inject network packets at the link layer, bypassing system firewalls.
- [Restrictive Network Connectivity](https://awesome-repositories.com/f/networking-communication/restrictive-network-connectivity.md) — Ensures communication stability in restrictive environments via heartbeats and automatic port rotation. ([source](https://github.com/wangyu-/udp2raw/blob/unified/README.md))
- [Raw](https://awesome-repositories.com/f/networking-communication/socket-networking/raw.md) — Sends network packets at the link layer to circumvent local system firewalls and standard socket limitations.
- [Encrypted Raw Sockets](https://awesome-repositories.com/f/networking-communication/socket-networking/secure-socket-wrappers/encrypted-raw-sockets.md) — Sends encrypted data packets at the link level to bypass system firewalls and socket limitations.
- [Fake-TCP Tunneling](https://awesome-repositories.com/f/networking-communication/tcp-protocol-implementations/tcp-tunneling/fake-tcp-tunneling.md) — Mimics the TCP three-way handshake and sequence numbering to bypass firewalls while delivering real-time UDP traffic. ([source](https://github.com/wangyu-/udp2raw/blob/unified/README.md))
- [Protocol Simulation](https://awesome-repositories.com/f/networking-communication/traffic-routing/tcp-and-udp-forwarders/udp-over-tcp-encapsulations/protocol-simulation.md) — Wraps UDP traffic in fake TCP headers and mimics handshakes to bypass firewalls that block UDP.
- [TCP Handshake Simulation](https://awesome-repositories.com/f/networking-communication/traffic-routing/tcp-and-udp-forwarders/udp-over-tcp-encapsulations/tcp-handshake-simulation.md) — Implements a fake TCP three-way handshake and sequence numbering to bypass firewalls by mimicking TCP traffic.
- [TCP State Simulation](https://awesome-repositories.com/f/networking-communication/traffic-routing/tcp-and-udp-forwarders/udp-over-tcp-encapsulations/tcp-state-simulation.md) — Mimics TCP connection states and sequence numbers to trick firewalls into treating UDP streams as TCP connections.
- [Connection Keepalives](https://awesome-repositories.com/f/networking-communication/connection-keepalives.md) — Maintains active network connections through periodic heartbeats and timeout monitoring. ([source](https://github.com/wangyu-/udp2raw/blob/unified/server.cpp))
- [Connection Multiplexing](https://awesome-repositories.com/f/networking-communication/connection-multiplexing.md) — Bundles multiple logical UDP data streams into a single physical raw connection. ([source](https://github.com/wangyu-/udp2raw#readme))
- [Connection Multiplexing](https://awesome-repositories.com/f/networking-communication/network-tunnels/tunnel-managers/connection-multiplexing.md) — Routes multiple independent UDP conversations through a single shared raw tunnel using unique identifiers. ([source](https://github.com/wangyu-/udp2raw/blob/unified/connection.h))
- [Automatic Port Rotation](https://awesome-repositories.com/f/networking-communication/udp-proxies/udp-port-mapping-stabilization/heartbeat-driven-nat-maintenance/automatic-port-rotation.md) — Automatically rotates ports to recover sessions after heartbeats detect a connection failure.
- [UDP Protocol Multiplexing](https://awesome-repositories.com/f/networking-communication/udp-session-management/udp-protocol-multiplexing.md) — Multiplexes several UDP conversations into a single raw tunnel for efficient endpoint routing.
- [UDP Session Multiplexing](https://awesome-repositories.com/f/networking-communication/udp-session-management/udp-protocol-multiplexing/udp-session-multiplexing.md) — Maps multiple independent UDP conversations into a single raw tunnel using unique identifiers for routing.

### Security & Cryptography

- [Network Traffic Obfuscators](https://awesome-repositories.com/f/security-cryptography/network-traffic-obfuscators.md) — Encrypts and masks UDP streams to hide communication patterns and evade deep packet inspection.
- [Encrypted Tunneling](https://awesome-repositories.com/f/security-cryptography/encrypted-tunneling.md) — Establishes secure, encrypted connections designed specifically to bypass network restrictions. ([source](https://github.com/wangyu-/udp2raw#readme))
- [Secure Tunneling](https://awesome-repositories.com/f/security-cryptography/secure-tunneling.md) — Encrypts tunneled data using a shared password to protect privacy and bypass restrictions. ([source](https://github.com/wangyu-/udp2raw/blob/unified/example.conf))
- [Symmetric Encryption](https://awesome-repositories.com/f/security-cryptography/symmetric-encryption.md) — Obfuscates tunneled data using symmetric-key block ciphers to prevent inspection by intermediaries.
- [Traffic Encryption](https://awesome-repositories.com/f/security-cryptography/traffic-encryption.md) — Provides encryption for data in transit to prevent detection and ensure communication privacy. ([source](https://github.com/wangyu-/udp2raw/blob/unified/encrypt.h))

### Software Engineering & Architecture

- [Packet Replay Protections](https://awesome-repositories.com/f/software-engineering-architecture/request-validation/packet-replay-protections.md) — Uses a sliding window of sequence numbers to detect and reject duplicate packets. ([source](https://github.com/wangyu-/udp2raw/blob/unified/connection.cpp))
- [UDP Session Replay Protections](https://awesome-repositories.com/f/software-engineering-architecture/request-validation/replay-attacks-prevention/udp-session-replay-protections.md) — Implements sliding-window replay protection to detect and reject duplicate packets in UDP sessions.
- [Automatic Connection Restoration](https://awesome-repositories.com/f/software-engineering-architecture/service-instance-managers/automatic-service-registrations/automatic-service-discoverers/automatic-connection-restoration.md) — Detects link failures via heartbeats and automatically establishes new links by switching ports. ([source](https://github.com/wangyu-/udp2raw#readme))

### System Administration & Monitoring

- [Connection Heartbeats](https://awesome-repositories.com/f/system-administration-monitoring/connection-heartbeats.md) — Uses periodic heartbeat signals to monitor connection health and detect link failures.