文档
测试

子域名配置

POST
http://domain/api/v1/subdomain/sets

请求头

参数名
类型
描述
必填
Content-Type
application/json
必填
apiKey
string
TkF2MFa9ZAfdOvoQoFIvM9Ch0NTLRzltL5DROGT8xGqCNkzv75qucmM7uxzxi0Nn
必填

请求参数

参数名
类型
描述
必填
func
string
方法名
必填
subDomains
array
子域名(批量)
必填

说明 / 示例

### 子域名配置请求方法: ==源站设置== **编辑源** addr = 1.1.1.1 或者 www.yuming.com ,源地址 port = 80 ,端口号最大65535 isSSL = false ,是否是https ``` { "func":"upstreams", "subDomains":[ "www.1.com", "www.2.com" ], "upstreams":[ { "addr":"1.1.1.1", "port":"80", "isSSL":false }, { "addr":"1.1.1.2", "port":"443", "isSSL":true } ] } ``` --- ==配置== **回源检测** openKeepalive = false = 关闭,true = 开启 ,默认关闭状态 kpHost = www.1.com , host=*通配符的域名填写具体域名,其他填写host对应的域名。 ``` { "func": "openKeepalive", "subDomains": [ "www.1.com", "www.2.com" ], "openKeepalive": false, "kpHost": "www.1.com" } ``` **自定义header** 目前支持宏为:\$host\$ = 来源host信息, \$remoteAddr\$ = 请求客户端IP, \$version\$ = 当前CDN版本号和信息 ``` { "func": "proxyHeader", "subDomains": [ "www.1.com" ], "proxyHeader": [ { "header": "X-Tenant-Forward-For1", "value": "$remoteAddr$" }, { "header": "X-Tenant-Forward-For2", "value": "$remoteAddr$" } ] } ``` **自定义头部host** proxyHost = www.1.com ``` { "func": "proxyHost ", "subDomains": [ "www.1.com" ], "proxyHost": "www.1.com" } ``` **回源** speedPref = false, 权重选项,默认false,false的时候是比例回源(可填写比例),true的时候是速度优先。 lockSource = false,端口跟随,默认false max_fail = 3 ,失败重试次数 timeout = 3 ,重试超时(秒) widget = 1,权重比例 ``` { "func": "weight", "subDomains": [ "www.1.com" ], "speedPref": false, "lockSource": false, "max_fail": 3, "timeout": 3, "upstreams": [ { "addr": "1.1.1.1", "port": "80", "isSSL": false, "widget": 1 }, { "addr": "1.1.1.1", "port": "88", "isSSL": true, "widget": 2 } ] } ``` ==缓存== **缓存类型** cacheType = html|js|css|jpg ...多个文件类型以竖杠“|”分割 ``` { "func":"cacheType", "subDomains":[ "www.1.com" ], "cache":{ "cacheType":"html|js|css|jpg" } } ``` **缓存时间** cacheTimeout = 2000,单位秒 useRespMaxAge = false, 缓存时间跟随源,如果源站设置了对应后缀的缓存时间,则cdn对该后缀缓存时间走源的设置。默认false。 ``` { "func":"cacheTimeout", "subDomains":[ "www.1.com", "www.2.com" ], "cache":{ "cacheTimeout":2000, "useRespMaxAge":false } } ``` **回源带宽** cacheLimit = 100 ,单位MB cacheLimitTTL = 1, 每多少秒 ``` { "func":"cacheLimit", "subDomains":[ "www.1.com", "www.2.com" ], "security":{ "cacheLimit":100, "cacheLimitTTL":1 } } ``` **强制缓存** clearPath = false,资源缓存时去除 URL「?」后的全部参数进行缓存,默认false ``` { "func":"clearPath", "subDomains":[ "www.1.com", "www.2.com" ], "security":{ "clearPath":false } } ``` **关闭缓存** closeCache = false ,强制关闭所有缓存,也包括智能缓存,针对所有的API特殊需求的系统,防止缓存影响系统。默认false。 ``` { "func":"closeCache", "subDomains":[ "www.1.com", "www.2.com" ], "cache":{ "closeCache":false } } ``` **长连接** keepaliveTime = 600 ,该数值必须在10-600之间,仅用于HTTP,WEBSOCKET非HTTP协议超时时间已设置默认为600秒 ``` { "func":"keepaliveTime", "subDomains":[ "www.1.com", "www.2.com" ], "keepaliveTime":600 } ``` **关闭源站GZIP请求** ``` { "func": "closeSrcGzip", "subDomains": [ "www.1.com", "www.2.com" ], "security": { "closeSrcGzip": true } } ``` **不缓存的路径** 路径支持正则 ``` { "func": "nocacheUrl", "subDomains": [ "www.1.com", "www.2.com" ], "cache": { "nocacheUrl": [ "/img/t.jpg", "(img\/home-bg.jpg)$ " ] } } ``` **自定义缓存路径** cacheTimeout = 缓存时间(秒),cacheUrl = 缓存路径 ``` { "subDomains": [ "www.1.com", "www.2.com" ], "func": "cacheUrlTime", "cache": { "cacheUrlTime": [ { "cacheTimeout": 1, "cacheUrl": [ "(img\\\/home-bg.jpg)$" ] } ] } } ``` --- ==维护== **维护设置** isMaintain = false,是否开启维护,默认false maintainCode = 200 ,状态码:如200,404,不能填写302 maintainPage 整个html页面,请为页面设置编码格式,否则可能出现乱码 ``` { "func":"maintain", "subDomains":[ "www.1.com", "www.2.com" ], "isMaintain":true, "maintainCode":200, "maintainPage":"<html>...</html>" } ``` --- ==证书== **HSTS** lockHSTS= false,是否开启HSTS,默认false ``` { "func":"lockHSTS", "subDomains":[ "www.1.com", "www.2.com" ], "lockHSTS":true } ``` [由于该文档字数限制,更多配置请点击此链接 >>](https://bak.easydoc.net/doc/14381291/MnydzdTz/IwSQAvuv)