---
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는 HTTP/3의 기반인 UDP 기반 프로토콜 QUIC 위에서 실행되므로 패킷이 손실되는 네트워크에서도 속도를 유지합니다. 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는 TCP와 같은 연결 위에서 QUIC 데이터그램으로 UDP를 전달합니다. 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 클라이언트 인증서 | ❌ |
| Realm(랑데부 서버를 통한 연결) | ❌ |
| 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` | 일부 앱이 포트에 쓰는 대신 사용하는 포트 호핑 포트. |
| `hop-interval` | 초 단위의 호핑 간격. |
| `up`, `down` | 일부 앱이 쓰는 업로드 및 다운로드 대역폭. |

Potatso는 `obfs=gecko` 또는 `ech`가 있는 링크를 가져오지 않습니다. `hysteria2+realm://` 링크도 가져오지 않습니다.

Potatso가 Hysteria 2 서버를 공유할 때는 호핑 포트를 포트 자리에 쓰거나 `mport`로 쓴 `hysteria2://` 링크를 제공합니다.

### 예시 {#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/ko/protocols/hysteria2/index.mdx