Skip to content

HTTP

http outbound is a HTTP CONNECT proxy client.

Structure

{
  "type": "http",
  "tag": "http-out",

  "server": "127.0.0.1",
  "server_port": 1080,
  "username": "sekai",
  "password": "admin",
  "path": "",
  "headers": {},
  "version": 0,
  "disable_version_fallback": false,
  "tls": {},

  ... // HTTP2 Fields / QUIC Fields
  ... // Dial Fields
}

Fields

server

Required

The server address.

server_port

Required

The server port.

username

Basic authorization username.

password

Basic authorization password.

path

Path of HTTP request.

headers

Extra headers of HTTP request.

version

Since sing-box 1.15.0

HTTP version.

Available values: 1, 2, 3.

2 is used by default, or 1 if path or the Host header is set.

path and the Host header are only available for 1.

When 3, HTTP2 Fields are replaced by QUIC Fields.

disable_version_fallback

Since sing-box 1.15.0

Disable automatic fallback to lower HTTP version.

tls

TLS configuration, see TLS.

HTTP2 Fields

Since sing-box 1.15.0

When version is 2 (default).

See HTTP2 Fields for details.

QUIC Fields

Since sing-box 1.15.0

When version is 3.

See QUIC Fields for details.

Dial Fields

See Dial Fields for details.