selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Hysteria logo

Self-host Hysteria

app/v2.13.0

Censorship-resistant HTTP/3 masquerading proxy

ReleaseOpen SourceMIT
Updated3 weeks ago
LanguageGo
Setup difficultyEasy
Stars
22 885
Port
443 (Default Hysteria proxy listen port (UDP/QUIC masquerading as HTTP/3), on IPv4 and IPv6)
Docker
tobyxdd/hysteria
Install with Docker

What is Hysteria?

Hysteria 2 is an MIT-licensed proxy written in Go that comes as a single executable serving both server and client roles, so you can host your own egress on any VPS or, with Hysteria Realms, behind NAT using UDP hole punching with no port forwarding. Its transport is a customized QUIC stack that picks among the Brutal, BBR and Reno congestion controllers, and it disguises itself as ordinary HTTP/3 traffic, optionally serving real web content through file, reverse-proxy or string masquerade modes. On the client side it offers SOCKS5 and HTTP proxy listeners, TCP and UDP port forwarding, Linux TProxy and REDIRECT, plus a cross-platform TUN mode. The server supports password, username/password, external HTTP or command authentication, ACL rule files with GeoIP/GeoSite matching, and direct, SOCKS5 or HTTP upstream outbounds; operators can watch per-client traffic or disconnect users through an HTTP traffic-stats API, and TLS certificates can be issued automatically via ACME. To run it you either download a binary, use the get.hy2.sh systemd deployment script for Linux, install the Arch AUR package or the published Docker image. Version 2 is not wire-compatible with the legacy Hysteria 1.x, client-side ACL and FakeTCP are still missing, and the project is donation-funded: it sells no proxies or VPN service.

Hysteria alternatives

Should you self-host Hysteria?

Hysteria scores 79/100 on selfhost.directory (how scoring works) and ranks #2 of 26 in Proxy. It has 22 885 GitHub stars, +115 in the last 30 days.

It shipped 3 stable releases in the past year. The latest, app/v2.13.0, came out on 5 October 2026. New versions land roughly every 3 weeks.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is frp (85/100, 110 491 stars). It scores higher overall, so compare the two before you pick. See Hysteria vs frp side by side.

Features

  • Access control listsClient-side ACL is not implemented yet.
  • Automatic TLS certificates via ACME
  • Built-in speed test
  • Censorship-resistant HTTP/3 masquerade
  • Client authentication
  • Encrypted Client Hello (ECH)
  • High-performance QUIC transport with bandwidth-based congestion control
  • Multiple proxy modes (SOCKS5, HTTP, forwarding, TProxy, TUN)TProxy/REDIRECT are Linux only; FreeBSD is not supported for TUN.
  • Obfuscation and fake-TCP disguisemimic requires a separate kernel module on Linux.
  • P2P NAT traversal (Hysteria Realms)
  • Port hopping
  • Traffic statistics and client-kick API
  • Upstream and direct outbounds

Hysteria README

Hysteria 2

License Release Telegram Discussions

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


🛠️ 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.


If you find Hysteria useful, consider giving it a ⭐️!

Star History Chart

How to install Hysteria

Install Hysteria with Docker

version: "3.9" services: hysteria: image: tobyxdd/hysteria container_name: hysteria restart: always network_mode: "host" cap_add: - NET_ADMIN volumes: - acme:/acme - ./hysteria.yaml:/etc/hysteria.yaml command: ["server", "-c", "/etc/hysteria.yaml"] volumes: acme:

NET_ADMIN is only required when port hopping is enabled.

How to configure Hysteria

  • HYSTERIA_LOG_LEVELLog level (debug, info [default], warn, error)

    values: Logging

  • HYSTERIA_LOG_FORMATLog format (console [default], json)

    values: Logging

  • HYSTERIA_BRUTAL_DEBUGSet to 1 to print information such as current RTT, packet loss, MTU, etc. every 2 seconds. Only applies when using Brutal as the congestion control algorithm.

    values: Logging

  • HYSTERIA_BBR_DEBUGSet to 1 to print BBR debug information. Only applies when using BBR as the congestion control algorithm.

    values: Logging

  • HYSTERIA_UDPHOP_DEBUGSet to 1 to print UDP port hopping debug information (hop events, local/remote address changes).

    values: Logging

Hysteria releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Proxy

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…