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
}