配置文件选项¶

您将在此处找到 Lighttpd 所有可用配置选项的列表。它们按模块分组，每个模块配置的链接将提供有关每个选项的更详细信息、示例以及其他指南。

• 目录
• 配置文件选项
  • Lighttpd 核心选项
    • SSL 选项
    • 核心调试信息
  • mod_access
  • mod_accesslog
  • mod_alias
  • mod_auth
  • mod_cache
  • mod_cgi
  • mod_cml
  • mod_compress
  • mod_deflate
  • mod_dirlisting
  • mod_evasive
  • mod_evhost
  • mod_expire
  • mod_extforward
  • mod_fastcgi
  • mod_flv_streaming
  • mod_indexfile
  • mod_mem_cache
  • mod_mysql_vhost
  • mod_proxy
  • mod_redirect
  • mod_rewrite
  • mod_rrdtool
  • mod_scgi
  • mod_secure_download
  • mod_setenv
  • mod_simple_vhost
  • mod_ssi
  • mod_status
  • mod_trigger_b4_dl
  • mod_userdir
  • mod_uploadprogress
  • mod_usertrack
  • mod_webdav

Lighttpd 核心选项¶

• connection.kbytes-per-second：将每个独立连接的吞吐量限制在给定值（单位：千字节/秒）。详情
• etag.use-inode：确定在 ETag 生成中是否使用 inode 值 详情
• etag.use-mtime：确定在 ETag 生成中是否使用 mtime 值 详情
• etag.use-size：确定在 ETag 生成中是否使用 size 值 详情
• mimetype.assign：已知 MIME 类型映射列表。详情
• mimetype.use-xattr：尝试使用 XFS 样式扩展属性接口来检索内容类型 (Content-Type)。详情
• server.bind：IP 地址、主机名或 Unix 域套接字的绝对路径。详情
• server.chroot：服务器的根目录。详情
• server.core-files：启用核心文件。详情
• server.dir-listing：启用/禁用目录列表。详情
• server.document-root：Web 服务器的文档根目录。详情
• server.error-handler-404：如果请求的文件导致 404 错误，则调用此 URI。详情
• server.errorfile-prefix：特殊状态码页面的路径前缀。详情
• server.errorlog：错误日志的文件名。详情
• server.errorlog-use-syslog：将错误日志发送到 syslog。详情
• server.event-handler：设置事件处理器。详情
• server.follow-symlink：允许跟随符号链接。详情
• server.force-lowercase-filenames：启用强制所有文件名小写。
• server.groupname：用于运行服务器的组名。详情
• server.kbytes-per-second：将所有连接的吞吐量限制在给定值（单位：千字节/秒）。详情
• server.max-connections：最大连接数。详情
• server.max-fds：最大文件描述符数量。详情
• server.max-keep-alive-idle：空闲的 Keep-alive 连接在断开前等待的最大秒数。详情
• server.max-keep-alive-requests：Keep-alive 会话中的最大请求数。详情
• server.max-read-idle：非 Keep-alive 读取操作在超时并关闭连接前等待的最大秒数。详情
• server.max-request-size：请求的最大大小（单位：千字节）。详情
• server.max-worker：要生成的 worker 进程数量。详情
• server.max-write-idle：写入调用在超时前等待的最大秒数。详情
• server.modules：要加载的模块。详情
• server.name：服务器/虚拟服务器的名称。详情
• server.network-backend：所有平台在系统调用 read() 和 write() 上的基本网络接口。详情
• server.pid-file：设置 .pid 文件的名称和位置。详情
• server.port：服务器绑定的 TCP 端口。详情
• server.protocol-http11：定义是否允许 HTTP/1.1。详情
• server.range-requests：定义是否允许范围请求。详情
• server.stat-cache-engine：选择 stat() 调用缓存。详情
• server.tag：设置服务器返回的字符串。详情
• server.upload-dirs：上传目录的路径。详情
• server.use-ipv6：绑定到 IPv6 套接字。
• server.username：用于运行服务器的用户名。详情
• static-file.etags：确定是否生成 ETag。
• static-file.exclude-extensions：通过扩展名禁止访问某些类型文件的源。

SSL 选项¶

• ssl.engine：启用/禁用 SSL 引擎。
• ssl.pemfile：用于 SSL 支持的 PEM 文件路径。详情
• ssl.ca-file：用于支持链式证书的 CA 文件路径。详情

核心调试信息¶

• debug.log-request-header：记录所有请求头。
• debug.log-file-not-found：如果文件未找到，则记录。
• debug.log-condition-handling：记录条件处理以进行调试。
• debug.log-request-header-on-error：记录请求头，但仅在发生错误时。
• debug.log-request-handling：记录 lighttpd 内部的请求处理。
• debug.log-state-handling：记录 lighttpd 内部的状态处理。
• debug.log-response-header：记录我们发送给客户端的响应头。
  调试变量信息

mod_access¶

访问限制模块 - 选项

• url.access-deny：拒绝访问所有具有给定尾部路径名的文件。
  mod_access 文档

mod_accesslog¶

访问日志文件模块 - 选项

• accesslog.use-syslog：将访问日志发送到 syslog。
• accesslog.format：日志文件的格式。
• accesslog.filename：如果不使用 syslog，则访问日志应写入的文件名。
  mod_accesslog 文档

mod_alias¶

目录别名模块 - 选项

• alias.url：重写 URL 子集的文档根目录。
  mod_alias 文档

mod_auth¶

身份验证模块 - 选项

• auth.debug：启用/禁用身份验证模块调试信息。
• auth.backend：身份验证后端类型。
• auth.require:
• auth.backend.ldap.hostname：LDAP 服务器主机名。
• auth.backend.ldap.starttls:
• auth.backend.ldap.filter:
• auth.backend.ldap.bind-pw:
• auth.backend.ldap.ca-file:
• auth.backend.ldap.base-dn:
• auth.backend.ldap.bind-dn:
• auth.backend.plain.userfile：纯文本用户文件路径。
• auth.backend.plain.groupfile：纯文本组文件路径。
• auth.backend.htdigest.userfile：htdigest 用户文件路径。
• auth.backend.htpasswd.userfile：htpasswd 用户文件路径。
  mod_auth 文档

mod_cache¶

Web 加速模块 - 选项

• cache.bases：希望保存缓存文件的目录数组
• cache.enable:
• cache.domains：mod_cache 将缓存的域名 PCRE 正则表达式数组
• cache.support-queries:
• cache.debug：是否将 mod_cache 调试消息写入 error.log
• cache.purge-host：允许清除缓存文件的 IP 主机 PCRE 正则表达式
• cache.refresh-pattern:
  mod_cache 文档

mod_cgi¶

CGI 模块 - 选项

• cgi.assign：将 CGI 处理器分配给一个扩展名。
  mod_cgi 文档

mod_cml¶

缓存元语言模块 - 选项

• cml.memcache-namespace：（尚未使用）
• cml.power-magnet：为每个请求执行的 CML 文件。
• cml.memcache-hosts：memcache.* 函数的主机。
• cml.extension：绑定到 CML 模块的文件扩展名。
  mod_cml 文档

mod_compress¶

压缩输出模块 - 选项

• compress.max-filesize：要压缩的原始文件的最大大小（单位：千字节）。
• compress.cache-dir：缓存压缩内容的目录名称。
• compress.filetype：可能被压缩的 MIME 类型。
  mod_compress 文档

mod_deflate¶

动态压缩模块（补丁） - 选项

• deflate.enabled：启用/禁用 deflate 支持。
• deflate.compression-level：压缩级别。
• deflate.mem-level:
• deflate.window-size:
• deflate.bzip2：启用/禁用 bzip 支持
• deflate.allowed_encodings：允许的编码
• deflate.min-compress-size：压缩前的最小文档大小。
• deflate.sync-flush：启用同步刷新。
• deflate.output-buffer-size：压缩缓冲区大小。
• deflate.work-block-size：压缩的最小块大小。
• deflate.mimetypes：要压缩的 MIME 类型列表。
• deflate.debug：启用调试。
  mod_deflate 文档

mod_dirlisting¶

目录列表模块 - 选项

• server.dir-listing：启用/禁用目录列表。
• dir-listing.activate：如果请求目录但未找到索引文件，则启用虚拟目录列表。
• dir-listing.external-css：目录列表的外部 CSS 样式表路径。
• dir-listing.encoding：为生成的目录列表设置编码。
• dir-listing.hide-dotfiles：如果启用，则不在由 dir-listing 选项生成的目录列表中列出隐藏文件。
• dir-listing.show-header：在目录列表上方包含 HEADER.txt 文件。
• dir-listing.hide-header-file：启用在目录列表中隐藏头部文件。
• dir-listing.show-readme：在目录列表上方包含 README.txt 文件。
• dir-listing.hide-readme-file：启用在目录列表中显示 README 文件。
• dir-listing.exclude：与任何指定正则表达式匹配的文件将从列表中排除。
• dir-listing.set-footer：在列表页面的页脚显示一个字符串。
  mod_dirlisting 文档

mod_evasive¶

规避模块 - 选项

• evasive.max-conns-per-ip：允许的每个 IP 连接数上限。

mod_evhost¶

增强型虚拟主机模块 - 选项

• evhost.path-pattern：带有通配符的模式，用于替换以构建文档根目录。
  mod_evhost 文档

