HTTP

HTTP proxy is a proxy service implemented using the CONNECT method of the HTTP protocol.

Standard HTTP Proxy

A simple HTTP proxy service without encryption or authentication.

CLIFile (YAML)

gost -L http://:8080

services:
- name: service-0
  addr: :8080
  handler:
    type: http
  listener:
    type: tcp

Standard HTTP Proxy (With Authentication Enabled)

A non-encrypted HTTP proxy service with user authentication.

CLIFile (YAML)

gost -L http://user:pass@:8080

services:
- name: service-0
  addr: :8080
  handler:
    type: http
    auth:
      username: user
      password: pass
  listener:
    type: tcp

Options

Custom HTTP Headers

Option header allow you to customize request and response headers.

services:
- name: service-0
  addr: :8080
  handler:
    type: http
    chain: chain-0
    header:
      Proxy-Agent: "gost/3.0"
      foo: bar
  listener:
    type: tcp
chains:
- name: chain-0
  hops:
  - name: hop-0
    nodes:
    - name: node-0
      addr: :8443
      connector:
        type: http
        metadata:
          header:
            User-Agent: "gost/3.0"
            foo: bar
      dialer:
        type: tcp

Data Channel

HTTP proxies can be used in combination with various data channels.

HTTP Over TLS

Standard HTTPS proxy service.

CLIFile (YAML)

gost -L https://:8443

is equivalent to

gost -L http+tls://:8443

services:
- name: service-0
  addr: :8443
  handler:
    type: http
  listener:
    type: tls

HTTP Over Websocket

CLIFile (YAML)

gost -L http+ws://:8080

gost -L http+wss://:8080

services:
- name: service-0
  addr: :8080
  handler:
    type: http
  listener:
    type: ws
    # type: wss

HTTP Over KCP

CLIFile (YAML)

gost -L http+kcp://:8080

services:
- name: service-0
  addr: :8080
  handler:
    type: http
  listener:
    type: kcp

UDP Data Forwarding

HTTP proxy extends the support for UDP data based on the standard protocol to implement UDP-Over-HTTP function. The UDP forwarding function of HTTP proxy service is disabled by default and needs to be enabled through udp option.

Server

CLIFile (YAML)

gost -L http://:8080?udp=true

services:
- name: service-0
  addr: :8080
  handler:
    type: http
    metadata:
      udp: true
  listener:
    type: tcp

Client

CLIFile (YAML)

gost -L udp://:10053/1.1.1.1:53 -F http://:8080

services:
- name: service-0
  addr: :10053
  handler:
    type: udp
    chain: chain-0
  listener:
    type: udp
  forwarder:
    nodes:
    - name: target-0
      addr: 1.1.1.1:53
chains:
- name: chain-0
  hops:
  - name: hop-0
    nodes:
    - name: node-0
      addr: :8080
      connector:
        type: http
      dialer:
        type: tcp