OpenSource-Hub
H

hysteria

SHA-256
20.3k stars·Privacy Protection·SHA-256 checksum verified

A powerful, lightning-fast, and censorship-resistant proxy tool designed for unreliable networks.

Smart Download

Download Download Version

vapp/v2.9.1 · 20.8 MB

A high-speed, censorship-resistant proxy that excels on lossy networks using a custom QUIC protocol.

Core Features

  • Supports SOCKS5, HTTP proxy, TCP/UDP forwarding, Linux TProxy, and TUN modes
  • Custom QUIC protocol for superior performance under packet loss and high latency
  • Traffic masquerades as HTTP/3 to evade DPI and censorship
  • Cross-platform: Windows, macOS, Linux, Android, iOS, and more
  • Built-in authentication, traffic stats, and access control for easy integration

What It Can't Do

  • Some cloud providers block UDP; use TCP relay mode as a workaround,Default port 443 may conflict with existing HTTPS servers; change in config,Test locally before deploying on a real server to avoid misconfiguration,TUN mode requires admin/root privileges and may conflict with other VPNs

Use Cases

  • Bypass internet censorship and access blocked websites
  • Reduce latency and packet loss for online gaming
  • Secure and accelerate remote access to corporate networks
  • Protect privacy by hiding your real IP and encrypting traffic

Detailed Introduction

Hysteria is a modern proxy tool built on a customized QUIC protocol, delivering exceptional speed and reliability even on lossy or high-latency connections. It disguises traffic as standard HTTP/3, making it extremely difficult for censors to detect or block. Supporting SOCKS5, HTTP proxy, TCP/UDP forwarding, Linux TProxy, and TUN modes, Hysteria runs on all major platforms and integrates easily with authentication, traffic statistics, and access control systems. Its well-documented code and active community make it a top choice for developers and users seeking a high-performance, anti-censorship solution.

Troubleshooting & FAQ (2)

Troubleshooting
Why does Hysteria NAT punching fail when client has public IP and server is behind a restricted NAT?

This was a known bug where the client ignored incoming punch packets if the source port did not match the server's expected port (NAT may rewrite ports). Fixed in commit 64c3963. Update to a version including this fix, or apply the patch. In the interim, you could try port range spraying, but upgrading is recommended.

GitHub Issue #1564
Troubleshooting
Why do I get 'Can't lock xtables.lock' when running Hysteria alongside other iptables tools?

This error occurs when Hysteria's built-in firewall manipulates iptables without the -w (wait) flag, causing lock contention with other tools like Mihomo or Clash Meta that also use iptables. The issue was fixed in a later commit (e.g., 25a2530). To resolve, upgrade to a Hysteria version that includes this fix, or manually add the -w flag to your iptables commands if using custom scripts.

GitHub Issue #1541

Tags

proxyvpnanti-censorshipquicnetwork-tool

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Download the binary for your OS/architecture from https://v2.hysteria.network/

4

Step 2: Create a config file (config.yaml) with server address, port, password, etc.

5

Step 3: Run `hysteria -c config.yaml` to start the client or server

Install Guide
  1. Step 1: Download the binary for your OS/architecture from https://v2.hysteria.network/
  2. Step 2: Create a config file (config.yaml) with server address, port, password, etc.
  3. Step 3: Run `hysteria -c config.yaml` to start the client or server
File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

e80c71bcf57d21cd6dede6b05938a24a9d75f44b494632be6b94bb1283928680

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Delete the binary and config files. If installed as a system service, stop and disable it first (e.g., systemctl stop hysteria && systemctl disable hysteria), then remove all related files.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseMIT
Last Updated2026-06-27 08:10:22
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

2 FAQs

Similar Projects