最后更新时间: 2025-06-29

Preview

本教程详解最速部署 hysteria2 server 并借助 mihomo 或 v2rayN 启动客户端出站代理的最佳实践，开箱即用！

What’s features

Prerequisites

• 在管理员权限下运行
• 提前为你的服务器的 IPv4 解析一个域名 A 纪录

Get started

一键部署脚本，以 uv tool 的方式调度管理工具：

服务端配置

curl -LsSf https://astral.sh/uv/install.sh | sh && \
source $HOME/.local/bin/env && \
uv tool install heyhy && \
uv run heyhy install -d <填写域名>

首次安装完毕后，你可以通过别名指令 heyhy 或 uv run heyhy 调度脚本。

该脚本自动配置运行所需依赖，包括 uv，docker，docker compose，snapd 和 certbot。

安装完成后可以得到大致如下的配置信息：

客户端配置

v2rayN

1. 从 v2rayN GitHub Release 下载最新版客户端。
2. 复制 heyhy 输出的 Hysteria2 分享链接，CTRL + V 粘贴到 v2rayN 客户端。
3. 选中自动生成的代理项，Enter 回车选中，切换至 自动配置系统代理 模式，启动客户端代理。
4. 观察图标变红说明系统代理启动成功。

Mihomo

Mihomo 是一个代理核心，推荐借助 GUI 项目来启动它。

1. 下载最新版客户端 Clash Verge Rev。

2. heyhy 仅生成 outbound proxies 配置，你需要在现有的 clash.meta 配置文件上添加该代理配置，并在任一代理组中启动它。可以参考 hy2 提供的完整模板文件 clash_config_tpl.yaml

3. 修改 proxies 和 proxy-groups 字段：

   已复制!

   proxies
   + - name: hy2-001          
   +  type: hysteria2                  
   +  server: [SERVER_IP]
   +  port: 4433                     
   +  password: [PASSWORD]                                         
   +  sni: [SERVER_DOMAIN]
   +  skip_cert_verify: false
   proxy-groups:
   + - name: PROXY
   +   type: select
   +   proxies:
   +   - hy2-001
   

4. 在「订阅」界面，将 YAML 配置文件添加到 Clash Verge Rev（可拖拽导入，或点击新建 Local 类型配置）

5. 在「设置」界面，启动系统代理（或虚拟网卡模式）。

NekoRay

🤷‍♂️ MatsuriDayo NekoRay 已不再维护，本教材已于 2025-06-29 删去相关配置介绍。

What’s next

安装指令其他参数：

heyhy install -d [DOMAIN]

移除所有项目依赖：

关闭容器服务，删除证书，移除工作目录，但保留 uv heyhy tool。

heyhy remove

升级脚本：

heyhy self update

输出客户端配置：

根据正在运行的服务配置生成客户端出站配置。

heyhy check

探索其他指令：

heyhy --help

Reference