模块索引

模块

名称 描述
plugin_core 包含用于通用请求处理、静态文件、日志文件和缓冲区限制的核心功能。
mod_access 允许您按 IP 地址过滤客户端。
mod_accesslog 将 lighttpd 处理的请求记录到文件、管道或 syslog。日志格式可以使用 printf 风格的占位符进行自定义。
mod_auth 要求客户端使用用户名和密码进行身份验证。它支持基本(摘要尚未支持)身份验证方法以及纯文本、htpasswd 和 htdigest 后端。
mod_balance 在不同后端之间进行负载均衡。
mod_cache_disk_etag 如果设置了 etag 响应头,则将生成的内容缓存到磁盘;如果后端发送了已缓存的 etag,则关闭后端并直接发送文件。
mod_debug 提供各种实用工具来帮助您调试问题。
mod_deflate mod_deflate 实时压缩内容
mod_dirlist 列出目录中的文件。输出可以通过多种方式进行自定义,从通过 CSS 设置样式到排除某些条目。
mod_expire 向响应添加 "Expires" 和 "Cache-Control" 标头
mod_fastcgi 连接到 FastCGI 后端以生成响应内容
mod_flv 提供 Flash 伪流媒体
mod_fortune 从文件中加载名言(即 fortune cookies),并提供将随机名言作为响应头 (X-fortune) 添加或作为页面显示的操作。
mod_gnutls 使用 GnuTLS 在单独的套接字上监听 TLS 连接 (https)
mod_limit 限制并发连接数或每秒请求数。
mod_lua 加载 lua 插件和动作
mod_core (lua) 提供一些用 lua 编写的实用辅助函数
mod_secdownload (lua) 使用有时限的代码保护文件
mod_memcached 在 memcached 服务器上缓存内容
mod_openssl 使用 OpenSSL 在单独的套接字上监听 TLS 连接 (https)
mod_progress 通过唯一标识符跟踪连接进度(状态)
mod_proxy 连接到 HTTP 后端以生成响应内容
mod_redirect 通过发送 HTTP 状态码 301 和 Location 标头来重定向客户端
mod_rewrite 修改请求路径和查询字符串
mod_scgi 连接到 SCGI 后端以生成响应内容
mod_status 显示一个包含内部统计信息的页面,例如请求数量(总数或每秒)、活动连接数等。
mod_throttle 限制传出带宽使用
mod_userdir 允许您通过 http://domain/~user/ 访问用户特定的文档根目录
mod_vhost 提供多种实现虚拟主机的方案

动作

名称 模块 描述
access.check mod_access 根据客户端 IP 地址允许或拒绝访问
access.deny mod_access 通过返回 403 状态码拒绝访问
alias plugin_core 根据匹配的前缀设置文档根目录
auth.deny mod_auth 以“401 Unauthorized”处理请求
auth.htdigest mod_auth 要求使用 htdigest 文件进行身份验证
auth.htpasswd mod_auth 要求使用 htpasswd 文件进行身份验证
auth.plain mod_auth 要求使用纯文本文件进行身份验证
auth.require_user mod_core (lua) 要求特定的已认证用户
balance.rr mod_balance 使用轮询 (Round-Robin) 在动作(列表或单个动作)之间进行负载均衡
balance.sqf mod_balance 使用 SQF 在动作(列表或单个动作)之间进行负载均衡
cache.disk.etag mod_cache_disk_etag 根据 ETag 响应头缓存响应
core.cached_html mod_core (lua) 如果当前 URL 尚未找到静态文件且 URL 不以 ".html" 后缀结尾,则尝试查找具有 ".html" 后缀的当前 URL 文件。
core.wsgi mod_core (lua) 将 URL 分割为 SCRIPT_NAME(Web 应用程序安装的子目录)和 PATH_INFO(Web 应用程序应路由的路径)
core.xsendfile mod_core (lua) 提供简单的 X-Sendfile 功能;从您的后端发送 "X-Sendfile: /path/to/file" 响应头
debug.profiler_dump mod_debug 如果启用了性能分析,则将所有已分配内存转储到性能分析器输出文件
debug.show_connections mod_debug 显示一个类似于 mod_status 页面的页面,列出所有活动连接
debug.show_events mod_debug 显示所有事件的纯文本列表
deflate mod_deflate 等待响应头;如果响应可以被压缩,deflate 会添加一个过滤器来压缩它
dirlist mod_dirlist 列出目录中的文件
docroot plugin_core 设置文档根目录,并为请求的文件构建物理路径
env.add plugin_core 如果未设置,则设置一个连接环境变量
env.clear plugin_core 移除所有连接环境变量
env.remove plugin_core 移除一个连接环境变量
env.set plugin_core 设置一个连接环境变量
expire mod_expire 向响应添加 "Expires" 标头
fastcgi mod_fastcgi 连接到 FastCGI 后端
flv mod_flv 将当前文件作为 Flash 伪流式传输
fortune.header mod_fortune 将随机名言添加为响应头 "X-fortune"。
fortune.page mod_fortune 显示随机 cookie 作为响应文本
header.add plugin_core 添加新的响应头行
header.append plugin_core 将值追加到响应头行
header.overwrite plugin_core 覆盖响应头行或添加新行
header.remove plugin_core 移除现有响应头
index plugin_core 目录中要显示的默认文件名
io.buffer_in plugin_core 设置传入分块队列的内存限制(默认 256KiB)
io.buffer_out plugin_core 设置传出分块队列的内存限制(默认 256KiB)
io.throttle mod_throttle 设置当前连接的传出限流限制
io.throttle_ip mod_throttle 将当前连接添加到基于 IP 的传出限制限流池
io.throttle_pool mod_throttle 将当前连接添加到传出限制限流池
limit.con mod_limit 限制并发连接的总数到指定限制。
limit.con_ip mod_limit 限制每个 IP 的并发连接总数到指定限制。
limit.req mod_limit 限制每秒请求量到指定限制。
limit.req_ip mod_limit 限制每个 IP 每秒请求量到指定限制。
list plugin_core (lua) 将动作列表组合成一个动作,仅在 lua 中需要
log plugin_core 覆盖所有日志级别的日志目标
log.write plugin_core 将日志消息写入“info”日志级别
lua.handler mod_lua 将文件作为 lua 配置加载
map plugin_core 将模式的结果映射到用户定义的动作
memcached.lookup mod_memcached 在 memcached 数据库中搜索内容
memcached.store mod_memcached 将生成的响应存储在 memcached 数据库中
openssl.setenv mod_openssl 设置 SSL 环境变量
pathinfo plugin_core 将物理路径分割为现有文件/目录和剩余的 PATH_INFO
progress.show mod_progress 返回由 X-Progress-ID 查询字符串参数指定的 ID 跟踪的请求状态信息
progress.track mod_progress 如果提供了 X-Progress-ID 查询字符串键,则跟踪当前请求
proxy mod_proxy 连接到 HTTP 后端
redirect mod_redirect 重定向客户端
req_header.add plugin_core 添加新的请求头行
req_header.append plugin_core 将值追加到请求头行
req_header.overwrite plugin_core 覆盖请求头行或添加新行
req_header.remove plugin_core 移除现有请求头
respond plugin_core 返回带可选主体的快速响应
rewrite mod_rewrite 修改请求路径和查询字符串
rewrite_raw mod_rewrite 修改请求路径和查询字符串,匹配并写入原始路径
scgi mod_scgi 连接到 SCGI 后端
secdownload mod_secdownload (lua) 使用有时限的代码保护文件
set_status plugin_core 修改 HTTP 状态码
static plugin_core 使用磁盘上的静态文件处理 GET 和 HEAD 请求
static_no_fail plugin_core 使用磁盘上的静态文件处理 GET 和 HEAD 请求
status.info mod_status 向客户端返回状态页面
userdir mod_userdir 通过用用户名(或其部分)替换路径中的特定占位符来构建文档根目录。
vhost.map mod_vhost 将给定主机名映射到动作块
vhost.map_regex mod_vhost 将匹配的主机名模式映射到动作块
when plugin_core (lua) 构建条件块(仅在 lua 中可用)

