LiteSpeed Web Server logo LiteSpeed Web Server用户手册

重定向上下文

目录

重定向上下文

重定向上下文

描述

A Redirect Context can be used to forward one URI or a group of URIs to another location. The destination URI can be either on the same web site (an internal redirect) or an absolute URI pointing to another web site (an external redirect).

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'指令是可选的。从其他位置复制规则时,可以移除或保留它,不会影响使用。

允许覆盖

描述

指定访问控制文件中允许使用哪些指令。访问控制文件可以放在目录中,用于控制该目录下文件的可访问性。

  • 如果未勾选任何选项,将使用继承的默认设置。
  • 如果勾选无,访问控制文件将被忽略。
  • 如果勾选限制,将允许使用"Allow"、"Deny"和"Order"指令。也允许使用<Limit>和<LimitExcept>指令,但仅有限支持GET、HEAD和POST请求。
  • 如果勾选认证,将允许使用"AuthGroupFile"、"AuthName"、"AuthType"、"AuthUserFile"、"Require"和"Satisfy"指令。也允许使用<Limit>和<LimitExcept>指令,但仅有限支持GET、HEAD和POST请求。
  • 如果勾选文件信息,将允许使用"AddDefaultCharset"、"AddType"、"DefaultType"、"ForceType"、"Redirect"、"RedirectPermanent"、"RedirectTemp"、"RewriteBase"、"RewriteCond"、"RewriteEngine"、"RewriteOptions"和"RewriteRule"指令。
  • 如果勾选索引,将允许使用"DirectoryIndex"、"ExpiresActive"、"ExpiresByType"和"ExpiresDefault"指令。
  • 如果勾选选项,将允许使用"Options"指令。

允许覆盖配置可在服务器、虚拟主机和上下文级别设置。如果某项配置在服务器级别未勾选,则无论较低级别如何设置,这些受控指令都会在整个服务器范围内禁用。较低级别可以禁用较高级别已启用的设置,但不能启用上级已禁用的设置。

默认值:
服务器级别:"None"(忽略访问控制文件)
VH级别:继承服务器级别设置
上下文级别继承VH级别设置

语法

复选框

提示

性能 如果不需要目录级配置自定义,请勾选无。

领域

描述

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

语法

从下拉列表选择

认证名称

描述

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

语法

文本

要求(已认证的用户/组)

描述

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

语法

语法与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/。

语法

从下拉列表选择