Our take
- Activity
- 19
- Community
- 30
- Issues
- 46
- Pull requests
- 20
+16 stars in the last 30 days
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
8,587Forks
1,281Change since Nov 17, 2026: +1 stars·0 forks
Overview
udp2raw creates a raw-socket tunnel that carries UDP traffic inside UDP, ICMP, or simulated TCP packets. It is intended for networks where UDP is blocked, throttled, or unreliable, and can also help stabilize a connection by reconnecting after a failure.
On its own, it tunnels UDP. Paired with a UDP-based VPN, it can carry other traffic through that VPN. FakeTCP mode imitates parts of a TCP connection for filtering purposes, but remains UDP-based and does not provide TCP congestion control or retransmission.
Key Features
- Encapsulates UDP traffic in UDP, ICMP, or simulated TCP packets.
- Supports AES-128-CBC encryption and message authentication options, with anti-replay protection.
- Uses heartbeats to detect failures and can reconnect while preserving existing UDP conversations.
- Multiplexes multiple UDP connections over one raw connection and supports multiple clients on a server.
- Can automatically add firewall rules or generate rules for manual configuration.
- Supports configuration files and a FIFO interface for runtime commands.
Use Cases
- Tunnel UDP-based VPN traffic across an ISP or network that blocks or degrades UDP.
- Connect a Linux router or Raspberry Pi to a remote service when the network has unreliable UDP handling.
- Keep VPN conversations active through a network interruption, such as changing Wi-Fi access points.
- Use ICMP or simulated TCP encapsulation when ordinary UDP traffic is filtered, provided the network permits the selected packet type.
Getting Started
Download a binary from the project releases. For usage and configuration details, see the README.
Considerations
The README documents Linux support and requires root access or cap_net_raw; FakeTCP mode also relies on suitable iptables rules to prevent the kernel from interfering with packets. Simulated TCP is not a real TCP connection, and the project notes that it may be distinguishable from real TCP. Choose encryption and authentication settings deliberately, and avoid the README's none modes outside debugging.
Found this useful?
Share it with someone who would like udp2raw.