---
title: "Hysteria 2"
description: "Potatso 支援的 Hysteria 2 選項、TLS 設定、連結與功能。"
---

> Documentation Index
> Fetch the complete documentation index at: https://potatso.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hysteria 2

Hysteria 2 伺服器由**密碼**及其 **TLS 設定**描述，另外可搭配**混淆**和**連接埠跳躍**。Hysteria 2 執行於 QUIC（HTTP/3 背後以 UDP 為基礎的協定）之上，因此在會掉封包的網路上仍能維持速度。當 Potatso 支援伺服器的設定時，就能連上該伺服器。請使用下方表格，對照服務商提供或 `hysteria2://` 連結中顯示的伺服器設定。

你可以手動加入 Hysteria 2 伺服器、使用 [`hysteria2://` 或 `hy2://` 連結](#links)，或透過匯入：

- Clash 或 Mihomo 訂閱，
- Xray 設定，
- Surge 設定。

Potatso 目前還無法從 sing-box 設定匯入 Hysteria 2 伺服器。請改用該伺服器的 `hysteria2://` 連結。

## 驗證 {#authentication}

| 伺服器的驗證 | 支援 |
| --- | --- |
| 密碼（`auth.type: password`） | ✅ |
| 使用者名稱和密碼（`auth.type: userpass`） | ✅ 請合併為一個密碼輸入：`name:password` |
| HTTP 或指令驗證器 | ✅ 輸入它預期的密碼 |

密碼錯誤就無法連線。許多伺服器會對沒有密碼的人顯示一般網站（也就是它的偽裝）。

## 混淆 {#obfuscation}

| 混淆 | Clash 鍵 | 連結參數 | 支援 |
| --- | --- | --- | --- |
| 無 | | | ✅ |
| Salamander | `obfs: salamander`、`obfs-password` | `obfs=salamander`、`obfs-password` | ✅ |
| Gecko | `obfs: gecko` | `obfs=gecko` | ❌ |

Salamander 會打亂每個封包，讓連線看起來不像 QUIC。密碼必須與伺服器的密碼一致。請在伺服器的設定中將它設為 **Salamander 密碼**。對於沒有混淆的伺服器，請留空。

Potatso 不會匯入使用 Gecko 混淆的伺服器，因為它無法連線到該伺服器。

## 頻寬 {#bandwidth}

| 設定 | Clash 鍵 | 支援 |
| --- | --- | --- |
| 下載頻寬 | `down` | ✅ 伺服器以此速率傳送給你 |
| 上傳頻寬 | `up` | ❌ Potatso 以 BBR 壅塞控制上傳，並忽略此設定 |
| 壅塞控制 | 官方用戶端中的 `congestion` | ❌ 一律為 BBR |

當你設定**下載頻寬**，例如 `100 Mbps` 時，伺服器會使用 Hysteria 的 Brutal 壅塞控制，即使掉封包也以該速率傳送。請設定成接近你真實的下載速度：設得太高反而會讓連線變慢，而不是更快。留空則由伺服器自行調整速率。

頻寬接受帶單位的數字（`bps`、`Kbps`、`Mbps`、`Gbps`），或單純的數字（以 Mbps 計）。

## 連接埠跳躍 {#port-hopping}

支援連接埠跳躍的伺服器會監聽一段範圍的 UDP 連接埠，而 Potatso 會每隔一段時間在它們之間切換。這有助於應對在一段時間後會減速或封鎖單一 UDP 連接埠的網路。

| 設定 | Clash 鍵 | 支援 |
| --- | --- | --- |
| 連接埠 | `ports` | ✅ 範圍（如 `20000-30000`）、清單（如 `443,8443`），或兩者並用 |
| 跳躍間隔 | `hop-interval` | ✅ 單位為秒，預設 30，最小 5。像 `10-30` 這樣的範圍會隨機選擇間隔。 |

請在伺服器的設定中將它們設為**連接埠跳躍**和**跳躍間隔**。伺服器的連接埠此後只用於第一次連線。

## TLS {#tls}

| 設定 | Clash 鍵 | 連結參數 | 支援 |
| --- | --- | --- | --- |
| 伺服器名稱（SNI） | `sni` | `sni`、`peer` | ✅ 未設定時，Potatso 會使用伺服器的位址。 |
| 略過憑證驗證 | `skip-cert-verify` | `insecure` | ✅ |
| 憑證釘選（SHA-256） | `fingerprint` | `pinSHA256` | ✅ |
| ALPN | `alpn` | `alpn` | ✅ 僅限 `h3`，Potatso 一律使用 |
| 自訂 CA 憑證 | 官方用戶端中的 `ca` | | ❌ |
| TLS 用戶端憑證 | `certificate`、`private-key` | | ❌ |
| Encrypted Client Hello（ECH） | `ech-opts` | `ech` | ❌ |
| 以另一個名稱驗證 | `name-cert-verify` | | ❌ |

關閉憑證驗證會讓你與伺服器之間的任何人都能讀取你的流量。許多 Hysteria 2 伺服器使用自簽憑證：請改為釘選它。把伺服器憑證的 SHA-256 設為憑證釘選。設定釘選後，無論名稱為何，Potatso 只信任該憑證，不信任其他任何憑證。

Potatso 不會匯入需要上述任一不支援設定的伺服器，因為沒有該設定它也會連線，但伺服器不會回應。

## UDP {#udp}

Hysteria 2 以 QUIC 資料報承載 UDP，與 TCP 共用同一條連線。UDP 預設為開啟。只有在你的伺服器關閉了 UDP（`disableUDP`）時，才需要在伺服器的設定中關閉 UDP 轉送。

透過 Xray 伺服器時，大於約 1,100 位元組的 UDP 封包抵達時會損壞。這是 Xray 的 Hysteria 2 伺服器的錯誤。官方伺服器、sing-box 和 mihomo 都能轉送任何大小的封包。

## 功能支援 {#features}

| 功能 | 支援 |
| --- | --- |
| [Hysteria 2 協定](https://v2.hysteria.network/docs/developers/Protocol/)：HTTP/3 驗證、TCP 串流 | ✅ |
| QUIC 資料報中的 UDP，包含拆成片段的大型封包 | ✅ |
| 一條 QUIC 連線承載多個連線 | ✅ |
| Salamander 混淆 | ✅ |
| Gecko 混淆 | ❌ |
| [下載頻寬](#bandwidth)（伺服器端的 Brutal） | ✅ |
| 上傳頻寬（你裝置端的 Brutal） | ❌ |
| [連接埠跳躍](#port-hopping) | ✅ |
| Fast open（每個連線少一次往返） | ✅ 一律開啟 |
| 憑證釘選、略過憑證驗證 | ✅ |
| ECH、自訂 CA、TLS 用戶端憑證 | ❌ |
| Realms（透過會合伺服器連線） | ❌ |
| Fake TCP（`mimic`） | ❌ |
| 自訂 QUIC 流量控制視窗、`cwnd`、`udp-mtu` | ❌ |
| `hysteria2://` 與 `hy2://` 連結 | ✅ |

每一項支援的功能都至少用一台真實的 Hysteria 2 伺服器測試過：[官方伺服器](https://v2.hysteria.network/)、[sing-box](https://sing-box.sagernet.org/)、[mihomo](https://wiki.metacubex.one/) 或 [Xray](https://xtls.github.io/)。

官方 Hysteria 用戶端的部分功能是其自身程式的設定，Potatso 以自己的方式完成相同的工作：

- 路由與 ACL：請使用設定檔中的規則。
- 本機 SOCKS5 與 HTTP 伺服器、轉送和 TUN 模式：Potatso 自行擷取你裝置的流量。
- 延遲連線：Potatso 在流量需要伺服器時才連線。

伺服器端的設定，例如偽裝網站、測速或伺服器自身的頻寬限制，你的裝置上不需要做任何設定。

## `hysteria2://` 連結 {#links}

`hysteria2://` 連結用一行就包含整台伺服器。`hy2://` 是名稱較短的同一種連結。

```text
hysteria2://password@host:port/?parameters#name
```

| 部分 | 說明 |
| --- | --- |
| `password` | 密碼，經過百分比編碼。若是使用者名稱和密碼，請寫成 `name:password`。 |
| `host` | 伺服器位址。IPv6 位址請放在方括號中，例如 `[2001:db8::1]`。 |
| `port` | 伺服器連接埠。缺少時，Potatso 使用 443。若要[連接埠跳躍](#port-hopping)，請在此列出連接埠，例如 `443,20000-30000`。 |
| `name` | 選填。伺服器在 Potatso 中的名稱。 |

參數遵循[官方格式](https://v2.hysteria.network/docs/developers/URI-Scheme/)：

| 參數 | 說明 |
| --- | --- |
| `sni` | TLS 伺服器名稱。 |
| `insecure` | `1` 表示關閉憑證驗證。 |
| `pinSHA256` | 伺服器憑證的 SHA-256。 |
| `obfs`、`obfs-password` | `salamander` 及其密碼。 |
| `mport` | 連接埠跳躍的連接埠，有些 App 用它來寫，而不是寫在連接埠中。 |
| `hop-interval` | 跳躍間隔，單位為秒。 |
| `up`、`down` | 上傳與下載頻寬，有些 App 這樣寫。 |

Potatso 不會匯入帶有 `obfs=gecko` 或 `ech` 的連結，也不會匯入 `hysteria2+realm://` 連結。

Potatso 分享 Hysteria 2 伺服器時，會提供 `hysteria2://` 連結，其跳躍連接埠寫在連接埠中或 `mport` 中。

### 範例 {#link-examples}

每個範例都顯示要匯入的連結。密碼是 `secret`。

基本伺服器：

```text
hysteria2://secret@hy2.example.com:443/?sni=hy2.example.com#Basic
```

使用密碼 `hidden` 的 Salamander 混淆：

```text
hysteria2://secret@hy2.example.com:443/?obfs=salamander&obfs-password=hidden#Salamander
```

在 20000 到 30000 之間的連接埠跳躍：

```text
hysteria2://secret@hy2.example.com:443,20000-30000/?sni=hy2.example.com#Hopping
```

已釘選的自簽憑證：

```text
hysteria2://secret@203.0.113.7:443/?sni=hy2.example.com&pinSHA256=abababababababababababababababababababababababababababababababab#Pinned
```

Source: https://potatso.com/docs/zh-hant/protocols/hysteria2/index.mdx