HTTP 与 Web 标准 / 知识点
HTTP Header 速查手册
浏览器安全
Referrer-Policy: <policy>控制浏览器在跳转/请求中发送多少 Referer 信息。
Referrer-Policy
控制浏览器在跳转/请求中发送多少 Referer 信息。
方向
响应
语法
Referrer-Policy: <policy>示例
Referrer-Policy: strict-origin-when-cross-origin关键边界
避免无必要泄露完整 URL、查询参数。
Permissions-Policy: <directive>=<allowlist>限制摄像头、麦克风、地理位置等浏览器能力。
Permissions-Policy
限制摄像头、麦克风、地理位置等浏览器能力。
方向
响应
语法
Permissions-Policy: <directive>=<allowlist>示例
Permissions-Policy: camera=(), microphone=()关键边界
不同浏览器支持度与 feature 名会演进,部署前验证。
Cross-Origin-Opener-Policy: same-origin控制顶层文档与跨源窗口的 browsing context group 隔离。
Cross-Origin-Opener-Policy
控制顶层文档与跨源窗口的 browsing context group 隔离。
方向
响应
语法
Cross-Origin-Opener-Policy: same-origin示例
Cross-Origin-Opener-Policy: same-origin关键边界
与 COEP 配合可用于 cross-origin isolation。
Cross-Origin-Embedder-Policy: require-corp要求嵌入的跨源资源显式允许被加载。
Cross-Origin-Embedder-Policy
要求嵌入的跨源资源显式允许被加载。
方向
响应
语法
Cross-Origin-Embedder-Policy: require-corp示例
Cross-Origin-Embedder-Policy: require-corp关键边界
开启后第三方资源可能被阻断,必须联动验证 CORP/CORS。
Cross-Origin-Resource-Policy: same-origin|same-site|cross-origin控制其他 Origin 是否可加载当前资源。
Cross-Origin-Resource-Policy
控制其他 Origin 是否可加载当前资源。
方向
响应
语法
Cross-Origin-Resource-Policy: same-origin|same-site|cross-origin示例
Cross-Origin-Resource-Policy: same-site关键边界
与 CORS 不完全等价,主要限制跨源资源嵌入。
Clear-Site-Data: "cache", "cookies", "storage"要求浏览器清理当前站点相关数据。
Clear-Site-Data
要求浏览器清理当前站点相关数据。
方向
响应
语法
Clear-Site-Data: "cache", "cookies", "storage"示例
Clear-Site-Data: "cache", "cookies", "storage"关键边界
影响范围很大,退出登录/安全恢复场景使用前充分测试。
Public-Key-Pins: ...旧版 HPKP 公钥固定 Header。
Public-Key-Pins
旧版 HPKP 公钥固定 Header。
方向
响应
语法
Public-Key-Pins: ...示例
Public-Key-Pins: ...关键边界
已废弃/移除,存在锁死站点风险;新系统不要使用。
Expect-CT: ...历史上要求 Certificate Transparency 行为。
Expect-CT
历史上要求 Certificate Transparency 行为。
方向
响应
语法
Expect-CT: ...示例
Expect-CT: max-age=86400关键边界
现代浏览器 CT 已由其他机制处理;该 Header 已过时,不应新部署。
代理、连接与追踪
Forwarded: for=<client>; proto=<scheme>; host=<host>标准化传递代理链中的客户端、协议和主机信息。
Forwarded
标准化传递代理链中的客户端、协议和主机信息。
方向
请求
语法
Forwarded: for=<client>; proto=<scheme>; host=<host>示例
Forwarded: for=192.0.2.60; proto=https; host=example.com关键边界
只能信任由受控反向代理追加/重写的值;客户端可伪造。
X-Forwarded-For: <client>, <proxy>, ...事实标准的客户端 IP 代理链 Header。
X-Forwarded-For
事实标准的客户端 IP 代理链 Header。
方向
请求
语法
X-Forwarded-For: <client>, <proxy>, ...示例
X-Forwarded-For: 203.0.113.10, 10.0.0.2关键边界
非标准但极常见;必须结合可信代理数量解析,不能直接取最左值就信任。
X-Forwarded-Proto: http|https告诉上游应用客户端原始访问协议。
X-Forwarded-Proto
告诉上游应用客户端原始访问协议。
方向
请求
语法
X-Forwarded-Proto: http|https示例
X-Forwarded-Proto: https关键边界
非标准;只能信任受控代理写入的值。
X-Forwarded-Host: <host>传递客户端原始 Host。
X-Forwarded-Host
传递客户端原始 Host。
方向
请求
语法
X-Forwarded-Host: <host>示例
X-Forwarded-Host: www.example.com关键边界
非标准;涉及重定向/绝对 URL 生成时需防 Host Header 注入。
Via: <protocol> <received-by>记录代理、网关经过信息,并帮助避免转发循环。
Via
记录代理、网关经过信息,并帮助避免转发循环。
方向
请求/响应
语法
Via: <protocol> <received-by>示例
Via: 1.1 proxy.example.com关键边界
属于标准代理 Header;不等同于 X-Forwarded-For。
Connection: <option>, ...HTTP/1.1 中声明当前连接级别的 hop-by-hop 选项。
Connection
HTTP/1.1 中声明当前连接级别的 hop-by-hop 选项。
方向
请求/响应
语法
Connection: <option>, ...示例
Connection: close关键边界
HTTP/2/3 禁止 Connection 字段;不要把 hop-by-hop Header 转发到下一跳。
Keep-Alive: timeout=<n>, max=<n>HTTP/1.x 中提供持久连接参数提示。
Keep-Alive
HTTP/1.x 中提供持久连接参数提示。
方向
请求/响应
语法
Keep-Alive: timeout=<n>, max=<n>示例
Keep-Alive: timeout=5, max=100关键边界
不是 HTTP/2/3 的连接复用控制方式;现代应用通常无需手工处理。
Upgrade: <protocol>HTTP/1.1 中请求/确认切换到其他协议。
Upgrade
HTTP/1.1 中请求/确认切换到其他协议。
方向
请求/响应
语法
Upgrade: <protocol>示例
Upgrade: websocket关键边界
HTTP/2/3 有不同机制;WebSocket over HTTP/2 使用扩展 CONNECT,而非简单照搬。
X-Request-ID: <id>常用于跨服务追踪单次请求。
X-Request-ID
常用于跨服务追踪单次请求。
方向
请求/响应
语法
X-Request-ID: <id>示例
X-Request-ID: <REQUEST_ID>关键边界
非标准但非常常见;网关应统一生成/校验格式,防日志注入。
traceparent: <version>-<trace-id>-<parent-id>-<flags>W3C Trace Context 的核心分布式追踪字段。
traceparent
W3C Trace Context 的核心分布式追踪字段。
方向
请求/响应
语法
traceparent: <version>-<trace-id>-<parent-id>-<flags>示例
traceparent: 00-<TRACE_ID>-<SPAN_ID>-01关键边界
格式严格;通常由 tracing SDK 自动管理,不建议业务代码手工拼。
tracestate: <list>携带多供应商 tracing 状态。
tracestate
携带多供应商 tracing 状态。
方向
请求/响应
语法
tracestate: <list>示例
tracestate: vendor=<VALUE>关键边界
与 traceparent 配套;顺序和大小有限制。
Client Hints 与请求上下文
Accept-CH: <client-hint>, ...服务端声明希望客户端在后续请求发送哪些 Client Hints。
Accept-CH
服务端声明希望客户端在后续请求发送哪些 Client Hints。
方向
响应
语法
Accept-CH: <client-hint>, ...示例
Accept-CH: Sec-CH-UA-Platform, Sec-CH-UA-Mobile关键边界
只适用于支持 Client Hints 的用户代理。