Using a Proxy

Xill4 can be configured to route all network requests through a proxy. To setup Xill4 to proxy the request, you need to set the following environment variables.

Name	Required	Description
XILL4_PROXY_HTTP	✔️ Yes	Route all HTTP network to this proxy address
XILL4_PROXY_HTTPS	✔️ Yes	Route all HTTPS network to this proxy address
XILL4_PROXY_NO_PROXY	❌ No	Exclude the following globs from being proxied

Alternatively, you can define the proxy settings in your config.yml file:

proxy:
    http: http://your-url.com

note

Both the HTTP and HTTPS proxy are URLs need to start with http://.

Exclude URLs using globs

You can exclude certain requests from being proxied by using the XILL4_PROXY_NO_PROXY environment variable. For example: XILL4_PROXY_NO_PROXY='*.foo.com,baz.com' Alternatively, you can define the proxy settings in your config.yml file:

proxy:
    noProxy: 
        - your-excluded-url.com

This will not proxy any request to baz.com or any of the subdomains of foo.com.

Proxy Authentication

If the proxy is protected with credentials, the credentials should be added to the environment variables. For example: XILL4_HTTP_PROXY=http://username:password@localhost:8080 Where username and password should be substituted with your credentials.

The proxy will use Basic-Authentication through the PROXY-AUTHORIZATION-Header in the outgoing request.