边缘开发者平台
  • 边缘函数
    • 概述
    • 快速指引
    • 操作指引
      • 函数管理
      • 触发配置
    • Runtime APIs
      • addEventListener
      • Cache
      • Cookies
      • Encoding
      • Fetch
      • FetchEvent
      • Headers
      • Request
      • Response
      • Streams
        • ReadableStream
        • ReadableStreamBYOBReader
        • ReadableStreamDefaultReader
        • TransformStream
        • WritableStream
        • WritableStreamDefaultWriter
      • Web Crypto
      • Web standards
      • Images
        • ImageProperties
    • 示例函数
      • 返回 HTML 页面
      • 返回 JSON
      • Fetch 远程资源
      • 请求头鉴权
      • 修改响应头
      • AB 测试
      • 设置 Cookie
      • 基于请求区域重定向
      • Cache API 使用
      • 缓存 POST 请求
      • 流式响应
      • 合并资源流式响应
      • 防篡改校验
      • m3u8 改写与鉴权
      • 图片自适应缩放
      • 图片自适应 WebP
      • 自定义 Referer 限制规则
      • 远程鉴权
      • HMAC 数字签名
      • 自定义下载文件名
      • 获取客户端 IP
    • 最佳实践
      • 通过边缘函数实现自适应图片格式转换

快速指引

本文通过示例创建一个简单的函数,实现请求重定向到其他 URL 并返回自定义响应头,来向您介绍如何使用边缘函数。

示例场景

当前已将站点 example.com 接入 EdgeOne 服务,在该站点下,需通过自定义域名 www.example.com 为用户提供一个自定义的 HTML 活动页面,可通过边缘函数将该页面部署至 EdgeOne 的全球可用区边缘节点内供用户就近访问。
说明:
1. 如何接入站点可参考:从零开始快速接入 EdgeOne
2. 如何添加加速域名可参考:添加加速域名

操作步骤

步骤1:创建并部署函数

1. 登录 边缘安全加速平台 EO 控制台,在左侧菜单栏中,单击站点列表,在站点列表内单击需配置的站点
2. 在站点详情页面,单击边缘函数 > 函数管理
3. 在边缘函数管理页面,单击新建函数,选择使用模板创建函数,在此步骤您可以根据实际业务需求来使用模板创建一个函数。以当前场景为例,可选择使用“创建 Hello World” 模板新建。选择模板后,单击下一步
4. 在新建边缘函数页面,配置相关参数,参数说明如下:
函数名称:必填项,只能包含字母、数字、连字符,以字母开头,以数字或字母结尾,2~30个字符;创建后无法修改。如:test-edgefunctions。
描述:非必填,最多支持60个字符。如:自定义 HTML 页面和响应头。
代码预览:模板对应的代码。
5. 单击创建并部署,当弹窗如下对话框,即表示部署成功。


步骤2:配置触发规则

如期望通过设置匹配站点的HOST、URL Path或文件后缀等方式触发函数执行,可通过如下2个步骤操作:
1. 创建并部署函数成功后,按照提示单击新增触发规则
2. 在新增触发规则页面,配置匹配条件,以当前场景为例,可选择匹配类型为“HOST”、运算符为“等于”、值为已添加的子域名 www.example.com,单击确定即可创建触发规则。


步骤3:验证边缘函数

验证函数是否按照预期运行,您可通过在浏览器或 Curl 发起请求测验:
浏览器验证
Curl 验证
在浏览器输入 URL,例如:https://www.example.com/test-edgefunctions,该 URL 可匹配已设置的触发条件触发函数的执行,查看响应页面信息:

在 MAC/Linux 终端内,运行 curl 请求命令进行验证,例如:curl https://www.example.com/test-edgefunctions,可查看响应如下: