| Server IP : 202.155.9.250 / Your IP : 216.73.217.178 Web Server : LiteSpeed System : Linux srv339029361 5.15.0-177-generic #187-Ubuntu SMP Sat Apr 11 22:54:33 UTC 2026 x86_64 User : bigas1846 ( 1044) PHP Version : 8.0.30 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /usr/local/lsws/docs/zh-CN/ |
Upload File : |
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
<title>OpenLiteSpeed用户手册 - 静态上下文</title>
<meta name="description" content="OpenLiteSpeed用户手册 - 静态上下文." />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="robots" content="noindex">
<script>
(function () {
var theme = 'light';
var resolved = false;
try {
if (window.localStorage) {
var storedTheme = window.localStorage.getItem('hdoc.theme');
if (storedTheme === 'light' || storedTheme === 'dark') {
theme = storedTheme;
resolved = true;
}
}
} catch (err) {
}
if (!resolved && window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) {
theme = 'dark';
}
document.documentElement.setAttribute('data-theme', theme);
document.documentElement.style.colorScheme = theme;
}());
</script>
<link rel="shortcut icon" href="../img/favicon.ico" />
<link rel="stylesheet" type="text/css" href="../css/hdoc.css">
<link rel="stylesheet" type="text/css" href="../css/hdoc-product-accent.css">
<script src="hdoc-search-index.js" defer></script>
<script src="../js/hdoc-search.js" defer></script>
</head>
<body>
<div class="doc-shell">
<header class="doc-topbar">
<a class="doc-brand" href="index.html" aria-label="OpenLiteSpeed用户手册">
<img src="../img/ols_logo.svg" alt="OpenLiteSpeed logo" />
<strong>OpenLiteSpeed用户手册</strong>
</a>
<div class="doc-actions">
<button class="doc-menu-toggle" type="button" aria-label="打开菜单" data-menu-toggle aria-expanded="false">
<svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M3 12h18M3 6h18M3 18h18" stroke="currentColor" stroke-width="2" stroke-linecap="round"/></svg>
</button>
<form class="doc-search" role="search" data-empty="搜索页面和设置" data-no-results="未找到结果。">
<label class="sr-only" for="doc-search-input">搜索手册</label>
<div class="doc-search__box">
<input id="doc-search-input" type="search" autocomplete="off" placeholder="搜索页面和设置" aria-controls="doc-search-results" />
<button type="submit">搜索</button>
</div>
<div id="doc-search-results" class="doc-search__results" hidden></div>
</form>
</div>
<label class="doc-language"><select id="doc-language-switcher" name="doc_language" data-language-switcher aria-label="语言"><option value="../Static_Context.html" data-lang="en-US">English</option><option value="../es-ES/Static_Context.html" data-lang="es-ES">Español</option><option value="../de-DE/Static_Context.html" data-lang="de-DE">Deutsch</option><option value="../fr-FR/Static_Context.html" data-lang="fr-FR">Français</option><option value="../zh-CN/Static_Context.html" data-lang="zh-CN" selected>简体中文</option><option value="../ja-JP/Static_Context.html" data-lang="ja-JP">日本語</option></select></label>
<button class="doc-theme-toggle" type="button" aria-label="切换主题" data-theme-toggle data-theme-light-label="浅色模式" data-theme-dark-label="深色模式" title="切换主题">
<span class="doc-theme-toggle__icon" aria-hidden="true"></span>
</button>
</header>
<div class="doc-menu-backdrop" data-menu-backdrop></div>
<div class="pagewrapper" data-current-lang="zh-CN" data-supported-langs="["en-US","es-ES","de-DE","fr-FR","zh-CN","ja-JP"]"><aside class="sidetree"><div class="sidetree__masthead"><figure class="sidetree__figure"><img src="../img/ols_logo.svg" alt="OpenLiteSpeed logo" /></figure><div class="sidetree__identity"><a class="sidetree__manual-link" href="index.html">用户手册</a><div class="sidetree__version">Version 1.9 — Rev. 4</div></div></div><nav class="sidetree__nav" aria-label="目录"><ul class="sidetree__list">
<li><a href="license.html">许可协议</a></li>
<li><a href="intro.html">简介</a></li>
<li><a href="install.html">安装/卸载</a></li>
<li>
<a href="admin.html">管理</a>
<ul class="level2">
<li><a href="ServerStat_Help.html">服务管理器</a></li>
<li><a href="Real_Time_Stats_Help.html">实时统计</a></li>
</ul>
</li>
<li><a href="security.html">安全</a></li>
<li>
<a href="config.html">配置</a>
<ul class="level2">
<li><a href="ServGeneral_Help.html">服务器常规</a></li>
<li><a href="ServLog_Help.html">服务器日志</a></li>
<li><a href="ServTuning_Help.html">服务器调优</a></li>
<li><a href="ServSecurity_Help.html">服务器安全</a></li>
<li>
<a href="ExtApp_Help.html">外部应用</a>
<ul class="level3">
<li><a href="External_LSAPI.html">LSAPI应用</a></li>
<li><a href="External_WS.html">Web服务器（代理）</a></li>
<li><a href="External_FCGI.html">Fast CGI应用</a></li>
<li><a href="External_FCGI_Auth.html">Fast CGI授权器</a></li>
<li><a href="External_SCGI.html">Simple CGI应用</a></li>
<li><a href="External_Servlet.html">Servlet引擎</a></li>
<li><a href="External_PL.html">管道日志器</a></li>
<li><a href="External_LB.html">负载均衡器</a></li>
<li><a href="External_UWSGI.html">uWSGI</a></li>
</ul>
</li>
<li><a href="ScriptHandler_Help.html">脚本处理程序</a></li>
<li><a href="App_Server_Help.html">应用服务器设置</a></li>
<li><a href="Module_Help.html">模块配置</a></li>
<li><a href="Listeners_General_Help.html">监听器常规</a></li>
<li><a href="Listeners_SSL_Help.html">监听器SSL</a></li>
<li><a href="Templates_Help.html">虚拟主机模板</a></li>
<li><a href="VirtualHosts_Help.html">虚拟主机注册</a></li>
<li><a href="VHGeneral_Help.html">虚拟主机常规</a></li>
<li><a href="VHSecurity_Help.html">虚拟主机安全</a></li>
<li><a href="VHSSL_Help.html">虚拟主机SSL</a></li>
<li><a href="Rewrite_Help.html">重写</a></li>
<li>
<a href="Context_Help.html">上下文</a>
<ul class="level3">
<li><a class="current" href="Static_Context.html">静态上下文</a></li>
<li><a href="Java_Web_App_Context.html">Java Web应用上下文</a></li>
<li><a href="Servlet_Context.html">Servlet上下文</a></li>
<li><a href="FCGI_Context.html">Fast CGI上下文</a></li>
<li><a href="SCGI_Context.html">Simple CGI上下文</a></li>
<li><a href="LSAPI_Context.html">LSAPI上下文</a></li>
<li><a href="Proxy_Context.html">代理上下文</a></li>
<li><a href="CGI_Context.html">CGI上下文</a></li>
<li><a href="LB_Context.html">负载均衡上下文</a></li>
<li><a href="Redirect_Context.html">重定向上下文</a></li>
<li><a href="App_Server_Context.html">应用服务器上下文</a></li>
<li><a href="UWSGI_Context.html">uWSGI上下文</a></li>
<li><a href="Module_Context.html">模块处理程序上下文</a></li>
</ul>
</li>
<li><a href="VHWebSocket_Help.html">WebSocket代理</a></li>
</ul>
</li>
<li>
<a href="webconsole.html">Web控制台</a>
<ul class="level2">
<li><a href="AdminGeneral_Help.html">管理控制台常规</a></li>
<li><a href="AdminSecurity_Help.html">管理控制台安全</a></li>
<li><a href="AdminListeners_General_Help.html">管理监听器常规</a></li>
<li><a href="AdminListeners_SSL_Help.html">管理监听器SSL</a></li>
</ul>
</li>
</ul></nav></aside><article class="contentwrapper"><div class="nav-bar"><div class="prev"> </div><div class="center"><a href="Context_Help.html">上下文</a></div><div class="next"><a href="Java_Web_App_Context.html">Java Web应用上下文</a> »</div></div>
<header class="doc-page-header"><h1>静态上下文</h1></header><section class="doc-toc" aria-labelledby="top"><header class="doc-toc__header"><h2 id="top">目录</h2></header><section class="doc-toc__row"><h3 class="doc-toc__heading"><a href="#generalContext">静态上下文</a></h3><ul class="doc-toc__links"><li><a href="#expuri">URI</a></li><li><a href="#location">位置</a></li><li><a href="#allowBrowse">可访问</a></li><li><a href="#enableExpires">启用过期</a></li><li><a href="#expiresDefault">默认过期</a></li><li><a href="#expiresByType">按类型过期</a></li><li><a href="#extraHeaders">头部操作</a></li><li><a href="#addMIMEType">MIME类型</a></li><li><a href="#forceType">强制MIME类型</a></li><li><a href="#defaultType">默认MIME类型</a></li><li><a href="#indexFiles">索引文件</a></li><li><a href="#autoIndex">自动索引</a></li><li><a href="#realm">领域</a></li><li><a href="#authName">认证名称</a></li><li><a href="#required">要求（已认证的用户/组）</a></li><li><a href="#accessAllowed">允许访问列表</a></li><li><a href="#accessDenied">拒绝访问列表</a></li><li><a href="#extAuthorizer">授权器</a></li><li><a href="#addDefaultCharset">添加默认字符集</a></li><li><a href="#defaultCharsetCustomized">自定义默认字符集</a></li><li><a href="#enableRewrite">启用重写</a></li><li><a href="#rewriteInherit">重写继承</a></li><li><a href="#rewriteBase">重写基准</a></li><li><a href="#rewriteRules">重写规则</a></li><li><a href="#enableIpGeo">启用IP地理定位</a></li><li><a href="#phpIniOverride">php.ini覆盖</a></li></ul></section>
</section>
<section class="doc-content-flow"><div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="generalContext"><h3>静态上下文<span class="ls-permlink"><a href="#generalContext"></a></span></h3></header><h4>描述</h4><p>上下文设置用于为特定位置的文件指定特殊设置。 这些设置可用于引入文档根目录外的文件（类似Apache的Alias或AliasMatch指令）， 使用授权域保护特定目录，或阻止/限制对文档根目录中特定目录的访问。</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="expuri"><h3>URI<span class="ls-permlink"><a href="#expuri"></a></span></h3></header><h4>描述</h4><p>指定此上下文的URI。</p> <h4>语法</h4><p>URI可以是普通URI（以"/"开头），也可以是Perl兼容的正则表达式URI（以"exp:"开头）。 如果普通URI以"/"结尾，则此上下文将包含该URI下的所有子URI。 如果上下文映射到文件系统上的目录，则必须添加结尾的"/"。</p> <h4>另请参阅</h4><p class="ls-text-small"><span class="tagl"><a href="#location">位置</a></span></p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="location"><h3>位置<span class="ls-permlink"><a href="#location"></a></span></h3></header><h4>描述</h4><p>指定此上下文在文件系统中的对应位置。<br/><br/> 默认值：$DOC_ROOT + <span class="tagl"><a href="#expuri">URI</a></span></p> <h4>语法</h4><p>可以是绝对路径，也可以是相对于$SERVER_ROOT、$VH_ROOT或$DOC_ROOT的路径。 $DOC_ROOT是默认相对路径，可以省略。<br/><br/> 如果<span class="tagl"><a href="#expuri">URI</a></span>是正则表达式，匹配的子字符串可用于组成"Root"字符串。匹配的子字符串可通过"$1"到"$9"引用；"$0"和"&"可引用整个匹配字符串。此外，可以追加"?"和查询字符串来设置查询字符串。注意：查询字符串中的"&"应转义为"\&"。</p> <h4>示例</h4><div class="ls-example">将<span class="tagl"><a href="#location">位置</a></span>设为<span class="val">/home/john/web_examples</span>时，类似<span class="val">/examples/</span>的普通URI会将请求"/examples/foo/bar.html"映射到文件"/home/john/web_examples/foo/bar.html"。<br/> 要模拟Apache的mod_userdir，可将URI设为<span class="val">exp: ^/~([A-Za-z0-9]+)(.*)</span>，并将<span class="tagl"><a href="#location">位置</a></span>设为<span class="val">/home/$1/public_html$2</span>。这样，URI /~john/foo/bar.html的请求会映射到文件/home/john/public_html/foo/bar.html。</div><h4>另请参阅</h4><p class="ls-text-small"><span class="tagl"><a href="#expuri">URI</a></span></p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="allowBrowse"><h3>可访问<span class="ls-permlink"><a href="#allowBrowse"></a></span></h3></header><h4>描述</h4><p>指定是否可以访问此上下文。设置为<span class="val">否</span>以拒绝访问。 您可以使用此功能来防止访问指定目录。 您可以在更新此上下文内容或此目录中有特殊数据时使用它。</p> <h4>语法</h4><p>布尔值</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="enableExpires"><h3>启用过期<span class="ls-permlink"><a href="#enableExpires"></a></span></h3></header><h4>描述</h4><p>指定是否为静态文件生成Expires头。如果启用，将根据 <span class="tagl"><a href="#expiresDefault">默认过期</a></span>和<span class="tagl"><a href="#expiresByType">按类型过期</a></span>生成Expires头。<br/><br/> 这可以在服务器、虚拟主机和上下文级别设置。低级别的设置将 覆盖高级别的设置。例如，上下文级别的设置将覆盖虚拟主机级别的设置， 虚拟主机级别的设置将覆盖服务器级别的设置。</p> <h4>语法</h4><p>布尔值</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="expiresDefault"><h3>默认过期<span class="ls-permlink"><a href="#expiresDefault"></a></span></h3></header><h4>描述</h4><p>指定生成Expires头的默认设置。该设置在<span class="tagl"><a href="#enableExpires">启用过期</a></span> 设为“启用”时有效。它可以被<span class="tagl"><a href="#expiresByType">按类型过期</a></span>覆盖。 除非必要，否则不要在服务器或虚拟主机级别设置该默认值。 因为它会为所有网页生成Expires头。大多数时候，应该是 为不常变动的某些目录在上下文级别设置。如果没有默认设置，<span class="tagl"><a href="#expiresByType">按类型过期</a></span>中未指定的类型不会生成Expires头。</p> <h4>语法</h4><p>A|Mseconds<br/> 文件将在基准时间（A|M）加指定秒数的时间后失效。 “A”代表基准时间为客户端的访问时间，“M”代表文件的最后修改时间。</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="expiresByType"><h3>按类型过期<span class="ls-permlink"><a href="#expiresByType"></a></span></h3></header><h4>描述</h4><p>为各个MIME类型分别指定Expires头设置。</p> <h4>语法</h4><p>逗号分隔的“MIME-类型=A|M秒数”的列表。 文件将在基准时间（A|M）加指定秒数的时间后失效。<br/><br/> “A”代表基准时间为客户端的访问时间，“M”代表文件的最后修改时间。 MIME-类型可使用通配符“*”，如image/*。</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="extraHeaders"><h3>头部操作<span class="ls-permlink"><a href="#extraHeaders"></a></span></h3></header><h4>描述</h4><p>指定要添加的附加响应/请求头。可添加多个头指令，每行一个。"NONE"可用于禁用父级头继承。如果未提供指令，则假定为"Header"。</p> <h4>语法</h4><p>[Header]|RequestHeader [condition] set|append|merge|add|unset header [value] [early|env=[!]variable]</p> <h4>示例</h4><div class="ls-example">set Cache-control no-cache<br/> append Cache-control no-store<br/> Header set My-header cust_header_val<br/> RequestHeader set My-req-header cust_req_header_val</div><h4>提示</h4><p><span class="ls-badge ls-badge--info">信息</span> 语法和用法类似于 <a href="https://httpd.apache.org/docs/2.2/mod/mod_headers.html#header" target="_blank" rel="noopener noreferrer">Apache的mod_headers指令</a><br/><br/> <span class="ls-badge ls-badge--info">信息</span> 'Header'指令是可选的。从其他位置复制规则时，可以移除或保留它，不会影响使用。</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="addMIMEType"><h3>MIME类型<span class="ls-permlink"><a href="#addMIMEType"></a></span></h3></header><h4>描述</h4><p>为此上下文指定额外的MIME类型映射。新映射会覆盖此上下文及其子上下文下的现有映射。<br/> 如果要将PHP脚本显示为文本文件而不是作为脚本执行，则只需覆盖.php映射到MIME类型"text/plain"</p> <h4>语法</h4><p>MIME-type1 extension extension ..., MIME-type2 extension ... 使用逗号分隔MIME类型，使用空格分隔多个扩展名。</p> <h4>示例</h4><div class="ls-example"><span class="val">image/jpg jpeg jpg, image/gif gif</span></div></article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="forceType"><h3>强制MIME类型<span class="ls-permlink"><a href="#forceType"></a></span></h3></header><h4>描述</h4><p>指定后，无论文件后缀如何， 此上下文下的所有文件都将作为具有指定MIME类型的静态文件提供。 设置为<span class="val">NONE</span>时，将禁用强制MIME类型。</p> <h4>语法</h4><p>MIME类型或NONE。</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="defaultType"><h3>默认MIME类型<span class="ls-permlink"><a href="#defaultType"></a></span></h3></header><h4>描述</h4><p>指定后，当无法通过文档后缀确定MIME类型映射或没有后缀时，将使用此类型。如果未指定，将使用默认值<span class="val">application/octet-stream</span>。</p> <h4>语法</h4><p>MIME类型</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="indexFiles"><h3>索引文件<span class="ls-permlink"><a href="#indexFiles"></a></span></h3></header><h4>描述</h4><p>指定URL映射到目录时按顺序查找的索引文件名称。 您可以在服务器、虚拟主机和上下文级别对其进行自定义。</p> <h4>语法</h4><p>以逗号分隔的索引文件名列表。</p> <h4>提示</h4><p><span class="ls-badge ls-badge--performance">性能</span> 只设置你需要的索引文件。</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="autoIndex"><h3>自动索引<span class="ls-permlink"><a href="#autoIndex"></a></span></h3></header><h4>描述</h4><p>在目录中，当<span class="tagl"><a href="#indexFiles">索引文件</a></span>中所列的索引文件不可用时，指定运行时是否即时生成目录索引。<br/> 此选项可以在虚拟主机级别和Context级别中设置，并可以顺着目录树继承，直到被显式覆盖。 您可以自定义生成的索引页面。请查看在线Wiki操作指南。</p> <h4>语法</h4><p>布尔值</p> <h4>提示</h4><p><span class="ls-badge ls-badge--security">安全</span> 建议尽可能关闭自动索引，以防止泄露机密数据。</p> <h4>另请参阅</h4><p class="ls-text-small"><span class="tagl"><a href="#indexFiles">索引文件</a></span>, <span class="tagl"><a href="#autoIndexURI">自动索引URI</a></span></p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="realm"><h3>领域<span class="ls-permlink"><a href="#realm"></a></span></h3></header><h4>描述</h4><p>指定此上下文的授权域。 指定后，必须提供有效的用户名和密码才能访问此上下文。 <span class="tagl"><a href="VHSecurity_Help.html#realms">授权Realm</a></span>需要在<span class="tagP"><a href="#VHSecurity_Help">虚拟主机安全</a></span>部分进行设置。 此设置使用每个授权域的<span class="tagl"><a href="VHSecurity_Help.html#realmName">领域名称</a></span>。</p> <h4>语法</h4><p>从下拉列表选择</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="authName"><h3>认证名称<span class="ls-permlink"><a href="#authName"></a></span></h3></header><h4>描述</h4><p>为当前上下文的授权域指定一个替代名称。 如果未指定，将使用原授权域名称。 认证名称会显示在浏览器登录弹窗中。</p> <h4>语法</h4><p>文本</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="required"><h3>要求（已认证的用户/组）<span class="ls-permlink"><a href="#required"></a></span></h3></header><h4>描述</h4><p>指定哪些用户/用户组可以访问此上下文。 这允许你在多个上下文中使用同一个用户/组数据库（由<span class="tagl"><a href="#realm">领域</a></span>指定）， 但只允许该数据库中的特定用户/组访问此上下文。</p> <h4>语法</h4><p>语法与Apache的Require指令兼容。例如： <ul> <li><span class="val">user username [username ...]</span><br/> 只有列出的用户可以访问此上下文。</li> <li> <span class="val">group groupid [groupid ...]</span><br/> 只有属于列出组的用户可以访问此上下文。</li> </ul> 如果未指定此设置，所有有效用户都可以访问此资源。</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="accessAllowed"><h3>允许访问列表<span class="ls-permlink"><a href="#accessAllowed"></a></span></h3></header><h4>描述</h4><p>指定允许访问此上下文下资源的IP地址或子网。综合 <span class="tagl"><a href="#accessDenied">拒绝访问列表</a></span>项的配置以及服务器/虚拟主机级别访问控制， 可访问性将以客户端IP所符合的最小范围来确定。</p> <h4>语法</h4><p>逗号分隔的IP地址/子网列表。</p> <h4>示例</h4><div class="ls-example">网络可以写成<span class="val">192.168.1.0/255.255.255.0</span>, <span class="val">192.168.1</span> 或<span class="val">192.168.1.*</span>。</div></article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="accessDenied"><h3>拒绝访问列表<span class="ls-permlink"><a href="#accessDenied"></a></span></h3></header><h4>描述</h4><p>指定哪些IP地址或子网不允许访问此上下文下的资源。 综合<span class="tagl"><a href="#accessAllowed">允许访问列表</a></span>项的配置以及服务器/虚拟主机级别访问控制， 可访问性将以客户端IP所符合的最小范围来确定。</p> <h4>语法</h4><p>逗号分隔的IP地址/子网列表。</p> <h4>示例</h4><div class="ls-example">子网络可以写成<span class="val">192.168.1.0/255.255.255.0</span>, <span class="val">192.168.1</span> 或<span class="val">192.168.1.*</span>。</div></article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="extAuthorizer"><h3>授权器<span class="ls-permlink"><a href="#extAuthorizer"></a></span></h3></header><h4>描述</h4><p>指定可用于生成授权/未授权决策的外部应用程序。目前仅FastCGI授权器可用。有关FastCGI授权器角色的更多详细信息， 请访问<a href="https://fastcgi-archives.github.io/" target="_blank" rel="noopener noreferrer">https://fastcgi-archives.github.io/</a>。</p> <h4>语法</h4><p>从下拉列表选择</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="addDefaultCharset"><h3>添加默认字符集<span class="ls-permlink"><a href="#addDefaultCharset"></a></span></h3></header><h4>描述</h4><p>指定当内容类型为"text/html"或"text/plain"且没有参数时，是否向"Content-Type"响应报头添加字符集标记。设置为<span class="val">关</span>时，该功能禁用。设置为<span class="val">开</span>时，将添加<span class="tagl"><a href="#defaultCharsetCustomized">自定义默认字符集</a></span>中指定的字符集；如果未指定，则添加默认的"iso-8859-1"字符集。</p> <h4>语法</h4><p>布尔值</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="defaultCharsetCustomized"><h3>自定义默认字符集<span class="ls-permlink"><a href="#defaultCharsetCustomized"></a></span></h3></header><h4>描述</h4><p>指定当<span class="tagl"><a href="#addDefaultCharset">添加默认字符集</a></span>为<span class="val">开</span>时使用的字符集。此项可选，默认值为<span class="val">iso-8859-1</span>。当<span class="tagl"><a href="#addDefaultCharset">添加默认字符集</a></span>为<span class="val">关</span>时，本设置不生效。</p> <h4>语法</h4><p>字符集名称。</p> <h4>示例</h4><div class="ls-example">utf-8</div></article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="enableRewrite"><h3>启用重写<span class="ls-permlink"><a href="#enableRewrite"></a></span></h3></header><h4>描述</h4><p>指定是否启用LiteSpeed的URL重写引擎。 此选项可在虚拟主机或Context级别自定义， 并会沿目录树继承，直到被显式覆盖。</p> <h4>语法</h4><p>布尔值</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="rewriteInherit"><h3>重写继承<span class="ls-permlink"><a href="#rewriteInherit"></a></span></h3></header><h4>描述</h4><p>指定是否从父级上下文继承重写规则。 如果启用重写但不继承，将使用此上下文中定义的重写基准和重写规则。</p> <h4>语法</h4><p>布尔值</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="rewriteBase"><h3>重写基准<span class="ls-permlink"><a href="#rewriteBase"></a></span></h3></header><h4>描述</h4><p>指定重写规则的基准URL。</p> <h4>语法</h4><p>URL</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="rewriteRules"><h3>重写规则<span class="ls-permlink"><a href="#rewriteRules"></a></span></h3></header><h4>描述</h4><p>指定虚拟主机级别的重写规则列表。<br/><br/> 请勿在此处添加任何文档根级别的重写规则。 如果有来自.htaccess的文档根级别重写规则，请改为创建URI为"/"的静态Context， 并在那里添加这些重写规则。<br/><br/> 重写规则由一个<span class="val">RewriteRule</span>指令组成，并且前面可以选择性地放置多个<span class="val">RewriteCond</span>指令。 <ul> <li>每条指令应只占一行。</li> <li> <span class="val">RewriteCond</span>和<span class="val">RewriteRule</span>遵循Apache的重写指令语法。可以直接从Apache配置文件复制并粘贴重写指令。 </li> <li> LiteSpeed与Apache mod_rewrite的实现有细微差别： <ul> <li> <span class="val">%\{LA-U:variable\}</span>和<span class="val">%\{LA-F:variable\}</span>会被LiteSpeed重写引擎忽略。 </li> <li> LiteSpeed重写引擎新增了两个服务器变量： <span class="val">%\{CURRENT_URI\}</span>表示重写引擎正在处理的当前URI， <span class="val">%\{SCRIPT_NAME\}</span>与对应CGI环境变量含义相同。 </li> <li> LiteSpeed重写引擎遇到<span class="val">[L]</span>标志后会停止处理重写规则以避免循环； Apache mod_rewrite只会停止当前迭代中的重写规则处理。此行为类似于Apache mod_rewrite中的<span class="val">[END]</span>标志。 </li> </ul> </li> </ul><br/> LiteSpeed重写引擎实现遵循Apache重写引擎规范。 有关重写规则的更多详细信息，请参阅 <a href=" http://httpd.apache.org/docs/current/mod/mod_rewrite.html " target="_blank" rel="noopener noreferrer"> Apache mod_rewrite文档 </a> 和 <a href=" http://httpd.apache.org/docs/current/rewrite/ " target="_blank" rel="noopener noreferrer"> Apache URL重写指南 </a>.</p> <h4>语法</h4><p>字符串</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="enableIpGeo"><h3>启用IP地理定位<span class="ls-permlink"><a href="#enableIpGeo"></a></span></h3></header><h4>描述</h4><p> 指定是否启用IP地理定位查找。 可以在服务器、虚拟主机或上下文级别设置。使用“Not Set”值时，默认禁用IP地理定位。</p> <h4>语法</h4><p>布尔值</p> <h4>另请参阅</h4><p class="ls-text-small"><span class="tagl"><a href="ServGeneral_Help.html#useIpInProxyHeader">使用报头中的客户端IP</a></span>, <span class="tagl"><a href="ServGeneral_Help.html#geoipDBFile">数据库文件路径</a></span>,</p> </article> </div>
<div class="helpitem"><article class="ls-helpitem"><header class="ls-helpitem__header" id="phpIniOverride"><h3>php.ini覆盖<span class="ls-permlink"><a href="#phpIniOverride"></a></span></h3></header><h4>描述</h4><p>用于覆盖当前Context（虚拟主机级别或Context级别）中的php.ini设置。<br/><br/> 支持的指令是：<br/> php_value<br/> php_flag<br/> php_admin_value<br/> php_admin_flag<br/><br/> 所有其他行/指令将被忽略。</p> <h4>语法</h4><p>覆盖语法类似于Apache：每行一个指令及其值，每个指令前根据需要加上php_value、php_flag、php_admin_value或php_admin_flag。</p> <h4>示例</h4><div class="ls-example">php_value include_path ".:/usr/local/lib/php"<br/> php_admin_flag engine on<br/> php_admin_value open_basedir "/home"</div></article> </div>
</section>
</article></div><button class="doc-back-to-top" type="button" aria-label="返回顶部" data-back-to-top><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M12 19V5" /><path d="m6 11 6-6 6 6" /></svg><span class="sr-only">返回顶部</span></button><footer class="copyright">版权 © 2013-2026. <a href="https://www.litespeedtech.com">LiteSpeed Technologies Inc.</a> 版权所有。</footer>
</div>
</body>
</html>