Hysteria2

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #typescript #llm #rust #linux #nodejs #macos #java #awesome-list #vue #security

(★ 81)

🟢🌍2026最新超详细+极速+隐私 Hysteria2一键安装脚本,默认解锁GPT和奈飞;🛡️附带VPN 安全性检测指南

Hysteria2 Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🌍 Hysteria2 极速+隐私 一键部署 🚀

[![hysteria2](https://img.shields.io/badge/hysteria2-orange)](https://v2.hysteria.network/zh/)
[![Clash Verge](https://img.shields.io/badge/Clash%20Verge-cb7fff)](https://www.clashverge.dev/)
![Debian](https://img.shields.io/badge/Debian-A81D33?logo=debian&logoColor=white)
![Ubuntu](https://img.shields.io/badge/Ubuntu-E95420?logo=ubuntu&logoColor=white)

**🐯 本项目设计初衷: 追求极致的速度和严格的隐私加密保护**

💯 本项目是俺正在使用的方案,会一直维护更新

如果安装部署遇到问题,请加入 [![Static Badge](https://img.shields.io/badge/Telegram-blue%3Flogo%3Dtelegram?logo=telegram&color=blue)](https://t.me/Amazing_George) https://t.me/Amazing_George

请直接将问题发送到群里,看到会及时回复

</div>

---

本项目适合不想折腾技术只想忙里偷闲的官人，只要有台 _`垃圾 VPS`_ 服务器，就能一键安装！

使用本项目脚本前,请详细阅读以下内容,了解基本流程和注意事项,再进行安装部署.

**📌 Hysteria2 是什么？**
点击 👉 [官方介绍](https://v2.hysteria.network/zh/) 了解详细内容。

1. 📇 本教程主要适用于客户端是 `windows` 系统的官人使用, `macOS/Linux` 系统也可以使用,俺在`Ubuntu24`的桌面版也能正常使用客户端,只是需要下载对应的客户端软件,服务端客户端的配置文件都是一样的

2. 📄 脚本文件为本项目中的 [h2.sh](https://github.com/georgetime1970/h2/blob/main/h2.sh) 和 [h2_domain.sh](https://github.com/georgetime1970/h2/blob/main/h2_domain.sh) 文件,已开源,请放心食用

3. 📦 本项目脚本文件核心是调用的 hysteria2 [官方安装脚本](https://v2.hysteria.network/zh/docs/getting-started/Installation/)

4. 🛡️ 俺给小白提供了 [fail2ban.sh](https://github.com/georgetime1970/h2/blob/main/fail2ban.sh) 脚本用于保护服务器免受 SSH 暴力破解攻击,可选择性安装

5. 🧑‍💻 目前给服务端增加了更安全的 [obfs 混淆算法配置](https://v2.hysteria.network/docs/advanced/Full-Server-Config/#obfuscation)、常驻 [信息面板](#信息面板)(订阅链接 / 二维码 / 流量),以及本机 [流量统计 API](https://v2.hysteria.network/docs/advanced/Traffic-Stats-API/)

---

## 💡 脚本说明

💖 本项目有 **2** 种模式, `域名模式` 和 `非域名模式`

### 域名模式

**使用域名的自动获取证书模式**

- 需要注册域名,解析域名;
- 使用 [cloudflare](https://dash.cloudflare.com/) 进行域名解析时,本脚本可以自动获取证书并自动续期;如果你使用的其他域名解析商,请查看官方支持自动配置证书的服务商:👉[查看此处](https://v2.hysteria.network/zh/docs/advanced/ACME-DNS-Config/);然后修改[h2_domain.sh](https://github.com/georgetime1970/h2/blob/main/h2_domain.sh)对应的第5步配置里的`acme`部分即可

### 非域名模式

**不使用域名的自签证书模式**

- 直接使用 ip 进行连接,伪装性不如域名好,但是不影响长期使用,适用于审查不是很严的地方
- 这种模式下您发送的数据依旧是加密的,仅是伪装性不如域名模式,毕竟谁没事每天大流量访问一个IP呢?

> 注意: 域名模式如果操作有难度,优先尝试非域名模式,先体验一下 hysteria2 的速度和稳定性,如果体验感不错,再尝试域名模式,域名模式的操作难度比非域名模式要高一些,但是安全性更高,证书自动续期,不需要手动续期,而且证书是自动获取的,不需要手动配置证书.

### 🟢 推荐使用`域名模式`

- 非域名模式最安全的使用方式是每个设备都安装证书才能最安全的使用,而域名模式则不需要;
- 如果要在设备上使用非域名模式,又不想安装证书则可将客户端配置中的`skip-cert-verify: false` 设置为`true`即可正常使用(无需修改服务端配置),您发送的数据依旧是加密的,只是如果有人伪造您的服务器,您的客户端将无法识别这个冒牌货.

> ⚠️ **温馨提示**：
>
> 1️⃣ 注册域名可使用 [DigitalPlat Domain](https://domain.digitalplat.org/),免费的域名注册服务,可获得至少一个免费二级域名
>
> 2️⃣ 你需要一台能访问外网的服务器,俺使用的 [vultr](https://www.vultr.com/),喜欢他的不限宽带,5$每月2T流量(带宽大,流量也根本用不完),支持支付宝付款(大陆地区实测选择日本,洛杉矶这2个地区(俺长期使用洛杉矶),体验感几乎和直接使用国内网络一致)
>
> 3️⃣ 域名和非域名模式选择一种安装即可,如果您的地区审查不严,非域名模式也够用,目前默认开启了 obfs 混淆算法,对抗DPI(深度包检测)也不错了
>
> 4️⃣ 安装时需设置服务器 `端口`, `443`、`8443`、`4433`、`8080`、`8888` 都可以,推荐使用`443`端口

---

## 🖥️ 服务端部署教程

### ✅ 推荐服务器系统环境

建议使用干净的 Linux VPS，系统推荐：

- Ubuntu 20.04 / 22.04 及以上
- Debian 12 x64 及以上
- 或其他稳定版本

---

### ⚡ 域名模式 一键部署

⚠️⚠️⚠️ **此模式部署前请提前将域名解析指向你的 VPS 服务器,否则会失败**

```bash
bash <(curl -fsSL https://raw.githubusercontent.com/georgetime1970/h2/main/h2_domain.sh)
```

### ⚡ 非域名模式 一键部署

```bash
bash <(curl -fsSL https://raw.githubusercontent.com/georgetime1970/h2/main/h2.sh)
```

---

### 🛡️ `fail2ban` 一键部署

- 安装成功后可选择安装 `fail2ban` 保护服务器,封禁恶意 IP, 防止 SSH 端口被恶意爆破
- 脚本来源于本项目的[fail2ban.sh](https://github.com/georgetime1970/h2/blob/main/fail2ban.sh) 文件,已开源,请放心食用

```bash
bash <(curl -fsSL https://raw.githubusercontent.com/georgetime1970/h2/main/fail2ban.sh)
```

---

## 🖥️ 信息面板

安装完成后会自动启动常驻面板,默认端口 `18080`(开机自启)。

- 域名模式打开: `https://你的域名:18080/`
- 非域名模式打开: `http://服务器IP:18080/`
- 浏览器弹出登录框时,**用户名随意**,密码填安装时设置的**连接密码**
- 面板可查看: 运行状态、上行/下行流量(单位 MiB)、服务器地址、端口、密码、fail2ban SSH 黑名单
- 提供 **Clash 订阅链接** 和 **二维码**,手机扫码或把链接填进 Clash Verge / ClashMeta 即可
- 面板可直接下载官方最新客户端(Windows / 安卓 / Linux deb),由服务器代为从 GitHub 获取,**无需 VPN 即可安装**,解决没有节点时下不了客户端的问题;首次点击可能需等待
- 订阅路径含随机 token,不要发到群里;云厂商安全组需要放行 `18080/tcp`

![信息面板截图](https://raw.githubusercontent.com/georgetime1970/Hysteria2/main/docs/panel.png)

常用命令:

```bash
sudo systemctl status h2-panel.service            # 查看面板运行状态
sudo systemctl restart h2-panel.service           # 重启面板
sudo journalctl --no-pager -e -u h2-panel.service # 查看面板日志
```

---

### 服务器常用命令

#### 放开端口并检查防火墙

```bash
sudo ufw allow 443/udp    # Hysteria 连接端口(务必开 UDP)
sudo ufw allow 443/tcp    # 域名模式伪装 HTTPS
sudo ufw allow 18080/tcp  # 信息面板
sudo ufw status           # 查看防火墙状态
```

#### 启动 hysteria2 服务

首次启动执行

```bash
sudo systemctl start hysteria-server.service
```

#### 重启 hysteria2 服务

修改配置文件后执行

```bash
sudo systemctl restart hysteria-server.service
```

#### 设置 hysteria2 开机自启

```bash
sudo systemctl enable hysteria-server.service
```

#### 查看 hysteria2 服务状态

```bash
sudo systemctl status hysteria-server.service
```

#### 查询 hysteria2 服务端日志

如果 hysteria2 启动失败可查看原因,看不懂问AI,如果还是解决不了,请加入群里寻求帮助

```bash
sudo journalctl --no-pager -e -u hysteria-server.service
```

#### 查询 fail2ban IP 封禁情况

```bash
sudo fail2ban-client status sshd
```

#### 查询流量统计 API

流量已显示在 [信息面板](#信息面板) 中(单位 MiB)。接口只监听本机,不再对公网开放:

```bash
curl -H "Authorization: secret" http://127.0.0.1:9999/traffic
```

> - `secret` 替换为你设置的连接密码
> - 这个统计的是 **Hysteria 客户端 ↔ 本机** 这一段的代理流量,不是网卡上的全部流量,也不是 VPS 账单流量
> - 你访问网站时,服务器还要再和网站传一份数据,账单大约会是面板数字的 **2 倍**;协议开销也不会算进去
> - 不要用它判断套餐有没有用超,要对齐账单请看云厂商后台
> - 重启 Hysteria 后计数会从 0 开始

返回示例:

```json
{ "user": { "tx": 24279564, "rx": 22961165 } }
```

- `tx` 表示客户端上传到服务器的流量,单位是字节(Byte)
- `rx` 表示客户端从服务器下载的流量,单位是字节(Byte)
- 计算: 24279564 字节(Byte) / 1024 / 1024 = 23.16 MiB (兆字节)

---

## 📱 客户端软件下载

没有代理、打不开 GitHub 时,请用 [信息面板](#信息面板) 上的「客户端下载」,由服务器代为获取官方最新安装包。

- 🤖 **安卓端**：[ClashMeta for Android](https://github.com/MetaCubeX/ClashMetaForAndroid/releases)
- 💻 **电脑端**：[Clash Verge](https://github.com/clash-verge-rev/clash-verge-rev/releases) ,有 linux 版本

---

## 📄 客户端 YAML 配置文件示例

- 将以下内容复制保存为 `h2.yaml`,
- 或安装完成后打开信息面板,把订阅链接填入 Clash Verge / ClashMeta,也可扫描二维码;
- 或服务器端安装完成后,按下回车键会获得对应的完整配置,直接复制使用即可;
- 或直接下载本项目的 [h2.yaml](https://github.com/georgetime1970/h2/blob/main/h2.yaml) 文件进行修改
- 将 `server` 字段改为你自己的 `服务器IP`或`域名`
- 将 `port` 字段改为你自己的 `端口号`
- 将 `password` 字段改为你自己的 `密码`
- 将 `sni` 字段改为你自己的 `服务器IP`或`域名`,必须与`server` 字段一致
- 将 `obfs-password` 字段改为你自己的 `密码`
- 然后就可以发送给 `Clash Verge` 电脑客户端或者 `ClashMeta for Android` 手机客户端使用了
- `Clash Verge` 客户端本地导入配置教程, 请点击 👉 [教程](https://www.clashverge.dev/guide/profile.html#_4)

```yaml
proxies:
  - name: Hysteria2-Server
    type: hysteria2
    server: 1.1.1.1 <你的服务器ip 或 域名>
    port: 443 <你设置的端口>
    password: your_password_here <你的密码>
    sni: 1.1.1.1 <你的服务器ip 或 域名 必须与 server字段 一致>
    # obfs 混淆算法配置,可以增加连接的隐蔽性,对抗 DPI(深度包检测)
    obfs: salamander
    obfs-password: your_password_here <你的密码>
    # 是否跳过证书验证,默认验证证书,设置为true则跳过验证
    # 如果跳过验证,您的客户端将无法识别您的服务器是否被冒充
    skip-cert-verify: false

proxy-groups:
  - name: H2
    type: select
    proxies:
      - Hysteria2-Server

rules:
  - DOMAIN-SUFFIX,cn,DIRECT
  - DOMAIN-SUFFIX,baidu.com,DIRECT
  - DOMAIN-SUFFIX,qq.com,DIRECT
  - DOMAIN-SUFFIX,weibo.com,DIRECT
  - DOMAIN-SUFFIX,alibaba.com,DIRECT
  - DOMAIN-SUFFIX,tmall.com,DIRECT
  - DOMAIN-SUFFIX,taobao.com,DIRECT
  - DOMAIN-SUFFIX,163.com,DIRECT
  - DOMAIN-SUFFIX,360.cn,DIRECT
  - DOMAIN-SUFFIX,gov.cn,DIRECT
  - DOMAIN-SUFFIX,edu.cn,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,H2
```

---

## 常见问题

这里会列出常见的安装问题,新的问题会整理在这里,不断完善中

### 1. 为什么需要 cloudflare_api_token? 如何获取?

域名模式要用 Let's Encrypt **自动签发并续期证书**。本脚本走的是 DNS 验证(不占用 80 端口):证书机构会检查你域名下是否存在 `_acme-challenge` 这条 TXT 记录。脚本拿这个 Token 去 Cloudflare **临时创建/删除这条 DNS 记录**,以此证明域名是你的,然后才能拿到证书。

所以 Token 必须有该域名的 **DNS 编辑**权限。没有它,域名模式会申请证书失败,Hysteria 起不来。非域名模式不需要这个 Token。

获取步骤: 登录 [Cloudflare](https://dash.cloudflare.com/) → 管理帐户 → 帐户 API 令牌 → 创建令牌 → 使用模板「编辑区域 DNS」→ 区域选中你的域名 → 继续创建。得到的一串字符就是 `cloudflare_api_token`,不要发给别人。

### 2.安装成功后建议手动检查hysteria2 服务状态

```bash
sudo systemctl status hysteria-server.service
```

- 如果失败了,先重试重启命令`sudo systemctl restart hysteria-server.service`
- 如果还是无法启动,请查看日志`sudo journalctl --no-pager -e -u hysteria-server.service` ,根据提示解决问题(丢给AI),如果无法解决请加入群里寻求帮助

### 3.客户端连接不上服务器?

1. 端口被封 / 只开了 TCP 没开 UDP: 这是针对服务器的
   - Hysteria 使用 **UDP**。云厂商安全组(和 ufw 是两套)必须放行 **UDP 你设置的端口**(推荐 443)
   - 可以尝试更换一个端口重新安装,或换一台服务器试试
   - 域名模式客户端的 `server` 和 `sni` 必须填**域名**,不要填 IP,否则证书对不上

2. 运营商阻断了UDP访问: 这是针对家庭网络的
   - 我实际遇到过,在下载了100G左右的模型几天后,就突然无法正常连接到代理服务器,这是针对的家庭网络ip的阻断,换服务器无法解决问题,重启光猫就可以了(原因是:重启后你的ip地址变了,封锁就无效了)

## 🔐 VPN 安全性检测指南

### ✅ 1.IP 地址泄露检测

🔍 工具：[IP 检测](https://browserleaks.com/ip)

👀 应看到的是 VPS 的公网 IP，而非本地真实 IP。

---

### ✅ 2.WebRTC 泄露检测

🔍 工具：[WebRTC 检测](https://browserleaks.com/webrtc)

`WebRTC Leak Test`字段显示为`✔No Leak`,代表没有泄露.

🔧 解决方案：

- 已过时 ~~Chrome 安装 [WebRTC Network Limiter](https://chromewebstore.google.com/detail/webrtc-network-limiter/npeicpdbkakmehahjeeohfdhnlpdklia)，在 `扩展程序选项` 中选择 `Use my proxy server`。~~
- 在 `Clash Verge` 电脑端打开 `TUN模式` , 并开启 `严格路由` 模式 , 这样当你使用 `规则模式` 或 `全局模式` 时, 就不会出现 `WebRTC 泄露` 了

---

### ✅ 3. DNS 泄露检测

🔍 工具：[DNS 检测](https://browserleaks.com/dns)

如果出现很多中国的 DNS 服务器, 不一定是出现了 `DNS 泄露`,但也有可能这些DNS服务器是运营商提供的,他们会知道你访问了哪些网站,甚至可能会被用来进行流量分析和监控.

如果你追求极致的隐私保护,请按照下面的解决方案进行设置,以防止 DNS 泄露.其原理是将 DNS 请求也通过 VPN 进行转发,而不是直接发送到 ISP 的 DNS 服务器.

**🔧 解决方案：**

- 启用「`禁用智能多宿主名称解析`」：`Win + R` → `gpedit.msc` → `计算机配置` → `管理模板` → `网络` → `DNS 客户端` → 双击「`禁用智能多宿主名称解析`」→ 选择「`已禁用`」→ 点击「`应用`」和「`确定`」
- 在 `Clash Verge` 电脑端打开 `TUN模式` , 并开启 `严格路由` 模式 , 这样当你使用 **`全局模式`** 时,就不会出现 `DNS` 泄露了

---

### ✅ 4. IPv6 泄露检测

🔍 工具：[IP 检测](https://browserleaks.com/ip)
查看`IPv6 Address`字段,显示 为`n/a`即表示没有检测到 IPv6,这意味着只有 IPv4 流量可用，并且您的真实位置不能通过 IPv6 泄漏.

**🔧 解决方案：** 电脑端禁用 IPv6：

控制面板 → 网络和 Internet → 网络和共享中心 → 更改适配器设置 → 选中网卡,右键`属性` → 取消勾选「`Internet 协议版本 6（TCP/IPv6）`」

---

## 🧭 `Clash Verge` 中「系统代理」和「TUN 模式」的区别与适用场景

| 模式名称     | 本质作用                                 | 覆盖范围                                             | 推荐使用场景                         |
| ------------ | ---------------------------------------- | ---------------------------------------------------- | ------------------------------------ |
| **系统代理** | 设置浏览器/应用的 HTTP/HTTPS/SOCKS5 代理 | ❗️**只作用于支持代理的软件**（如浏览器）             | 网页浏览、开发调试、轻量使用         |
| **TUN 模式** | 创建虚拟网卡，拦截系统层所有流量         | ✅ **拦截所有程序/服务的流量**，包括不支持代理的软件 | 游戏、音乐软件、系统级加速、全局代理 |

- **TUN 模式**现在也叫**虚拟网卡模式**
- 简单理解就是 **`系统代理`** 只会代理一部分软件, **`TUN 模式`** 会接管电脑的所有流量出入
- **追求极致隐私**, 就使用 **`TUN 模式`** 并设置 `严格路由`和`全局模式`, 但是会使访问变慢一点
- 如果不追求极致隐私, 又想访问快一点,就使用 **`系统代理`** 并设置 `规则模式`
- **兼顾隐私和速度**,使用 **`TUN 模式`** 并设置 `规则模式`, 这样就可以通过规则来选择哪些域名/IP走代理,哪些不走代理了

Hysteria2

Hysteria2 Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Hysteria2

Hysteria2 Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README