No description
Find a file
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
.github ci: bump action versions 2026-05-05 17:08:54 -07:00
app feat: TLS 1.3 mimicry obfuscation, multi-mode (auto + plain), session recreation 2026-06-17 16:36:29 +03:00
core feat: TLS 1.3 mimicry obfuscation, multi-mode (auto + plain), session recreation 2026-06-17 16:36:29 +03:00
extras feat: TLS 1.3 mimicry obfuscation, multi-mode (auto + plain), session recreation 2026-06-17 16:36:29 +03:00
media-kit chore: media kit 2023-09-01 18:09:56 -07:00
scripts chore(scripts): detect arch for loong64 2025-01-08 14:57:02 +09:00
.gitignore feat: quic-go v0.54.0 2025-09-13 16:17:59 -07:00
CHANGELOG.md chore: update README 2023-09-01 17:51:44 -07:00
Dockerfile Add nftables to Dockerfile for firewall rules (#1543) 2026-04-02 12:44:13 -07:00
go.work chore: bump cobra & viper versions 2026-02-21 17:03:34 -08:00
go.work.sum feat(realm): UPnP/NAT-PMP port mapping support (#1600) 2026-06-10 18:16:27 -07:00
hyperbole.py fix(hyperbole): android build 2026-05-08 16:26:15 -07:00
LICENSE.md chore: add license 2023-09-01 13:44:12 -07:00
logo.svg chore: update README 2023-09-01 17:51:44 -07:00
NEW_FEATURES.md feat: TLS 1.3 mimicry obfuscation, multi-mode (auto + plain), session recreation 2026-06-17 16:36:29 +03:00
platforms.txt ci: add linux/loong64 to platforms.txt 2025-01-08 14:56:15 +09:00
PROTOCOL.md fix: typo in PROTOCOL.md 2024-03-13 19:39:55 -07:00
README.md docs(README): add fork changes section vs upstream 2026-06-17 16:46:05 +03:00
requirements.txt fix: update requirements.txt 2 2026-03-29 15:03:43 -07:00

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