Overview
To connect to a destination from behind a proxy server, you must configure proxy server settings. If you are able to make an initial connection to the destination without connecting through a proxy, configure your proxy settings from the CrashPlan app. However, if you can only connect through a proxy, then you must configure proxy settings manually. Both processes are described below.
Considerations
- This article assumes you have permission to manage your proxy settings. Your administrator may prevent changes to your proxy settings.
- The CrashPlan app does not support SOCKS-only HTTP proxies.
Recommended solution
If you are able to make an initial connection to the destination without connecting through a proxy, configure proxy settings in the CrashPlan app:
- Open the CrashPlan app.
- Select
- Select Network.
- Next to Proxy, click Change.
- Select Enable proxy.
- If your proxy connection requires a proxy auto-config (PAC) file, select Manual then enter the file URL in PAC URL.
- Click Save.
The CrashPlan app can now detect your proxy settings and connect to the destination, which allows you to begin your backup and modify your settings.
Proxy auto-config (PAC) files
A proxy auto-config (PAC) file defines what proxies the CrashPlan app should use to connect to its destinations. Use of a PAC file is enabled by a CrashPlan administrator.
The PAC file specifies whether the CrashPlan app should connect through a specific proxy, connect directly, or a combination depending on the desired order of failover. The PAC file is JavaScript and implements the FindProxyForURL method that returns the proxies to use for a specified URL and host. The following is an example of a PAC file:
function FindProxyForURL(url, host) { return "PROXY fastproxy.example.com:8080; PROXY proxy.example.com:8080; DIRECT"; }
The example PAC file directs a CrashPlan app to first try fastproxy.example.com; if that fails, try proxy.example.com; if that fails, try a direct connection. All proxy servers defined in the PAC file must have a port specified.
- CrashPlan app version 8.7.1 and later automatically applies the
DIRECT
connection option if none is explicitly defined in the PAC file. - In CrashPlan app versions 6.0 - 8.7.0, the PAC file must include the
DIRECT
option. If not, the CrashPlan app does not attempt a direct connection if the proxy fails. After adding the"DIRECT"
option to your PAC file, issue theproxy refresh
command in the CrashPlan app's command-line interface.
Alternative solution
CrashPlan only
Work with your CrashPlan administrator to set the proxy URL in a deployment policy.
Confirm your connection
To confirm that the client is able to connect to the server using the proxy:
- Open the CrashPlan app.
-
Open CrashPlan Commands using one of the following methods:
- Version 8.6 and later: Double-click the CrashPlan logo in the upper-left corner.
-
All versions: Enter the keyboard shortcut for your operating system:
- Windows: Ctrl+Shift+C
- Mac: Option+Command+C
- Linux: Ctrl+Shift+C
- Enter the following command-line command using the server and port for the destination:
proxy test server:port
- For example:
proxy test master-server.example.com:443
- For example:
This will also list the proxies returned by the PAC file that the CrashPlan app is using.
External resources
- Digital Inspiration: How to Edit Files That Require Admin Privileges
- CNET: How to edit OS X system files with TextEdit
- Wikipedia: Proxy auto-config (PAC)