115 lines
2.1 KiB
Markdown
115 lines
2.1 KiB
Markdown
---
|
||
icon: material/new-box
|
||
---
|
||
|
||
!!! question "自 sing-box 1.14.0 起"
|
||
|
||
### 结构
|
||
|
||
字符串或对象。
|
||
|
||
当为字符串时，为顶层 `http_clients` 中定义的共享 [HTTP 客户端](/zh/configuration/shared/http-client/) 的标签。
|
||
|
||
当为对象时：
|
||
|
||
```json
|
||
{
|
||
"engine": "",
|
||
"version": 0,
|
||
"disable_version_fallback": false,
|
||
"headers": {},
|
||
|
||
... // HTTP2 字段
|
||
|
||
"tls": {},
|
||
|
||
... // 拨号字段
|
||
}
|
||
```
|
||
|
||
### 字段
|
||
|
||
#### engine
|
||
|
||
要使用的 HTTP 引擎。
|
||
|
||
可用值：
|
||
|
||
* `go`（默认）
|
||
* `apple`
|
||
|
||
`apple` 使用 NSURLSession，仅在 Apple 平台可用。
|
||
|
||
!!! warning ""
|
||
|
||
仅供实验用途：由于 CGO 和 Network.framework 占用的内存都很多，
|
||
不应在 iOS 和 tvOS 的热路径中使用。
|
||
|
||
支持的字段：
|
||
|
||
* `headers`
|
||
* `tls.server_name`（必须与请求主机匹配）
|
||
* `tls.insecure`
|
||
* `tls.min_version` / `tls.max_version`
|
||
* `tls.certificate` / `tls.certificate_path`
|
||
* `tls.certificate_public_key_sha256`
|
||
* 拨号字段
|
||
|
||
不支持的字段：
|
||
|
||
* `version`
|
||
* `disable_version_fallback`
|
||
* HTTP2 字段
|
||
* QUIC 字段
|
||
* `tls.engine`
|
||
* `tls.alpn`
|
||
* `tls.disable_sni`
|
||
* `tls.cipher_suites`
|
||
* `tls.curve_preferences`
|
||
* `tls.client_certificate` / `tls.client_certificate_path` / `tls.client_key` / `tls.client_key_path`
|
||
* `tls.fragment` / `tls.record_fragment`
|
||
* `tls.kernel_tx` / `tls.kernel_rx`
|
||
* `tls.ech`
|
||
* `tls.utls`
|
||
* `tls.reality`
|
||
|
||
#### version
|
||
|
||
HTTP 版本。
|
||
|
||
可用值：`1`、`2`、`3`。
|
||
|
||
默认使用 `2`。
|
||
|
||
当为 `3` 时，[HTTP2 字段](#http2-字段) 替换为 [QUIC 字段](#quic-字段)。
|
||
|
||
#### disable_version_fallback
|
||
|
||
禁用自动回退到更低的 HTTP 版本。
|
||
|
||
#### headers
|
||
|
||
自定义 HTTP 标头。
|
||
|
||
`Host` 标头用作请求主机。
|
||
|
||
### HTTP2 字段
|
||
|
||
当 `version` 为 `2`（默认）时。
|
||
|
||
参阅 [HTTP2 字段](/zh/configuration/shared/http2/) 了解详情。
|
||
|
||
### QUIC 字段
|
||
|
||
当 `version` 为 `3` 时。
|
||
|
||
参阅 [QUIC 字段](/zh/configuration/shared/quic/) 了解详情。
|
||
|
||
### TLS 字段
|
||
|
||
参阅 [TLS](/zh/configuration/shared/tls/#出站) 了解详情。
|
||
|
||
### 拨号字段
|
||
|
||
参阅 [拨号字段](/zh/configuration/shared/dial/) 了解详情。
|