diff --git a/index.html b/index.html index 365e67c4..4fd8fc50 100644 --- a/index.html +++ b/index.html @@ -1618,13 +1618,24 @@

Proxy

Any URL. + + proxyPerShema + JSON Object representing shema proxy specifiers + Setting the specific proxy specifier per scheme or + "default" for all other not specified schemes when the + proxyType is "manual". + A valid shema proxy specifiers mutually exclusive with other + scheme-specific proxy configurations ("httpProxy", + "sslProxy", "socksProxy"). + + httpProxy string Defines the proxy host for HTTP traffic when the proxyType is "manual". - A host and optional port for - scheme "http". + A host and optional port for scheme "http". Mutually + exclusive with proxyPerShema. @@ -1640,8 +1651,8 @@

Proxy

string Defines the proxy host for encrypted TLS traffic when the proxyType is "manual". - A host and optional port for - scheme "https". + A host and optional port for scheme "https". Mutually + exclusive with proxyPerShema. @@ -1649,7 +1660,8 @@

Proxy

string Defines the proxy host for a SOCKS proxy when the proxyType is "manual". - A host and optional port with an undefined scheme. + A host and optional port with an undefined scheme. Mutually + exclusive with proxyPerShema. @@ -1657,11 +1669,86 @@

Proxy

number Defines the SOCKS proxy version when the proxyType is "manual". - Any integer between 0 and 255 inclusive. + Any integer between 0 and 255 inclusive. Mutually exclusive with + proxyPerShema. + + + + +

A shema proxy specifiers is a JSON Object where each + key represents either a scheme to be proxied or a string + "default" for proxying traffic with not specified schemes, and + value is proxy specifier to be used as a proxy server for the traffic + with the given scheme. For example, the configuration below would proxy + HTTP traffic to "proxy.example.com:443" over HTTPS, HTTPS traffic to + "proxy.example.com:1080" over SOCKS4, and all other traffic to + "proxy.example.com:443" over SOCKS5: + +

+{
+  "http": {
+    "host": "proxy.example.com",
+    "port": 443,
+    "protocol": "https"
+  },
+  "https": {
+    "host": "proxy.example.com",
+    "port": 1080,
+    "protocol": "socks4"
+  },
+  "default": {
+    "host": "proxy.example.com",
+    "port": 443,
+    "protocol": "socks5"
+  }
+}
+
+ +

A shema proxy specifiers is considered to be a + valid shema proxy specifiers, if each of it's + own property is a non-empty String, and each of it's keys is a + valid proxy specifier. + +

A proxy specifier is a JSON Object with the following keys: + + + + + + + + + + + +
Key + Value Type + Description + Valid values +
host + string + Defines the proxy server host. + A valid host with optional + credentials. +
port + integer + Defines the proxy server port. + A valid port.
protocol + string + Defines the protocol to communicate with the proxy server. + "http", "ssl", "socks4", + "socks5" or other implementation-specific proxy protocol. +
+

A proxy specifier is considered to be a + valid proxy specifier, if it is a JSON Object and contains + own properties for each of the proxy specifier's table's, and + each property contains a valid value, as defined in the + proxy specifier's table. +

A host and optional port for a scheme is defined as being a valid host, optionally followed by a colon and a valid port. The host may