sxg_fallback_host
`sxg_fallback_host` 指令指定用于生成的 Signed HTTP Exchanges (SXG) 的回退主机名。
Signed HTTP Exchange(SXG) support for NGINX
·
server
语法sxg_fallback_host hostname;
默认值Host header value from the HTTP request.
上下文server
参数1
说明
sxg_fallback_host 指令是一个可选的配置参数,适用于 NGINX 的 Signed HTTP Exchanges (SXG) 模块。在生成 SXG 文件时,如果原始请求未为签名交换提供合适的主机头(Host header),此指令定义一个可以包含在 SXG 文件中的回退主机名,从而确保即使无法从请求中确定主机,生成的任何 SXG 仍能被正确解析。
sxg_fallback_host 的值应为有效的主机名,模块在创建 SXG 负载时将使用该值。在需要时,如果 SXG 无法包含请求中所需的主机,则会改用该回退主机值。这在服务器可能处理多个主机或某些安全机制阻止使用原始请求的主机头的情况下尤其有用。
如果未设置此指令,默认行为会使用 HTTP 请求的 Host 头参数;在主机特定的处理不一致或不可靠的场景下,这可能并非理想。此类情况下,显式设置 sxg_fallback_host 可提高服务器生成的 SXG 的稳定性。
配置示例
server {
listen 80;
server_name example.com;
sxg;
sxg_certificate /path/to/cert.pem;
sxg_certificate_key /path/to/cert.key;
sxg_cert_url https://example.com/cert-url;
sxg_fallback_host fallback.example.com;
}⚠
确保备用主机是一个有效且可访问的主机名,以避免 SXG 解析出现问题。
⚠
使用不正确或不存在的备用主机可能导致无法正确提供 SXG 文件。