mod_expire¶

缓存过期模块 - 选项

• expire.url：为指定路径下的所有文件分配过期时间。
  mod_expire 文档

mod_extforward¶

从 X-Forwarded-For 头部提取客户端的“真实”IP - 选项

• extforward.forwarder：设置代理 IP 的信任级别
  mod_extforward 文档

mod_fastcgi¶

FastCGI 模块 - 选项

• fastcgi.map-extensions：将多个扩展名映射到同一个 FastCGI 服务器。
• fastcgi.debug：一个介于 0 到 65535 之间的值，用于设置 FastCGI 模块的调试级别。
• fastcgi.server：告诉模块将 FastCGI 请求发送到何处。
  • host：FastCGI 进程的主机名/IP。
  • port：FastCGI 进程使用的“主机”上的 TCP 端口。
  • socket：Unix 域套接字路径。
  • bin-path：如果本地没有 FastCGI 运行，则应启动的本地 FastCGI 二进制文件路径。
  • bin-environment：设置 FastCGI 二进制文件的环境。
  • bin-copy-environment：从服务器复制环境给 FastCGI 二进制文件。
  • mode：FastCGI 协议模式。默认是“响应器”，也实现了“授权器”模式。
  • docroot：远程主机的文档根目录。
  • allow-x-send-file：控制是否允许 X-LIGHTTPD-send-file 和 X-Sendfile 头部。
  • broken-scriptfilename：以 PHP 可以从中提取 PATH_INFO 的方式破坏 SCRIPT_FILENAME。
  • idle-timeout：未使用的进程在终止前等待的秒数。
  • max-procs：启动进程的上限。
  • min-procs：设置要启动的最小进程数。
  • min-procs-not-working:
  • max-load-per-proc：每个进程平均最大等待进程数，超过此值将生成新进程。
  • check-local：启用/禁用检查文档根目录中请求的文件。
  • disable-time：禁用后端在再次检查前等待的时间。
  • strip-request-uri：截断请求 URI 的一部分。
    mod_fastcgi 文档

mod_flv_streaming¶

FLV 流媒体模块 - 选项

• flv-streaming.extensions：FLV 文件的扩展名
  博客文章
  附加信息
  Flash Video Player 3.5

mod_indexfile¶

索引文件模块 - 选项

• index-file.names：如果请求目录，则要搜索的文件列表
  mod_indexfile 文档

mod_mem_cache¶

本地文件加速 - 选项

• mem-cache.filetypes：希望放入内存的内容类型数组
• mem-cache.enable:
• mem-cache.max-memory：mod-mem-cache 可使用的最大内存（单位：兆字节）
• mem-cache.max-file-size：单个文件缓存到内存的最大文件大小（单位：千字节）
• mem-cache.lru-remove-count:
• mem-cache.expire-time：内存缓存的过期时间（单位：分钟）
• mem-cache.slru-thresold ：SLRU 阈值（针对命中计数器）
  mod_mem_cache 文档

mod_mysql_vhost¶

MySQL 虚拟主机模块 - 选项

• mysql-vhost.hostname：MySQL 服务器主机名。
• mysql-vhost.db：数据库名称。
• mysql-vhost.user：访问数据库的用户名。
• mysql-vhost.pass：访问数据库的密码。
• mysql-vhost.sql：用于获取文档根目录的 SQL 语句。
• mysql-vhost.port：连接数据库的端口。
• mysql-vhost.sock：连接数据库的套接字。
  mod_mysql_vhost 文档

mod_proxy¶

代理模块 - 选项

• proxy.server：将代理请求发送到何处。
  • host：发送请求的主机 IP。
  • port：主机侦听端口。
• proxy.balance：选择负载均衡算法类型（轮询、哈希、公平）。
• proxy.debug：启用/禁用代理调试信息。
  mod_proxy 文档

mod_redirect¶

重定向模块 - 选项

• url.redirect：将一组 URL 外部重定向。
  mod_redirect 文档

mod_rewrite¶

重写模块 - 选项

• url.rewrite-once：内部重写一组 URL 并跳过其余部分。
• url.rewrite-repeat：在 Web 服务器内部重写一组 URL，并继续应用重写规则。
• url.rewrite：与 url.rewrite-once 相同。
• url.rewrite-final：与 url.rewrite-once 相同。
  mod_rewrite 文档

mod_rrdtool¶

RRDtool 模块 - 选项

• rrdtool.db-name：RRD 数据库的文件名。
• rrdtool.binary：RRDtool 二进制文件路径。
  mod_rrdtool 文档

mod_scgi¶

SCGI 模块 - 选项

• scgi.map-extensions：将多个扩展名映射到同一个 SCGI 服务器。
• scgi.debug：一个介于 0 到 65535 之间的值，用于设置 SCGI 模块的调试级别。
• scgi.server：告诉模块将 SCGI 请求发送到何处。
  • host：SCGI 进程的主机名/IP。
  • port：SCGI 进程使用的“主机”上的 TCP 端口。
  • socket：Unix 域套接字路径。
  • bin-path：如果本地没有 SCGI 运行，则应启动的本地 SCGI 二进制文件路径。
  • bin-environment：设置 SCGI 二进制文件的环境。
  • bin-copy-environment：从服务器复制环境给 SCGI 二进制文件。
  • docroot：远程主机的文档根目录。
  • allow-x-send-file：控制是否允许 X-LIGHTTPD-send-file 和 X-Sendfile 头部。
  • broken-scriptfilename：以 PHP 可以从中提取 PATH_INFO 的方式破坏 SCRIPT_FILENAME。
  • idle-timeout：未使用的进程在终止前等待的秒数。
  • max-procs：启动进程的上限。
  • min-procs：设置要启动的最小进程数。
  • min-procs-not-working:
  • max-load-per-proc：每个进程平均最大等待进程数，超过此值将生成新进程。
  • check-local：启用/禁用检查文档根目录中请求的文件。
  • disable-time：禁用后端在再次检查前等待的时间。
  • strip-request-uri：截断请求 URI 的一部分。
    mod_scgi 文档

mod_secure_download¶

安全快速下载模块 - 选项

• secdownload.document-root：下载区域的路径。
• secdownload.timeout：密钥有效时长（单位：秒）。
• secdownload.uri-prefix：下载 URL 的前缀。
• secdownload.secret：用于校验和计算的密钥字符串。
  mod_secure_download 文档

mod_setenv¶

设置 HTTP 环境变量模块 - 选项

• setenv.add-response-header：向发送给客户端的 HTTP 响应添加头部。
• setenv.add-request-header：向从客户端接收到的 HTTP 请求添加头部。
• setenv.add-environment：向传递给外部应用程序的进程环境添加一个值。
  mod_setenv 文档

mod_simple_vhost¶

简单虚拟主机模块 - 选项

• simple-vhost.document-root：虚拟主机目录下的路径。
• simple-vhost.server-root：虚拟主机的根目录。
• simple-vhost.default-host：如果请求的主机名没有自己的目录，则使用此主机名。
• simple-vhost.debug：调试简单虚拟主机模块。
  mod_simple_vhost 文档

mod_ssi¶

服务器端包含模块 - 选项

• ssi.extension：mod_ssi 处理的文件扩展名。
  mod_ssi 文档

mod_status¶

服务器状态模块 - 选项

• status.config-url：显示已加载模块的配置页面的相对 URL。
• status.statistics-url：包含内部统计信息的纯文本页面的相对 URL。
• status.enable-sort：添加 JavaScript，允许客户端对连接概览进行排序。
• status.status-url：用于检索状态页面的相对 URL。
  mod_status 文档

mod_trigger_b4_dl¶

下载前触发模块 - 选项

• trigger-before-download.trigger-url：触发页面的 URL。
• trigger-before-download.trigger-timeout：下载链接的有效时间。
• trigger-before-download.download-url：下载的 URL。
• trigger-before-download.deny-url：当访问者拒绝下载时显示的 URL。
• trigger-before-download.gdbm-filename：GDBM 文件路径。
• trigger-before-download.memcache-hosts：memcache.* 函数的主机。
• trigger-before-download.memcache-namespace：（尚未使用）
• trigger-before-download.debug:
  mod_trigger_b4_dl 文档

mod_userdir¶

用户目录 - 选项

• userdir.basepath：如果设置，则不检查 /etc/passwd 以获取主目录。
• userdir.exclude-user：不允许使用此功能的用户名列表。
• userdir.path：通常应设置为“public_html”，将 ~/public_html/ 作为文档根目录。
• userdir.include-user：如果设置，则只有此列表中的用户可以使用此功能。
  mod_userdir 文档

mod_uploadprogress¶

上传进度模块 - 选项

• upload-progress.progress-url:

mod_usertrack¶

用户跟踪模块（cookies） - 选项

• usertrack.cookie-name:
• usertrack.cookiename-：（已弃用）
• usertrack.cookie-domain:
• usertrack.cookie-max-age:
  mod_usertrack 文档

mod_webdav¶

WebDAV 模块 - 选项

• webdav.activate：启用/禁用 WebDAV。
• webdav.is-readonly：启用/禁用只读。
• webdav.sqlite-db-name：SQLite 数据库的文件名。
• webdav.log-xml：记录 XML 请求体以进行调试。
  mod_webdav 文档