CDN (RuGeeks) → Settings is available to the customers who are using CDN by RuGeeks and enabled RuGeeks integration in the Qrator Labs dashboard. This section lists settings affecting CDN operation. You can also disable integration here. All settings are applied only to the selected domain or service.

Set hostnames

By default RuGeeks is providing you with a single hostname which the CDN will use for responses on behalf of your domain or service. This hostname is primary and available regardless of other settings. You can add an arbitrary number of additional hostnames in Set Hostnames widget.

1. Select the specified domain/service in Domains or Services section.

2. Choose CDN (RuGeeks) → Settings in the menu.

3. In CDN Hostnames click Set Hostnames.

4. In the appearing window input the list of hostnames separated by line breaks.

5. Click Save.

6. Access your domain name registrar's control panel. For each of the hostnames CDN must respond by create a CNAME record pointing at the primary CDN hostname provided by RuGeeks.

   Wait for the DNS cache refresh after saving the changes if needed.

Example

Enable HTTPS

By default the CDN supports HTTP protocol. In order to enable HTTPS you need to install an SSL/TLS certificate for it. You can choose any of the certificates you have added to the Certificate storage.

1. Select the specified domain/service in Domains or Services section.

2. Choose CDN (RuGeeks) → Settings in the menu.

3. In Certificate section click Install certificate.

4. Find and select a certificate in the appearing window. You can use Hostname field for search.

   To see the data about a specific certificate in the list click . The details shown are the same as in the Certificate storage.

   Select the certificate you want to install for CDN and click Install.

Disable HTTPS

1. Select the specified domain/service in Domains or Services section.

2. Choose CDN (RuGeeks) → Settings in the menu.

3. In Certificate section click Delete next to the installed certificate description.

4. In the appearing window click Delete.

Change HTTP header settings

This block contains settings related to processing HTTP headers in requests and responses sent and received by the CDN server.

1. Select the specified domain/service in Domains or Services section.

2. Choose CDN (RuGeeks) → Settings in the menu.

3. Change the needed parameters under Headers section.

   • Upstream headers, Client headers

     Sets of HTTP headers appended by CDN. Upstream headers defines the headers added to each user request when sending it to the upstream. Client headers defines the headers added to each response returned to the user.

     Click the Edit button next to the name of the header set you want to edit. For each header enter Name and Value separately. Both name and value should be non-empty. In order to add another header click Add row. In order to delete a header click Delete. Click Save to apply the changes.

   • Access-Control-Allow-Origin

     A list of regular expressions defining the acceptable values of the Origin header in user requests. For each Origin value matching one of the regular expressions CDN will add the same value in the Access-Control-Allow-Origin header of the response. Thus the browser will be allowed to use the files received from CDN on websites listed in the Origin header.

     Click Edit. Enter a valid regular expression on each line. If the expression is valid you will see a icon next to it. To add another regular expression click Add row. To remove a regular expression click Delete. Click Save to apply the changes.

     Tip

     You can check the correctness of a regular expression by clicking the icon. In the appearing widget you can input an arbitrary string to check whether it matches the regular expression you put in earlier or not. If the check is successful you will see the icon near the string, otherwise you will see the icon. In order to close the widget and go back to editing the regular expression, click outside it or press Esc key.

   • Client IP header

     If you set this parameter, CDN will pass a user's IP address to the upstream in a HTTP header with the given name.

     Click Edit. In the appearing text area enter a valid HTTP header name. Click Save to apply the changes.

Example

Set Request URL policy

By defauld CDN assumes every request it receives should be forwarded to the upstream but in some cases this may be a suboptimal behaviour.

If you are aware that on some URLs the upstream cannot provide the content and the user should receive 404 Not Found or any other error code, it is recommended to describe them using the request URL policy. Such configuration allows CDN to return error code responses without requesting the upstream in aforementioned cases.

In order to set the policy:

1. Select the specified domain/service in Domains or Services section.

2. Choose CDN (RuGeeks) → Settings in the menu.

3. Change the needed settings in Request URL policy.

   • White URLs

     A list of regular expressions describing all paths a user may request from CDN. If this parameter is non-empty, for any other URL the 404 Not Found error will be returned (except for Blocked URLs).

     Click Edit. Enter a valid regular expression on each line. If the expression is valid you will see a icon next to it. To add another regular expression click Add row. To remove a regular expression click Delete. Click Save to apply the changes.

   • Blocked URLs

     A list of reregular expressions describing specific paths for with CDN must return specific error codes.

     Click Edit. Enter a valid regular expression on each line. If the expression is valid you will see a icon next to it. In the Code field ender the error code CDN should return for the requests matching this regular expression. To add another tuple of a regular expression and an error code click Add row. To remove a tuple click Delete. Click Save to apply the changes.

   Tip

   You can check the correctness of a regular expression by clicking the icon. In the appearing widget you can input an arbitrary string to check whether it matches the regular expression you put in earlier or not. If the check is successful you will see the icon near the string, otherwise you will see the icon. In order to close the widget and go back to editing the regular expression, click outside it or press Esc key.

Example

Change cache settings

1. Select the specified domain/service in Domains or Services section.

2. Choose CDN (RuGeeks) → Settings in the menu.

3. Set parameters in Cache settings.

   • Cache control

     Defines whether CDN should respect the time to live of the cached files provided by the upstream in Expires и Cache-Control headers.

   • Client no cache

     If enabled, then no cache headers beside Cache-control: no-cache are sent to client.

   • Cache errors

     If an error is received from upstream with one of specified status codes, then the next request for the same resource is possible after defined timeout.

     Click Edit. Ented the error Code and the corresponding Timeout to cache it. Timeout value may range from 60 000 to 300 000 ms. Click Save to apply the changes.

   • Cache errors (Client IP)

     Identical to Cache errors but the cache saved according to these rules will only be used for requests from the same IP address as in the original request.

   • Ignore query parameters

     Ignore all GET parameters when caching. It is convenient when you are using randomly generated GET parameters to force the browser to refresh the cached content, but do not want CDN to make unneeded requests to the upstream server.

   • Clear cache

     You can manually remover one or several files from CDN.

     Click Clear cache. In the appearing window specify paths to all files you wish to remove from the cache Each path should start with /. After that click Clear cache once more. The specified files will be removed from the cache in several minutes.

Example

Change transport settings

1. Select the specified domain/service in Domains or Services section.

2. Choose CDN (RuGeeks) → Settings in the menu.

3. Change parameters in Transport section.

   • HTTP/2 Support

     Enable the HTTP/2 protocol support. If disabled, CDN will use only the HTTP/1.1 protocol.

   • Compression algorithms

     You can enable or disable the support of certain compression algorithms here. By default RuGeeks supports gzip, deflate и br formats but you can disable any of them by unticking the checkboxes.

Example

Turn off RuGeeks integration

1. Select the specified domain/service in Domains or Services section.

2. Choose CDN (RuGeeks) → Settings in the menu.

3. In Turn off RuGeeks section click Turn off.

4. In the appearing window click Turn off.