Metadata-Version: 2.4
Name: heyhy
Version: 0.1.7.post4
Summary: mihomo-hysteria2-inbound manager
Author-email: QIN2DIM <yaoqinse@gmail.com>
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: typer>=0.16.0
Description-Content-Type: text/markdown

# Heyhy <a href = "https://t.me/+V1rQL8WFTNxiMjRh"><img src="https://img.shields.io/static/v1?style=social&logo=telegram&label=chat&message=studio" ></a>

Heyhy 用于快速部署 [hysteria2 server](https://github.com/apernet/hysteria) 并输出客户端最佳实践配置，开箱即用！

**What's features**

| Supported Configuration     | Status |
| --------------------------- | ------ |
| Hysteria2 server            | ✅      |
| NekoRay client proxy        | ✅      |
| sing-box `hy2` outbound     | ✅      |
| Mihomo `hysteria2` outbound | ✅      |
| Hysteria2 client            | ✅      |
| via Cloudflare CDN          | ✅      |

**Prerequisites**

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

## Get started

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

```bash
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` 调度脚本。

## What's next

安装指令其他参数：

```bash
heyhy install -d [DOMAIN]
```

| 必选参数         | 简介       |
| ---------------- | ---------- |
| `--domain`, `-d` | 绑定的域名 |

| 可选参数           | 简介                                                 |
| ------------------ | ---------------------------------------------------- |
| `--password`, `-p` | 手动指定连接密码 (可选，默认随机生成)                |
| `--ip`             | 手动指定服务器公网 IPv4 (可选，默认自动检测)         |
| `--port`           | 指定监听端口 (可选，默认 4433)                       |
| `--image`          | 指定托管镜像（可选，默认 `metacubex/mihomo:latest`） |

移除所有项目依赖：

```bash
heyhy remove
```

升级脚本：

```bash
heyhy self update
```

输出客户端配置：

根据正在运行的服务配置生成 `mihomo client outbound` 配置。

```bash
heyhy check
```

探索其他指令：

```bash
heyhy --help
```

![image-20250629184651534](./assets/image-20250629184651534.png)

## References

- [Hysteria2](https://v2.hysteria.network/zh/docs/getting-started/Client/) hy2 官方文档

- [sing-box outbound](https://sing-box.sagernet.org/zh/configuration/outbound/hysteria2/) sing-box 客户端出站代理设置

- [mihomo outbound](https://wiki.metacubex.one/config/proxies/hysteria2/#hysteria2) mihomo/clash-meta 客户端出站代理设置

- [MatsuriDayo configuration](https://matsuridayo.github.io/n-extra_core/#_5) nekoray / nekobox 客户端出战代理设置（该项目已停止维护）

