文档
测试

子域名配置

websocket测试
POST
http:/domain/api/front/host/edit

请求头

参数名
类型
描述
必填
Content-Type:application/json
sring
必填
Authorization
string
例如：Bearer token值
必填

请求参数

参数名
类型
描述
必填
func
string
请求方法名
必填
host
string
子域名
必填

说明 / 示例

子域名配置请求方法： //编辑源 addr = 1.1.1.1 或者 www.yuming.com ，源地址 port = 80 ，端口号 isSSL = false ，是否是https ``` { "func":"upstreams", "host": "www.1.com", "upstreams": [{ "addr": "1.1.1.2", "port":"80", "isSSL":true }, { "addr": "1.1.1.2", "port":"88", "isSSL":false }] } ``` //防盗链 CheckReferer = false ，是否开启防盗链，默认false PassEmptyReferer = false，放行浏览器，默认false RefererRegex = 1234 ，URL正则表达式，可为空，黑名单机制（屏蔽填写的域名） RefererRules= ["1","2"]， 白名单机制（放行所填的域名） ``` { "func": "referer", "host":"www.1.com", "security":{ "CheckReferer":true, "PassEmptyReferer":true, "RefererRegex":"1234", "RefererRules":[ "1","2","4" ] } } ``` //维护 isMaintain = false，是否开启维护，默认false maintainCode = 200 ，状态码：如200，404，不能填写302 maintainPage 整个html页面，请为页面设置编码格式，否则可能出现乱码 ``` { "func": "maintain", "host":"www.1.com", "isMaintain":true, "maintainCode":200, "maintainPage":"<html><head><title>网站维护中...</title><meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" /></head><body style=\"text-align:center;\"><p style=\"margin-top:50px;\"><h2>网站维护中…</h2></p></body></html>" } ``` //权重 speedPref = false, 权重选项，默认false，false的时候是比例回源（可填写比例），true的时候是速度优先。 lockSource = false，端口跟随，默认false max_fail = 3 ，失败重试次数 timeout = 3 ，重试超时（秒） widget = 1，权重比例 ``` { "func": "weight", "host":"www.1.com", "speedPref":false, "lockSource":false, "max_fail":3, "timeout":3, "upstreams": [{ "max_fail": 3, "addr": "1.1.1.1", "port":"80", "isSSL":false, "timeout":4, "widget":1 }, { "max_fail": 3, "addr": "1.1.1.1", "port":"88", "isSSL":true, "timeout":5, "widget":2 }] } ``` //回源检测 openKeepalive = false = 关闭，true = 开启 ，默认关闭状态 kpHost = www.1.com , host=*通配符的域名填写具体域名，其他填写host对应的域名。 ``` { "func": "openKeepalive", "host":"www.1.com", "openKeepalive":false, "kpHost":"www.1.com" } ``` //负载 balancer = iphash,urlhash,normal ``` { "func": "balancer", "host":"www.1.com", "balancer":"iphash" } ``` //缓存类型 cacheType = html|js|css|jpg ...多个文件类型以竖杠“|”分割 ``` { "func": "cacheType", "host":"www.1.com", "cache":{ "cacheType":"html|js|css|jpg" } } ``` //缓存时间 cacheTimeout = 2000，单位秒 useRespMaxAge = false， 缓存时间跟随源，如果源站设置了对应后缀的缓存时间，则cdn对该后缀缓存时间走源的设置。默认false。 ``` { "func": "cacheTimeout", "host":"www.1.com", "cache":{ "cacheTimeout":2000, "useRespMaxAge":false } } ``` //回源带宽 cacheLimit = 100 ，单位MB cacheLimitTTL = 1, 每多少秒 ``` { "func": "cacheLimit", "host":"www.1.com", "security":{ "cacheLimit":100, "cacheLimitTTL":1 } } ``` //强制关闭所有缓存 closeCache = false ，强制关闭所有缓存，也包括智能缓存，针对所有的API特殊需求的系统，防止缓存影响系统。默认false。 ``` { "func": "closeCache", "host":"www.1.com", "cache":{ "closeCache":false } } ``` //关闭源站GZIP请求 ``` { "func": "closeSrcGzip", "host":"www.1.com", "security":{ "closeSrcGzip":true } } ``` //强制缓存 clearPath = false，资源缓存时去除 URL「?」后的全部参数进行缓存，默认false ``` { "func": "clearPath", "host":"www.1.com", "security":{ "clearPath":false } } ``` //流量缓冲 closeBuffering = false， 关闭流量缓冲默认false = 流量缓冲默认是开启状态 ``` { "func": "closeBuffering", "host":"www.1.com", "closeBuffering":false } ``` //防御等级（子域名列表防御设置：js盾防御+验证码防御） jsGuard = 2 , 2=开启 0=关闭 ，js盾防御 useCaptcha = 1, 1=开启 -1=关闭 ，验证码防御 ``` { "func": "guard", "host":"www.1.com", "security":{ "jsGuard":2, "useCaptcha":1 } } ``` //js盾防御 jsGuard = 2 开启 0-关闭 ``` { "func": "jsGuard", "host":"www.1.com", "security":{ "jsGuard":2 } } ``` //验证码防御 + 资源拉黑 useCaptcha 1=开启 -1 关闭 CapQueryResAction 资源拉黑 1=开启 0-关闭 ``` { "func": "Captcha", "host":"www.1.com", "security":{ "useCaptcha":1, "CapQueryResAction":1 } } ``` //验证码防御 useCaptcha 1=开启 -1 关闭 ``` { "func": "useCaptcha", "host":"www.1.com", "security":{ "useCaptcha":1 } } ``` //Hsts lockHSTS = false,强制使用https与服务器创建连接，默认false ``` { "func": "lockHSTS", "host":"www.1.com", "lockHSTS":true } ``` //强制跳转 lockHttps = false ,默认false关闭 ``` { "func": "lockHttps", "host":"www.1.com", "lockHttps":false } ``` //长连接 keepaliveTime = 600 ，该数值必须在10-600之间，仅用于HTTP，WEBSOCKET非HTTP协议超时时间已设置默认为600秒 ``` { "func": "keepaliveTime", "host":"www.1.com", "keepaliveTime":600 } ``` //User-Agent屏蔽, UserAgentAction 0-仅预警 1-仅拦截 3-IP拉入黑名单 isBanEmptyUA 屏蔽空UA -1=关闭 1=开启 UserAgent 模糊匹配 如：屏蔽非英文ua正則（模糊匹配添加上这个正则会屏蔽掉英文以外其他文字的ua访问）：[^a-zA-Z\s0-9\.\/\(\)\,\;]+ matchUserAgnet 精准匹配 ``` { "func": "UserAgent", "host":"www.1.com", "security":{ "UserAgentAction":1, "UserAgent":[ "1", "2" ], "matchUserAgnet":[ "2", "3" ], "isBanEmptyUA":1 } } ``` //区域屏蔽 banArea_states 开关状态 banArea 屏蔽的地区 ``` { "func": "banArea", "host":"www.1.com", "security":{ "banArea_states":true, "banArea":[ "中国", "中非共和国" ] } } ``` //URL白名单 ``` { "func": "whiteurl", "host":"www.1.com", "security":{ "whiteurl":[ "/url1", "/url2" ] } } ``` //URL黑名单 ``` { "func": "blackurl", "host":"www.1.com", "security":{ "blackurl":[ "/url1", "/url2" ] } } ``` //触发防御频率 badReqOnSec 普通频率 每2秒异常请求数量5~1000 STBadReqOnSec 基站频率 每2秒异常请求数量5~1000 ``` { "func": "badReq", "host":"www.1.com", "security":{ "badReqOnSec":100, "STBadReqOnSec":100 } } ``` //同IP访问限制 IPLimitAction 0-仅预警 1-仅拦截 2-弹出验证码(失败拉黑) 3-IP拉入黑名单 ipLimit 普通IP 每2秒异常请求数量5~1000 STIpLimit 基站IP 每2秒异常请求数量5~1000 ``` { "func":"ipLimit", "host":"www.1.com", "security":{ "IPLimitAction":1, "ipLimit":100, "STIpLimit":100 } } ``` //白名单IP访问限制 WhiteIPAction 0-仅预警 1-仅拦截 2-弹出验证码(失败拉黑) 3-IP拉入黑名单 WhiteIPLimit 请求不同URL次数 IP过白后访问限制，每秒单个IP同时请求不同URL（资源）次数5~10000,该数值设置太低会导致频繁误封报错，建议大于100 WhiteBadReqOnSec 请求同一URL次数 IP过白后访问限制，每2秒单个IP请求同一URL（资源）或者顺序请求中相同地址包含过多，次数5~10000,该数值设置太低会导致频繁误封报错，建议大于150 ``` { "func":"WhiteIPLimit", "host":"www.1.com", "security":{ "WhiteIPAction":0, "WhiteIPLimit":100, "WhiteBadReqOnSec":100 } } ``` //白名单IP单个URL访问限制 URLAction 0-仅预警 1-仅拦截 2-弹出验证码(失败拉黑) 3-IP拉入黑名单 URLLimit IP过白后访问限制，每多少秒单个IP请求设置都URL次数5~10000 URLLimitTTL 搭配URLLimit ，多少秒内 UrlPathRegex URL地址，如：/test/a.html ``` { "func": "WhiteUrlLimit", "host": "www.1.com", "security": { "WhiteUrlLimit": [{ "URLAction": 1, "URLLimit": 10, "URLLimitTTL": 2, "UrlPathRegex": "string1" }, { "URLAction": 1, "URLLimit": 10, "URLLimitTTL": 2, "UrlPathRegex": "string2" } ] } } ``` //旧网站兼容 openCSPCheat = false,默认不开启 ``` { "func": "openCSPCheat", "host":"www.1.com", "openCSPCheat":false } ``` //自定义header //目前支持宏为：$host$ = 来源host信息， $remoteAddr$ = 请求客户端IP， $version$ = 当前CDN版本号和信息 ``` { "func": "proxyHeader", "host": "www.1.com", "proxyHeader": [{ "header": "X-Tenant-Forward-For1", "value": "$remoteAddr$" }, { "header": "X-Tenant-Forward-For2", "value": "$remoteAddr$" } ] } ``` //强制返回关闭CLOSE forceClose= -1 不开启 1 开启 ，默认不开启 ``` { "func": "forceClose", "host":"www.1.com", "security":{ "forceClose":-1 } } ``` //关闭防火墙 stopWaf = false = 不关闭,默认不关闭 ，ture = 关闭 ``` { "func": "stopWaf", "host":"www.1.com", "security":{ "stopWaf":false } } ``` //缓存206和ranges数据 cacheRanges = -1 关闭 1-开启，默认关闭 源站本身必须支持206或RANGES下载，开启后可能产生多个RANGES记录。如果每次RANGES不同，可能还会回源。 ``` { "func": "cacheRanges", "host":"www.1.com", "cache":{ "cacheRanges":-1 } } ``` //自定义头部host proxyHost = www.1.com ``` { "func": "proxyHost ", "host":"www.1.com", "proxyHost": "www.1.com" } ``` //大文件缓存 host 具体域名 preload 是否预加载文件，即自动下载最新的文件，文件大于200M必须开启预加载 preloadTicker 不包含 Last-Modified 则无效, 预加载开启时，设置缓存文件更新周期，建议超过30分钟或大于1小时一次（为0时不主动更新）[自动检测源站文件是否已刷新，如果刷新才下载，不刷新则不下载] urlPath URL地址，如：game/1.apk，则代表该路径使用大文件系统缓存(由于大文件管理关乎下载和缓存，不可使用正则表达式匹配) preloadNodes 指定哪些节点参与大文件系统预加载，必须设置，如果无设置，则全部节点不参与。 ``` { "func": "bigFSFiles", "host": "www.1.com", "cache": { "bigFSFiles": [{ "host": [ "www.1.com" ], "preload": true, "preloadTicker": 60, "urlPath": "game/11.apk" }, { "host": [ "www.1.com" ], "preload": true, "preloadTicker": 60, "urlPath": "game/22.apk" } ], "preloadNodes": ["1", "2"] } } ``` //跨域 openCORS = -1 关闭 1-开启 ，默认关闭 AllowCredentials = false，是否响应头暴露给页面，默认false MaxAge = 60 预检结果缓存周期（秒） ``` { "func": "corsConf", "host": "www.1.com", "security": { "corsConf": { "AllowCredentials": true, "AllowHeaders": "x-requested-with,content-type,Cache-Control,Pragma,Date,x-timestamp", "AllowMethods": "GET,HEAD,POST,PUT", "AllowOrigin": "*", "ExposeHeaders": "WWW-Authenticate,Server-Authorization", "MaxAge": 60, "openCORS": 1 } } } ``` //智能缓存 closeAutoCache = false,关闭智能缓存，默认开启 ``` { "func": "closeAutoCache", "host": "www.1.com", "cache": { "closeAutoCache": true } } ``` //UA高频率访问的限制 UABadReqAction 0-仅预警 1-仅拦截 2-弹出验证码(失败拉黑) 3-IP拉入黑名单 uaBadReqOnSec = 100 普通频率 每2秒异常请求数量5~10000 STUABadReqOnSec = 500 基站频率 每2秒异常请求数量5~10000 限制方式为相同路径为13个，连续路径为10个，开始计算攻击，，此时开始走限制的频率。相同13个是说，比如20次访问里面，13个是相同的，即便你不是连续的，而连续10次是说，这10次UA都一样。 相同路径为13个，连续路径为10个，开始计算攻击，依次递增，就是说第13，14，15次 = 第1，2，3次（前面13次和10次是基础值，目的是为了防止误封） ``` { "func": "UABadReqLimit", "host": "www.1.com", "security": { "UABadReqAction": 1, "uaBadReqOnSec":100, "STUABadReqOnSec":500 } } ``` 返回参数示例： ``` { "code": 1, "msg": "success", "data": [] } ```
上一篇 子域名详情
nextDoc 申请证书（子域名）
本文档使用易文档编写, 更新时间: 2020-12-23 21:58