CPanel Proxy Support

What is CPanel Proxy Support?

CPanel proxy support allows you to access both the domain.tld/cpanel and domain.tld/webmail as sub domains. Additionally the normal CPanel ports for both the control panel and webmail are proxied through port 80. There are quite a few firewalls that block 2082, 2083 et. cetra as they are not standard ports.

The following once enabled should work:

http://cpanel.domain.tld
http://webmail.domain.tld
http://whm.domain.tld

Requirements

CPanel
mod_proxy

How to enable CPanel Proxy

1. Open the WHM and access tweak settings:

Main >> Server Configuration >> Tweak Settings

2. Enable the following options:

Add proxy VirtualHost to httpd.conf to automatically redirect unconfigured cpanel, webmail, webdisk and whm subdomains to the correct port (requires mod_rewrite and mod_proxy)

Automatically create cpanel, webmail, webdisk and whm proxy subdomain DNS entries for new accounts. When this is initially enabled it will add appropriate proxy
subdomain DNS entries to all existing accounts. (Use /scripts/proxydomains to reconfigure the DNS entries manually)

This will setup all new accounts with the proper records; existing ones will need to be added via the /scripts/proxydomains script.

I would recommend disabling this one as you probably don’t want a client to break the setup for their domain trying to fix it:

Allow users to create cpanel, webmail, webdisk and whm subdomains that override automatically generated proxy subdomains

3. For existing accounts open a shell prompt as root. All you need to do now is to setup the sub-domains so that customers can access them. The best way to do this is to specify the username:

Example:

/scripts/proxydomains --user=username add

Usage:

/scripts/proxydomains --user=mycpaneluser add

To do all accounts on the server (which can take a while):

/scripts/proxydomains add

To list all the options for this script simply type

/scripts/proxydomains

Old Way

Occasionally you will see someone requesting that the software from cpanelproxy.net or the old sourceforge be installed. I would highly recommend against this as its already supported by CPanel and the old way no longer works.