sing-box/docs/configuration/inbound/hysteria2.md

91 lines
1.6 KiB
Markdown
Raw Permalink Normal View History

2023-09-09 05:42:38 +00:00
### Structure
```json
{
"type": "hysteria2",
"tag": "hy2-in",
... // Listen Fields
"up_mbps": 100,
"down_mbps": 100,
"obfs": {
"type": "salamander",
"password": "cry_me_a_r1ver"
},
"users": [
{
"name": "tobyxdd",
"password": "goofy_ahh_password"
}
],
"ignore_client_bandwidth": false,
2023-10-21 04:00:00 +00:00
"tls": {},
2023-09-09 05:42:38 +00:00
"masquerade": "",
2023-10-21 04:00:00 +00:00
"brutal_debug": false
2023-09-09 05:42:38 +00:00
}
```
!!! warning ""
QUIC, which is required by Hysteria2 is not included by default, see [Installation](/#installation).
### Listen Fields
See [Listen Fields](/configuration/shared/listen) for details.
### Fields
#### up_mbps, down_mbps
Max bandwidth, in Mbps.
Not limited if empty.
Conflict with `ignore_client_bandwidth`.
#### obfs.type
QUIC traffic obfuscator type, only available with `salamander`.
Disabled if empty.
#### obfs.password
QUIC traffic obfuscator password.
#### users
Hysteria2 users
#### users.password
Authentication password
#### ignore_client_bandwidth
Commands the client to use the BBR flow control algorithm instead of Hysteria CC.
Conflict with `up_mbps` and `down_mbps`.
2023-10-21 04:00:00 +00:00
#### tls
==Required==
TLS configuration, see [TLS](/configuration/shared/tls/#inbound).
2023-09-09 05:42:38 +00:00
#### masquerade
HTTP3 server behavior when authentication fails.
| Scheme | Example | Description |
|--------------|-------------------------|--------------------|
| `file` | `file:///var/www` | As a file server |
| `http/https` | `http://127.0.0.1:8080` | As a reverse proxy |
A 404 page will be returned if empty.
2023-10-21 04:00:00 +00:00
#### brutal_debug
2023-09-09 05:42:38 +00:00
2023-10-21 04:00:00 +00:00
Enable debug information logging for Hysteria Brutal CC.