本文介绍如何通过边缘函数返回HTML页面。 直接响应边缘函数代码中的HTML页面。 示例代码 javascript const html Hello World This example was generated by Chinatelecom Cloud AccessOne BosonFaaS. ; async function handleRequest(request) { return new Response(html, { headers: { 'contenttype': 'text/html; charsetUTF8', }, }); } addEventListener('fetch', event > { event.respondWith(handleRequest(event.request)); }); 示例预览 在浏览器地址栏中输入匹配到HTTP路由的URL，即可预览示例效果。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent

本文简述其他章节不包含的功能函数的语法、作用、入参、返回值、示例。 ctyun.getiplocation 函数信息详见下表： 项目 描述 语法 vender, province, city ctyun.getiplocation(remoteip) 作用 返回ip的归属运营商，归属省，归属地市。 入参 ip地址，可以是ipv4，也可以是ipv6。 返回值 依次为ip归属运营商，归属省，归属地市。如果没有找到则返回nil。 示例： reasonml local vender, province, city ctyun.getiplocation("183.38.147.155") if vender ~ nil then ctyun.resp.setoutput(vender..":"..province..":"..city.."n") else ctyun.resp.setoutput("unknown ipn") end 输出结果： CNdianxin:CNguangdong:CNguangdongfoshan ctyun.splitstring 函数信息详见下表： 项目 描述 语法 array ctyun.splitstring(str, splittoken) 作用 根据分隔符，分割字符串。将结果保存到数组中。 入参 str为被分割的字符串，splittoken为分割符。 返回值 返回分割后的结果放到数组中，可以通过ipairs遍历。 示例： applescript local result ctyun.splitstring("aaa,bbb,ccc,ddd", ",") for k,v in ipairs(result) do ctyun.resp.setoutput(v.."n") end 输出结果： aaa bbb ccc ddd ctyun.refreshmode 函数信息详见下表： 项目 描述 语法 isrefreshmode ctyun.refreshmode() 作用 查询该请求是否处于刷新模式。 入参 无。 返回值 返回是否处于刷新模式，bool类型。 示例： awk 设置缓存 local cachekey ctyun.var('uri') ctyun.req.setcache(cachekey, "follow", 3600) 刷新模式下跳过远程鉴权 local isrefreshmode ctyun.refreshmode() if not isrefreshmode then local res, err ctyun.queryremote(" + ctyun.var('uri')) if err then ctyun.exit(403) end if res.status ~ 200 then ctyun.exit(res.status) end end

本文介绍全局字典的添加、查看、编辑、删除等操作。 全局字典是客户粒度的，客户的多个域名可共享全局字典。 添加全局字典 1. 单击全局字典首页右上角的【添加全局字典】来添加全局字典。 2. 进入添加全局字典页面后，输入字典名称和字典大小。最多添加5个全局字典，每个全局字典的大小不超过100MB。全局字典的名称为264位的小写字母、数字、下划线的结合，开头结尾只允许小写字母和数字，多个全局字典的名称不允许相同。添加完成后，单击【确认提交】后进行全局字典的部署。 3. 提交后，会自动跳转到全局字典首页，展示字典部署状态，总共有等待部署、部署中、部署成功、部署失败四种状态，部署失败的可单击操作列的【失败重试】重新部署。部署成功后，可查看、编辑、删除全局字典。 查看全局字典 单击全局字典首页操作列的【查看】，可进入“查看全局字典”页面，可查看每个全局字典的名称和大小。单击【返回】可回到全局字典首页。

项目 描述 语法 res, err ctyun.querygetcache(cachehost, cacheurl, cachemode, ttl, uri?, args?, timeouts?) 作用 回源拉取文件并缓存，得到响应内容可编辑。如m3u8改写，请求得到响应体，使用Lua脚本对响应体进行编辑后，重新计算ContentLength头部，调用ngx.print() 响应客户端经过处理后的响应。 入参 cachehost: 缓存host。示例：ctyun.cn。 cacheurl: 缓存url。示例：/static/origin.m3u8。 cachemode: 固定缓存时间/跟随源站缓存（定值 "fixed" / “follow”）。默认为fixed, 非合法输入初始化为默认值。 ttl: 缓存时间，单位秒。如果是固定缓存，设置缓存多久； 如果跟随源站也可以设置默认值（秒)。 uri：请求uri，缺省为当前的请求uri。示例：/static/origin.m3u8。 args：请求参数，缺省为当前的请求参数，支持luastring和luatable两种格式。示例：a1&b2或者{a1,b2}。 timeouts：超时时间，array table格式。分别为connecttimeout、sendtimeout、readtimout，单位ms。缺省为15000 60000 60000。示例：{15000, 15000, 15000}。 返回值 res：响应结果，luatable类型，{ status, headers, body }。 err：错误信息。

项目 描述 语法 DICT:delete(keyname) 作用 删除指定的key。 入参 keyname：设置内容的键。 返回值 无。

项目 描述 语法 result，err ctyun.thread.run(callback, arg1, arg2, ...) 作用 创建一个线程， 异步执行lua函数。主要使用场景为异步通知远端处理结果，不阻塞正常的业务流程。 入参 callback 为lua函数，arg1,arg2,...为lua函数的参数。 返回值 创建成功返回true，失败返回false，以及错误信息err。 注意 ：由于是独立的线程执行callback，跟正常的业务请求是独立的环境。在callback中不能使用跟请求属性相关的函数（ctyun.req和ctyun.resp以及ctyun.var)。如果需要用到相关的变量，请通过arg1,arg2,...参数传进去。

项目 描述 语法 iterator, err ctyun.re.gmatch(subject, regex, options?) 作用 类似于ctyun.re.match，但返回一个 Lua 迭代器。 入参 subject：待匹配字符串。 regex：正则表达式。 options：控制如何执行匹配操作。 返回值 iterator： Lua 迭代器，可遍历获取所有匹配项。 err：描述错误信息的字符串。

ctyun.md5 函数信息详见下表： 项目 描述 语法 digest ctyun.md5(str) 作用 计算参数str的MD5摘要，并返回十六进制表示形式。 入参 str：string，待加密字符串。 返回值 digest: md5摘要的十六进制表示形式。 示例： pgsql local src "hello" local digest ctyun.md5(src) digest结果为：5d41402abc4b2a76b9719d911017c592 ctyun.md5bin 函数信息详见下表： 项目 描述 语法 digest ctyun.md5bin(str) 作用 计算参数str的MD5摘要，并返回二进制结果。 入参 str：string，待加密字符串。 返回值 digest: md5摘要的原始二进制形式。 示例： stylus local src "some string we want to sign" local digest ctyun.md5bin(src) ctyun.hmacsha1 函数信息详见下表： 项目 描述 语法 digest ctyun.hmacsha1(secretkey, str) 作用 计算参数str的HMACSHA1摘要，并使用秘钥 得到结果。注意，使用ctyun.hmacsha1生成的是HMACSHA1摘要的原始二进制形式，如果需要，可使用ctyun.encodebase64将结果编码为文本表示形式。 入参 secretkey : string，密钥。 str：string，待加密字符串。 返回值 digest: HMACSHA1摘要的原始二进制形式。 示例： reasonml local key "thisisverysecretstuff" local src "some string we want to sign" local digest ctyun.hmacsha1(key, src) ctyun.resp.setoutput(ctyun.encodebase64(digest)) 结果：R/pvxzHC4NLtj7S+kXFg/NePTmk

项目 描述 语法 rawheader str ctyun.req.rawheader(norequestline?) 作用 用来获取Nginx 服务器接收到的原始 HTTP 协议头。 入参 norequestline? : bool。norequestline：可选参数。参数为 true 可以去除结果中的请求行。 返回值 rawheaderstr: string。Nginx接收到的原始 HTTP 协议头。

项目 描述 语法 jsontext ctyun.json.encode(value) 作用 将Lua值序列化为包含JSON表示的字符串。 入参 value: Lua值或表，支持如下类型：boolean, nil,number,string,table。 返回值 jsontext: UTF8 JSON字符串。

变量名 变量说明 举例 arg参数名 url中的某个具体参数的值 比如请求为: http参数名 某个请求头xxx的值 比如请求为: H "test: hello" H "headacc: 222"， 调用ctyun.var("httptest")返回“hello”。 调用ctyun.var("httpheadacc") 返回“222”。 如果xxx有破折号，通过var调用时，用下划线代替。 cookiexxx 请求cookie头中的name值 使用方式同上。 scheme 请求使用的Web协议，“http” 或 “https” ctyun.var("scheme") 返回http。 serverprotocol 服务器的HTTP版本，通常为 “HTTP/1.0” 或 “HTTP/1.1” ctyun.var("serverprotocol") 返回HTTP/1.1。 timeiso8601 服务器时间的ISO 8610格式 ctyun.var("timeiso8601") 返回 20220714T11:13:56+08:00。 timelocal 服务器时间 ctyun.var("timelocal") 返回14/Jul/2022:11:13:56 +0800。 timehttp 服务器时间的http表示法 ctyun.var("timehttp") 返回 Thu, 14 Jul 2022 03:13:56 GMT。 host 客户端请求的域名 ctyun.var("host") 返回ctyun.cn。 requesturi 用户原始请求url包括查询参数 比如客户端发送请求uri为： /%E4%BD%A0%E5%A5%BD?tt123 ctyun.var("requesturi") 返回/%E4%BD%A0%E5%A5%BD?tt123。 uri requesturi变量中不带查询参数部分，且进行了urldecode 比如客户端发送请求uri为： /%E4%BD%A0%E5%A5%BD?tt123 ctyun.var("uri") 返回 /你好。 querystring 查询参数, requesturi的参数部分 比如：请求uri为： /hello?tt123&t2%E4%BD%A0%E5%A5%BD ctyun.var("querystring") 返回 tt123&t2%E4%BD%A0%E5%A5%BD。 requestmethod HTTP请求方法，通常为"GET"或"POST"等 ctyun.var("requestmethod") 返回GET。 remoteaddr 返回客户端ip ctyun.var("remoteaddr") 返回172.21.51.44。 remoteport 客户端端口号 ctyun.var("remoteport") 返回38966。 serveraddr 服务端ip ctyun.var("serveraddr") 返回172.21.51.88。 serverport 服务端端口号 ctyun.var("serverport") 返回80。

本文通过图文说明如何自定义查询刷新预取任务的执行状态。 功能介绍 当客户完成刷新或预取任务提交后，如要查看任务执行进度和结果，可以通过天翼云客户控制台【刷新预取】页面，分别查看已提交的URL刷新、目录刷新、正则刷新和URL预取任务的执行情况。 操作方式 1. 登录客户控制台。 2. 在【刷新预取】页面。 3. 按实际情况，选择【URL刷新】、【目录刷新】、【正则刷新】或【URL预取】。 4. 选择具体的时间、输入完整域名，或者选择一种特定的任务状态类型。 5. 单击【查询】。 注意 URL刷新、目录刷新、正则刷新只支持查询最近7天内、时间跨度不超过5天的任务。 URL预取只支持查询最近15天内、时间跨度不超过7天的任务。

本文介绍边缘函数增值服务的计费规则。 计费规则 边缘函数按函数执行次数计费，资费说明如下： 函数规格 标准资费 单位 10ms 1 元/百万次 50ms 3 元/百万次 100ms 5 元/百万次 计费方式：按需计费。 计费周期：按小时结算，定时扣费。 注意事项 边缘函数不区分中国内地和全球（不含中国内地），价格统一。 函数规格不同，标准资费不同，请根据需要选择函数规格。 因边缘函数为增值服务，涉及计费，如无需使用，请及时退订服务。

参数名 配置值 说明 标签组名 只能输入，英文字母、中文和数字，不允许为空。 标签组，即一组具有相同类别属性标签的统称，在配置关系里面，它是一类标签的集合。 标签名 只能输入，英文字母、中文和数字，多个值用;分隔，不允许为空。 标签，即一组具有相同属性的域名的统称，在配置关系里面，它是一类域名的集合。

本文介绍图片裁剪具体使用参数及示例。 开通图片处理后，客户可通过URL请求中携带图片裁剪参数，裁剪原图中指定位置的内容并生成新的图片。 注意 图片处理为付费服务，目前处于公测期间，暂不收取费用，收费时间另行通知。 居中裁剪：从图片居中部分裁剪指定宽和高的图片内容。宽的起点(图片总宽w)/2，高的起点(图片总高h)/2，找到该原点，然后裁剪宽×高大小的图片内容。 指定X、Y轴裁剪：按指定x、y、宽和高裁剪，以x和y为起点，裁剪宽×高大小的图片内容。 九宫格裁剪：设置原点位置，原点按九宫格分布，横向以w指示的宽度向右裁剪，纵向以h指示的高度向下裁剪，裁剪宽×高大小的图片内容。 参数说明及示例 参数名称：cut。 支持的参数值说明如下： 参数类型 参数 说明 取值范围 :::: 裁剪类型 mid 居中裁剪参数，需与参数w、h一起使用。 无。 裁剪类型 x 指定X、Y轴裁剪参数，指定裁剪起点横坐标，需与参数y、w、h一起使用，必填。 不能超出原图宽度，如x超出原图宽，将会返回原图。 裁剪类型 y 指定X、Y轴裁剪参数，指定裁剪起点纵坐标，需与参数x、w、h一起使用，必填。 不能超出原图高度，如y超出原图高，将会返回原图。 裁剪类型 g 九宫格裁剪参数，设置裁剪的原点位置。原点按照九宫格的形式分布，一共有九个位置可以设置，为每个九宫格的左上角顶点。 需与参数w、h一起使用。 NW：左上。 N：中上。 NE：右上。 W：左中。 M：中部。 E：右中。 SW：左下。 S：中下。 SE：右下。 超出上述值，裁剪不生效，将会返回原图。 裁剪宽和高 w 指定从原点开始向右的裁剪宽度。与居中裁剪、指定X、Y轴裁剪、九宫格裁剪参数一起使用。 不能超出原图宽度，如w超出原图宽，将会按照对应的宽最大值处理。 裁剪宽和高 h 指定从原点开始向下的裁剪高度。与居中裁剪、指定X、Y轴裁剪、九宫格裁剪参数一起使用。 不能超出原图高度，如h超出原图高，将会按照对应的高最大值处理。 操作方式说明及示例如下： 裁剪方式 说明 参数示例 居中裁剪 从图片居中部分裁剪指定宽和高的图片内容。宽的起点(图片总宽w)/2，高的起点(图片总高h)/2，找到该原点，然后裁剪宽×高大小的图片内容。 从图片居中部分裁剪指定宽和高的图片内容。宽的起点(图片总宽w)/2，高的起点(图片总高h)/2，找到该原点，然后向右向下裁剪400×200大小的图片内容。 指定X、Y轴裁剪 按指定x、y、宽和高裁剪，以x和y为起点，裁剪宽×高大小的图片内容。注意：x、y值必填，否则会返回原图。 指定X、Y轴剪切：按x为10，y为10的位置为指定原点，向右向下裁剪400×200的图片内容。 九宫格裁剪 设置原点位置，原点按九宫格分布，横向以w指示的宽度向右裁剪，纵向以h指示的高度向下裁剪，裁剪宽×高大小的图片内容。 九宫格切：设置原点位置为九宫格左上位置，横向向右以w指示的400宽度裁切，纵向向下以h指示的高度200裁切，裁剪400×200大小的图片内容。

参数名 说明 回源连接超时时间 指回源节点与源站服务器建立连接的超时时间。如果回源节点在指定的超时时间内未能与源站服务器建立连接，则会触发节点重试，重试失败后将与源站终止连接并返回502。默认回源连接超时时间为5s。 回源请求超时时间 指回源节点与源站服务器建连成功后，向源站服务器发送请求的超时时间。如果在指定的超时时间内未接收到源站服务器响应的首包，则会触发节点重试，重试失败后将与源站终止连接并返回502。默认回源请求超时时间为15s。

