io.buffer_out (动作)

设置传出块队列的内存限制（默认为 256KB）

io.buffer_out limit;

限制

以字节为单位的限制（0 表示无限制）

io.buffer_out 512kbyte;

io.buffer_in (动作)

设置传入块队列的内存限制（默认为 256KB）

io.buffer_in limit;

限制

以字节为单位的限制（0 表示无限制）

io.buffer_in 512kbyte;

map (动作)

将模式结果映射到用户定义的动作

map (pattern, mapping);

模式

此模式的评估结果用作映射中的键

映射

将字符串（或默认值）映射到操作

模式被解析为 模式。有关主机名的特殊映射，请查看 mod_vhost。

map "%{req.path}" => [
	"/" => {
		respond 200 => "root";
	},
	"/news" => {
		respond 200 => "news";
	},
	default => {
		respond 404;
	},
];

access.deny (动作)

通过返回 403 状态码拒绝访问

access.deny;

access.check (动作)

根据客户端 IP 地址允许或拒绝访问

access.check rules;

规则

一个键值列表，将“access”和/或“deny”键映射到 CIDR 地址列表或“all”。

根据规则检查客户端 IP 地址。默认是拒绝所有地址。最精确的匹配规则定义结果（“192.168.100.0/24”优先于“192.168.0.0/16”；类似于路由表）；如果相同的 CIDR 在两个列表中，则执行第二个操作。“all”是“0.0.0.0/0”和“::/0”的同义词，匹配所有 IPv4 和 IPv6 地址。

setup {
	module_load "mod_access";
}

access.check (
	"allow" => ("127.0.0.0/8", "10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"),
	"deny" => ("all")
);

setup {
	module_load "mod_access";
}

access.check (
	"allow" => ("192.168.10.0/24"),
	"deny" => ("192.168.10.1")
);

auth.plain (动作)

要求使用纯文本文件进行身份验证

auth.plain options;

选项

一个包含以下条目的键值表

方法

“basic”或“digest”——目前只支持“basic”，但您仍然必须指定它。

领域

在“需要身份验证”响应中发送给浏览器的领域名称；也在 htdigest 的哈希中使用。

文件

（可选）在多少秒后，如果密码文件被更改并且再次需要时，lighty 会重新加载它（默认为 10 秒）

生存时间

需要使用包含以换行符 (\n) 分隔的用户:密码对的纯文本文件进行身份验证。

仅支持“basic”

auth.htpasswd (动作)

要求使用 htpasswd 文件进行身份验证

auth.htpasswd options;

选项

一个包含以下条目的键值表

方法

需要使用包含以换行符 (\n) 分隔的用户:加密密码对的 htpasswd 文件进行身份验证

领域

在“需要身份验证”响应中发送给浏览器的领域名称；也在 htdigest 的哈希中使用。

文件

（可选）在多少秒后，如果密码文件被更改并且再次需要时，lighty 会重新加载它（默认为 10 秒）

生存时间

需要使用包含以换行符 (\n) 分隔的用户:密码对的纯文本文件进行身份验证。

• 密码使用 crypt(3) 加密，使用 Apache 的 htpasswd 二进制文件管理该文件
• 支持以“$apr1$”开头的哈希 (htpasswd -m)
  • 支持以“{SHA}”开头的哈希（后跟 sha1_base64(password)，htpasswd -s）
  • 需要使用包含以换行符 (\n) 分隔的用户:领域:哈希密码元组的 htdigest 文件进行身份验证

auth.htdigest (动作)

要求使用 htdigest 文件进行身份验证

auth.htdigest options;

选项

一个包含以下条目的键值表

方法

“basic”或“digest”——目前只支持“basic”，但您仍然必须指定它。

领域

在“需要身份验证”响应中发送给浏览器的领域名称；也在 htdigest 的哈希中使用。

文件

（可选）在多少秒后，如果密码文件被更改并且再次需要时，lighty 会重新加载它（默认为 10 秒）

生存时间

需要使用包含以换行符 (\n) 分隔的用户:密码对的纯文本文件进行身份验证。

• 哈希值绑定到领域，因此您无法在不重置密码的情况下更改领域
• 密码保存为（修改过的）md5 哈希
• md5hex(用户名 + ":" + 领域 + ":" + 密码)
  您也可以使用 mod_lua 插件 contrib/core.lua 中的 auth.require_user 进行 REMOTE_USER 检查

auth.deny (动作)

以“401 未授权”处理请求

auth.deny;

balance.rr (动作)

以轮询方式在动作之间进行负载均衡（列表或单个动作）

balance.rr actions;

动作

循环 (rr) 方式下，请求均匀分布到所有后端。

最短队列优先 (sqf) 类似于循环方式，并优先选择等待队列最短的后端。

balance.rr { fastcgi "127.0.0.1:9090"; };

balance.rr ({ fastcgi "127.0.0.1:9090"; }, { fastcgi "127.0.0.1:9091"; });

balance.sqf (动作)

以 SQF 在动作之间进行负载均衡（列表或单个动作）

balance.sqf actions;

动作

循环 (rr) 方式下，请求均匀分布到所有后端。

mod_cache_disk_etag 会在设置了 etag 响应头时将生成的内容缓存到磁盘；如果后端发送了一个已缓存的 etag，则关闭后端并直接发送文件。

balance.sqf { fastcgi "127.0.0.1:9090"; };

cache.disk.etag (动作)

根据 ETag 响应头缓存响应

cache.disk.etag path;

路径

这会阻塞操作进度，直到响应头完成（即，在此之前必须有一个内容生成器，例如 fastcgi/dirlist/静态文件）。您当然可以多次插入它（例如在 deflate 之前和之后）。

mod_debug 提供各种实用工具来帮助您调试问题。

setup {
	module_load "mod_cache_disk_etag";
}

cache.disk.etag "/var/lib/lighttpd/cache_etag"

debug.show_connections (动作)

显示一个与 mod_status 类似的页面，列出所有活动连接

debug.show_connections;

lighttpd2 需要编译时支持分析器，并且必须通过将环境变量 LIGHTY_PROFILE_MEM 设置为目标日志文件的路径来启用分析。

if req.path == "/debug/connections" { debug.show_connections; }

debug.profiler_dump (动作)

如果启用了性能分析，则将所有已分配内存转储到性能分析输出文件

debug.profiler_dump;

这是一个非常底层的开发者调试工具。

debug.show_events (动作)

显示所有事件的纯文本列表

debug.show_events;

显示事件的超时时间（默认：禁用）

if req.path == "/debug/events" { debug.show_events; }

deflate (动作)

等待响应头；如果响应可以压缩，deflate 会添加一个过滤器来压缩它

deflate options;

选项

一个包含以下条目的键值表

支持的方法，取决于编译时包含的（默认：“deflate,gzip,bzip2”）

块大小

blocksize 是每次压缩的千字节数，它允许 Web 服务器在压缩之间执行其他工作（网络 I/O）（默认：4096）

输出缓冲区

output-buffer 是每个连接用于压缩输出的缓冲区，它可以帮助减小响应大小（减少要编码的块）。如果设置为零，将使用共享缓冲区。（默认：4096）

压缩级别

0-9：数字越低表示压缩速度越快但文件/输出越大，数字越高可能压缩时间更长但文件/输出越小（取决于文件的可压缩能力），此选项用于所有选定的编码变体（默认：1）

重要：由于 deflate; 会等待响应头，您必须在此之前处理请求（请参阅下方如何检查请求是否已处理）。如果请求未被处理，您将收到“500 - 内部错误”以及 error.log 中的一条消息。

deflate [ "encodings" => "deflate,gzip,bzip2", "blocksize" => 4096, "output-buffer" => 4096, "compression-level" => 1 ];

deflate [ "compression-level" => 6 ];

dirlist (动作)

列出目录中的文件

dirlist options;

选项

一个包含以下条目的键值表

字符串：外部样式表的 URL（默认：内联内部 CSS）

隐藏点文件

布尔值：隐藏以点开头的条目（默认：true）

隐藏波浪号文件

布尔值：隐藏以波浪号 (~) 结尾的条目，常用于备份（默认：true）

隐藏目录

布尔值：从目录列表中隐藏目录（默认：false）

包含头文件

布尔值：在目录列表上方包含 HEADER.txt（默认：false）

隐藏头文件

布尔值：从目录列表中隐藏 HEADER.txt（默认：false）

编码头文件

布尔值：HTML 编码 HEADER.txt（如果包含），如果包含真正的 HTML，则设置为 false（默认：true）

包含自述文件

布尔值：在目录列表下方包含 README.txt（默认：true）

隐藏自述文件

布尔值：从目录列表中隐藏 README.txt（默认：false）

编码自述文件

布尔值：HTML 编码 README.txt（如果包含），如果包含真正的 HTML，则设置为 false（默认：true）

排除后缀

字符串列表：隐藏以所提供字符串之一结尾的条目（默认：空列表）

排除前缀

字符串列表：隐藏以所提供字符串之一开头的条目（默认：空列表）

布尔值：输出调试信息到日志（默认：false）

调试

内容类型

字符串：要在 HTTP 响应头中返回的内容类型（默认：“text/html; charset=utf-8”）

显示目录列表，包括列表上方的 HEADER.txt 内容并将其自身从列表中隐藏；同时隐藏所有以“.bak”结尾的文件

setup {
	module_load ("mod_dirlist");
}

if req.path =^ "/files/" {
	dirlist ("include-header" => true, "hide-header" => true, "hide->suffix" => (".bak"));
}

expire (动作)

向响应添加“Expires”头部

expire rule;

用于计算“Expires”头值的规则

此处使用的规则/公式符合 Apache mod_expire 的使用方式

<base> 是“access”、“now”或“modification”之一；“now”等同于“access”。

<base> [plus] (<num> <type>)+

• “plus”是可选的，不执行任何操作。
• <num> 是任何正整数。
• <type> 是“seconds”、“minutes”、“hours”、“days”、“weeks”、“months”或“years”之一。
• <type> 中的尾随“s”是可选的。

如果您使用“modification”作为 <base> 且文件不存在或无法访问，mod_expire 将不执行任何操作，请求处理将继续进行。

过期操作将覆盖任何现有的“Expires”头。

它会将 max-age 值附加到任何现有的“Cache-Control”头。
缓存图片、CSS、TXT 和 JS 文件 1 周。

setup {
	module_load "mod_expire";
}

if req.path =~ "\.(jpe?g|png|gif|txt|css|js)$" {
	expire "access plus 1 week";
}

fastcgi (动作)

连接到 FastCGI 后端

fastcgi socket;

要连接的套接字，可以是“ip:port”或“unix:/path”

不要混淆 FastCGI 和 CGI！并非所有 CGI 后端都可以用作 FastCGI 后端（但您可以使用 fcgi-cgi 来让 lighttpd2 运行 CGI 后端）。

例如，使用 spawn-fcgi 启动 PHP：spawn-fcgi -n -s /var/run/lighttpd2/php.sock -- /usr/bin/php5-cgi

fastcgi "127.0.0.1:9090"

setup {
	module_load "mod_fastcgi";
}

if phys.path =$ ".php" and phys.is_file {
	fastcgi "unix:/var/run/lighttpd2/php.sock";
}

flv (动作)

将当前文件伪流式传输为 flash

flv;

使用“video/x-flv”作为硬编码的内容类型。

使用缓存和带宽限制来节省流量。使用较小的突发阈值以防止播放器在开始时缓冲。

if phys.path =$ ".flv" {
	flv;
}

if phys.path =$ ".flv" {
	expire "access 1 month";
	io.throttle 500kbyte => 150kbyte;
	flv;
}

fortune.header (动作)

将随机名言作为响应头“X-fortune”添加。

fortune.header;

fortune.page (动作)

显示随机 cookie 作为响应文本

fortune.page;

limit.con (动作)

将并发连接总数限制为指定限制。

limit.con (limit, action);

限制

操作

（可选）达到限制时要执行的操作

如果没有定义操作，将返回 503 错误页面。如果指定了操作，则除了在达到限制时运行指定操作外，没有其他特殊处理。

每 IP 的最大并发连接数

limit.con 10;

limit.con_ip (动作)

将每个 IP 的并发连接总数限制为指定限制。

limit.con_ip (limit, action);

限制

每秒最大请求数

（可选）达到限制时要执行的操作

如果没有定义操作，将返回 503 错误页面。如果指定了操作，则除了在达到限制时运行指定操作外，没有其他特殊处理。

每 IP 的最大并发连接数

limit.con_ip 2;

limit.req (动作)

将每秒请求数限制为指定限制。

limit.req (limit, action);

限制

每 IP 每秒最大请求数

（可选）达到限制时要执行的操作

如果没有定义操作，将返回 503 错误页面。如果指定了操作，则除了在达到限制时运行指定操作外，没有其他特殊处理。

每 IP 的最大并发连接数

limit.req 100;

limit.req_ip (动作)

将每个 IP 的每秒请求数限制为指定限制。

limit.req_ip (limit, action);

限制

此配置片段将允许总共 10 个活动下载，以及每 IP 1 个下载。如果超过限制，无论是由于超过 10 人尝试访问此资源，还是某人已有一个下载正在运行而再次尝试，他们都将被重定向到 /connection_limit_reached.html。

（可选）达到限制时要执行的操作

如果没有定义操作，将返回 503 错误页面。如果指定了操作，则除了在达到限制时运行指定操作外，没有其他特殊处理。

每 IP 的最大并发连接数

limit.req_ip 100;

lua.handler (动作)

将文件作为 lua 配置加载

lua.handler (filename, options, lua-args);

加载 cookie 的文件

一个带有选项的键值表；目前还没有可用选项

选项

一个包含以下条目的键值表

生存时间

lua.handler 基本与 include_lua 相同，但有以下区别：

转发到 Lua 插件的参数

Lua 插件可以通过在全局 Lua 命名空间中创建设置/操作表来注册设置和操作回调（像任何 C 模块一样）。

每个工作进程自行加载 Lua 文件

• 它在使用前不会被加载，因此您在加载时不会看到脚本中的错误
• 它不能调用设置函数
• 它支持脚本参数（local filename, args = ...）
• 不锁定全局 Lua 锁，因此在使用多个工作进程时性能更佳
• 请参阅 contrib/core.lua 了解我们如何加载某些外部操作，例如 contrib/core__xsendfile.lua。

mod_core.lua 提供了一些用 Lua 编写的有用辅助工具

setup {
	module_load "mod_lua";
	lua.plugin "secdownload.lua";
}

if req.path =^ "/app" {
	lua.handler "/etc/lighttpd/pathrewrite.lua", [ "ttl" => 300 ], "/app";
}

core.wsgi (动作)

将 URL 分割为 SCRIPT_NAME（Web 应用程序挂载的子目录）和 PATH_INFO（Web 应用程序应路由的路径）

core.wsgi (prefix, action);

Web 应用程序挂载的 URL 前缀（“子目录”）

连接到 WSGI 后端的动作块

（可选）达到限制时要执行的操作

请参阅 WSGI 操作指南 获取示例。

WSGI 应用程序期望 URL 被拆分为 SCRIPT_NAME 和 PATH_INFO（CGI 环境变量）；SCRIPT_NAME 是它们的“应用程序根”，而 PATH_INFO 是应用程序中请求的资源。

默认情况下，lighttpd 使用空的 PATH_INFO（除非您使用了“pathinfo;”操作，但这无济于事，因为我们这里不处理静态文件）。
重要：WSGI 是 CGI 的“扩展”；它不指定传输协议，您可以将其与普通 CGI、FastCGI 或 SCGI（或任何其他支持基本 CGI 协议的）一起使用

示例：/trac 中的 Trac，通过 FastCGI 监听 unix:/var/run/lighttpd/trac.socket。

setup {
	module_load ("mod_lua", "mod_fastcgi");
	lua.plugin "core.lua";
}
core.wsgi ( "/trac", { fastcgi "unix:/var/run/lighttpd/trac.socket"; } );

core.cached_html (动作)

如果我们尚未找到 URL 的静态文件，并且 URL 还没有“.html”后缀，则尝试为当前 URL 查找带有“.html”后缀的文件。

core.cached_html;

setup {
	module_load "mod_lua";
	lua.plugin "core.lua";
}
docroot "/some/dynamic/app/public";
core.cached_html;
if physical.is_file {
	header.add ("X-cleanurl", "hit");
} else {
	header.add ("X-cleanurl", "miss");
	fastcgi "/var/run/lighttpd/dynamic-app.sock";
}

core.xsendfile (动作)

提供简单的 X-Sendfile 功能；从您的后端发送“X-Sendfile: /path/to/file”响应头

core.xsendfile docroot;

docroot

用户列表

setup {
	module_load ("mod_lua", "mod_fastcgi");
	lua.plugin "core.lua";
}
fastcgi "/var/run/lighttpd/dynamic-app.sock";
core.xsendfile "/some/dynamic/app/";

auth.require_user (动作)

要求特定已验证用户

auth.require_user userlist;

允许的用户名列表

此辅助工具构造一个正则表达式以匹配 request.environment[“REMOTE_USER”]，因此下面的示例与以下内容相同

auth.plain [ "method" => "basic", "realm" => "test", "file" => "/etc/lighttpd2/test.plain" ]; if req.env["REMOTE_USER"] !~ "^(foo1|foo2)$" { auth.deny; }

此操作仅使用 Lua 创建操作，在这种情况下不执行 Lua 来处理请求。

请注意：空用户名匹配未经身份验证的用户。

mod_secdownload.lua 使用限时代码保护文件

setup {
	module_load "mod_lua";
	lua.plugin "core.lua";
}
auth.plain [ "method" => "basic", "realm" => "test", "file" => "/etc/lighttpd2/test.plain" ];
auth.require_user ("foo1", "foo2");

secdownload (动作)

使用有时限的代码保护文件

secdownload options;

选项

一个包含以下条目的键值表

Web 应用程序挂载的 URL 前缀（“子目录”）

文档根目录

秘密文件在磁盘上的存储位置

密钥

用于创建和验证 URL 的共享密钥。

生成的 URL 有效时长（秒）（最大允许时间差）；默认值为 60

超时

prefix 不用于构建文件名；请手动将其包含在 document-root 中（其工作方式类似于 alias "/prefix" => "/docroot"，请参阅 alias）。

secdownload 实际上不处理（有效）请求，它只是提供文件名映射（并拒绝无效请求）。
要生成对 secdownload 有效的 URL，您需要相同的密钥。

setup {
	module_load "mod_lua";
	lua.plugin "secdownload.lua";
}
secdownload [ "prefix" => "/sec/", "document-root" => "/secret/path", "secret" => "abc", "timeout" => 600 ];

memcached.lookup (动作)

在 memcached 数据库中搜索内容

memcached.lookup (options, action-hit, action-miss);

选项

一个包含以下条目的键值表

套接字地址字符串（默认：127.0.0.1:11211）

头

（布尔值，暂不支持）是否也查找头。如果为 false，内容类型由 request.uri.path 决定（默认：false）

键

查找键的模式（默认：“%{req.path}”）

命中操作

缓存命中时运行的操作（查找成功）

未命中操作

缓存未命中时运行的操作（查找不成功）

标志

memcached.store (动作)

将生成的响应存储在 memcached 数据库中

memcached.store options;

选项

一个包含以下条目的键值表

套接字地址字符串（默认：127.0.0.1:11211）

头

（整数）存储数据的标志（默认 0）

存储的 TTL（默认 30；如果想“永久”缓存，请使用 0）

生存时间

最大尺寸

我们希望存储的最大大小（字节）（默认：64*1024）

（布尔值，暂不支持）是否也存储头（默认：false）

（布尔值，暂不支持）是否也查找头。如果为 false，内容类型由 request.uri.path 决定（默认：false）

存储键的模式（默认：“%{req.path}”）

查找键的模式（默认：“%{req.path}”）

mod_memcached 也向每个工作进程的 luaState 导出 Lua API（用于 lua.handler）

openssl.setenv (动作)

设置 SSL 环境变量字符串

openssl.setenv list;

列表

支持的子集

“client” – 设置 SSL_CLIENT_S_DN_ 短命名条目

• “client-cert” – 将 SSL_CLIENT_CERT 设置为客户端证书 PEM
• “server” – 设置 SSL_SERVER_S_DN_ 短命名条目
• “server-cert” – 将 SSL_SERVER_CERT 设置为服务器证书 PEM
• mod_progress 通过唯一标识符跟踪连接进度（状态）

progress.track (动作)

如果提供了 X-Progress-ID 查询字符串键，则跟踪当前请求

progress.track;

progress.show (动作)

返回由 X-Progress-ID 查询字符串参数指定的请求的状态信息

progress.show format;

格式

输出格式

legacy: new Object({"state": "running"", "received": 123456, "sent": 0, "request_size": 200000, "response_size": 0})

• json: {"state": "running", "received": 123456, "sent": 0, "request_size": 200000, "response_size": 0}
• jsonp: progress({"state": "running", "received": 123456, "sent": 0, "request_size": 200000, "response_size": 0})
• 函数名（默认“progress”）可以通过提供 X-Progress-Callback 查询字符串参数进行更改。
  JSON 对象可以包含以下成员

状态 (state)："unknown"、"running"、"done" 或 "error" 之一。

• 已接收 (received)：lighty 接收或客户端上传的字节数。
• 请求大小 (request_size)：请求或上传文件的总大小，由 Content-Length 请求头指定。
• 已发送 (sent)：lighty 发送或客户端下载的字节数。
• 响应大小 (response_size)：响应的总大小。注意：如果从后端进行流式传输，此值可能会随时间增长。
• 状态码 (status)：响应的 HTTP 状态码。
• received、request_size、sent 和 response_size 仅在 state 为 "running" 或 "done" 时可用。status 仅在 state 为 "error" 时可用。

mod_proxy 连接到 HTTP 后端以生成响应内容

setup {
	module_load "mod_progress";
}

if req.path == "/upload.php" { progress.track; }
if req.path == "/progress" { progress.show; }

proxy (动作)

连接到 HTTP 后端

proxy socket;

要连接的套接字，可以是“ip:port”或“unix:/path”

不要混淆 FastCGI 和 CGI！并非所有 CGI 后端都可以用作 FastCGI 后端（但您可以使用 fcgi-cgi 来让 lighttpd2 运行 CGI 后端）。

mod_redirect 通过发送 HTTP 状态码 301 和 Location 头来重定向客户端

setup {
	module_load "mod_proxy";
}

proxy "127.0.0.1:8080";

redirect (动作)

重定向客户端

redirect rule;

用于计算“Expires”头值的规则

目标字符串是一个 模式。

• 正则表达式 用于匹配请求路径（始终以“/”开头！）
• 如果给定规则列表，重定向将在第一个匹配项处停止。
• 默认情况下，目标字符串被解释为绝对 URI；如果它以“？”开头，它将替换查询字符串；如果以“/”开头，它将替换当前路径；如果以“./”开头，则相对于路径中的当前“目录”进行解释。
• 示例：始终重定向（HTTP 到 HTTPS）

setup {
	module_load "mod_redirect";
}
if request.scheme == "http" {
	if request.query == "" {
		redirect "https://%{request.host}%{enc:request.path}";
	} else {
		redirect "https://%{request.host}%{enc:request.path}?%{request.query}";
	}
}

setup {
	module_load "mod_redirect";
}
if request.host !~ "^www\.(.*)$" {
	if request.query == "" {
		redirect "http://www.%{request.host}%{enc:request.path}";
	} else {
		redirect "http://www.%{request.host}%{enc:request.path}?%{request.query}";
	}
}

setup {
	module_load "mod_redirect";
}
redirect "^/old_url$" => "http://new.example.tld/url"

if request.host !~ "^www\.(.*)$" {
	redirect "." => "http://www.%1/$0?%{request.query}";
}

rewrite (动作)

修改请求路径和查询字符串

rewrite rule;

用于计算“Expires”头值的规则

目标字符串是一个 模式。

• 正则表达式 用于匹配请求路径（始终以“/”开头！）
• 如果给定规则列表，重写将在第一个匹配项处停止。
• 仅当目标字符串包含 ? 时替换查询字符串
• 示例：始终重写

setup {
	module_load "mod_rewrite";
}
rewrite "/new/path";

setup {
	module_load "mod_rewrite";
}
rewrite "regex" => "/new/path";

setup {
	module_load "mod_rewrite";
}
rewrite ("regex1" => "/new/path1", ..., "regexN" => "/new/pathN");

setup {
	module_load "mod_rewrite";
}

# bad: routing login in webserver config:
rewrite (
	"^/article/(\d+)/.*$" => "/article.php?id=$1",
	"^/download/(\d+)/(.*)$" => "/download.php?fileid=$1&filename=$2"
);
rewrite "^/user/(.+)$" => "/user.php?name=$1";

# good: handle it in the backend (easier to port the config)
rewrite "^/(article|download|user)(/|$)" => "/index.php";

rewrite_raw (动作)

修改请求路径和查询字符串，匹配和写入原始路径

rewrite_raw rule;

用于计算“Expires”头值的规则

目标字符串是一个 模式。

rewrite 将结果写入 request.path 和可能的 request.query，并使用 URL 编码从这些生成 request.raw_path。

rewrite_raw 写入 request.raw_path 并将其解码为 request.path 和 request.query；这意味着查询字符串总是被覆盖。
在这两种情况下，request.path 之后都会被简化。
mod_scgi 连接到 SCGI 后端以生成响应内容

scgi (动作)

连接到 SCGI 后端

scgi socket;

要连接的套接字，可以是“ip:port”或“unix:/path”

不要混淆 FastCGI 和 CGI！并非所有 CGI 后端都可以用作 FastCGI 后端（但您可以使用 fcgi-cgi 来让 lighttpd2 运行 CGI 后端）。

setup {
	module_load "mod_scgi";
}

if req.path =^ "/RPC2" {
	scgi "127.0.0.1:5000";
}

status.info (动作)

向客户端返回状态页面

status.info mode;

（可选）“short”

“short”模式会移除连接和运行时详情（推荐用于“公共”状态）。

状态页面接受以下查询字符串参数

?mode=runtime：显示运行时详情

• format=plain：以纯文本格式显示“short”统计信息
• 如果请求 /server-status，则显示一个包含 lighttpd 统计信息的页面。

setup {
	module_load "mod_status";
}

if req.path == "/server-status" {
	status.info;
}

io.throttle (动作)

为当前连接设置出站限制

io.throttle (rate, burst);

字节/秒限制

突发

可选，默认为 2*rate

burst 是 magazine 的初始和最大值；进行 IO 会耗尽 magazine，而 magazine 会随着时间以指定的 rate 再次填充。

同一池中的所有连接作为一个整体受到限制。每个 io.throttle_pool 操作都会创建自己的池。

io.throttle_pool (动作)

将当前连接添加到出站限制池中

io.throttle_pool rate;

字节/秒限制

突发

在多个地方使用同一个池

setup {
	module_load "mod_throttle";
}
downloadLimit = {
	io.throttle_pool 1mbyte;
}
# now use it wherever you need it...
downloadLimit;

io.throttle_ip (动作)

将当前连接添加到基于 IP 的出站限制池中

io.throttle_ip rate;

字节/秒限制

突发

mod_userdir 允许您通过 http://domain/~user/ 访问用户特定的文档根目录

setup {
	module_load "mod_throttle";
}
downloadLimit = {
	io.throttle_ip 200kbyte;
}
# now use it wherever you need it...
downloadLimit;

userdir (动作)

通过将路径中的某些占位符替换为用户名（部分）来构建文档根目录。

userdir path;

路径

如果 path 不以斜杠 (/) 开头，则文档根目录将以 /etc/passwd 中指定的用户主目录作为前缀。

否则，path 指定要使用的绝对文档根目录。
占位符有

* 被完整用户名替换

• $1-$9 被用户名的第 n 个字母替换，例如 $2 是第二个字母
• 示例

请求 http://host/~lighty/foo.html（假设“/home/lighty”是“lighty”用户的主目录）

物理路径

mod_vhost 提供了多种实现虚拟网站主机的方式

setup {
	module_load "mod_userdir";
}

userdir "public_html";

vhost.map (动作)

将给定的主机名映射到动作块

vhost.map mapping;

映射

vhost.map 提供快速（通过哈希表查找）和灵活的映射，但只映射精确的主机名（不支持模式/正则表达式匹配）。服务器端口绝不被视为主机名的一部分。使用键 default（关键字，而非字符串）来指定默认操作。

以主机名的正则表达式为键、操作为值的键值列表

vhost.map ["host1" => actionblock1, "host2" => actionblock2, ..., "hostN" => actionblockN, default => actionblock0];

vhost.map_regex (动作)

将匹配的主机名模式映射到动作块

vhost.map_regex mapping;

映射

vhost.map_regex 按照给定顺序遍历列表，并在第一个匹配项处停止；如果没有正则表达式匹配，它将使用 default 操作（如果已指定）。

两种操作也可以结合使用。

vhost.map_regex ["host1regex" => actionblock1, "host2regex" => actionblock2, ..., "hostNregex" => actionblockN, default => actionblock0];