lighttpd - 配置文件

转载其他网站，收藏查看！

配置文件lighttpd.conf参数详细说明的链接和选译

发表于 2010年12月22日

http://redmine.lighttpd.net/projects/lighttpd/wiki/Docs:ConfigurationOptions

1. mimetype.assign

指定mime类型映射列表，对于没有映射的mime类型使用”application/octet-stream”。例如：

mimetype.assign = ( “.png” => “image/png”,
“.jpg” => “image/jpeg”,
“.jpeg” => “image/jpeg”,
“.html” => “text/html”,
“.txt” => “text/plain” )

在映射表中按从上到下的顺序进行匹配搜索，一旦找到匹配的就停止搜索。所以下面的映射顺序不能颠倒，否则在匹配搜索时不能正确匹配 *.tar.gz 类型的文件。

“.tar.gz” => “application/x-tgz”,
“.gz” => “application/x-gzip”,

使用下面的语句来实现缺省映射，注意缺省映射要放到映射表的最后一项：

…,
“” => “text/plain” )

2. mimetype.use-xattr

如果有效则使用XFS类型扩展属性接口来检索每个文件的“网页类型（Content-Type）”属性，并使用检索到的类型作为mime类型。如果配置文件中没有定义该参数或禁止了该参数（mimetype.use-xattr = “enable”），则使用 mimetype.assign 的类型映射。

3. server.bind

指定服务器侦听的IP地址、主机名或者unix域的socket绝对路径（absolute path to the unix-domain socket ）。例如：

server.bind = “127.0.0.1″
server.bind = “www.example.org”
server.bind = “/tmp/lighttpd.socket”

缺省时侦听所有端口（缺省的IP协议为IPV4，可通过配置参数 server.use-ipv6 来启用IPV6）。

4. server.chroot

设置服务器的根目录，注意：需要root权限。

5. server.core-files（允许值为enable或disable）

如果使能，那么在lighttpd崩溃时将进行存储器状态记录（core dump）。注意：需要使能操作系统级的core dump功能，linux用户能通过ulimit指令来使能/禁止core dump。

6. server.document-root

设置网页服务器的根目录。配置文件必需指定该参数。例如

server.document-root = “/home/usrxxxxx/lighttpd-1.4.19/web”

7. server.errorlog

设置错误日志文件的路径。缺省值为 STDERR 或 server.errorlog-use-syslog。该指令在配置文件中应该只出现一次。

8. server.errorlog-use-syslog

若使能将发送错误日志到系统日志中，缺省为disable。

9. server.error-handler-404

如果网址不能被定位到一个静态网页文件，那么将调用该参数指定的页面。若网址不能被定位到动态页面时，则不会转到参数指定的页面。例如：

server.error-handler-404 = “/error-404.php”

10. server.errorfile-prefix

指定出错时去显示哪个目录下的页面。功能类似参数 server.error-handler-404，但能根据错误代码（status-code）调用不同的用户页面。例如：

server.errorfile-prefix = “/srv/www/htdocs/errors/status-”

上面语句指定了当出现错误时，去哪个目录取出用户定义的出错显示页面。在上面指定的目录下，写出错误代码（status-code）对应的显示页面，然后以status-(status-code).html命名。这样，出现不同的错误时，就会去调用不同的status-(status-code).html文件。例如：

/srv/www/htdocs/errors/status-404.html
/srv/www/htdocs/errors/status-500.html
/srv/www/htdocs/errors/status-501.html

11. server.force-lowercase-filenames

强制所有的文件名为小写。

12. server.groupname

指定可以运行服务器的组名。要求lighttp以root权限启动。

13. server.kbytes-per-second

限制所有连接的速率（kbyte / s）。

14. server.max-connections

设置允许的最大连接数。例如：server.max-connections = 1024。该参数与参数 server.max-fds 的设置有关联，即 max-connections == max-fds/2 (也可能 /3)。例如，若要同时允许2048个连接，max-fds需要被设置为server.max-fds = 4096 (或 6144)。

15. server.max-fds

设置允许的最大文件描述符个数。lighttpd是单线程的服务器，其最大的资源限制就是文件描述符的数量，默认为1024。对于高负荷的站点，需要增加该值，对于较为繁忙的服务器设置为2048较好。修改该设置需要root权限。

16. server.max-keep-alive-requests

活动的单个会话中的最大请求数。缺省为16。

17. server.max-request-size

POST请求（包括请求头部+请求体）的最大大小（kbytes）。缺省为2097152 (2GB)。

18. server.modules

指定要装载的模块。指定装载的顺序很重要，模块按照装载的顺序执行，在模块mod_fastcgi之后装载模块mod_auth可能导致fastcgi下的身份验证功能无效（如果check-local被设置为disable）。模块mod_auth应该在所有的执行模块之前（比如 proxy, fastcgi, scgi and cgi），而模块rewrites, redirects and access应该放在最前面。例如：

server.modules = ( “mod_rewrite”,
“mod_redirect”,
“mod_alias”,
“mod_access”,
“mod_auth”,
“mod_status”,
“mod_simple_vhost”,
“mod_evhost”,
“mod_userdir”,
“mod_secdownload”,
“mod_fastcgi”,
“mod_proxy”,
“mod_cgi”,
“mod_ssi”,
“mod_compress”,
“mod_usertrack”,
“mod_expire”,
“mod_rrdtool”,
“mod_accesslog” )

下面的模块是自动加入的，不要手工加入它们：

mod_indexfile 、mod_dirlisting 、mod_staticfile

另外，不要重复加入同一个模块。

19. server.name

指定服务器/虚拟服务器的名字。

20. server.pid-file

设置用于存储服务器的PID的文件名。该参数多用于系统启动时使用脚本启动服务器为守护进程的情况。

21. server.protocol-http11

定义是否支持HTTP/1.1，缺省为支持。

22. server.tag

设置服务器应答的头部的字符串。

23. server.username

指定可以运行服务器的用户名。要求lighttp以root权限启动。

24. server.upload-dirs

设置上传目录。缺省为 /var/tmp （server.upload-dirs = ( “/var/tmp” )）。

25. static-file.exclude-extensions

禁止对某些扩展名的源文件进行访问。

来源：http://hi.baidu.com/id_joyride/blog/item/60ff4ff1685667ca7831aa78.html