参数名 配置示例 改写参数模式 追加 优先级 默认10 参数名 a 参数值 123

本文介绍基于标签的域名日常管理操作。 功能介绍 在完成域名绑定标签后，您在日常运营时，就可以使用标签快速筛选对应的域名，进行分组管理。 配置说明 1. 登录客户控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到首行的自定义筛选行。 4. 找到首个筛选框，提示【请选择标签】。 5. 下拉选择您本次计划筛选的【标签组】、【标签】。 6. 在选定标签组和标签之后，系统会自动过滤，并在【域名列表】中只显示符合条件的域名，从而帮助您快速定位到目标域名。 参数名 配置值 说明 标签组 必选项，按标签组筛选域名 如果先勾选某个标签组，则默认筛选出该标签组内全部标签所绑定的域名。 标签 必选项，按标签筛选域名 在选定某个标签组后，可以选择所关联的一个或多个标签进行筛选，选出目标标签绑定的域名。

本文介绍域名解绑标签的操作步骤。 功能介绍 标签为域名分类管理工具，通过标签功能对具有相同属性的域名进行分类管理。如果标签已不再适用于您当前某个或多个域名的用途，您可以解绑域名标签。本文介绍如何为域名解绑标签。 配置说明 1. 登录客户控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到目标域名的【标签】列。 4. 单击标签图标【】。 5. 在标签管理页面将对应标签【】 6. 确认无误后，单击【确定】提交。

本文简述视频直播域名需满足的条件。 使用天翼云视频直播服务的域名，需满足如下条件： 域名已完成ICP备案且备案信息准确有效，如何备案请参见：新增备案。 域名接入时需能通过域名归属权验证。 域名类型为子域名（例如，abc.ctyun.cn），暂不支持泛域名（例如，.ctyun.cn域名）。 域名长度不超过128字节。 域名字符为小写英文字母（az）、数字（09）、短划线（）。 此外，视频直播推拉流场景下，除上述条件外，还需满足推流域名和拉流域名不能为同一个。

本文介绍新版回源超时时间功能及其配置说明。 功能介绍 回源超时时间设置（新）包括回源连接超时时间跟回源请求超时时间： 回源连接超时时间指回源节点与源站服务器建立连接的超时时间。 回源请求超时时间指回源节点与源站服务器建连成功后，向源站服务器发送请求的超时时间。 回源HTTP超时时间设置的长短要综合考虑网络链路情况、源站处理能力、连接问题等诸多因素。如您将回源响应超时时间设置的过长，可能会出现在源站处理能力达到上限，无法正常响应的情况下，失败的请求仍然长时间占用连接数，导致正常请求无法访问。建议您合理配置回源请求超时时间，以保证请求均能正常回源。 注意事项 “回源超时时间设置（新）”与“回源超时时间设置”的区别：新的回源连接超时时间和回源请求超时时间具备内部链路超时时间从回源层往边缘层逐层递增的能力，默认递增1s。可促进回源重试，降低访问异常的概率。 “回源超时时间设置（新）”与“回源超时时间设置”无法同时配置，新增域名默认使用“回源超时时间设置（新）”，历史域名支持从“回源超时时间设置”迁移为“回源超时时间设置（新）”。 配置说明 1. 登录CDN控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到目标域名，单击【操作】列的【编辑】。 4. 单击右侧【回源配置】。 5. 在【回源超时时间设置（新）】模块，开启功能进行配置。 6. 单击【保存】，完成配置。 参数名 说明 回源连接超时时间 1. 指回源节点与源站服务器建立连接的超时时间。 2. 如果回源节点在指定的连接超时时间内未能与源站服务器建立连接，则会触发节点重试，重试失败后将与源站终止连接并返回502。 3. “回源超时时间设置（新）”和“回源超时时间设置”均未配置时，默认回源连接超时时间为5s。 回源请求超时时间 1. 指回源节点与源站服务器建连成功后，向源站服务器发送请求的超时时间。配置之后，内部链路的回源请求超时时间从回源层往边缘层逐层递增的能力，默认递增1s。 2. 如果在指定的请求超时时间内未接收到源站服务器响应的首包，则会触发节点重试，重试失败后将与源站终止连接并返回502。 3. “回源超时时间设置（新）”和“回源超时时间设置”均未配置时，默认回源请求超时时间为12s。

