Hysteria 2 是什么
根据项目中文文档，Hysteria 是采用 MIT 许可的开源代理工具。文档列出的功能包括 HTTP 代理、SOCKS5，以及 TCP、UDP 转发，还提供 TUN 等模式。
协议基于经过定制的 QUIC。项目将流量外观描述为接近标准 HTTP/3，这是官方对协议设计的自述，不能据此判断某次连接的实际效果。
获取程序可前往项目 Releases 发布页。截至 2026-11-08，官方更新日志列出的最新版本为 2.13.0。需要单独核对下载位置时，可查看Hysteria 程序下载入口说明。
截至 2026-11-08，安装文档按操作系统和处理器架构区分文件。Windows 文件列有 amd64、amd64-avx、386、arm64；带 AVX 标记的版本要求处理器具备相应支持，不能只按操作系统名称选择。
截至 2026-11-08，安装文档中的 Android 文件属于 Linux ELF 可执行程序，由 NDK 编译而来，并非可以直接安装的 APK。文件列在 Android 一栏，不等于它就是手机图形应用。
服务端要配什么
官方的服务端入门说明将最小配置分为监听端口、TLS 证书来源、密码认证和 masquerade 伪装设置；证书来源可采用 ACME，或填写已有证书与私钥，具体部署应对照该文档完成。
两端的分工可以这样看：
| 要核对的内容 | 服务端承担的职责 | 客户端填写的内容 |
|---|---|---|
| 连接位置 | 设置监听端口 | 用 server 指定目标地址和端口 |
| 密码认证 | 定义认证方式与密码 | 用 auth 提交认证信息 |
| TLS | 配置证书来源 | 按证书情况设置验证参数 |
| 本地代理 | 不属于此处的客户端入口 | 用 socks5.listen 或 http.listen 定义本地监听 |
这些内容不能互相替代。知道服务器地址，并不意味着认证信息已经齐全；填好密码，也不代表证书验证已经完成。客户端配置要与服务器实际采用的设置对应。
客户端怎么填
官方客户端说明从已取得可执行程序开始：在程序所在目录建立 config.yaml，再运行程序。Windows 可以双击启动，前提是配置文件已放在同一目录。
先看字段用途，再填写自己的值：
| 字段 | 填写内容 | 核对重点 |
|---|---|---|
server | 你的服务器地址及端口 | 指向需要连接的服务端 |
auth | 你的认证密码 | 与服务端的密码设置对应 |
bandwidth.up | 可选的上行带宽值 | 不超过实际可用上行带宽 |
bandwidth.down | 可选的下行带宽值 | 不超过实际可用下行带宽 |
socks5.listen | 本地 SOCKS5 监听位置 | 用于客户端提供本地代理入口 |
http.listen | 本地 HTTP 代理监听位置 | 与远端服务器地址分开理解 |
bandwidth 是可选项。官方教程提醒，填写的数值不能高于实际可用带宽；它不是填得越大越合适。
涉及自签证书时，文档还介绍了 tls 下的 ca、insecure 和 pinSHA256。官方不建议只启用 insecure，而是建议结合 pinSHA256 使用。遇到证书错误，应核对证书相关配置，不能把关闭验证当作配置完成的标志。
程序运行后，检查日志中是否出现 connected to server，并确认没有错误。官方教程以此作为连接成功的判断依据。程序还会输出可分享的 URI，其中包含密码，不应公开粘贴。
连不上时的排查顺序
按下面的顺序检查，可以把程序、配置与连接结果分开核对。
- 核对两端版本。 截至 2026-11-08，官方兼容说明指出，Hysteria 2 无法与 Hysteria 1.x 互通，客户端与服务端应采用一致的版本。
- 核对程序与配置文件。 检查所选文件是否对应设备架构，并确认
config.yaml位于程序所在目录。通过 Windows 双击运行时，也需要满足这个目录条件。 - 核对目标与密码。 检查
server的地址、端口，以及auth的认证信息，逐项与服务端设置对应。 - 核对证书设置。 使用自签证书时，对照客户端文档检查
tls参数，尤其留意是否只开启了insecure。 - 阅读连接日志。 查找
connected to server，同时检查是否仍有错误。只有程序窗口出现，不能代替日志中的成功信息。 - 核对带宽填写。 如果设置了
bandwidth，检查上下行数值是否超出实际可用范围。
这些检查对应的是官方入门文档中能直接核对的项目。日志报错、证书配置和两端参数应一起看，不能仅凭某一个字段判断原因。
常见问题
Hysteria 和 Hysteria 2 是一回事吗？
Hysteria 是项目名称，阅读教程时还要辨认所指的代际。截至 2026-11-08，官方文档明确区分 Hysteria 2 与旧版 1.x，两者不能互通，不能直接混用对应教程与配置。
哪些客户端支持 Hysteria 2？
截至 2026-11-08，mihomo 的协议配置文档和 sing-box 的出站配置文档均设有 Hysteria2 页面；项目也提供第三方应用列表。第三方实现可能没有跟进项目的全部新功能，使用 mihomo 时还可参照配置文档与中文说明的辨认方法。
第三方整理，与项目方无关。