Skip to content

HTTP ​

An HTTP proxy: CONNECT tunnels and absolute-form requests (GET http://…), with Basic authentication. TCP only.

Structure ​

json
{
  "tag": "http-in",
  "listen": "127.0.0.1",
  "port": 8080,
  "transport": [{ "type": "tcp" }],
  "protocol": {
    "type": "http",
    "settings": {
      "users": [{ "name": "alice", "password": "correct horse" }],
      "handshake_timeout": "10s"
    }
  }
}

WARNING

Basic authentication sends the password readably. Use it only on a trusted network or inside an encrypting transport.

Inbound fields ​

users ​

list of users

Each user has a name, which may not contain :, and a password. With none, no login is asked: anyone who reaches the port may use it, and check warns off loopback. See Users.

Outbound fields ​

username, password ​

string

The login, if the server asks for one. Set both or neither.

Fields for both ​

handshake_timeout ​

durationDefault: 10s

How long the request (inbound) or the answer to CONNECT (outbound) may take.