hysteria/README.md
Niko Marmeladkov e4facdf010
Some checks failed
Build master branch / build (push) Has been cancelled
Tests / Test (push) Has been cancelled
docs(README): add fork changes section vs upstream
2026-06-17 16:46:05 +03:00

3.1 KiB
Raw Permalink Blame History

Hysteria 2

License Release Telegram Discussions

Hysteria is a powerful, lightning-fast, and censorship-resistant proxy.

Get Started

中文文档

Hysteria 1.x (legacy)


🛠️ Jack of all trades

Wide range of modes including SOCKS5, HTTP Proxy, TCP/UDP Forwarding, Linux TProxy, TUN - with more features being added constantly.

Blazing fast

Powered by a customized QUIC protocol, Hysteria is designed to deliver unparalleled performance over unreliable and lossy networks.

Censorship resistant

The protocol masquerades as standard HTTP/3 traffic, making it very difficult for censors to detect and block without widespread collateral damage.

💻 Cross-platform

We have builds for every major platform and architecture. Deploy anywhere & use everywhere. Not to mention the long list of 3rd party apps.

🔗 Easy integration

With built-in support for custom authentication, traffic statistics & access control, Hysteria is easy to integrate into your infrastructure.

🤗 Chill and supportive

We have well-documented specifications and code for developers to contribute and/or build their own apps. And a helpful community, too.


Fork changes vs upstream (apernet/hysteria)

This fork adds the following features on top of the original Hysteria 2:

  • L3 VPN Tunnel — full IP tunnel over QUIC with TUN interface and IP pool
  • FileMask Noise — obfuscation layer that masks traffic as encrypted file downloads (AES-GCM)
  • Hysteria Outbound — chain multiple Hysteria servers (use one as upstream outbound)
  • TLS 1.3 Mimic Obfuscation — wraps QUIC packets in TLS 1.3 record headers to bypass DPI
  • Multi-mode Obfuscation — auto-detects Salamander / TLS-mimic / plain clients on the same port
  • Random Padding & Jitter — obfuscation options to break constant-packet-size and constant-bitrate DPI patterns
  • Session Recreation — periodic client reconnection (MaxSessionDuration) to avoid long-lived session detection
  • Plain client support — stock Hysteria 2 clients connect without obfuscation on the same port

If you find Hysteria useful, consider giving it a !

Star History Chart