基于ESA边缘函数的转发和重定向实践指南

第一步：添加站点

1. 在ESA控制台，选择站点管理，单击新增站点。

2. 在输入站点页面中输入站点，如：example.com，点击下一步。

3. 在选择区域和接入方式页面，在获得加速与保护的区域处选择您的站点需要获得安全加速服务的区域，并在接入方式处选择CNAME方式，单击下一步。

4. 在选择套餐类型页面，可以通过新购套餐和绑定已购套餐两种方式选择合适的套餐，按照控制台指引完成套餐订购。

   新购套餐

   在新购套餐页面根据实际需要选择合适的套餐。

   

   绑定已购套餐

   如果当前已购买套餐，可在已购套餐页签中选择该套餐进行绑定。

   

   说明

   如果您未参与过免费试用活动，则可以登录阿里云官网-试用中心，搜索ESA即可领取1个月ESA基础版。

5. 在ESA控制台，在左侧导航栏单击站点管理，进入站点管理页面后单击目标站点，在站点概况页面，对域名归属权进行验证。

   1. 复制TXT记录中的记录值。

      

   2. 在云解析DNS控制台，在左侧菜单栏单击公网DNS解析 > 权威域名解析，在权威域名页签下找到目标站点的域名，单击解析设置。

   3. 在解析设置中单击添加记录，按照以下配置添加记录，单击确定。

      配置项	示例值
      记录类型	TXT
      主机记录	_esaauth
      记录值	verify_a186***be8（控制台给出的记录值）
      TTL	10分钟

   4. 在ESA控制台，进入目标站点概况页面，单击点击验证。

   5. 验证成功的情况： 当查看验证结果时，如果系统提示验证成功，则说明验证已通过，无需进一步操作。

      验证失败的情况： 如果系统提示验证失败，则需要检查上一步的操作是否正确，并调整相关配置。完成调整后，单击点击验证按钮重新进行验证。

第二步：配置边缘函数

1. 登录ESA控制台，在左侧导航栏选择边缘计算 > 边缘函数。

2. 在边缘函数页面，单击创建函数。

3. 在创建函数对话框中，您可以选择ESA提供的模板生成函数代码，也可以选择业务需要的模板。选择完成后，单击下一步。

   

4. 配置函数规格等基本信息，完成后单击提交。

   

   参数	说明
   函数名称	请输入函数名称。 说明 小写英文字母开头，可包含小写英文字母、数字和中划线，但不能以中划线结尾，名称长度2到41个字符，例如routine-name。函数名创建后无法修改。
   描述	（选填）函数的描述信息。
   代码预览	函数代码预览信息。

第三步：配置触发器

在ESA边缘函数中，触发器定义了函数脚本的调用方式。通过域名绑定功能，您可以为函数分配一个域名，直接通过该域名访问函数。

例如：您已在ESA添加了站点example.com，您想通过function.example.com访问边缘函数，那么function.example.com、function.example.com/user、function.example.com/login等请求均会被转发至边缘函数。

1. 在左侧菜单栏单击边缘计算 > 边缘函数，在边缘函数列表页面选择目标函数，在操作列单击详情。

2. 在函数详情页面，切换至触发器页签，单击添加域名。为边缘函数分配访问域名function.example.com，单击确定。

3. 在域名绑定区域找到上一步所创建的边缘函数域名，在操作列单击查看DNS记录，在DNS记录管理页面复制边缘函数域名对应的CNAME值。

   

4. 登录云解析DNS控制台，在左侧菜单栏单击公网DNS解析 > 权威域名解析，在权威域名页签下找到目标站点的域名，单击解析设置。

5. 在解析设置中单击添加记录，按以下配置添加记录，单击确定。

   配置项	说明	示例值
   记录类型	选择域名指向的类型。	CNAME
   主机记录	根据域名前缀填写主机记录。	function
   记录值	填写边缘函数域名对应的CNAME值。	function.example.com.a1.initmm.com
   TTL	域名的更新周期，保留默认值。	10分钟

