ContextQMD
Back to Whistle

http

docs/en/docs/rules/http.md

2.10.63.3 KB
Original Source

http

Convert the following three requests into HTTP requests (the server will receive the converted HTTP URL):

  1. Tunnel proxy: tunnel://domain:port

    Example: tunnel://www.test.com:443

  2. WebSocket: ws[s]://domain[:port]/[path/to[?query]]

    Example: wss://www.test.com/path?a=1&b=2

  3. Normal HTTP/HTTPS: http[s]://domain[:port]/[path/to[?query]]

    Example: https://www.test.com/path?a=1&b=2

Rule Syntax

txt
pattern http://value [filters...]
ParametersDescriptionDetailed Documentation
patternExpression to match the request URLMatch Pattern Documentation
valueTarget URL format: domain[:port]/[path][?query]
⚠️ Loading data from files/remote URLs is not supportedOperation Instruction Documentation
filtersOptional filters, supported matching:
• Request URL/Method/Header/Content
• Response Status Code/HeaderFilter Documentation

HTTP/HTTPS Conversion

txt
http://www.example.com/path1 http://www.test.com/path/xxx
https://www.example.com/path2 http://www.abc.com/path3/yyy
  1. Automatic Path Concatenation:
    Original RequestConversion Result (URL Received by the Server)
    http://www.example.com/path1http://www.test.com/path/xxx
    http://www.example.com/path1/a/b/c?queryhttp://www.test.com/path/xxx/a/b/c?query
    https://www.example.com/path2http://www.abc.com/path3/yyy
    https://www.example.com/path2/a/b/c?queryhttp://www.abc.com/path3/yyy/a/b/c?query
  2. Disable path concatenation: Use < > or () to wrap the path.
    txt
    www.example.com/path1 http://<www.test.com/path/xxx>
# www.example.com/path1 http://(www.test.com/path/xxx)
    Original requestConversion result (URL received by the server)
    [http/https/wss/ws]://www.example.com/path/x/y/zhttp://www.test.com/path/xxx

WebSocket Conversion

txt
ws://www.example.com/path1 http://www.test.com/path/xxx
wss://www.example.com/path2 http://www.abc.com/path3/yyy

The WebSocket request is replaced with the specified ws request:

Original RequestConversion Result (URL Received by the Server)
ws://www.example.com/path1ws://www.test.com/path/xxx
wss://www.example.com/path2/a/b/c?queryws://www.abc.com/path3/yyy/a/b/c?query

Also supports automatic path concatenation and disabling path concatenation.

TUNNEL Conversion

txt
tunnel://www.example.com:443 http://www.test.com:123
tunnel://www.example2.com:443 http://www.test2.com/path
Original RequestConversion Result (URL Received by the Server)
tunnel://www.example.com:443tunnel://www.test.com:123
tunnel://www.example2.com:443tunnel://www.test2.com:80

Automatically ignores the path of the matching URL. The default port for HTTP is 80, and the default port for HTTPS is 443.