Cache Configuration

Last updated: 2020-04-28 14:50:50

    Feature Overview

    ECDN can automatically detect static/dynamic content access requests based on the configured rules and intelligently choose the most appropriate acceleration scheme, satisfying your needs for accelerating access to sites with static/dynamic hybrid content at one stop.

    • For static content requests, the edge servers are preferentially used to cache the content for response, improving access efficiency and reducing origin-pull traffic usage.
    • For dynamic content requests, resources are directly pulled from the origin servers through high-quality caching and intelligent routing, reducing the average response latency.

    Feature Configuration Guide

    1. Log in to the ECDN Console and click Domain Management on the left sidebar to enter the management page.
    2. In the list, find the domain name to be configured and click Manage in the "Operation" column on the right to enter the domain management page.
    3. On the "Cache Configuration" page, manage configuration of content caching rules.
      • Ignore Query String cache configuration:
        You can enable Ignore Query String cache to ignore parameters after "?" in the user request URL during caching. For example, when a node caches a resource whose URL is, the corresponding cache_key will be, and parameters after "?" will be ignored. When a user initiates a request, parameters after "?" will also be ignored. The system will use the cache_key whose value is to search for the resource, which can be hit directly.
      • Content cache configuration:
        Click Modify Caching Rule to add a caching rule or modify an existing one and click Save for the rule to take effect.

    Caching rule types

    Cache Type Description Example Remarks
    File Type Sets the caching time based on file extension .jpg; .png; .jsp 1. The content is case-sensitive and must be a file extension starting with `.`.
    2. Different file types should be separated with `;`.
    Folder Sets the caching time based on folder /access; /pic 1. The content is case-sensitive, and different paths should be separated with `;`.
    2. It must be a folder starting with `/`.
    3. It cannot end with `/`.
    Full-path file Sets the caching time for a specified file /a.jpg; /b.png 1. The content is case-sensitive, and files at different paths should be separated with `;`.
    2. `*` can be used to match a type of files by regex, such as `/test/abc/*.jpg`.
    Homepage Sets the caching time for the homepage / The homepage content to be cached is "/" by default and does not need to be modified.

    Cache purge time

    Cache purge time description

    • Cache purge time can be set by second, minute, hour, and day (up to 30 days).
    • If the cache purge time is 0, it indicates dynamic content, all requests will be directly passed through to the origin server, and the response content will not be cached.
    • If the cache purge time is greater than 0, it indicates static resource, and the edge caching feature will be enabled:
      • If the content accessed by the user has been cached on the edge server, and the cache has not expired, then the request does not need to be forwarded to the origin server, and the cached content will be directly returned, so that the user can enjoy nearby access to the content.
      • If the content accessed by the user has not been cached on the edge server, or the cache has expired, then the request needs to be forwarded to the origin server to get the content, which will be returned to the user and cached on the edge server.
    • When a domain name is connected, the cache purge time of all files is 0 seconds by default, indicating that the dynamic acceleration service is not used by default.

    Suggestions on setting cache purge time

    File Type Scenario Example Recommended Caching Time
    Basically unchanged static content Images and audio/video files Set the cache purge time to 30 days.
    Static content that needs to be frequently updated Files in formats such as .js and .css Set the caching time generally at the day or hour level based on the update frequency.
    Dynamic content that is frequently updated and shared by users Weather queries and region-specific portal content Set the caching time at the minute or second level.
    Content that is dynamically generated or cannot be accessed twice by the same user User registration and login APIs Set the caching time to 0 to disable caching.

    Caching rule priority

    If multiple caching policies are set, there may be overlapping rules, and a request may hit multiple rules. Therefore, there is priority order for caching rules.

    • The rule at the bottom of the configuration list has higher priority than that on the top, and a new caching rule has the highest priority by default.
    • A user request will be matched with caching rules by rule priority from high to low. The first hit rule determines the cache purge time of the request.
    • You can adjust the priority of rules.

    Click Edit Caching Rule. You can drag the icon to adjust the rule priority.

    Cache Inheritance

    • When you configure edge caching for static content, the ECDN system will use the caching rules configured on the platform to process static user requests by default. The Cache-Control field in the response header from the origin server will not be inherited by the node for processing by default.
    • If you want to set special caching rules for certain content on the origin server, you can set them in the full-path file type.

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback