用户手册
Version 1.9 — Rev. 3

# 重定向上下文

#### 描述

重定向上下文可将一个URI或一组URI转发到其他位置。 目标URI可以位于同一网站（内部重定向），也可以是指向其他网站的绝对URI（外部重定向）。

### URI

#### 描述

指定此上下文的URI。

#### 语法

URI可以是普通URI（以"/"开头），也可以是Perl兼容的正则表达式URI（以"exp:"开头）。 如果普通URI以"/"结尾，则此上下文将包含该URI下的所有子URI。 如果上下文映射到文件系统上的目录，则必须添加结尾的"/"。

#### 另请参阅

位置

### 外部重定向

#### 描述

指定此重定向是否为外部重定向。 对于外部重定向，可以指定状态码，并且目标URI可以以"/"或"http(s)://"开头。 对于内部重定向，目标URI必须以"/"开头。

### 状态码

#### 描述

指定外部重定向响应状态码。 如果状态码在300和399之间，可以指定目标URI。

#### 语法

从下拉列表选择

### 目标URI

#### 描述

指定重定向的目标位置。 如果被重定向的URI映射到另一个重定向URI时，将再次被重定向。

#### 语法

此URI可以是同一网站上以"/"开头的相对URI，也可以是指向其他网站并以"http(s)://"开头的绝对URI。 如果URI包含正则表达式，目标地址可以引用匹配变量，例如$1或$2。

### 标头控制

#### 描述

指定要添加的附加响应/请求头。可添加多个头指令，每行一个。"NONE"可用于禁用父级头继承。如果未提供指令，则假定为"Header"。

#### 语法

[Header]|RequestHeader [condition] set|append|merge|add|unset header [value] [early|env=[!]variable]

#### 示例

set Cache-control no-cache
append Cache-control no-store
Header set My-header cust_header_val
RequestHeader set My-req-header cust_req_header_val

#### 提示

[信息] 语法和用法类似于 Apache的mod_headers指令
[信息] 'Header'指令是可选的。从其他位置复制规则时，可以移除或保留它，不会影响使用。

### 域

#### 描述

指定此上下文的授权域。 指定后，必须提供有效的用户名和密码才能访问此上下文。 授权Realm需要在虚拟主机安全部分进行设置。 此设置使用每个授权域的Realm名称。

#### 语法

从下拉列表选择

### 认证名称

#### 描述

为当前上下文的授权域指定一个替代名称。 如果未指定，将使用原授权域名称。 认证名称会显示在浏览器登录弹窗中。

#### 语法

文本

### Require（授权的用户/组）

#### 描述

指定哪些用户/用户组可以访问此上下文。 这允许你在多个上下文中使用同一个用户/组数据库（由域指定）， 但只允许该数据库中的特定用户/组访问此上下文。

#### 语法

语法与Apache的Require指令兼容。例如：

- user username [username ...]
  只有列出的用户可以访问此上下文。
- group groupid [groupid ...]
  只有属于列出组的用户可以访问此上下文。

如果未指定此设置，所有有效用户都可以访问此资源。

### 允许访问列表

#### 描述

指定允许访问此上下文下资源的IP地址或子网。综合 拒绝访问列表项的配置以及服务器/虚拟主机级别访问控制， 可访问性将以客户端IP所符合的最小范围来确定。

#### 语法

逗号分隔的IP地址/子网列表。

#### 示例

网络可以写成192.168.1.0/255.255.255.0, 192.168.1 或192.168.1.*。

### 拒绝访问列表

#### 描述

指定哪些IP地址或子网不允许访问此上下文下的资源。 综合允许访问列表项的配置以及服务器/虚拟主机级别访问控制， 可访问性将以客户端IP所符合的最小范围来确定。

#### 语法

逗号分隔的IP地址/子网列表。

#### 示例

子网络可以写成192.168.1.0/255.255.255.0, 192.168.1 或192.168.1.*。

### 授权器

#### 描述

指定可用于生成授权/未授权决策的外部应用程序。目前仅FastCGI授权器可用。有关FastCGI授权器角色的更多详细信息， 请访问https://fastcgi-archives.github.io/。

#### 语法

从下拉列表选择