redir

向客户端发出 HTTP 重定向。

此指令意味着匹配的请求将被原样拒绝，客户端应尝试使用不同的 URL 重新请求。因此，它的 指令顺序 非常早。

语法

redir [<matcher>] <to> [<code>]

• <to> 是目标位置。成为响应的 Location 标头 。

• <code> 是用于重定向的 HTTP 状态代码。可以是

  • 3xx 范围内的正整数，或 401

  • temporary 用于临时重定向 (302，这是默认值)

  • permanent 用于永久重定向 (301)

  • html 用于使用 HTML 文档执行重定向（对于重定向浏览器但不是 API 客户端很有用）

  • 带有状态代码值的占位符

示例

将所有请求重定向到 https://example.com

www.example.com {
	redir https://example.com
}

相同，但通过追加 {uri} 占位符 来保留现有 URI

www.example.com {
	redir https://example.com{uri}
}

相同，但永久

www.example.com {
	redir https://example.com{uri} permanent
}

将旧的 /about-us 页面重定向到新的 /about 页面

example.com {
	redir /about-us /about
	reverse_proxy localhost:9000
}