Setup HTTPS proxy clients

It's quite trivial to set up program which supports proxies to use dumbproxy in plain HTTP mode. However, using HTTP proxy over TLS connection with browsers is little bit tricky. Note that TLS must be enabled (-cert and -key options or -autocert option) for this to work.

Routing all browsers on Windows via HTTPS proxy

Open proxy settings in system's network settings:

Turn on setup script option and set script address:

data:,function FindProxyForURL(u, h){return "HTTPS example.com:8080";}

where instead of example.com:8080 you should use actual address of your HTTPS proxy.

Note: this method will not work with MS Edge Legacy.

Using with Firefox

Option 1. Inline PAC file in settings.

Open Firefox proxy settings, switch proxy mode to "Automatic proxy configuration URL". Specify URL:

data:,function FindProxyForURL(u, h){return "HTTPS example.com:8080";}

Option 2. Browser extension.

Use any proxy switching browser extension which supports HTTPS proxies like this one.

Using with Chrome

Option 1. CLI option.

Specify proxy via command line:

chromium-browser --proxy-server='https://example.com:8080'

Option 2. Browser extension.

Use any proxy switching browser extension which supports HTTPS proxies like this one.

Using with other applications

It is possible to expose remote HTTPS proxy as a local plaintext HTTP proxy with help of external application which performs remote communication via TLS and exposes local plaintext socket. dumbproxy itself can be such application. E.g. running dumbproxy -bind-address 127.0.0.1:8080 -proxy 'h2://login:password@example.org:443' exposes remote proxy with TLS and authentication as a local plain HTTP proxy without TLS and authorization.

Using with Android

1. Install DumDum on your Android device from F-Droid or GitHub.

2. Open DumDum, tap ➕ (in the upper right corner) and choose "HTTP(S)".

3. Configure a connection:

   

Important

For HTTPS, make sure the "Encryption" parameter is set to "tls".

4. Save settings by tapping ✔.
5. If a self-signed certificate is used, go to "Settings > Advanced > Connection" and enable "Ignore Proxy SSL Certificate."
6. Enjoy!