# 使用 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
- **软件包管理器页面:** <https://formulae.brew.sh/formula/hysteria>
- **版本:** 2.11.0
- **来源摘要:** Feature-packed proxy & relay tool optimized for lossy, unstable connections
- **主页:** <https://hysteria.network/>
- **仓库:** <https://github.com/apernet/hysteria>
- **上游文档:** <https://hysteria.network/>
- **许可证:** MIT
- **源码归档:** <https://github.com/apernet/hysteria/archive/refs/tags/app/v2.11.0.tar.gz>
- **最后更新:** 2026-08-01T04:52:44Z
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- hysteria (cli)
- hysteria (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- 服务: declared
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 2.11.0
- 管理器更新时间: 2026-08-01
- 本地数据: OK
- 上游仓库: https://github.com/apernet/hysteria
- 检测到的最新版本: app/v2.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.

### 来源

- <https://api.github.com/repos/apernet/hysteria/releases?per_page=100>
- <https://formulae.brew.sh/formula/hysteria>
- <https://github.com/apernet/hysteria>
- <https://raw.githubusercontent.com/apernet/hysteria/master/README.md>
- <https://v2.hysteria.network/docs/developers/Protocol/>
- <https://v2.hysteria.network/docs/getting-started/Installation/>


## 安全说明

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
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** hysteria
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## 其他软件包管理器记录

- 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


## 相关链接

- [Secret-risk packages](https://pkg.so/zh-hans/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://pkg.so/zh-hans/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://pkg.so/zh-hans/brew-utility-packages/) - Matched Homebrew package provider.
- [go](https://pkg.so/zh-hans/brew/go/) - Build dependency declared by Homebrew.
- [cloudflare-quiche](https://pkg.so/zh-hans/brew/cloudflare-quiche/) - Shares pkgdb curated category or tags: cli, http3, networking, quic.
- [socat](https://pkg.so/zh-hans/brew/socat/) - Shares pkgdb curated category or tags: cli, networking, relay.
- [sing-box](https://pkg.so/zh-hans/brew/sing-box/) - Shares pkgdb curated category or tags: cli, networking, proxy.
- [xray](https://pkg.so/zh-hans/brew/xray/) - Shares pkgdb curated category or tags: cli, networking, proxy.
- [proxychains-ng](https://pkg.so/zh-hans/brew/proxychains-ng/) - Shares pkgdb curated category or tags: cli, networking, proxy.
- [v2ray](https://pkg.so/zh-hans/brew/v2ray/) - Shares pkgdb curated category or tags: cli, networking, proxy.
- [squid](https://pkg.so/zh-hans/brew/squid/) - Shares pkgdb curated category or tags: cli, networking, proxy.
- [mihomo](https://pkg.so/zh-hans/brew/mihomo/) - Shares pkgdb curated category or tags: cli, networking, proxy.
- [ehco](https://pkg.so/zh-hans/brew/ehco/) - Local package facts share a topical domain. Shared terms: cli, networking, proxy, relay.
- [geph4](https://pkg.so/zh-hans/brew/geph4/) - Local package facts share a topical domain. Shared terms: censorship, cli, networking, proxy.

## 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
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