平台通过多种算子迁移适配、算子调优能力和工具链,实现国产化硬件下模型在预训练、微调、推理下的性能对齐NV80%及以上。 平台针对国产化硬件910B进行主流模型的迁移适配和性能优化，多数训练性能达到A800的90%及以上，推理性能达到A10或A100的80%及以上。 目前模型广场所有模型均达到国产化适配的性能标准。 主流模型适配结果示例： 多数模型基于昇腾的训练可达A800的90%以上，举例如下： Llama38Binstruct、ChatGLM36B 性能对标可达90% Qwen272BInstruct 性能对标可达100% 部分模型基于昇腾910B的推理可达A800的80%以上，举例如下： Qwen1.8BChat 性能对标可达110.32% Llama213BChat 性能对标可达91.28% 主流适配模型清单参考如下： 大语言： DeepSeek：DeepSeekR1系列、DeepSeekV3系列 Llama：Llama系列、Llama2系列、Llama3系列 通义千问：Qwen系列、Qwen1.5系列、Qwen2系列、Qwen2.5系列、Qwen3系列 智谱：ChatGLM2系列、ChatGLM3、GLM4系列 书生浦语：InternLM系列、InternLM2系列 百川：Baichuan系列、Baichuan2系列、BaichuanTurbo 电信星辰：TeleChat系列、TeleChat2系列 其他：AquilaChat7B、Gemma29BChat等 多模态： OpenClip ChineseCliP Blip2 VisualGLM6B StableDiffusionV1.5 StableDiffusionV2.1 QwenVLChat InternVLChatV1.5

使用键的集合对象 这些集合对象在存储数据时会使用到键，支持按照插入顺序来迭代元素。 Map Set WeakMap WeakSet 结构化数据 这些对象用来表示和操作结构化的缓冲区数据，或使用JSON（JavaScript Object Notation）编码的数据。 ArrayBuffer DataView JSON 控制抽象对象 控件抽象可以帮助构造代码，尤其是异步代码（例如，不使用深度嵌套的回调）。 Promise Generator AsyncFunction 反射 Reflect Proxy 其他 arguments Web全局API 每个全局对象Worker Global Scope都可以访问这些方法： Base64 atob()，解码已使用BASE64编码的字符串。 javascript atob(data: string): string; btoa()，对二进制数据或字符串进行BASE64编码。 javascript btoa(data: string ArrayBuffer ArrayBufferView): string; Timer（即将支持） setInterval() clearInterval() setInterval() clearTimeout() Fetch Fetch() Encoding TextEncoder 和 TextDecoder 都支持UTF8编码/解码。 URL URL API支持符合HTTP和HTTPS方案的URL。

本文介绍如何使用边缘函数阻止其他网站盗链您的内容。 阻止其他网站盗链您的内容。 示例代码 javascript const HOMEPAGEURL " const PROTECTEDTYPE "image/" async function handleRequest(request) { // Fetch the original request const response await fetch(request) // If it's an image, engage hotlink protection based on the // Referer header. const referer request.headers.get("Referer") const contentType response.headers.get("ContentType") "" if (referer && contentType.startsWith(PROTECTEDTYPE)) { // If the hostnames don't match, it's a hotlink if (new URL(referer).hostname ! new URL(request.url).hostname) { // Redirect the user to your website return Response.redirect(HOMEPAGEURL, 302) } } // Everything is fine, return the response normally. return response } addEventListener("fetch", event > { event.respondWith(handleRequest(event.request)) }) 示例预览 当一个请求到达时，首先检查其ContentType是否是图像类型。 如果是图像类型，再检查 Referer头部是否指向当前域名。 如果 Referer头部指向的域名与当前域名不一致，则重定向到主页。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent 运行时API：Web Standard 运行时API：Fetch

