# 使用 Homebrew, MacPorts, Nix, scoop, winget 安装 hysteria
查看 hysteria 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。
## 安装
```sh
sudo av install brew:hysteria
```
其他安装命令:
### macOS
- Homebrew (100%):
```sh
brew install hysteria
```
证据: local Homebrew formula metadata
- MacPorts (94%):
```sh
sudo port install hysteria
```
证据: MacPorts ports tree: net/hysteria/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
### Linux
- Nix (92%):
```sh
nix profile install nixpkgs#hysteria
```
证据: nixpkgs package indexes: pkgs/by-name/hy/hysteria/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
### Windows
- Scoop (92%):
```sh
scoop install extras/hysteria
```
证据: Scoop official bucket manifest trees: bucket/hysteria.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1
- winget (92%):
```sh
winget install --id apernet.Hysteria -e
```
证据: Windows Package Manager source index: apernet.Hysteria from https://cdn.winget.microsoft.com/cache/source.msix
## 软件包事实
- **软件包键:** brew:hysteria
- **软件包管理器:** Homebrew
- **版本:** 2.11.0
- **来源摘要:** Feature-packed proxy & relay tool optimized for lossy, unstable connections
- **主页:**
- **仓库:**
- **最后更新:** 2026-08-01T04:52:44Z
- **已生成:** 2026-08-03T19:37:03+00:00
## 可执行文件
- hysteria (别名)
## 安装行为
- Bottle: 不可用
## 版本和新鲜度
- 页面生成时间: 2026-08-03
- 管理器版本: 2.11.0
## 项目历史与用法
Hysteria is a proxy and relay tool built around a customized QUIC protocol, designed for high performance on unreliable or lossy networks and for traffic that can masquerade as HTTP/3.
### 项目历史
The GitHub release history begins in 2020 with the original v0.x line. The README presents Hysteria as a fast, censorship-resistant proxy with SOCKS5, HTTP proxy, TCP and UDP forwarding, Linux TProxy, TUN mode, custom authentication, traffic statistics, and access control.
Hysteria 2 arrived as `app/v2.0.0` in September 2023. The protocol documentation describes the v2 protocol as a TCP and UDP proxy based on QUIC for speed, security, and censorship resistance; release notes after v2 added masquerade servers, Android builds, congestion-control work, port hopping, ACME improvements, sharing links, mTLS, and Realms NAT traversal.
### 采用历史
Hysteria is packaged by Homebrew and appears in MacPorts, Nix, Scoop, and winget metadata. Its docs also provide a Linux deployment script, Docker images, and cross-platform release binaries, which made it attractive to self-hosters and network operators working across desktop, server, and mobile environments.
### 使用方式
Operators configure a server and client with YAML files, commonly named `config.yaml`, and choose modes such as SOCKS5, HTTP proxy, TCP/UDP forwarding, TProxy, or TUN. Hysteria's appeal is strongest where packet loss, mobile links, congested Wi-Fi, long-distance routes, or censorship make ordinary proxy transports perform poorly.
### 为什么软件包爱好者会关心
Hysteria is notable because it packages modern transport ideas into a single deployable CLI: QUIC, HTTP/3 masquerading, congestion control tuning, port hopping, ACME, QR/share links, Docker images, and platform-native package-manager entries. For networking package nerds, it is a concrete example of censorship-resistance tooling becoming a routine `brew install` artifact.
### 时间线
- 2020: v0.0.1 appeared in GitHub release metadata.
- 2023: app/v2.0.0 was published as the first Hysteria v2 release.
- 2024: v2.5.0 added ACME DNS challenge support and protocol sniffing.
- 2025: v2.6.x added sharing links, mTLS, and QUIC/TLS behavior changes.
- 2026: v2.9.x introduced Hysteria Realms NAT traversal and additional obfuscation work.
### Related projects
- Hysteria belongs near QUIC-based and censorship-resistance proxy tools such as TUIC, sing-box, Clash-compatible clients, and other HTTP/3 or UDP-focused relay systems.
### 来源
-
-
-
-
-
-
## 安全说明
formula declares a Homebrew service.
- **Geiger 风险:** orange / 中
- formula declares a Homebrew service
## Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
## Configuration files
- Unix: ./config.yaml
- Windows: .\config.yaml
## Credential files
- Unix: ./config.yaml
- Windows: .\config.yaml
## 其他软件包管理器记录
- Nix - hysteria: normalized package name match | nixpkgs package indexes: pkgs/by-name/hy/hysteria/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- MacPorts - hysteria: normalized package name match | MacPorts ports tree: net/hysteria/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - extras/hysteria: normalized package name match | Scoop official bucket manifest trees: bucket/hysteria.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1
- winget - apernet.Hysteria: normalized package name match | Windows Package Manager source index: apernet.Hysteria from https://cdn.winget.microsoft.com/cache/source.msix
## Combined YAML source
View the package source record on GitHub. [combined/hysteria.yml](https://github.com/mxcl/pkgdb/blob/main/combined/hysteria.yml)
## 来源
- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph