tencent cloud

Tencent Cloud EdgeOne

Release Notes and Announcements
Release Notes
Security Announcement
Announcements
Product Introduction
Overview
Strengths
Use Cases
Comparison Between EdgeOne and CDN Products
Use Limits
Purchase Guide
Description of Trial Plan Experience Benefits
Free Plan Guide
Billing Overview
Billing Items
Subscriptions
Renewals
Instructions for overdue and refunds
Comparison of EdgeOne Plans
About "clean traffic" billing instructions
DDoS Protection Capacity Description
Getting Started
Choose business scenario
Quick access to website security acceleration
Quick deploying a website with Pages
Domain Service&Origin Configuration
Domain Service
HTTPS Certificate
Origin Configuration
Site Acceleration
Overview
Access Control
Smart Acceleration
Cache Configuration
File Optimization
Network Optimization
URL Rewrite
Modifying Header
Modify the response content
Rule Engine
Image&Video Processing
Speed limit for single connection download
DDoS & Web Protection
Overview
DDoS Protection
Web Protection
Bot Management
API Discovery(Beta)
Edge Functions
Overview
Getting Started
Operation Guide
Runtime APIs
Sample Functions
Best Practices
Pages
L4 Proxy
Overview
Creating an L4 Proxy Instance
Modifying an L4 Proxy Instance
Disabling or Deleting an L4 Proxy Instance
Batch Configuring Forwarding Rules
Obtaining Real Client IPs
Data Analysis&Log Service
Log Service
Data Analysis
Alarm Service
Site and Billing Management
Billing Management
Site Management
Version Management
General Policy
General Reference
Configuration Syntax
Request and Response Actions
Country/region and Corresponding Codes
Terraform
Overview
Installing and Configuring Terraform
Practical Tutorial
EdgeOne Skill User Guide
Automatic Warm-up/Cache Purge
Resource Abuse/hotlinking Protection Practical
HTTPS Related Practices
Acceleration Optimization
Scheduling Traffic
Data Analysis and Alerting
Log Platform Integration Practices
Configuring Origin Servers for Cloud Object Storage (Such As COS)
CORS Response Configuration
API Documentation
History
Introduction
API Category
Making API Requests
Site APIs
Acceleration Domain Management APIs
Site Acceleration Configuration APIs
Edge Function APIs
Alias Domain APIs
Security Configuration APIs
Layer 4 Application Proxy APIs
Content Management APIs
Data Analysis APIs
Log Service APIs
Billing APIs
Certificate APIs
Origin Protection APIs
Load Balancing APIs
Diagnostic Tool APIs
Custom Response Page APIs
API Security APIs
DNS Record APIs
Content Identifier APIs
Legacy APIs
Ownership APIs
Image and Video Processing APIs
Multi-Channel Security Gateway APIs
Version Management APIs
Data Types
Error Codes
FAQs
Product Features FAQs
DNS Record FAQs
Domain Configuration FAQs
Site Acceleration FAQs
Data and Log FAQs
Security Protection-related Queries
Origin Configuration FAQs
Troubleshooting
Reference for Abnormal Status Codes
Troubleshooting Guide for EdgeOne 4XX/5XX Status Codes
520/524 Status Code Troubleshooting Guide
521/522 Status Code Troubleshooting Guide
Tool Guide
Agreements
Service Level Agreement
Origin Protection Enablement Conditions of Use
TEO Policy
Privacy Policy
Data Processing And Security Agreement
Contact Us
Glossary

Access URL Redirection

PDF
Focus Mode
Font Size
Last updated: 2025-07-29 15:31:52

Overview

EdgeOne Nodes redirect the client requests request URL to the target URL by responding to 3XX status codes. This feature can change the URL redirection that originally needed to be generated and returned by the origin server in your business scenario to be directly constructed and returned by the EdgeOne edge nodes, reducing the network latency of following the origin-pull and the load of the origin server generating the URL redirection, and improving the access performance of the client.

Use Cases

