ctyun.querygetcache 函数信息详见下表： 项目 描述 语法 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：错误信息。 示例： reasonml local res, err ctyun.querygetcache("ctyun.cn", "/static/origin.m3u8", "fixed", 86400, "/static/origin.m3u8", "a1&b2", {15000, 15000, 15000}) if err then return end headers for k, v in pairs(res.headers) do ctyun.resp.setheader(k, v) end status ctyun.resp.setcode(res.status) local status res.status if status > 299 or status < 200 then ctyun.resp.setoutput(res.body) end process body local body res.body if body then 对响应的处理, processbody仅用于说明 body processbody(body) 重写ContentLength响应头，输出响应 ctyun.resp.setheader("ContentLength",

名称 描述 是否必选 示例 ContentType 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json ctyuneoprequestid 流水号（32位随机数） 是 0ffb9b07d5a84e19b3ce12dfb9705a1d EopAuthorization EopAuthorization 是 4a4bdc57e06542199b5f98d4cd107be2 Headersctyuneoprequestid;eopdate Signatureb2WEo4nh9ewn6SWOP0ii5g8L0z9CT5gprpDWntlCX9I Eopdate 时间，15分钟有效期(实际传时间为北京东八区UTC+8时间。TZ仅为格式，非UTC时间。) 是 20221107T093029Z

运营商 运营商编码（string型） 中国电信 001 中国联通 002 中国移动 003 中国铁通 004 教育网 005 鹏博士 006

项目 描述 语法 sec ctyun.time() 作用 从nginx时间缓存，返回当前时间戳。 入参 无。 返回值 sec : number，时间戳，例如 1657678155。

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

项目 描述 语法 respcode ctyun.resp.getcode() 作用 获响应状态码。 入参 无。 返回值 number 状态码 注意： 建议ctyun.req.enrollheaderback 回调函数内使用。

本文介绍获取图片信息具体参数及示例。 开通图片处理后，客户可通过请求URL中携带获取图片信息的参数，获取原图的大小、宽、高、图片格式、图片质量和图片方向信息。 注意 图片处理为付费服务，目前处于公测期间，暂不收取费用，收费时间另行通知。 参数说明及示例 参数名称：getinfo。 返回的图片信息为JSON格式，返回的参数包括图片的大小、宽、高、图片质量、图片格式和图片方向。 参数示例： 返回json示例： { "size":1055089, // 文件大小 "width":1920, "height":1080, "quality":100, "format":"JPEG", "orientation":"UNDEFINED" } 注意 若请求URL中同时携带getinfo和其他图片处理参数，则只处理getinfo，其他参数不做处理。

参数类型 参数 说明 取值范围 裁剪类型 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超出原图高，将会按照对应的高最大值处理。

参数类型 取值范围 示例 顺时针旋转 仅支持90、180、270，超出范围会返回原图。 逆时针旋转 仅支持90、 180、270，超出范围会返回原图。

支持转换的图片格式 说明 JPEG 将原图保存为JPG或JPEG格式。 PNG 将原图保存为PNG格式。 WEBP 将原图保存为WEBP格式。 BMP 将原图保存为BMP格式。 GIF 将原图保存为GIF格式。注意：GIF为动图格式，如由其他静态格式转换而来，则仅转换为静图效果。 TIFF 将原图保存为TIFF格式。 JP2 将原图保存为JP2格式。 JXR 将原图保存为JXR格式。

本文介绍图片质量转换具体使用参数及示例。 开通图片处理后，客户可通过URL请求中携带质量转换参数，将原图转换为指定质量的图片。 注意 图片处理为付费服务，目前处于公测期间，暂不收取费用，收费时间另行通知。 参数说明及示例 支持的原图格式：JPEG、WEBP，其中WEBP仅支持相对质量转换。 参数名称：quality。 支持的参数值： 参数 说明 取值范围 示例 数字 绝对质量转换的具体数字。按绝对质量进行转换，转换成指定大小的质量。 0<数字<100，如超出范围会返回原图。即如果图片当前质量大于number进行转换，小于不转换。 数字p 相对质量转换的具体数字。根据图片当前质量乘以number%，得到最终的质量。 0<数字<100，如超出范围会返回原图。

参数 说明 取值范围 示例 w 按宽固定自适应等比缩放: 固定宽度，高度自适应。 缩放后的宽×高不能超过16777216 px。 h 按高固定自适应等比缩放: 固定高度，宽边自适应。 缩放后的宽×高不能超过16777216 px。 l 按长边固定自适应等比缩放：长边固定长度，短边自适应缩放。 缩放后的宽×高不能超过16777216 px。 s 按短边固定自适应等比缩放：短边固定长度，长边自适应缩放 缩放后的宽×高不能超过16777216 px。 。 fw、fh 指定目标缩放图的宽高。 缩放后的宽×高不能超过16777216 px。 。 p 按原图宽高比例进行缩放。 0

本文介绍如何批量配置域名。 背景信息 客户往往会存在多个域名需要配置，而配置又是相同的情况，这时我们提供批量配置域名的方式可以使客户快速、便捷的接入域名。 操作步骤 可以通过API接口调用方法批量配置域名。 详情请见：批量新增域名。 注意事项 添加域名之前，您需要先开通对应产品类型的服务。 对应域名必须已成功备案。 对应域名之前未创建过，且没有在途工单。 单个用户一分钟限制调用10次。 调用本接口批量新增时仅支持最简单配置，若需要对域名进行更复杂配置，请创建后再调用：批量更新域名配置接口。

账单详情 1. 支持不同统计维度（使用量、资源、产品）、统计周期（按账期、按天、明细）、计费模式（包周期、按需）查看账单的详细信息，并支持导出两种格式（XLSX、CSV）的账单，可在“导出记录”下载。 2. 支持通过单击导出按钮左侧的【列设置】，自定义规划需要展示的列项，实现自定义查询账单。 导出记录 用户单击【导出记录】后，可查看已导出的全部文件记录，也可在如下图的页面单击【下载】，将账单数据下载至本地查看。

使用键的集合对象 这些集合对象在存储数据时会使用到键，支持按照插入顺序来迭代元素。 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

本文介绍如何使用边缘函数更改在请求中发送或在响应中返回的HTTP头。 更改在请求中发送或在响应中返回的HTTP头。 示例代码 javascript addEventListener('fetch', event > { event.respondWith(handleRequest(event.request)) }) async function handleRequest(request) { const response await fetch(request) // 添加新的头 response.headers.append("XHello", "hello from ctyun") // 修改旧的头 response.headers.set("Etag" ,"4kf36KRuEB") return response } 示例预览 相关HTTP头被修改。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent 运行时API：Web Standard 运行时API：Fetch

本文介绍如何通过Referer防盗链实现访问控制。 通过Referer进行请求防盗链。 示例代码 javascript function verifyReferer(referer) { let regex /ctyun/; return regex.test(referer); } async function verifyHeaderParameters(request) { //401表示鉴权不通过 let statuscode 401 let result 'Referer verification failed!' try { if(verifyReferer(request.headers.get("referer")) true){ statuscode 200 result "Referer verification succeeded!" } } catch (error) { result error } return new Response(result, { "status": statuscode }); } addEventListener('fetch', event > { event.respondWith(verifyHeaderParameters(event.request)) }) 示例预览 访问请求传入鉴权referer，鉴权通过。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent 运行时API：Web Standard 运行时API：Fetch

本文介绍如何使用边缘函数修改客户端请求。 根据特殊分支场景，修改用户请求内容。 示例代码 javascript async function handleRequest(request) { // 修改当前请求的地址的 host 指向别的域名 const url new URL(request.url) url.hostname "www.ctyun.cn" url.protocol "https" // 继承原始请求的头、请求方法等参数 let newheaders request.headers newheaders.delete("Host") const requestInit { method: request.method, newheaders, } const newreq new Request(url, requestInit) // 访问 yourdomain/path 即请求 ctyun.cn/path return fetch(newreq) } addEventListener("fetch", event > { event.respondWith(handleRequest(event.request)) }) 示例预览 请求内容被修改，根据用户修改后的请求响应其他内容。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent 运行时API：Web Standard 运行时API：Fetch 运行时API：Request

参数 类型 是否必传 名称 描述 page int 否 当前页数 不填默认1 perpage int 否 每页显示的记录条数 不填默认1000

接口描述：调用本接口创建预取任务。 请求方式：post 请求路径：/preloadtask/createpreloadtask 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明： 参数 类型 是否必填 名称 描述 values list 是 预取文件列表 单次最多50条。若域名有做防盗链配置，则相应的预取url需同样带有防盗链。 headers list 否 指定请求头 字段headers详细说明见下方 详细参数说明： headers参数 参数 类型 是否必填 名称 描述 name string 否 请求头名称 长度限制50个字符 value string 否 请求头值 长度限制100个字符 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 submitid string 否 预取提交id result list 否 创建的预取任务列表 result[].url string 否 预取URL result[].taskid string 否 预取任务id 示例： 请求路径： 示例1： 请求参数： { "values": [ " " ], "headers": [ { "name": "test", "value": "111" }, { "name": "test2", "value": "222" } ] } 返回结果： { "code": 100000, "message": "success", "submitid": "cf48cdece3160f174a5f3026d52991ee", "result": [ { "taskid": "e12a05dc190045af2645f4b8bbe4135f", "url": " }, { "taskid": "e12a05dc190045af2645f4b8bbe4135f", "url": " } ] } 错误码请参考：参数code和message含义

参数 类型 是否必传 名称 描述 domain string 是 域名

本文介绍设置Nginx缓存策略的方法。 免责声明： 本文档包含第三方产品信息，该信息仅供参考。 背景说明 本文主要介绍Nginx服务器的缓存策略配置方法。如源站服务器使用的是Nginx，可将本文作为参考。 详细信息 Nginx服务器的缓存策略设置方法有两种：addheader或者expires。 1. addheader 1）语法：addheader name value。 2）默认值：none。 3）使用范围：http、server、location。 配置示例如下： addheader cachecontrol "maxage86400"；设置缓存时间为1天。 addheader cachecontrol "nocache"； 设置为不缓存。 addheader cachecontrol "maxage60"； 设置缓存时间为1分钟。 2. expires 1）语法：expires [timeepochmaxoff] 2）默认值：expires off 3）使用范围：http、server、location 4）这个指令控制是否在应答中标记一个过期时间，标记说明如下： off：将禁止修改头部中的Expires和CacheControl字段。 time：控制CacheControl的值，负数标识永远过期，并且响应cachecontrol: nocache。 epoch：将Expires头设置为1 January, 1970 00:00:01 GMT。 max：将Expires头设置为31 December 2037 23:59:59 GMT，将CacheControl最大化到10年。 配置示例如下： expires 1； expires响应头内容为当前服务器时间过去1秒的时间，同时响应cachecontrol: nocache。 expires 1d； expires响应头内容为当前服务器时间未来1天的时间，同时响应cachecontrol: 86400。 expires 1h； expires响应头内容为当前服务器时间未来1小时的时间，同时响应cachecontrol: 3600。

省份/国家中文 省份/国家英文 省份/国家编码 省份/国家英文编码 安徽 AnHui 340000 CNanhui 浙江 ZheJiang 330000 CNzhejiang 上海 ShangHai 310000 CNshanghai 江苏 JiangSu 320000 CNjiangsu 福建 FuJian 350000 CNfujian 山东 ShanDong 370000 CNshandong 广东 GuangDong 440000 CNguangdong 广西 GuangXi 450000 CNguangxi 海南 HaiNan 460000 CNhainan 江西 JiangXi 360000 CNjiangxi 河南 HeNan 410000 CNhenan 湖南 HuNan 430000 CNhunan 湖北 HuBei 420000 CNhubei 辽宁 LiaoNing 210000 CNliaoning 吉林 JiLin 220000 CNjilin 黑龙江 HeiLongJiang 230000 CNheilongjiang 陕西 ShaanXi 610000 CNshaanxi 甘肃 GanSu 620000 CNgansu 青海 QingHai 630000 CNqinghai 宁夏 NingXia 640000 CNningxia 新疆 XinJiang 650000 CNxinjiang 北京 BeiJing 110000 CNbeijing 天津 TianJin 120000 CNtianjin 河北 HeBei 130000 CNhebei 山西 ShanXi 140000 CNshanxi 内蒙古 NeiMengGu 150000 CNneimenggu 重庆 ChongQing 500000 CNchongqing 四川 SiChuan 510000 CNsichuan 贵州 GuiZhou 520000 CNguizhou 云南 YunNan 530000 CNyunnan 西藏 XiZang 540000 CNxizang 香港 HongKong,China 810000 HK 澳门 Macao,China 820000 MO 台湾 Taiwan,China 710000 TW 中国其他 China 0 CNqita 中国 CN 中国东北其他省 CNdongbei 中国华北其他省 CNhuabei 中国华东其它省 CNhuadong 中国华南其它省 CNhuanan 中国华中其它省 CNhuazhong 中国西北其它省 CNxibei 中国西南其它省 CNxinan 文莱 Brunei 1000000 BN 日本 Japan 1000001 JP 泰国 Thailand 1000002 TH 约旦 Jordan 1000003 JO 越南 Vietnam 1000005 VN 阿曼 Oman 1000006 OM 韩国 South Korea 1000007 KR 叙利亚 Syria 1000008 SY 新加坡 Singapore 1000009 SG 阿富汗 Afghanistan 1000010 AF 阿联酋 United Arab Emirates 1000011 AE 塞浦路斯 Cyprus 1000012 CY 巴基斯坦 Pakistan 1000013 PK 尼泊尔 Nepal 1000014 NP 哈萨克斯坦 Kazakhstan 1000015 KZ 喀麦隆 Cameroon 1000016 CM 巴拿马 Panama 1000017 PA 几内亚 Guinea 1000019 GN 立陶宛 Lithuania 1000020 LT 科威特 Kuwait 1000021 KW 伊朗 Iran 1000022 IR 墨西哥 Mexico 1000023 MX 瑞士 Switzerland 1000024 CH 匈牙利 Hungary 1000025 HU 土耳其 Turkey 1000026 TR 奥地利 Austria 1000027 AT 意大利 Italy 1000028 IT 比利时 Belgium 1000029 BE 葡萄牙 Portugal 1000030 PT 西班牙 Spain 1000031 ES 库克群岛 Cook Islands 1000034 CK 萨摩亚 Samoa 1000035 WS 瑙鲁 Nauru 1000036 NR 汤加 Tonga 1000037 TO 瓦努阿图 Vanuatu 1000038 VU 格林纳达 Grenada 1000039 GD 科摩罗 Comoros 1000040 KM 毛里塔尼亚 Mauritania 1000041 MR 塞拉利昂 Sierra Leone 1000042 SL 坦桑尼亚 Tanzania 1000043 TZ 乍得 Chad 1000044 TD 斐济 Fiji 1000045 FJ 密克罗尼西亚联邦 Micronesia 1000046 FM 卡塔尔 Qatar 1000047 QA 卢森堡 Luxembourg 1000048 LU 智利 Chile 1000049 CL 秘鲁 Peru 1000050 PE 哥伦比亚 Colombia 1000051 CO 保加利亚 Bulgaria 1000052 BG 白俄罗斯 Belarus 1000053 BY 罗马尼亚 Romania 1000054 RO 加纳 Ghana 1000055 GH 加蓬 Gabon 1000056 GA 南非 South Africa 1000057 ZA 埃及 Egypt 1000058 EG 苏丹 Sudan 1000059 SD 贝宁 Benin 1000060 BJ 利比亚 Libya 1000061 LY 吉布提 Djibouti 1000062 DJ 安哥拉 Angola 1000063 AO 摩洛哥 Morocco 1000064 MA 尼日利亚 Nigeria 1000066 NG 毛里求斯 Mauritius 1000067 MU 亚美尼亚 Armenia 1000068 AM 加拿大 Canada 1000069 CA 多米尼加 Dominican Republic 1000071 DM 乌拉圭 Uruguay 1000072 UY 厄瓜多尔 Ecuador 1000073 EC 阿尔及利亚 Algeria 1000074 DZ 刚果(布) Congo 1000075 CG 肯尼亚 Kenya 1000076 KE 伊拉克 Iraq 1000077 IQ 埃塞俄比亚 Ethiopia 1000078 ET 斯里兰卡 Sri Lanka 1000079 LK 印度尼西亚 Indonesia 1000081 ID 沙特阿拉伯 Saudi Arabia 1000084 SA 丹麦 Denmark 1000086 DK 德国 Germany 1000087 DE 挪威 Norway 1000088 NO 法国 France 1000089 FR 委内瑞拉 Venezuela 1000091 VE 朝鲜 North Korea 1000092 KP 老挝 Laos 1000093 LA 菲律宾 Philippines 1000094 PH 澳大利亚 Australia 1000095 AU 塔吉克斯坦 Tajikistan 1000096 TJ 土库曼斯坦 Turkmenistan 1000097 TM 巴巴多斯 Barbados 1000099 BB 波兰 Poland 1000101 PL 瑞典 Sweden 1000102 SE 多米尼克 Dominica 1000103 苏里南 Suriname 1000104 SR 圣卢西亚 Saint Lucia 1000105 LC 特立尼达和多巴哥 Trinidad and Tobago 1000106 TT 牙买加 Jamaica 1000107 JM 巴哈马 Bahamas 1000108 BS 博茨瓦纳 Botswana 1000109 BW 布基纳法索 Burkina Faso 1000110 BF 赤道几内亚 Equatorial Guinea 1000111 GQ 多哥 Togo 1000112 TG 厄立特里亚 Eritrea 1000113 ER 冈比亚 Gambia 1000115 GM 刚果(金) DR Congo 1000116 CD 几内亚比绍 GuineaBissau 1000117 GW 科特迪瓦 Cote d’Ivoire 1000118 CI 莱索托 Lesotho 1000119 LS 卢旺达 Rwanda 1000120 RW 马达加斯加 Madagascar 1000121 MG 马里 Mali 1000122 ML 尼日尔 Niger 1000123 NE 塞舌尔 Seychelles 1000124 SC 安道尔 Andorra 1000125 AD 阿尔巴尼亚 Albania 1000126 AL 爱沙尼亚 Estonia 1000127 EE 克罗地亚 Croatia 1000129 HR 拉脱维亚 Latvia 1000130 LV 列支敦士登 Liechtenstein 1000131 LI 北马其顿 North Macedonia 1000132 MK 马耳他 Malta 1000133 MT 摩纳哥 Monaco 1000134 MC 摩尔多瓦 Moldova 1000135 MD 斯洛文尼亚 Slovenia 1000137 SI 巴勒斯坦 Palestine 1000138 PS 巴林 Bahrain 1000139 BH 不丹 Bhutan 1000140 BT 吉尔吉斯斯坦 Kyrgyzstan 1000142 KG 黎巴嫩 Lebanon 1000143 LB 马尔代夫 Maldives 1000144 MV 马来西亚 Malaysia 1000145 MY 缅甸 Myanmar 1000146 MM 印度 India 1000147 IN 巴布亚新几内亚 Papua New Guinea 1000148 PG 巴西 Brazil 1000149 BR 阿根廷 Argentina 1000150 AR 新西兰 New Zealand 1000151 NZ 阿塞拜疆 Azerbaijan 1000152 AZ 蒙古 Mongolia 1000153 MN 圭亚那 Guyana 1000155 GY 洪都拉斯 Honduras 1000156 HN 美国 United States 1000157 US 荷兰 Netherlands 1000158 NL 乌克兰 Ukraine 1000159 UA 关岛 Guam 1000160 GU 危地马拉 Guatemala 1000161 GT 格恩西或根西岛 Guernsey 1000162 海地 Haiti 1000163 HT 马恩岛 Isle of Man 1000164 IM 泽西 Jersey 1000165 基里巴斯 Kiribati 1000166 KI 马拉维 Malawi 1000167 MW 马绍尔群岛 Marshall Islands 1000168 MH 马提尼克 Martinique 1000169 MQ 马约特 Mayotte 1000170 YT 黑山 Montenegro 1000171 ME 蒙特塞拉特 Montserrat 1000172 MS 新喀里多尼亚 New Caledonia 1000174 NC 纽埃 Niue 1000175 NU 帕劳 Palau 1000176 PW 巴拉圭 Paraguay 1000178 PY 皮特凯恩 Pitcairn 1000179 PN 波多黎各 Puerto Rico 1000180 PR 圣赫勒拿 Saint Helena 1000181 圣皮埃尔和密克隆 Saint Pierre and Miquelon 1000182 PM 圣文森特和格林纳丁斯 Saint Vincent and the Grenadines 1000183 VC 索马里 Somalia 1000184 SO 南乔治亚岛和南桑德韦奇岛 South Georgia and the South Sandwich Islands 1000185 GS 斯瓦尔巴群岛和扬马延岛 Svalbard and Jan Mayen Islands 1000186 SJ 斯威士兰 Eswatini 1000187 SZ 东帝汶 TimorLeste 1000188 TL 特克斯和凯科斯群岛 Turks and Caicos Islands 1000189 TC 英属维尔京群岛 British Virgin Islands 1000190 VG 圣多美和普林西比 Sao Tome and Principe 1000191 ST 塞尔维亚 Serbia 1000192 RS 斯洛伐克 Slovakia 1000193 SK 所罗门群岛 Solomon Islands 1000194 SB 美属萨摩亚 American Samoa 1000195 AS 安圭拉 Anguilla 1000196 AI 阿鲁巴 Aruba 1000197 AW 伯利兹 Belize 1000198 BZ 百慕大 Bermuda 1000199 BM 波黑 Bosnia and Herzegovina 1000200 BA 开曼群岛 Cayman Islands 1000201 KY 中非 Central African Republic 1000202 CF 哥斯达黎加 Costa Rica 1000203 CR 萨尔瓦多 El Salvador 1000204 SV 福克兰群岛（马尔维纳斯） Falkland Islands 1000205 FK 法罗群岛 Faroe Islands 1000206 FO 法属圭亚那 French Guiana 1000207 GF 法属波利尼西亚 French Polynesia 1000208 PF 直布罗陀 Gibraltar 1000209 GI 格陵兰 Greenland 1000210 GL 瓜德罗普 Guadeloupe 1000211 GP 美属维尔京群岛 United States Virgin Islands 1000212 VI 西撒哈拉 Western Sahara 1000213 EH 捷克 Czechia 1000214 CZ 英国 United Kingdom 1000215 GB 梵蒂冈 Holy See 1000216 VA 诺福克岛 Norfolk Island 1000217 NF 圣基茨和尼维斯 Saint Kitts and Nevis 1000218 KN 突尼斯 Tunisia 1000219 TN 利比里亚 Liberia 1000220 LR 图瓦卢 Tuvalu 1000221 TV 古巴 Cuba 1000222 CU 安提瓜和巴布达 Antigua and Barbuda 1000223 AG 圣诞岛 Christmas Island 1000224 CX 莫桑比克 Mozambique 1000226 MZ 冰岛 Iceland 1000227 IS 圣马力诺 San Marino 1000228 SM 孟加拉 Bangladesh 1000229 BD 南极洲 Antarctica 1000230 AQ 芬兰 Finland 1000231 FI 爱尔兰 Ireland 1000232 IE 俄罗斯 Russia 1000233 RU 希腊 Greece 1000235 GR 乌兹别克斯坦 Uzbekistan 1000236 UZ 尼加拉瓜 Nicaragua 1000237 NI 玻利维亚 Bolivia 1000238 BO 格鲁吉亚 Georgia 1000239 GE 赞比亚 Zambia 1000241 ZM 南苏丹 South Sudan 1000242 SS 以色列 Israel 1000243 IL 乌干达 Uganda 1000244 UG 塞内加尔 Senegal 1000245 SN 布隆迪 Burundi 1000246 BI 津巴布韦 Zimbabwe 1000247 ZW 纳米比亚 Namibia 1000248 NA 留尼汪 Reunion 1000249 RE 佛得角 Cabo Verde 1000250 CV 也门 Yemen 1000251 YE 柬埔寨 Cambodia 1000252 KH 英属印度洋领土 British Indian Ocean Territory 1000258 IO 奥兰群岛 Aland Islands 1000261 AX 布维岛 Bouvet Island 1000262 BV 欧盟 European Union 1000263 EU 科索沃 Kosovo 1000264 XK 法属南方领地 French Southern Territories 1000265 博纳尔，圣俄斯塔休斯和萨巴 Bonaire, Sint Eustatius and Saba 1000266 库拉索 Curaçao 1000267 CW 圣巴泰勒米 Saint Barthelemy 1000268 BL 圣马丁（法属） Saint Martin (French Part) 1000269 MF 圣马丁（荷属） Sint Maarten (Dutch part) 1000270 SX 美国本土外小岛屿 United States Minor Outlying Islands 1000271 科科斯（基林）群岛 Cocos (Keeling) Islands 1000272 CC 赫德岛和麦克唐纳岛 Heard Island and McDonald Islands 1000273 HM 北马里亚纳群岛 Northern Mariana Islands 1000274 MP 托克劳 Tokelau 1000275 TK 瓦利斯群岛和富图纳群岛 Wallis and Futuna Islands 1000276 WF 未知国家 unknown 1000277 XX 海外其他 1 海外 2