Domain Booster Proxy

Domain Booster Proxy binaries have no dependencies and are available for variety of platforms. Download Domain Booster Proxy for your platform and extract the archive.

Create file domainbooster-proxy-server.conf in the same directory where domain-proxy-server executable is located. Domain Booster config panel in Confluence can generate sample config file for the web sites you defined. The minimal config file has the following structure:

http://site.example.com, https://site.example.com {
domainbooster_proxy http://confluenceserver/confluence {
api_key 696701c9ffbc4a4fa41eb16b07f0b170
}
}

This tells Domain Booster Proxy to accept HTTP and HTTPS connections for site.example.com which has to be defined in Domain Booster settings in Confluence. The API key authenticates proxy with the Confluence when obtaining host configuration. You can find API key for your instance in Domain Booster configuration panel in Confluence.

Domain Booster Proxy is based on Caddy Server and you can use any Caddy's documentation to review all available configuration options and supported command line arguments. Note that Domain Booster Proxy uses domainbooster-proxy-server.conf, not Caddyfile.

The above example assumes use of automatic HTTPS that obtains SSL certificates from Let's Encrypt. To use this setup, start the proxy with the following options:

domainbooster-proxy-server -agree -email admin_email@example.com

To use own certificate file:

http://site.example.com, https://site.example.com {
domainbooster_proxy http://confluenceserver/confluence {
api_key 696701c9ffbc4a4fa41eb16b07f0b170
}
tls cert_file key
}

and start the proxy with:

domainbooster-proxy-server

To use a self signed certificate:

http://site.example.com, https://site.example.com {
domainbooster_proxy http://confluenceserver/confluence {
api_key 696701c9ffbc4a4fa41eb16b07f0b170
}
tls self_signed
}

Startup Scripts

To run the proxy on system start, check Caddy's init script examples.

Running with Confluence behind Nginx/Apache

It's a common practice to run Confluence behind Nginx or Apache server that provides SSL/TLS termination. In that case run Domain Booster Proxy on a custom port and update Nginx/Apache config to proxy your host names to it.

http://site.example.com:4321 {
domainbooster_proxy http://confluenceserver/confluence {
api_key 696701c9ffbc4a4fa41eb16b07f0b170
external_url https://confluenceserver
}
}

Make sure to pass Host HTTP header to Domain Booster Proxy to make sure it receives the original caller's host name.

For Nginx, use proxy_set_header directive, for example:

location / {
proxy_pass http://site.example.com:4321/;
proxy_set_header Host $http_host;
}

For Apache, use "ProxyPreserveHost On":

<VirtualHost *:80>
ServerName confluenceserver
ProxyPreserveHost On
ProxyPass / http://127.0.0.1:4321/ timeout=35
ProxyPassReverse / http://127.0.0.1:4321/
</VirtualHost>

comments powered by Disqus