redir

向客户端发出 HTTP 重定向。

此指令意味着要按原样拒绝匹配的请求，客户端应该在不同的 URL 重试。因此，其指令顺序很早。

语法

redir [<匹配器>] <目标> [<状态码>]

• <目标> 是重定向的目标位置。将成为响应的 Location 头部。

• <状态码> 是用于重定向的 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
}