redir

向客户端发出 HTTP 重定向。

此指令意味着匹配的请求将被按原样拒绝，客户端应在不同的 URL 再次尝试。因此，其指令顺序非常靠前。

语法

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

• <to> 是目标位置。 变为响应的 Location header 。

• <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
}