请选择
边缘加速
  • 站点加速
    • 概述
    • Quickly Import and Export Site Configuration
    • 访问控制
      • Token 鉴权
    • 智能加速
    • 文件优化
      • 智能压缩
    • 网络优化
      • HTTP/2
      • HTTP/3(QUIC)
        • 概述
        • 启用 HTTP/3
        • QUIC SDK
          • SDK 概览
          • SDK 下载和集成指引
          • 代码示例
            • Android
            • iOS
          • API 文档
            • Android
            • iOS
      • IPv6 访问
      • 最大上传大小
      • WebSocket
      • 携带客户端 IP 头部回源
      • 携带客户端 IP 地理位置头部回源
      • 开启 gRPC
    • URL 重写
      • 访问 URL 重定向
      • 回源 URL 重写
    • 修改头部
      • 修改 HTTP 节点响应头
      • 修改 HTTP 回源请求头
    • 自定义错误页面
    • 请求与响应行为
      • 请求处理顺序
      • EdgeOne 默认 HTTP 回源请求头
      • EdgeOne 默认 HTTP 响应头
    • Media Services
      • Audio and Video Pre-pulling
      • Just-in-Time Image Processing
      • Just-in-Time Media Processing
      • VOD Media Origin
  • 四层代理
    • 概述
    • 新建四层代理实例
    • 修改四层代理实例配置
    • 停用/删除四层代理实例
    • 批量配置转发规则
    • 获取客户端真实IP
      • 通过 TOA 获取 TCP 协议客户端真实 IP
      • 通过 Proxy Protocol V1/V2 协议获取客户端真实 IP
        • 概述
        • 方式一：通过 Nginx 获取客户端真实 IP
        • 方式二：在业务服务器解析客户端真实 IP
        • Proxy Protocol V1/V2 获取的客户端真实 IP 格式
      • 通过 SPP 协议传递客户端真实 IP
  • 边缘 DNS
    • 托管域名 DNS 解析
      • 修改 DNS 服务器
      • 配置域名 DNS 解析记录
      • DNS 高级配置
    • 接入加速域名
      • 添加加速域名
      • 站点/域名归属权验证
      • 修改 CNAME 解析
    • 别称域名
      • 概述
      • 配置指南
      • 通过别称域名批量接入 SaaS 建站域名
      • 别称域名实现业务的容灾
    • 流量调度
      • 流量调度管理
    • 源站配置
      • 回源配置
        • 配置回源 HTTPS
        • Host Header 重写
        • 回源请求参数设置
        • 回源跟随重定向
        • HTTP/2 回源
        • 分片回源
      • 负载均衡
        • 概述
        • 快速创建负载均衡实例
        • 健康检查策略介绍
        • 查看源站健康状态
        • 相关参考
          • 负载均衡相关概念
          • 请求重试策略介绍
      • 源站组操作指引
      • 相关参考
        • 旧版源站组兼容相关问题
      • 获取 EdgeOne 回源节点 IP
  • 边缘缓存
    • 概述
    • EdgeOne 缓存规则介绍
      • EdgeOne 内容缓存规则
      • 缓存键（Cache Key）介绍
      • Vary 特性
    • 缓存配置
      • 自定义 Cache Key
      • 节点缓存 TTL
      • 状态码缓存 TTL
      • 浏览器缓存 TTL
      • 离线缓存
      • 缓存预刷新
    • 清除和预热缓存
      • 清除缓存
      • 预热缓存
    • 如何提高 EdgeOne 的缓存命中率
  • 规则引擎
    • 概述
    • 规则引擎支持的匹配类型与操作
    • 规则管理
    • 变量
Docs Overview/
边缘加速/
站点加速/
URL 重写/
访问 URL 重定向/

访问 URL 重定向

功能简介

EdgeOne 节点支持响应 3XX 状态码将客户端请求 URL 重定向到目标 URL。此功能可以将您业务场景中需要源站实现的 URL 重定向，改为直接由 EdgeOne 边缘节点构造并返回，减少回源的网络延时和源站生成 URL 重定向的性能消耗，提升客户端访问性能。

适用场景

以下为常见的访问 URL 重写适用场景：
网站迁移或重构：当网站进行迁移或重构时，可能会涉及到 URL结构的变化。为了保持旧链接的有效性，可以使用 URL 重定向将旧 URL 重定向到新 URL，从而确保用户和搜索引擎可以顺利访问新的资源。
地理位置或设备类型定向：根据用户的地理位置或设备类型，可以使用 URL 重定向将用户引导到不同的资源或页面。例如：针对移动设备用户提供专门优化的移动页面，或根据用户所在地区提供不同语言版本的页面。
临时维护或活动页面：当网站进行临时维护或举办特定活动时，可以使用 URL 重定向将用户引导到维护通知页面或活动页面，从而提升用户体验。

操作步骤

场景一：域名业务需要 302 跳转到临时维护页面

若您 example.com 站点下的 www.example.com 域名业务需要进行临时维护，希望将域名下的所有请求均 302 跳转至 https://www.example.com/public/waitingpage/index.html，可参考以下步骤：
1. 登录 边缘安全加速平台 EO 控制台，在左侧菜单栏中，单击站点列表，在站点列表内单击需配置的站点。
2. 在站点详情页面，单击站点加速，进入站点全局配置页面，单击规则引擎 Tab 页。
3. 在规则引擎页面，单击创建规则，选择新增空白规则。
4. 在规则编辑页面，匹配类型选择为 HOST 等于 www.example.com。
5. 单击操作 > 选择框，在弹出的操作列表内，选择操作为 访问 URL 重定向。
6. 配置访问 URL 重定向规则。可保持目标请求协议为HTTPS、目标 Hostname 为跟随请求，目标路径自定义为/public/waitingpage/index.html。
7. 完整的规则配置如下所示，单击保存并发布，即可完成该规则配置。


场景二：源站资源目录迁移，客户端请求 URL 需要保持不变

若您 example.com 站点下的 www.example.com 域名，所有的 jpg 图片资源需要由 test 目录迁移至 newtest 目录，但客户端请求 URL 需要保持不变，即仍访问 test 目录，可参考以下步骤：
1. 登录 边缘安全加速平台 EO 控制台，在左侧菜单栏中，单击站点列表，在站点列表内单击需配置的站点。
2. 在站点详情页面，单击站点加速，进入站点全局配置页面，单击规则引擎 Tab 页。
3. 在规则引擎页面，单击创建规则，选择新增空白规则。
4. 在规则编辑页面，匹配类型选择为 HOST 等于 www.example.com。
5. 单击操作 > 选择框，在弹出的操作列表内，选择操作为 访问 URL 重定向。
6. 配置访问 URL 重定向规则。可保持目标请求协议为跟随请求、目标 Hostname 为跟随请求。配置目标路径为正则替换，输入正则表达式 /test/([^/]*)\.jpg 用于匹配目标路径，替换为 /newtest/$1.jpg。
7. 完整的规则配置如下所示，单击保存并发布，即可完成该规则配置。


相关参考

访问 URL 重定向相关配置项说明如下：
配置项
说明
目标请求协议
目标重定向地址的请求协议，默认跟随请求协议，可支持指定跳转为 HTTP/HTTPS 协议。
目标 Hostname
目标重定向地址的 Hostname 部分，默认跟随请求域名，支持修改为自定义域名。例如：www.example.com。
目标路径
目标重定向地址的路径部分，提供三种模式选择：
跟随请求：默认配置，跟随请求的路径。
自定义：自定义一个完整路径，原请求路径替换为目标路径。例如 /download。
正则替换：支持通过Google RE2正则表达式匹配和替换路径。同时支持以 $num 引用正则捕获组，num 代表组编号，最多支持 $9。
例如：当前希望将路径 /old-parh/1234 替换为 /new-path/1234，可以配置正则表达式为^/old-path/(\d+)$，替换路径为 /new-path/$1， $1 表示引用正则表达式中的第一个捕获分组，即路径中数字部分。
携带查询参数
是否携带原查询参数至目标 URL ，默认开启，即重定向后仍携带原查询参数。
状态码
选择重定向的响应状态码：302（默认），301，303 和 307。