本文介绍如何根据不同的HTTP路由,响应对应内容。 根据不同的HTTP路由，响应对应内容。 示例代码 javascript addEventListener("fetch", (event) > { event.respondWith( handleRequest(event.request).catch( (err) > new Response(err.stack, { status: 500 }) ) ); }); async function handleRequest(request) { const { pathname } new URL(request.url); if (pathname.startsWith("/api")) { return new Response(JSON.stringify({ pathname }), { headers: { "ContentType": "application/json" }, }); } if (pathname.startsWith("/status")) { const httpStatusCode Number(pathname.split("/")[2]); return Number.isInteger(httpStatusCode) ? fetch(" + httpStatusCode) : new Response("That's not a valid HTTP status code."); } return new Response("This is a http router example!"); } 示例预览 在浏览器地址栏中输入匹配到HTTP路由的URL，即可预览示例效果。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent 运行时API：Web Standards

本文介绍函数运行时的FetchEvent的定义与用法。 分配给运行时的HTTP请求的事件类型。详细定义请参见MDN官方文档FetchEvent。 上下文 javascript addEventListener("fetch", event > { event.respondWith(handleRequest(event)) }) 属性 event.request Request 触发FetchEvent的HTTP请求。 方法 当运行时脚本收到请求时，运行时将触发FetchEvent，然后触发事件类型为fetch事件侦听器进行处理。事件处理程序可以调用event对象的以下方法来进行控制： event.respondWith( response RequestPromise ) void 拦截请求并发送自定义响应。 必须调用respondWith()进行有效的响应，否则运行时会报错。 生命周期 当边缘接收到一个请求，该请求的URL映射到用户函数时，FetchEvent生命周期开始；这时运行时触发一个事件，并创建一个FetchEvent对象传递给运行时的第一个注册为fetch的事件处理程序。 事件处理程序可以使用respondWith()来拦截请求并允许用户发送自定义响应。 如果fetch事件处理程序未调用respondWith()，则运行时会将事件传递到下一个注册的fetch事件处理程序。 javascript addEventListener('fetch', (event) > { event.respondWith(handle(event)); }); async function handle(event) { // 1.异步发起一个fetch请求，但是我们不使用await，所以该请求会并行执行 fetch(" // 2.立刻发起回复。这个回复hello world发回给客户端时，前面发起的fetch可能没有执行完毕。 return "hello world"; } 相关参考 示例代码：返回HTML页面 示例代码：返回JSON内容

本文介绍如何使用边缘函数部署时间戳防盗链。 通过时间戳进行请求防盗链。 示例代码 javascript / 示例url: / addEventListener('fetch', event > { event.respondWith(handleRequest(event.request)) }) async function handleRequest(request){ //401表示鉴权不通过 let statuscode 401 let result 'TimeStamp verification failed!' try { if(verifyTimeStamp(request.url) true){ statuscode 200 result "TimeStamp verification succeeded!" // 返回请求内容 } } catch (error) { result error } return new Response(result, { "status": statuscode }) } function verifyTimeStamp(url){ //"url": " let currentTime new Date().getTime() let myURL new URL(url) let searchParams new URLSearchParams(myURL.search) let timeStamp parseInt(searchParams.get('time')) let token searchParams.get('token') // 校验时间戳：如果时间戳距离当前时间没有过期，则进行 token 检查 if (currentTime timeStamp < 60000) { // 校验token return tokenCheck(token) } return false } function tokenCheck(token){ // 此处可替换为自定义的复杂加解密算法 return token "abcabc" } 示例预览 访问请求传入未过期时间、鉴权token，鉴权通过。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent 运行时API：Web Standard 运行时API：Fetch

本文介绍如何通过UA黑白名单实现访问控制。 通过UA进行黑白名单限制。 示例代码 javascript //放行UserAgent:Mozilla/5.0的请求 function uaverify(ua){ let regex /Mozilla/5.0/ return regex.test(ua) } async function handle(request) { //401表示鉴权不通过 let statuscode 401 let result 'Verification failed!' try { //解析Request对象中的UA let myHeaders new Headers(request.headers) //封禁空UA if(!myHeaders.get('UserAgent')){ throw new Error('UA is empty!') } //精确匹配，不忽略大小写 if(uaverify(myHeaders.get('UserAgent'))){ statuscode 200 result "Verification succeeded!" } } catch (error) { result result + error } return new Response(result, { "status": statuscode }); } addEventListener('fetch', event > { event.respondWith(handle(event.request)) }) 示例预览 通过火狐浏览器访问，返回鉴权成功。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent 运行时API：Web Standard 运行时API：Fetch

本文介绍如何通过边缘函数返回HTML页面。 直接响应边缘函数代码中的HTML页面。 示例代码 javascript const html Hello World This example was generated by Chinatelecom Cloud AccessOne BosonFaaS. ; async function handleRequest(request) { return new Response(html, { headers: { 'contenttype': 'text/html; charsetUTF8', }, }); } addEventListener('fetch', event > { event.respondWith(handleRequest(event.request)); }); 示例预览 在浏览器地址栏中输入匹配到HTTP路由的URL，即可预览示例效果。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent

本文介绍如何通过边缘函数修改源站响应内容。 根据特殊分支场景，修改源站响应内容。 示例代码 javascript async function handleRequest(request) { // 获取原始的请求数据 const originalResponse await fetch(" const url new URL(request.url) const params url.searchParams // 如果传入 title 参数，尝试填充到页面中，修改返回的内容 let title params.get("title") if (title ! "") { title encodeURIComponent(title) let text await originalResponse.text() text text.replace(" ", " " + title + " ") return new Response(text, originalResponse) } return originalResponse } addEventListener("fetch", event > { event.respondWith(handleRequest(event.request)) }) 示例预览 源站响应内容被修改。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent 运行时API：Web Standard 运行时API：Fetch

本文介绍BosonFaas边缘函数相关使用限制。 规格说明 功能 规格限制 说明 ::: 函数个数 20个 单个用户账号允许发布的函数个数 开发语言 JavaScript（ES6） 运行时支持的开发语言，后续会陆续扩展更多语言 CPU运行时间 支持10ms、50ms、100ms三种规格 指单次请求运行用户函数的CPU耗时，该耗时不包括等待IO的时间 内存 128MB 单次请求运行用户函数的内存占用 响应时间 30s 单次请求运行用户函数的响应时间 子请求 6个 单次请求运行用户函数允许发出fetch子请求的数量 重定向次数 暂不支持重定向 请求URL 64KB 用户函数接收终端用户请求的URL长度，超过则返回494状态码 请求标头 64KB 用户函数接收终端用户单个请求标头大小不大于64KB，超过则返回494状态码；请求标头总大小不大于256KB，超过则返回414状态码 代码限制 以下函数出于安全原因，不允许使用： eval() new Function

本文介绍如何通过边缘函数聚合多个请求响应。 向两个URL发送GET请求，并将响应聚合为一个响应。 示例代码 javascript // 提取抓取页面的 文本内容 async function parseTitleFromHTML(response) { let htmlText await response.text() const titleStart htmlText.indexOf(' '); const titleEnd htmlText.indexOf(' ', titleStart); if (titleStart ! 1 && titleEnd ! 1) { return htmlText.substring(titleStart + ' '.length, titleEnd); } return "" } async function handleRequest() { // 同时发出两个 fetch 请求获取两个页面的 HTML const responses await Promise.all([fetch(" fetch(" // 将两个页面的 文本内容拼接起来 const results await Promise.all([ parseTitleFromHTML(responses[0]), parseTitleFromHTML(responses[1]), ]) // 将拼接后的结果返回 return new Response(results.join(" ")) } addEventListener("fetch", event > { return event.respondWith(handleRequest()) }) 示例预览 返回响应聚合内容。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent 运行时API：Web Standard 运行时API：Fetch