6. 刷新DNS记录页面，检查边缘函数域名对应CNAME状态是否从待配置转变为已配置。

   说明

   CNAME生效时间可能需要数分钟，配置完成之后，如果没有及时生效，请耐心等待。

第四步：调试并发布函数

1. 登录ESA控制台。

2. 在左侧导航栏，选择边缘计算 > 边缘函数。

3. 边缘函数创建完成后，单击绑定域名。

   

4. 在详情页面，选择代码页签，将下方的演示代码粘贴到编辑器中。

   // 需求场景,想要实现的功能如下：
   // 1. 如果请求的Path部分是以”/esa/“开头，以”.html“结尾的，则直接将请求转发到ESA的官网。
   // 2. 如果请求的Path部分是以”/product“开头，则将用户请求重定向阿里云官网产品页。
   // 3. 如果请求未匹配上述规则，则重定向到阿里云官网首页。
   
   
   // 定义正则表达式：如Path部分是以”/esa/“开头，以”.html“结尾的
   const productPageRegex = /^\/esa\/.*\.html$/;
   
   function handleRequest(request) {
     const url = new URL(request.url);
     const pathName = url.pathname;
   
      // 如果Path部分是以”/esa/“开头，以”.html“结尾的，则直接将请求转发到ESA产品页
     if(productPageRegex.test(pathName)) {
       const newUrl = 'https://www.aliyun.com/product/esa';
       return fetch(new Request(newUrl, request)); 
     }
   
     // 满足以”/product“开头，直接重定向到首页阿里云官网产品页。
     if (pathName.startsWith('/product')) {
       const newUrl = 'https://www.aliyun.com/product/list';  
       return Response.redirect(newUrl, 301);
     }
     
     // 如果请求未匹配上述规则，则重定向到阿里云官网首页。
     const newUrl = 'https://www.aliyun.com/';  
     return Response.redirect(newUrl, 301); 
   }
   
   export default {
     fetch(request) {
       return handleRequest(request);
     }
   }

5. ESA在控制台代码开发工具右侧提供了一套调试环境，完成代码开发后，单击保存。在右侧工具栏构造HTTP的请求方法、请求头、请求体，构造完成后单击请求按钮，控制台将直接返回请求经过函数处理后的响应结果。

6. 调试完代码后，单击生成版本。

7. 选择上一步生成的版本，点击发布。您可以选择在测试环境、生产环境发布。本次实践作为演示，直接在生产环境发布。

   说明

   建议的发布顺序：先发布测试环境，待测试完成之后，再发布至生产环境。

方案验证

1. 验证ESA边缘函数的URL转发。

   直接在浏览器中输入http://function.example.com/esa/info.html，可以看到浏览器在页面地址栏不变的情况下，展示了阿里云ESA的首页，此时边缘函数的中的转发处理已经生效。

   

2. 验证ESA边缘函数的URL重定向。

   直接在浏览器中输入http://function.example.com/product，可以看到浏览器会自动跳转到阿里云产品页，并且地址栏的地址也会变为https://www.aliyun.com/product/list。

   打开浏览器的开发者工具，找到http://function.example.com/product的请求信息，可以看到Status Code是301 Moved Permanently；响应头（Response Headers）中Location的值为https://www.aliyun.com/product/list。

   此时，ESA边缘函数的重定向操作已经生效。

   

资源清理

在本方案中，您创建多个云资源实例。测试完方案后，如果不再需要这些资源，您可以参考以下规则处理对应产品的实例，避免继续产生费用：

1. 删除ESA加速节点。

   登录ESA控制台，在左侧导航栏单击站点管理，在站点管理列表页面右侧操作列单击删除。

2. 删除边缘函数。

   在ESA控制台，在左侧导航栏单击边缘计算 > 边缘函数，在边缘函数列表页面右侧操作列单击删除。

3. 删除DNS解析记录。

   登录云解析DNS控制台，在权威域名解析页签下找到目标站点的域名，单击解析设置。找到第三步：配置触发器中配置的主机记录，点击删除按钮。