tencent cloud

文档反馈

回源 Request Header 配置

最后更新时间:2023-09-06 18:09:52

    配置场景

    腾讯云 CDN 支持增加回源请求头部:
    支持通过 X-Forwarded-For 头部携带真实客户端 IP 至源站。
    支持通过 X-Forward-Port 头部携带真实客户端端口至源站,用于源站侧分析。
    支持添加各类自定义头部。
    也支持设置和删除自定义回源请求头部。

    配置指南

    查看配置

    登录 CDN 控制台,在菜单栏里选择【域名管理】,单击域名右侧【管理】,即可在【回源配置】中看到回源 Request Header 配置,默认情况下为关闭状态,无任何配置:
    img
    
    

    操作类型

    操作类型
    说明
    设置
    变更指定请求头部参数的取值为设置后的值。
    若设置的头部不存在,则会增加该头部。
    若回源请求头部参数已存在,则设置的请求头会覆盖原有头部且唯一。
    增加
    增加指定的回源请求头部参数。
    若设置的头部已存在,则增加的请求头会覆盖原有头部且唯一。
    删除
    删除指定的响应头参数。
    注意:
    底部优先级大于顶部 - 此相对位置的优先级仅限于同类型头部操作中,例如多条增加头部规则之间、多条删除头部规则之间或多条设置头部规则之间。
    当不同的头部操作类型同时作用于同一个回源请求头参数的时候,按照操作类型的优先级来执行,顺序为:增加 > 删除 > 设置。例如:同时存在增加、删除和设置X-CDN头部的规则时,会先增加,再删除,最后再设置。

    头部参数

    头部参数
    说明
    X-Forwarded-For
    用于携带用户端真实 IP 的头部。其值默认为 $client_ip 变量,不允许修改。
    X-Forward-Port
    用于携带用户端真实端口的头部。其值默认为 $remote_port 变量,不允许修改。
    自定义头部
    自定义头部的Key 值长度默认为1 - 100个字符,由数字0 - 9、字符a - z、A - Z,及特殊符 - 组成。
    Value 长度为1 - 1000个字符,不支持中文。
    部分标准头部不支持自助设置/增加/删除,具体清单请参见文档 注意事项
    注意:
    回源 Request Header 配置规则最多可配置10条。
    生效类型支持全部文件、文件类型、文件目录、指定文件路径四种模式,暂不支持正则匹配。

    配置示例

    若加速域名 cloud.tencent.com 的回源 Request Header 配置如下:
    img
    
    若访问资源为:http://cloud.tencent.com/test/test.mp4
    1. 命中 * 规则,增加头部 X-Forwarded-For:$client_ip 头部,回源时将 $client_ip 替换为真实客户端 IP。
    2. 命中 .mp4 文件类型及/test路径,因是同一头部操作类型 - 增加,则底部优先级大于顶部,因此增加 x-cdn:Tencent 头部。
    

    注意事项

    以下标准头部暂时不支持设置/增加/删除回源 Request Header:
    www-authenticate
    authorization
    proxy-authenticate
    proxy-authorization
    age
    cache-control
    clear-site-data
    expires
    pragma
    warning
    accept-ch
    accept-ch-lifetime
    early-data
    content-dpr
    dpr
    device-memory
    save-data
    viewport-width
    width
    last-modified
    etag
    if-match
    if-none-match
    if-modified-since
    if-unmodified-since
    vary
    connection
    keep-alive
    accept
    accept-charset
    expect
    max-forwards
    access-control-allow-origin
    access-control-max-age
    access-control-allow-headers
    access-control-allow-methods
    access-control-expose-headers
    access-control-allow-credentials
    access-control-request-headers
    access-control-request-method
    origin
    timing-allow-origin
    dnt
    tk
    content-disposition
    content-length
    content-type
    content-encoding
    content-language
    content-location
    forwarded
    x-forwarded-host
    x-forwarded-proto
    via
    from
    host
    referer-policy
    allow
    server
    accept-ranges
    range
    if-range
    content-range
    cross-origin-embedder-policy
    cross-origin-opener-policy
    cross-origin-resource-policy
    content-security-policy
    content-security-policy-report-only
    expect-ct
    feature-policy
    strict-transport-security
    upgrade-insecure-requests
    x-content-type-options
    x-download-options
    x-frame-options(xfo)
    x-permitted-cross-domain-policies
    x-powered-by
    x-xss-protection
    public-key-pins
    public-key-pins-report-only
    sec-fetch-site
    sec-fetch-mode
    sec-fetch-user
    sec-fetch-dest
    last-event-id
    nel
    ping-from
    ping-to
    report-to
    transfer-encoding
    te
    trailer
    sec-websocket-key
    sec-websocket-extensions
    sec-websocket-accept
    sec-websocket-protocol
    sec-websocket-version
    accept-push-policy
    accept-signature
    alt-svc
    date
    large-allocation
    link
    push-policy
    retry-after
    signature
    signed-headers
    server-timing
    service-worker-allowed
    sourcemap
    upgrade
    x-dns-prefetch-control
    x-firefox-spdy
    x-pingback
    x-requested-with
    x-robots-tag
    x-ua-compatible
    max-age
    
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持