Featured image of post 『Blog』Hysteria2 Get Started

『Blog』Hysteria2 Get Started

敏捷部署 Hysteria v2

Preview

最速传说!挑战 5 分钟部署 Hysteria v2!不含一句废话的 quick start 教程!

准备:Python3.7+(近几年发行的主流 Linux 镜像都预装了 Python3);在管理员权限下运行;提前为你的服务器解析一个域名 A 纪录。

忠告:在你开始吸收包括本文在内的各种来路不明的教程之前,运行刚发布的「一键安装脚本」之前,翻看所谓油管大神的讲解视频之前,一定先把 Hysteria 官方文档 多翻几遍!

Quick start

服务端配置

运行脚本,填写 IPv4 的域名:

1
python3 <(curl -fsSL https://raw.githubusercontent.com/QIN2DIM/hy2/main/heyhy.py) install

首次安装完成后可通过 heyhy 别名指令调度脚本。

客户端配置

初始化

(如果首次使用)请下载最新版 NekoRay,支持 Win 和 Linux

「首选项 / 基本设置 / 通用」启用 HTTP 监听端口

添加自定义核心

如果你不知道如何选择,请看官方文档

  1. 下载与操作系统适配的 hysteria app/v2.0.0

    「 首选项 / 打开配置目录」 将下载好的可执行文件拖进配置目录。

  2. 添加 Hysteria2 自定义核心

    「首选项 / 基本设置 / 其他核心」 点击 添加选择刚拖进来的核心文件,命名为 hysteria2。命名随意,但你需要知道自己写了什么,接下来会用到。

添加自定义配置

查看脚本运行完毕后打印的 NekoRay 自定义核心配置。可以运行 heyhy check 重新输出。

「服务器 / 手动输入配置 / 编辑」 通用 → 类型 选择 自定义(其他核心)。 其中需要填写的字段与脚本输出的内容一一对应,复制并填写,保存配置。

启动系统代理

选中刚添加的 item,打开系统代理。检查网络状态,开始排查错误。

What’s more

Uninstall

卸载服务器上与 Hysteria2 有关的一切依赖。你必须指明安装 Hysteria2 时绑定的域名才能安全卸载证书。

1
python3 <(curl -fsSL https://raw.githubusercontent.com/QIN2DIM/hy2/main/heyhy.py) remove

你可以通过 heyhy check 从输出配置中查询域名。

Heyhy

你可以通过 heyhy 脚本灵活管理 Hysteria2 系统服务。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
$heyhy -h

usage: heyhy [-h] {install,remove,check,status,log,start,stop,restart} ...

Hysteria-v2 Scaffold (Python3.7+)

positional arguments:
  {install,remove,check,status,log,start,stop,restart}
    install             Automatically install and run
    remove              Uninstall services and associated caches
    check               Print client configuration
    status              Check hysteria2 service status
    log                 Check hysteria2 service syslog
    start               Start hysteria2 service
    stop                Stop hysteria2 service
    restart             restart hysteria2 service

optional arguments:
  -h, --help            show this help message and exit

其他出站配置

🚧2023.09.03 预发行特性

  1. heyhy 支持输出 sing-box 的 Hysteria2 出站代理配置。
  2. 目前 clash-meta 暂未集成 Hysteria2。
  3. 在 PC 端,你还可以通过原理相似的软件(如:v2rayN)引导 Hysteria2 代理核心。
  4. 在 Android / iOS 移动端,你可以使用一切内置 sing-box 内核的软件尝鲜 Hysteria2

Reference

开源项目:

项目名发行版本号用途
QIN2DIM/hy2latest服务端一键部署
apernet/hysteriav2.0.0代理服务端
MatsuriDayo/nekorayv3.19Win / Linux PC 图形客户端

相关文档:

索引简介
Home - Hysteria 2Hysteria v2 官方文档
extra core - Nekoray为 NekoRay 添加自定义核心
Hysteria2 - sing-box为 sing-box 添加 Hysteria2 出站代理
You will to enjoy grander sight / By climing to a greater height.