當(dāng)您的業(yè)務(wù)用戶請求業(yè)務(wù)資源時(shí),您可以在返回的響應(yīng)消息中配置頭部,以實(shí)現(xiàn)跨域訪問等目的。
響應(yīng)頭部配置是域名維度的,因此一旦配置生效,會(huì)對域名下任意一個(gè)資源的響應(yīng)消息生效。配置響應(yīng)頭部僅影響客戶端(如瀏覽器)的響應(yīng)行為,不會(huì)影響到 CDN 節(jié)點(diǎn)的緩存行為。
登錄 CDN控制臺(tái),在菜單欄里選擇域名管理,單擊域名右側(cè)管理,即可進(jìn)入域名配置頁面,在高級配置中可看到響應(yīng)頭部配置,默認(rèn)情況下配置為關(guān)閉狀態(tài),單擊新增規(guī)則可配置 HTTP 響應(yīng)頭規(guī)則:
操作類型 | 說明 |
設(shè)置 | 變更指定響應(yīng)頭部參數(shù)的取值為設(shè)置后的值。 若設(shè)置的頭部不存在,則會(huì)增加該頭部。 若存在多個(gè)重復(fù)的頭部參數(shù),則會(huì)全部變更,同時(shí)合并為一個(gè)頭部。 即當(dāng)配置規(guī)則為設(shè)置 x-cdn: value1,若請求中包含有多個(gè) x-cdn 頭部,則多個(gè)頭部均會(huì)變更,合并為一個(gè)頭部 x-cdn: value1。 |
刪除 | 刪除指定的響應(yīng)頭參數(shù)。 |
注意
● HTTP 響應(yīng)頭配置規(guī)則最多可配置10條。
● 多條規(guī)則支持調(diào)整優(yōu)先級:底部優(yōu)先級大于頂部。若同一頭部參數(shù)配置了多條規(guī)則,則生效的是最底部,即優(yōu)先級最高的那條。
頭部參數(shù) | 說明 |
Access-Control-Allow-Origin | 用于解決資源的跨域權(quán)限問題,域值定義了允許訪問該資源的域。若來源請求 Host 到域名配置列表之內(nèi),則直接填充對應(yīng)值在返回頭部中。也可以設(shè)置通配符 “*”,允許被所有域請求。支持輸入“*” ,或多個(gè)域名 / IP / 域名與 IP 混填(必須包含 http:// 或 https://,填寫示例:http://test.com,http://1.1.1.1,逗號隔開)(注意:輸入框最多可輸入2000字符)。 |
Access-Control-Allow-Methods | 用于設(shè)置跨域允許的 HTTP 請求方法,可同時(shí)設(shè)置多個(gè)方法,如下:Access-Control-Allow-Methods: POST, GET, OPTIONS。 |
Access-Control-Max-Age | 用于指定預(yù)請求的有效時(shí)間,單位為秒。非簡單的跨域請求,在正式通信之前,需要增加一次 HTTP 查詢請求,稱為“預(yù)請求”,用來查明這個(gè)跨域請求是不是安全可以接受的,如下請求會(huì)被視為非簡單的跨域請求:以 GET、HEAD 或者 POST 以外的方式發(fā)起,或者使用 POST,但是請求數(shù)據(jù)類型為 application/x-www-form-urlencoded、 multipart/form-data、text/plain 以外的數(shù)據(jù)類型,如 application/xml 或者 text/xml。使用自定義請求頭為:Access-Control-Max-Age:1728000,表明在1728000秒(20天)內(nèi),對該資源的跨域訪問不再發(fā)送另外一條預(yù)請求。 |
Access-Control-Expose-Headers | 用于指定哪些頭部可以作為響應(yīng)的一部分暴露給客戶端。默認(rèn)情況下,只有6種頭部可以暴露給客戶端:Cache-Control、Content-Language、Content-Type、Expires、Last-Modified、Pragma。如果想讓客戶端訪問到其他的頭部信息,可以進(jìn)行如下設(shè)置,當(dāng)輸入多個(gè)頭部時(shí),需用 “,” 隔開,如:Access-Control-Expose-Headers: Content-Length,X-My-Header,表明客戶端可以訪問到 Content-Length 和 X-My-Header 這兩個(gè)頭部信息。 |
Content-Disposition | 用來激活瀏覽器的下載,同時(shí)可以設(shè)置默認(rèn)的下載的文件名。服務(wù)端向客戶端瀏覽器發(fā)送文件時(shí),如果是瀏覽器支持的文件類型,如 TXT、JPG 等類型,會(huì)默認(rèn)直接使用瀏覽器打開,如果需要提示用戶保存,則可以通過配置 Content-Disposition 字段覆蓋瀏覽器默認(rèn)行為。常用的配置如下:Content-Disposition:attachment;filename=FileName.txt |
Content-Language | 用于定義頁面所使用的語言代碼。常用配置如下:Content-Language: zh-CN Content-Language: en-US |
自定義 | 支持添加自定義 Header,自定義 key-value 設(shè)置。自定義頭部參數(shù):由大小寫字母、數(shù)字及 - 組成,長度支持1 - 100個(gè)字符。自定義頭部取值:長度為1 - 2000個(gè)字符,不支持中文。 |
匹配模式 | 域值 | 說明 |
全匹配 | * | 設(shè)置為 * 時(shí),則響應(yīng)添加頭部: Access-Control-Allow-Origin:* |
固定匹配 |
http://www.yijingcm.com/ | 來源為http://www.yijingcm.com/,命中列表,則響應(yīng)添加頭部: Access-Control-Allow-Origin: http://www.yijingcm.com/ 來源為 https://www.qq.com,未命中列表,響應(yīng)無變化。 |
二級泛域名匹配 | https://*.xinnent.com | 來源為 https://cloud.xinnet.com,命中列表,則響應(yīng)添加頭部: Access-Control-Allow-Origin: https://cloud.xinnet.com 來源為 https://cloud.qq.com,未命中列表,響應(yīng)無變化。 |
端口匹配 | https://cloud.xinnet.com:8080 | 來源為 https://cloud.xinnet.com:8080,命中列表,則響應(yīng)添加頭部: Access-Control-Allow-Origin:https://cloud.xinnet.com:8080 來源為 https://cloud.xinnet.com,未命中列表,響應(yīng)無變化。 |
注意
若存在特殊端口,則需要在列表中填寫相關(guān)信息,不支持任意端口匹配,必須指定。
此功能不支持以下頭部,即以下頭部不會(huì)生效:
Date
Expires
Content-Type
Content-Encoding
Content-Length
Transfer-Encoding
Cache-Control (僅不支持刪除)
If-Modified-Since
Last-Modified
Connection
Content-Range
ETag
Accept-Ranges
Age
Authentication-Info
Proxy-Authenticate
Retry-After
Set-Cookie
Vary
WWW-Authenticate
Content-Location
Content-MD5
Content-Range
Meter
Allow
Error