HTTP 与 Web 标准 / 知识点
HTTP Header 速查手册
范围、下载与响应控制
Range: bytes=<range>只请求 representation 的一部分字节范围。
Range
只请求 representation 的一部分字节范围。
方向
请求
语法
Range: bytes=<range>示例
Range: bytes=0-1023关键边界
服务端可忽略;成功的部分响应通常是 206。
Accept-Ranges: <range-unit>声明服务端支持的范围单位。
Accept-Ranges
声明服务端支持的范围单位。
方向
响应
语法
Accept-Ranges: <range-unit>示例
Accept-Ranges: bytes关键边界
它是能力提示,不保证未来每次 Range 请求都一定返回 206。
Content-Range: bytes <start>-<end>/<size>描述 206 部分响应中本次返回的范围。
Content-Range
描述 206 部分响应中本次返回的范围。
方向
响应
语法
Content-Range: bytes <start>-<end>/<size>示例
Content-Range: bytes 0-1023/4096关键边界
也可在 416 中表示当前资源总长度。
If-Range: <etag|HTTP-date>只有资源未变化时才按 Range 返回部分内容。
If-Range
只有资源未变化时才按 Range 返回部分内容。
方向
请求
语法
If-Range: <etag|HTTP-date>示例
If-Range: "abc123"关键边界
若验证失败,服务器应返回完整 representation,而不是部分内容。
Content-Disposition: attachment; filename=<name>提示浏览器把内容作为下载附件。
Content-Disposition: attachment
提示浏览器把内容作为下载附件。
方向
响应
语法
Content-Disposition: attachment; filename=<name>示例
Content-Disposition: attachment; filename="report.csv"关键边界
文件名需要正确编码和清理,不能信任为安全本地路径。
Content-Digest: <algorithm>=:<digest>:提供内容摘要以验证消息内容完整性。
Digest / Content-Digest
提供内容摘要以验证消息内容完整性。
方向
请求/响应
语法
Content-Digest: <algorithm>=:<digest>:示例
Content-Digest: sha-256=:<DIGEST>:关键边界
现代 HTTP 完整性字段请按对应 RFC 实现;不要再新用已废弃 Content-MD5。
CORS 跨域
Origin: <scheme>://<host>[:port]表示触发请求的源。
Origin
表示触发请求的源。
方向
请求
语法
Origin: <scheme>://<host>[:port]示例
Origin: https://app.example.com关键边界
CORS 判断核心输入;与 Referer 不同,Origin 不携带路径。
Access-Control-Allow-Origin: <origin>|*声明允许哪个 Origin 读取响应。
Access-Control-Allow-Origin
声明允许哪个 Origin 读取响应。
方向
响应
语法
Access-Control-Allow-Origin: <origin>|*示例
Access-Control-Allow-Origin: https://app.example.com关键边界
携带凭据时不能用 * 来允许任意 Origin。
Access-Control-Allow-Credentials: true允许浏览器在跨域请求中暴露带凭据响应。
Access-Control-Allow-Credentials
允许浏览器在跨域请求中暴露带凭据响应。
方向
响应
语法
Access-Control-Allow-Credentials: true示例
Access-Control-Allow-Credentials: true关键边界
唯一有效允许值是 true;同时必须正确限制 Allow-Origin。
Access-Control-Allow-Methods: <method>, ...预检响应中声明允许的跨域方法。
Access-Control-Allow-Methods
预检响应中声明允许的跨域方法。
方向
响应
语法
Access-Control-Allow-Methods: <method>, ...示例
Access-Control-Allow-Methods: GET, POST, PUT关键边界
主要用于 CORS preflight,不等同于资源的 Allow。
Access-Control-Allow-Headers: <field-name>, ...预检响应中声明允许客户端发送哪些非 safelisted Header。
Access-Control-Allow-Headers
预检响应中声明允许客户端发送哪些非 safelisted Header。
方向
响应
语法
Access-Control-Allow-Headers: <field-name>, ...示例
Access-Control-Allow-Headers: Authorization, Content-Type关键边界
不要无边界放开不需要的 Header。
Access-Control-Expose-Headers: <field-name>, ...允许前端 JavaScript 读取额外响应 Header。
Access-Control-Expose-Headers
允许前端 JavaScript 读取额外响应 Header。
方向
响应
语法
Access-Control-Expose-Headers: <field-name>, ...示例
Access-Control-Expose-Headers: X-Request-ID关键边界
不配置时,脚本只能直接读取 CORS-safelisted response headers。
Access-Control-Max-Age: <seconds>指定浏览器可缓存预检结果多久。
Access-Control-Max-Age
指定浏览器可缓存预检结果多久。
方向
响应
语法
Access-Control-Max-Age: <seconds>示例
Access-Control-Max-Age: 600关键边界
浏览器可能设置自己的上限。
Access-Control-Request-Method: <method>预检中告诉服务器实际请求准备使用的方法。
Access-Control-Request-Method
预检中告诉服务器实际请求准备使用的方法。
方向
预检请求
语法
Access-Control-Request-Method: <method>示例
Access-Control-Request-Method: PUT关键边界
由浏览器自动生成,不应由普通前端代码手工设置。
Access-Control-Request-Headers: <field-name>, ...预检中列出实际请求准备发送的额外 Header。
Access-Control-Request-Headers
预检中列出实际请求准备发送的额外 Header。
方向
预检请求
语法
Access-Control-Request-Headers: <field-name>, ...示例
Access-Control-Request-Headers: authorization, content-type关键边界
由浏览器根据实际请求生成。
浏览器安全
Strict-Transport-Security: max-age=<seconds>[; includeSubDomains][; preload]要求浏览器在未来一段时间只通过 HTTPS 访问该主机。
Strict-Transport-Security
要求浏览器在未来一段时间只通过 HTTPS 访问该主机。
方向
响应
语法
Strict-Transport-Security: max-age=<seconds>[; includeSubDomains][; preload]示例
Strict-Transport-Security: max-age=31536000; includeSubDomains关键边界
只应通过 HTTPS 下发;includeSubDomains/preload 前要确认所有子域都支持 HTTPS。
Content-Security-Policy: <directives>限制脚本、样式、图片、frame 等资源来源,降低 XSS 等风险。
Content-Security-Policy
限制脚本、样式、图片、frame 等资源来源,降低 XSS 等风险。
方向
响应
语法
Content-Security-Policy: <directives>示例
Content-Security-Policy: default-src 'self'; object-src 'none'关键边界
策略复杂,建议从 Report-Only 观察再收紧。
Content-Security-Policy-Report-Only: <directives>只报告 CSP 违规,不真正阻止资源。
Content-Security-Policy-Report-Only
只报告 CSP 违规,不真正阻止资源。
方向
响应
语法
Content-Security-Policy-Report-Only: <directives>示例
Content-Security-Policy-Report-Only: default-src 'self'关键边界
适合上线新 CSP 前观察影响。
X-Content-Type-Options: nosniff要求浏览器不要 MIME sniffing。
X-Content-Type-Options
要求浏览器不要 MIME sniffing。
方向
响应
语法
X-Content-Type-Options: nosniff示例
X-Content-Type-Options: nosniff关键边界
常作为基础安全 Header;值基本就是 nosniff。
X-Frame-Options: DENY|SAMEORIGIN限制页面能否被 frame/iframe 嵌入。
X-Frame-Options
限制页面能否被 frame/iframe 嵌入。
方向
响应
语法
X-Frame-Options: DENY|SAMEORIGIN示例
X-Frame-Options: SAMEORIGIN关键边界
现代策略优先 CSP frame-ancestors;仍常保留兼容。