sing-box/docs/configuration/shared/http-client.md

icon

icon
material/new-box

!!! question "Since sing-box 1.14.0"

Structure

A string or an object.

When string, the tag of a shared HTTP Client defined in top-level http_clients.

When object:

{
  "version": 0,
  "disable_version_fallback": false,
  "headers": {},

  ... // HTTP2 Fields

  "tls": {},

  ... // Dial Fields
}

Fields

version

HTTP version.

Available values: 1, 2, 3.

2 is used by default.

When 3, HTTP2 Fields are replaced by QUIC Fields.

disable_version_fallback

Disable automatic fallback to lower HTTP version.

headers

Custom HTTP headers.

Host header is used as request host.

HTTP2 Fields

When version is 2 (default).

See HTTP2 Fields for details.

QUIC Fields

When version is 3.

See QUIC Fields for details.

TLS Fields

See TLS for details.

Dial Fields

See Dial Fields for details.