wangyu-

udp2raw: Tunnel UDP Traffic Through Raw Packets

udp2raw wraps UDP traffic in encrypted UDP, simulated TCP, or ICMP packets to help it pass through networks that block or degrade UDP. It is aimed at Linux users who can configure raw sockets and want to carry UDP-based VPN traffic across restrictive links.

View on GitHub Compare
Stars
8.6k
Forks
1.3k
Stars, last 30 days
+16

Our take

Health score

29/100

How it is scored
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.

Selected snapshot

Stars

8,587

Forks

1,281

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