The following are common Applicable Scenarios for Rewrite access URL:
Migration of website or reconstruction: When a website undergoes migration or reconstruction, the URL structure may change. To maintain the validity of old links, you can use URL redirect to redirect old URLs to new URLs, ensuring that users and Search Engines can smoothly access the new resources.
Geographical location or Device Type orientation: Based on the user's geographical location or device type, you can use URL redirect to guide users to different resources or pages. For example, provide optimized mobile pages for mobile device users, or provide different language versions of pages based on the user's region.
Temporary maintenance or activity page: When a website is undergoing temporary maintenance or hosting a specific event, you can use URL redirect to guide users to the maintenance notification page or activity page, thereby improving the user Experience.

Directions

Scenario One: Domain Services Require a 302 Redirection to a Temporary Maintenance Page

If you require temporary maintenance for the domain business www.example.com under your example.com site, and want to redirect all requests under the domain to https://www.example.com/public/waitingpage/index.html via a 302 redirection, you can refer to the following steps:
1. Log in to the Tencent Cloud EdgeOne console, enter Service Overview in the left menu bar, and click the site to be configured under Website Security Acceleration.
2. On the site details page, click Site Acceleration to enter the global site configuration page, then click the Rule Engine tab.
3. On the rule engine management page, click Create rule and select Add blank rule.
4. On the rule editing page, select the Matching type as HOST is www.example.com.
5. Click on Action, and in the pop-up action list, select the Action as Redirect access URL.
6. Configure the rules for Redirect access URL. Select the Target protocol as HTTPS, the Target hostname as Follow request, and the Destination Path as /public/waitingpage/index.html.
7. Click Save and Publish to complete the configuration. The complete rule configuration is as shown below:


Scenario Two: Migration of Origin Server Resource Directory, Client Request URL Must Remain Unchanged

If you need to migrate all jpg image resources from the test directory to the newtest directory under the www.example.com domain of your example.com site, but the client request URL needs to remain unchanged, that is, the test directory is still accessed. You may refer to the following steps:
1. Log in to the Tencent Cloud EdgeOne console, enter Service Overview in the left menu bar, and click the site to be configured under Website Security Acceleration.
2. On the site details page, click Site Acceleration to enter the global site configuration page, then click the Rule Engine tab.
3. On the rule engine management page, click Create rule and select Add blank rule.
4. On the rule editing page, select the Matching type as HOST is www.example.com.
5. Click on Action, and in the pop-up action list, select the action as Redirect access URL.
6. Configure the rules for Redirect access URL. Select the Target protocol as Follow request, the Target hostname as Follow request. And you can configure the Destination Path as Replace by regex, input the Regular Expression as /test/([^/]*)\\.jpg to match the destination path, and replace it with /newtest/$1.jpg.
7. Click Save and Publish to complete the configuration. The complete rule configuration is as shown below:


Relevant References

The explanations for each configuration item of the redirect access URL are as follows:
Configuration Item
Description
Target Protocol
The request protocol of the target redirect address, default to follow the request, can support specifying the jump to HTTP/HTTPS protocol.
Target Hostname
The Hostname part of the target redirect address, default to follow the request, support modifying to a custom domain. For example, www.example.com.
Destination Path
The path part of the target redirect address, providing three mode options:
Follow request: Default configuration, follow the request path.
Custom: Customize a complete path, replace the original request path with the target path. For example, /download.
Regular Expression: Support matching and replacing paths through Google RE2 Regex. At the same time, it supports using $numto refer to the Regex capture group, where num represents the group number, up to $9.
For example: Currently, we hope to replace the path /old-path/1234 with /new-path/1234, we can configure the Regex expression as ^/old-path/(\\d+)$, and the replacement path can be configured as /new-path/$1, where $1 refers to the first capture group in the Regex expression, that is, the number part of the path.
Query String
Whether to carry the original query string to the target URL, default to enable, that is, carry the original query string after redirecting.
Status Code
Select the response status code for the redirect: 302 (default), 301, 303, and 307.


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback