docs/configuration/inbound/hysteria2.zh.md
!!! quote "sing-box 1.14.0 中的更改"
:material-plus: [bbr_profile](#bbr_profile)
:material-plus: [realm](#realm)
:material-alert: [obfs](#obfstype)
!!! quote "sing-box 1.11.0 中的更改"
:material-alert: [masquerade](#masquerade)
:material-alert: [ignore_client_bandwidth](#ignore_client_bandwidth)
{
"type": "hysteria2",
"tag": "hy2-in",
... // 监听字段
"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,
"tls": {},
... // QUIC 字段
"masquerade": "", // 或 {}
"bbr_profile": "",
"brutal_debug": false,
"realm": {
"server_url": "https://realm.example.com",
"token": "",
"realm_id": "",
"stun_servers": [],
"stun_domain_resolver": "", // 或 {}
"ip_version": 0,
"port_mapping": {
"enabled": false,
"timeout": "",
"lifetime": ""
},
"http_client": {}
}
}
!!! warning "与官方 Hysteria2 的区别"
官方程序支持一种名为 **userpass** 的验证方式，
本质上是将用户名与密码的组合 `<username>:<password>` 作为实际上的密码，而 sing-box 不提供此别名。
要将 sing-box 与官方程序一起使用， 您需要填写该组合作为实际密码。
参阅 监听字段。
支持的速率，默认不限制。
与 ignore_client_bandwidth 冲突。
QUIC 流量混淆器类型，可选 salamander gecko。
如果为空则禁用。
QUIC 流量混淆器密码。
!!! question "自 sing-box 1.14.0 起"
最小线上数据包大小（字节）。仅限 Gecko。
默认使用 512。
!!! question "自 sing-box 1.14.0 起"
最大线上数据包大小（字节）。仅限 Gecko。
默认使用 1200。
Hysteria 用户
认证密码。
当 up_mbps 和 down_mbps 未设定时:
命令客户端使用 BBR 拥塞控制算法而不是 Hysteria CC。
当 up_mbps 和 down_mbps 已设定时:
禁止客户端使用 BBR 拥塞控制算法。
==必填==
TLS 配置, 参阅 TLS。
参阅 QUIC 字段 了解详情。
HTTP3 服务器认证失败时的行为 （URL 字符串配置）。
| Scheme | 示例 | 描述 |
|---|---|---|
file | file:///var/www | 作为文件服务器 |
http/https | http://127.0.0.1:8080 | 作为反向代理 |
如果 masquerade 未配置，则返回 404 页。
与 masquerade.type 冲突。
HTTP3 服务器认证失败时的行为 （对象配置）。
| Type | 描述 | 字段 |
|---|---|---|
file | 作为文件服务器 | directory |
proxy | 作为反向代理 | url, rewrite_host |
string | 返回固定响应 | status_code, headers, content |
如果 masquerade 未配置，则返回 404 页。
与 masquerade 冲突。
文件服务器根目录。
反向代理目标 URL。
重写请求头中的 Host 字段到目标 URL。
固定响应状态码。
固定响应头。
固定响应内容。
!!! question "自 sing-box 1.14.0 起"
BBR 拥塞控制算法配置，可选 conservative standard aggressive。
默认使用 standard。
启用 Hysteria Brutal CC 的调试信息日志记录。
!!! question "自 sing-box 1.14.0 起"
将此入站注册到 Hysteria Realm 会合服务，以启用 NAT 穿透。
入站通过 STUN 发现自己的公网地址并注册到 realm，借助 UDP 打洞接受客户端连接，无需可公网直达的监听地址。
会合服务参阅 Hysteria Realm。
==必填==
Realm 会合服务 URL。
Realm 的 Bearer 令牌，需与 realm 上配置的 users[].token 之一匹配。
==必填==
Realm 上的槽位标识符。
1–64 字符，需匹配 ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$。
出站需使用相同的 realm_id 才能找到本服务器。
==必填==
用于发现公网地址的 STUN 服务器列表（host 或 host:port）。
用于解析 STUN 服务器域名的域名解析器。
此选项的格式与 路由 DNS 规则动作 相同，但不包含 action 字段。
若直接将此选项设置为字符串，则等同于设置该选项的 server 字段。
如果为空，则使用默认域名解析器。
将 realm 连接（STUN、打洞与最终的 QUIC 路径）限制为单一 IP 版本。
4 或 6。默认使用两者。
listen 地址必须与所选版本兼容。
通过 UPnP 或 NAT-PMP 在本地网关上维护 UDP 端口映射。
映射在 STUN 发现之前建立，可在支持的网关后提升打洞成功率；失败不影响正常流程。
需要 IPv4：与 "ip_version": 6 冲突。
启用端口映射。
网关发现与映射操作的超时。
默认使用 10s。
映射的租约时长；每过一半时长续期一次。
默认使用 10m。
与 realm 通信使用的 HTTP 客户端。
参阅 HTTP 客户端 了解详情。