# Hysteria2 - sing-box
The universal proxy platform.
Author: nekohasekai

跳转至

# Hysteria2

sing-box 1.11.0 中的更改

masquerade
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": {},
      "masquerade": "", // 或 {}
      "brutal_debug": false
    }

与官方 Hysteria2 的区别

官方程序支持一种名为 userpass 的验证方式， 本质上上是将用户名与密码的组合 `<username>:<password>` 作为实际上的密码，而 sing-box 不提供此别名。 要将 sing-box 与官方程序一起使用， 您需要填写该组合作为实际密码。

### 监听字段

参阅 监听字段。

### 字段

#### up_mbps, down_mbps

支持的速率，默认不限制。

与 `ignore_client_bandwidth` 冲突。

#### obfs.type

QUIC 流量混淆器类型，仅可设为 `salamander`。

如果为空则禁用。

#### obfs.password

QUIC 流量混淆器密码.

#### users

Hysteria 用户

#### users.password

认证密码。

#### ignore_client_bandwidth

当 `up_mbps` 和 `down_mbps` 未设定时:

命令客户端使用 BBR 拥塞控制算法而不是 Hysteria CC。

当 `up_mbps` 和 `down_mbps` 已设定时:

禁止客户端使用 BBR 拥塞控制算法。

#### tls

必填

TLS 配置, 参阅 TLS。

#### masquerade

HTTP3 服务器认证失败时的行为 （URL 字符串配置）。

Scheme | 示例 | 描述
--- | --- | ---
`file` | `file:///var/www` | 作为文件服务器
`http/https` | `http://127.0.0.1:8080` | 作为反向代理

如果 masquerade 未配置，则返回 404 页。

与 `masquerade.type` 冲突。

#### masquerade.type

HTTP3 服务器认证失败时的行为 （对象配置）。

Type | 描述 | 字段
--- | --- | ---
`file` | 作为文件服务器 | `directory`
`proxy` | 作为反向代理 | `url`, `rewrite_host`
`string` | 返回固定响应 | `status_code`, `headers`, `content`

如果 masquerade 未配置，则返回 404 页。

与 `masquerade` 冲突。

#### masquerade.directory

文件服务器根目录。

#### masquerade.url

反向代理目标 URL。

#### masquerade.rewrite_host

重写请求头中的 Host 字段到目标 URL。

#### masquerade.status_code

固定响应状态码。

#### masquerade.headers

固定响应头。

#### masquerade.content

固定响应内容。

#### brutal_debug

启用 Hysteria Brutal CC 的调试信息日志记录。