Overview
Menu

Offline Caching

Function Introduction

By default, if EdgeOne cannot establish a connection with the origin when following the origin to obtain resources, it will respond with an error code. After enabling offline caching, when EdgeOne cannot establish a connection with the origin, it can use the resources cached in EdgeOne (even if the resources have expired) until the origin recovers the connection. This can effectively ensure the availability and continuity of the business and improve the user experience.
Note:
If there is no cache available in EdgeOne, it will respond with an error code.

Usage Scenarios

Unstable origin: If your origin server is prone to failures or instability, enabling offline caching can provide a better user experience during origin failures. Even if the cached resources have expired, the service can still be provided to users, avoiding the situation where users cannot access the site when the origin fails.
Critical business assurance: For some critical businesses, you may want to ensure that users can still access key content on the website or application when the origin has issues. Enabling offline caching can ensure that users can still access critical resources when the origin fails, ensuring business continuity.
Avoid sudden traffic impact: In some cases, the origin may be subject to sudden traffic surges, causing server overload or crashes. Enabling offline caching can continue to provide services to users during origin failures, mitigate the pressure on the origin, and help the origin recover to normal operation.

Directions

Scenario 1: Configure offline caching for all domain names of the site

If you need to enable/disable offline caching for the whole connected site, or as a site-level fallback configuration, please refer to the following steps:
1. Log in to the EdgeOne console, and in the left menu bar, click on the site list. In the site list, click on the site that needs to be configured.
2. On the site details page, click on Security Acceleration > Cache Configuration, find the offline cache card, and click on the switch to enable it.



Default state: Enabled. If disabled, when the origin fails, i.e., it cannot follow the origin to obtain resources normally, the node will pass the origin response to the client request.

Scenario 2: Configure offline caching for specific domain names, paths, or file extensions, etc.

If you need to configure different offline caching for different domain names, paths, or file extensions, etc., for example, enable offline caching for the www.example.com domain under the example.com site, please refer to the following steps:
1. Log in to the EdgeOne console, and click on Site List in the left menu bar, then click on the site to be configured in the Site List.
2. On the Site Details page, click on the Rule Engine.
3. On the Rule Engine Management page, click Create Rule to enter the editing page for the new rule. On the Rule Editing page, select Host as the matching type and configure it as www.example.com.
4. Click on the operation, and in the pop-up operation list, select the operation as Offline Cache and turn on the switch.



5. Click Save and Publish to complete the rule configuration.