设置

名称 模块 描述
debug.show_events_after_shutdown mod_debug 关机开始后,记录剩余活动事件的时间(秒)
fetch.files_static plugin_core 启动一个 Fetch API 提供程序
fortune.load mod_fortune 从文件加载 cookie,可以多次调用以从多个文件加载数据
gnutls mod_gnutls 设置 TLS 套接字
io.timeout plugin_core 设置全局 I/O 超时(等待网络读写)
listen plugin_core 监听套接字地址,接受的格式见上文(默认 TCP 端口为 80)
log plugin_core 为所有日志级别设置默认日志目标
log.timestamp plugin_core 设置日志中时间戳的格式字符串
lua.plugin mod_lua 将文件作为 lua 插件加载
module_load plugin_core 加载给定模块
openssl mod_openssl 设置 TLS 套接字
progress.ttl mod_progress 内部查找表中连接断开后条目的生存时间(秒)
stat_cache.ttl plugin_core 为统计缓存条目设置 TTL
tasklet_pool.threads plugin_core 设置阻塞任务的后台线程数
workers plugin_core 设置工作进程数量;每个工作进程在其自己的线程中运行,并处理从主工作进程分配的连接
workers.cpu_affinity plugin_core 将工作线程绑定到 CPU,仅在 Linux 系统上可用

选项

名称 模块 描述
access.log_blocked mod_access 是否在访问被拒绝时记录日志(日志级别为“info”)
access.redirect_url mod_access 如果访问被拒绝,重定向到的 URL(尚未实现)
accesslog mod_accesslog 定义日志目标
accesslog.format mod_accesslog 定义日志格式
auth.debug mod_auth 启用调试输出
balance.debug mod_balance 启用调试输出
buffer_request_body plugin_core 启用在磁盘上缓冲请求体
debug.log_request_handling plugin_core 启用请求处理的调试输出
deflate.debug mod_deflate 启用调试输出
etag.use plugin_core 用于计算 etag 的属性列表;指定空列表以禁用 etag。可用属性:“inode”、“mtime”、“size”
fastcgi.log_plain_errors mod_fastcgi 是否在“backend”日志中,为 FastCGI stderr 行前置时间戳和其他信息
keepalive.requests plugin_core 客户端在一个连接中允许发出的最大请求数
keepalive.timeout plugin_core keep-alive 连接保持打开的时间(秒)
mime_types plugin_core 将文件扩展名映射到 MIME 类型
progress.debug mod_progress 启用调试输出
progress.methods mod_progress 要跟踪的请求方法
redirect.debug mod_redirect 启用调试输出
rewrite.debug mod_rewrite 启用调试输出
server.name plugin_core 服务器名称;在某些情况下使用,如果 HTTP/1.0 请求中未指定 HTTP 请求主机名,则用此代替
server.tag plugin_core 用于在不同位置显示服务器名称 + 版本(HTTP 响应头、CGI 环境、mod_dirlist 页脚等)
stat.async plugin_core 启用异步 stat() 调用
static.exclude_extensions plugin_core 不提供带有列出扩展名的静态文件
static.range_requests plugin_core 启用范围请求
status.css mod_status 定义要使用的样式表。可用值:未设置(默认)、"blue" 或您希望的任何 URL
strict.post_content_length plugin_core 要求 POST 请求具有 Content-Length
vhost.debug mod_vhost 启用调试输出