Lighttpd (Русский)

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Состояние перевода: На этой странице представлен перевод статьи Lighttpd. Дата последней синхронизации: 29 августа 2011. Вы можете помочь синхронизировать перевод, если в английской версии произошли изменения.

Перевод этой статьи или раздела не отражает оригинальное содержание.

Причина: Last updated in 2012 (186815), out of sync with English page (Discuss)

lighttpd - веб-сервер, разрабатываемый с расчётом на быстроту и защищённость, а также соответствие стандартам. В lighttpd есть поддержка сжатия отдаваемого содержимого «на лету», HTTP-аутентификации, перезаписи URL, SSL и автоматической балансировки нагрузки (нагрузка может автоматически распределяться по нескольким запущенным серверам lighttpd). Веб-сервер также поддерживает интерфейсы CGI, SCGI, FastCGI.

Установка

lighttpd доступ в extra репозитории

# pacman -S lighttpd

Настройка

Настройи lighttpd находятся в файле /etc/lighttpd/lighttpd.conf. Настройки по умолчанию позволяют проверить работоспособность сервера.

Совет: Проверить правильность настроек и выявить ошибки можно с помощью команды:

$ lighttpd -t -f /etc/lighttpd/lighttpd.conf

По умолчанию в качестве document-root сервера служит директория /srv/http/.

Проверяем, существует ли пользователь http:

# grep http /etc/passwd

Если такого пользователя нет в системе, добавляем его командой:

# useradd -d /srv/http -r -s /bin/false -U http

Проверим правильность установки

# rc.d start lighttpd
# echo 'It works!' > /srv/http/index.html

Затем откройте в своём браузере адрес http://localhost и вы должны увидеть тестовую страницу.

Вы также можете добавить lighttpd в секцию DAEMONS в /etc/rc.conf, чтобы он загружался при старте системы.

Примеры конфигурационных файлов вы можете найти в /usr/share/doc/lighttpd/config/.

Совет: Вы можете копировать текст из примеров прямо в /etc/lighttpd/lighttpd.conf или разместить настройки в отдельных файлах в /etc/lighttpd/conf.d (предварительно создав этот каталог). Чтобы включить файл с настройками из /etc/lighttpd/conf.d добавьте в /etc/lighttpd/lighttpd.conf следующую строку:

/etc/lighttpd/lighttpd.conf

include "conf.d/example.conf"

Вы также можете включить все файлы настроек из /etc/lighttpd/conf.d/ одной командой:

/etc/lighttpd/lighttpd.conf

include_shell "cat /etc/lighttpd/conf.d/*.conf"

При этом файлы будут включаться в порядке их следования в каталоге, что может привести к непредсказуемым результатам. В качетсве решения можно перед названием файла ставить цифры, например, 10-auth.conf, 20-fastcgi.conf, 21-fastcgi-php.conf.

Совет: Для корректной обработки различных типов файлов нужно определить mime-типы:

# cp /usr/share/doc/lighttpd/config/conf.d/mime.conf /etc/lighttpd/conf.d/

Теперь нужно включить эти настройки в /etc/lighttpd/lighttpd.conf:

/etc/lighttpd/lighttpd.conf

include "conf.d/mime.conf"

Совет: После изменения конфигурационных файлов не забудьте перезапустить сервер:

# rc.d retsrt lighttpd

CGI

Важно: По умолчанию lighttpd будет запускать процессы от пользователя и группы "http".

Этот модуль позволяет выполнять различные CGI программы. Пример конфигурации CGI модуля приведён ниже:

/etc/lighttpd/conf.d/cgi.conf

server.modules += ( "mod_alias", "mod_cgi" )

alias.url += ( "/cgi-bin" => server_root + "/cgi-bin" )
$HTTP["url"] =~ "^/cgi-bin" {
   cgi.assign = ( ".pl"  => "/usr/bin/perl",
                  ".cgi" => "/usr/bin/perl",
                  ".rb"  => "/usr/bin/ruby",
                  ".erb" => "/usr/bin/eruby",
                  ".py"  => "/usr/bin/python",
                  ".sh"  => "/bin/sh"
   )
}

Включаем эти настройки в /etc/lighttpd/lighttpd.conf:

/etc/lighttpd/lighttpd.conf

include "conf.d/cgi.conf"

Совет: Чтобы файлы с некоторым расширением исполнялись безо всякой спец. программы, просто не указывайте никакую CGI-программу:

cgi.assign = ( ".sh" => "" )

Файл без расширения, но имеет определённую правую часть URL:

cgi.assign = ( "/testfile" => "" )

FastCGI

Устанавливаем FastCGI командой:

# pacman -S fcgi

Теперь у вас есть lighttpd с поддержкой fcgi.

Важно: По умолчанию lighttpd будет запускать процессы от пользователя и группы "http".

Следующее содержимое нужно добавить в файл конфигурации

/etc/lighttpd/conf.d/fastcgi.conf

server.modules += ( "mod_fastcgi" )

server.indexfiles += ( "dispatch.fcgi" ) #dispatch.fcgi if rails specified

server.error-handler-404   = "/dispatch.fcgi" #too
fastcgi.server = (
   ".fcgi" => ((
      "socket" => "/var/run/lighttpd/rails-fastcgi.sock",
      "bin-path" => "/path/to/rails/application/public/dispatch.fcgi"
   ))
)

Включаем этот конфиг в /etc/lighttpd/lighttpd.conf строкой

/etc/lighttpd/lighttpd.conf

include "conf.d/fastcgi.conf"

PHP

Устанавливаем php и php-cgi

# pacman -S php php-cgi

Проверяем, что php-cgi работает:

$ php-cgi --version

PHP 5.3.8 with Suhosin-Patch (cgi-fcgi) (built: Sep 11 2011 10:04:49)
Copyright (c) 1997-2011 The PHP Group
Zend Engine v2.3.0, Copyright (c) 1998-2011 Zend Technologies

Если вы увидели похожий вывод, значит всё установлено правильно.

Примечание: Если вы получаете ошибки, подобные этим "No input file found" при попытке получить доступ к вашему php файлу, убедитесь, что следующие директивы активированы в /etc/php/php.ini:

/etc/php.ini

cgi.fix_pathinfo=1
open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/another/path:/second/path

И что файлы доступны для чтения всем:

# chmod -R 644

Чтобы lighttpd мог работать с php в /etc/lighttpd/conf.d/fastcgi-php.conf добавляем

/etc/lighttpd/conf.d/fastcgi-php.conf

server.modules += ( "mod_fastcgi" )

index-file.names += ( "index.php" )

fastcgi.server = (
   ".php" => (( 
      "bin-path" => "/usr/bin/php-cgi",
      "socket" => "/var/run/lighttpd/php-fastcgi" + PID + ".sock",
      "max-procs" => 4, # значение по умолчанию
      "bin-environment" => (
         "PHP_FCGI_CHILDREN" => "1", # значение по умолчанию
         "PHP_FCGI_MAX_REQUESTS" => "10000"
      ),
      "broken-scriptfilename" => "enable"
   ))
)

fastcgi.map-extensions = ( ".php3" => ".php", ".php4" => ".php", ".php5" => ".php", "phtml" => "php" ) # если используете разные версии php

Включаем этот конфиг в /etc/lighttpd/lighttpd.conf строкой

/etc/lighttpd/lighttpd.conf

include "conf.d/fastcgi-php.conf"

Проверяем работу php:

# echo "<?php phpinfo() ?>" > /srv/http/phpinfo.php

Затем откройте в своём браузере адрес http://localhost/phpinfo.php и вы должны увидеть страницу, содержащую информацию о php.

Совет: Если вы хотите, чтобы в html файлах обрабатывался php-код, добавьте в fastcgi-php.conf:

fastcgi.map-extensions = ( ".html" => ".php" )

php-fpm

В качестве альтернативы php-cgi можно использовать php-fpm. Целесообразность использования php-fpm заключается в отсутствии в последних версиях lighttpd динамической регуляции количества php процессов.

Устанавливаем php-fpm и запускаем демон:

# pacman -S php-fpm
# rc.d start php-fpm

Примечание: Настройки php-fpm находятся в файле /etc/php/php-fpm.conf. Подробнее о настройках php-fpm^{[устаревшая ссылка 2020-12-27]}.

В /etc/lighttpd/conf.d/fastcgi-php.conf добавляем:

/etc/lighttpd/conf.d/fastcgi-php.conf

server.modules += ( "mod_fastcgi" )

index-file.names += ( "index.php" ) 

fastcgi.server = (
   ".php" => ((
      "socket" => "/var/run/php-fpm/php-fpm.sock",
      "broken-scriptfilename" => "enable"
   ))
)

Аналогично предыдущему описанию включаем этот конфиг в /etc/lighttpd/lighttpd.conf строкой

/etc/lighttpd/lighttpd.conf

include "conf.d/fastcgi-php.conf"

Примечание: Демон php-fpm необходимо запускать до lighttpd, иначе php-скрипты не будут обрабатываться (будут выдаваться ошибки 500 или 503).

SSI

SSI (Server Side Includes — включения на стороне сервера) — несложный язык для динамической «сборки» веб-страниц на сервере из отдельных составных частей и выдачи клиенту полученного HTML-документа.

Важно: Если вы используете одновременно mod_ssi и mod_compress, то mod_ssi должен быть загружен до mod_compress.

Чтобы добавить поддержку SSI в Lighttpd добавляем следующие настройки в /etc/lighttpd/conf.d/ssi.conf:

/etc/lighttpd/conf.d/ssi.conf

server.modules += ( "mod_ssi" )

ssi.extension              = ( ".html", ".shtml" )

Затем

/etc/lighttpd/lighttpd.conf

include "conf.d/ssi.conf"

SSL

Создаем директорию для хранения сертификатов:

# mkdir /etc/lighttpd/certs

Генерируем самоподписанный сертификат (пример команды):

# openssl req -x509 -nodes -days 7300 -newkey rsa:2048 -keyout /etc/lighttpd/certs/www.example.com.pem -out /etc/lighttpd/certs/www.example.com.pem

Примечание: Подробнее о создании сертификатов смотрите отдельную статью.

Выставляем владельца и нужные права:

# chown http:http /etc/lighttpd/certs/www.example.com.pem
# chmod 600 /etc/lighttpd/certs/www.example.com.pem

Теперь нужно включить SSL в настройках lighttpd (в /etc/lighttpd/lighttpd.conf).

Чтобы включить SSL для всего HTTP-сервера (вам также нужно указать порт сервера 443):

/etc/lighttpd/lighttpd.conf

ssl.engine = "enable" 
ssl.pemfile = "/etc/lighttpd/certs/www.example.com.pemm"

Чтобы включить SSL в дополнение к HTTP:

/etc/lighttpd/lighttpd.conf

$SERVER["socket"] == ":443" {
   ssl.engine = "enable" 
   ssl.pemfile = "/etc/lighttpd/certs/www.example.com.pem" 
}

Если вы хотите использовать другой сайт при переходе на HTTPS, вам нужно указать другую директорию в качестве document-root используя сокет (в данном случае 443 порт) в качестве условия:

/etc/lighttpd/lighttpd.conf

$SERVER["socket"] == ":443" {
   server.document-root = "/srv/ssl" # use your ssl directory here
   ssl.engine                 = "enable"
   ssl.pemfile                = "/etc/lighttpd/certs/www.example.com.pem"  # use the path where you created your pem file
}

Вы также можете использовать named-based виртуальным хостинг, чтобы реализовать несколько SSL серверов:

/etc/lighttpd/lighttpd.conf

$HTTP["host"] == "www.example.org" {
   ssl.pemfile = "/etc/lighttpd/certs/www.example.org.pem" 
}
$HTTP["host"] == "mail.example.org" {
   ssl.pemfile = "/etc/lighttpd/certs/mail.example.org.pem" 
}

Примечание: SNI поддерживается не всеми браузерами. Подробнее. IP-based виртуальный хостинг лишён этого недостатка.

Совет: Некоторые php-скрипты пытаются определить HTTPS, проверяя значение переменной $_SERVER['HTTPS']. Чтобы разрешить это, вам нужно подключить модуль setenv и передать соответствующую опцию. Пример настройки:

/etc/lighttpd/lighttpd.conf

server.modules = ( ... "mod_setenv", ... )

$SERVER["socket"] == ":443" {
   ssl.engine             = "enable" 
   ssl.pemfile            = "/etc/lighttpd/server.pem" 
   setenv.add-environment = (
     "HTTPS" => "on" 
   )
}

Перенаправление HTTP на HTTPS

mod_redirect должен быть включён:

/etc/lighttpd/lighttpd.conf

server.modules              = ( ... "mod_redirect", ... )

Перенаправляем трафик для домена example.org:

/etc/lighttpd/lighttpd.conf

$SERVER["socket"] == ":80" {
   $HTTP["host"] =~ "example.org" {
      url.redirect = ( "^/(.*)" => "https://example.org/$1" )
      server.name                 = "example.org" 
   }
}

Перенаправляем запросы на HTTPS для части сайта (в примере ниже - /secure):

/etc/lighttpd/lighttpd.conf

$SERVER["socket"] == ":80" {
   $HTTP["url"] =~ "^/secure|^/phpmyadmin" {
      url.redirect = ( "^/(.*)" => "https://example.com/$1" )
   }
}

Перенаправляем весь трафик на HTTPS:

/etc/lighttpd/lighttpd.conf

$SERVER["socket"] == ":80" {
   $HTTP["host"] =~ "(.*)" {
      url.redirect = ( "^/(.*)" => "https://%1/$1" )
   }
}

Сжатие исходящих данных

Сжатие исходящих данных уменьшает нагрузку на сеть и может улучшить общую пропускную способность веб-сервера.

На сегодня поддерживается только статичное содержимое.

Сервер автоматически договаривается какой метод сжатия использовать. Поддерживается gzip, deflate, bzip.

Ограничение на размер сжимаемых файлов: от 128 байт до 128 мегабайт.

Создаём нужную директорию и задаём владельца:

# mkdir /var/cache/lighttpd/compress/
# chown http:http /var/cache/lighttpd/compress/

В /etc/lighttpd/conf.d/compress.conf вносим:

/etc/lighttpd/conf.d/compress.conf

server.modules += ( "mod_compress" )

compress.cache-dir          = "/var/cache/lighttpd/compress/"
compress.allowed-encodings  = ("bzip2", "gzip", "deflate") # значение по умолчанию
compress.filetype           = ("text/plain", "text/html", "text/javascript", "text/css", "text/xml")

Включаем настройки /etc/lighttpd/conf.d/compress.conf в /etc/lighttpd/lighttpd.conf

/etc/lighttpd/lighttpd.conf

include "conf.d/compress.conf"

Совет: Чтобы каталог, в котором Lighttpd хранит сжатые файлы регулярно очищался от старых, неиспользуемых файлов, можно использовать следующий скрипт в качестве задания Cron:

/etc/cron.daily/lighttpd

#!/bin/bash

find /var/cache/lighttpd/compress -type f -mtime +10 | xargs -r rm

В данном примере будут удалены все файлы, которые старше 10 дней.

Совет: Вы также можете использовать условия (имя хоста или url), чтобы задать произвольный каталог для сжатых фавйлов.

/etc/lighttpd/lighttpd.conf

$HTTP["host"] == "docs.example.org" {
   compress.cache-dir = "/srv/http/cache/docs.example.org/" 
}

Не забудьте установить владельцем каталога пользователя http.

Сжатие динамического контента

Для сжатия динамического контента (PHP) в /etc/php/php.ini нужно включить следующую директиву:

/etc/php/php.ini

zlib.output_compression = On

Совет: Вы также можете задать уровен сжатия с помощью директивы zlib.output_compression_level.

Управление кешем браузера пользователя

Для ускорения загрузки статических файлов можно управлять кешем браузера пользователя через заголовки Expires и Cache-Control. Для этого в Lighttpd используется mod_expire.

/etc/lighttpd/lighttpd.conf

server.modules += ( "mod_expire" )

expire.url = (
   "/images/"  => "access plus 7 days",
   "/themes/" => "access plus 7 days",
   "/jquery/" => "access plus 2 weeks",
)

Можно также перечислить отдельные расширения файлов:

/etc/lighttpd/lighttpd.conf

server.modules += ( "mod_expire" )

expire.url = (
   ".css" => "access plus 7 days",
   ".js" => "access plus 2 weeks",
   ".png" => "access plus 7 days",
   ".gif" => "access plus 7 days",
   ".jpg" => "access plus 7 days",
)

Альтернативу предыдущему листингу:

/etc/lighttpd/lighttpd.conf

server.modules += ( "mod_expire" )

$HTTP["url"] =~ "\.(jpe?g|gif|png|css|js)$" {
     expire.url = ( "" => "access 7 days" )
}

Виртуальные хосты

Использование условий

Первый способ заключается в изменении server.document-root в зависимости от содержимого заголовка "host".

/etc/lighttpd/lighttpd.conf

$HTTP["host"] == "www.example1.com" {
   server.document-root = "/srv/vhosts/www.example1.com/http"
   accesslog.filename = "/srv/vhosts/www.example1.com/access.log"
   server.error-handler-404 = "/404.php"
}

$HTTP["host"] == "www.example2.com" {
   server.document-root = "/srv/vhosts/www.example2.com/http"
   accesslog.filename = "/srv/vhosts/www.example2.com/access.log"
   server.error-handler-404 = "/404.php"
}

Примечание: Не забудьте предварительно создать необходимые каталоги и назначить им соответствующих владельцев (http:http).

# mkdir -p /srv/vhosts/www.exmaple1.com/http
# mkdir -p /srv/vhosts/www.exmaple2.com/http
# chown -R http:http /srv/vhosts/

mod_simple_vhost

Этот способ более прост и экономичен. В указанной директории хостинга имя каждого каталога соответствует аналогичному имени вируального хоста. Внутри каждого такого каталога находится dccroot вируального хоста.

Docroot для каждого вируального хоста строится из следующих трёх значений:

server-root
hostname
document-root

Абсолютный путь к docroot'у строится из:

server-root + hostname + document-root

в случае если путь не существует

server-root + default-host + document-root

Совет: Вы можете использовать символьные ссылки чтобы соотнести несколько имён хостов одной директории.

В качестве примера приведём следующий:

/etc/lighttpd/conf.d/simple_vhost.conf

server.modules += ( "mod_simple_vhost" )

simple-vhost.server-root = "/srv/vhosts/"
simple-vhost.default-host = "www.example.org"
simple-vhost.document-root = "http"

Включаем конфигурацию из /etc/lighttpd/conf.d/simple_vhost.conf в /etc/lighttpd/lighttpd.conf:

/etc/lighttpd/lighttpd.conf

include /etc/lighttpd/conf.d/simple_vhost.conf

Для создания виртуального хоста достаточно создать каталог в /srv/vhosts/ и сделать владельцем http:http. Например:

# mkdir -p /srv/vhosts/www.exmaple1.com/http
# chown http:http /srv/vhosts/www.exmaple1.com/http

mod_evhost

Модуль evhost создаёт document-root, основываясь на шаблнах. Эти шаблоны представляют различные части запроса "host":

%% => % sign
%0 => domain name + tld
%1 => tld
%2 => domain name without tld
%3 => subdomain 1 name
%4 => subdomain 2 name
%_ => full domain name

/etc/lighttpd/lighttpd.conf

server.modules = ( ... "mod_evhost", ... )
evhost.path-pattern = "/srv/vhosts/%0/http/"

С помощью этого моудля можно также организовать виртуальные хосты для поддоменов:

/etc/lighttpd/lighttpd.conf

evhost.path-pattern = "/srv/vhosts/%0/http/%3/"

Листинг директорий

Чтобы включить листинг для всех каталогов в /etc/lighttpd/lighttpd.conf укажите следующую опцию:

/etc/lighttpd/lighttpd.conf

dir-listing.activate = "enable"

Листинг включается для всех каталогов, в корне которых нет файлов перечисленных в директиве index-file.names.

Чтобы включить листинг для отдельного каталога укажите следующее:

/etc/lighttpd/lighttpd.conf

$HTTP["url"] =~ "^/download($|/)" {
   dir-listing.activate = "enable" 
}

Совет: Для исключения из листинга скрытых файлов используется директива dir-listing.hide-dotfiles = "enable". Список исключений, основанный на регулярных выражениях, задаётся директивой dir-listing.exclude

Ограничение доступа

Для использования ограничения доступа необходим включить mod_access:

/etc/lighttpd/lighttpd,conf

server.modules = ( ... "mod_access", ... )

Ограничиваем доступ к файлам, заканчивающимся на "~" и ".inc":

/etc/lighttpd/lighttpd,conf

url.access-deny = ( "~", ".inc")

Запрет доступа к сайту для определённого IP:

/etc/lighttpd/lighttpd,conf

$HTTP["remoteip"] == "202.54.1.1" {
   url.access-deny = ( "" )
}

Ограничение доступа к каталогу /libraries:

/etc/lighttpd/lighttpd,conf

$HTTP["url"] =~ "^/libraries/" {
   url.access-deny = ("")
}

Запрет доступа к каталогу /stats всех кроме IP адресов 200.19.1.5 и 210.45.2.7:

/etc/lighttpd/lighttpd,conf

$HTTP["remoteip"] !~ "200\.19\.1\.5|210\.45\.2\.7" {
   $HTTP["url"] =~ "^/stats/" {
      url.access-deny = ( "" )
   }
}

Запрет доступа к файлам jpg, jpeg, png если запрос приходит не с www.example.com (защита от прямых ссылок):

/etc/lighttpd/lighttpd,conf

$HTTP["referer"] !~ "^($|http://www\.example\.org)" {
   url.access-deny = ( ".jpg", ".jpeg", ".png" )
}

Важно: При совместном использовании директив url.access-deny и server.error-handler-404 при запросе запрещённого контента запросы будут направляться согласно директиве server.error-handler-404 (Подробнее).Чтобы этого избежать необходимо добавить server.error-handler-404 = "forbidden" внутрь условия, содержащего url.access-deny. Пример:

/etc/lighttpd/lighttpd.conf

$HTTP["host"] =~ "mysite\.com" {
   server.document-root = "/srv/http/mysite.com"
   server.error-handler-404 = "/index.php"
   $HTTP["url"] == "/cache/" {
      url.access-deny = ( "" )
      server.error-handler-404 = "forbidden"
   }
   $HTTP["url"] =~ "^/wiki/(.*/)?\.ht" {
      url.access-deny = ( "" )
      server.error-handler-404 = "forbidden"
   }
}

Аутентификация

Важно: Если mod_fastcgi и mod_auth используются вместе, то mod_auth должен быть загружен до mod_fastcgi.

Методы

lighttpd поддерживает два метода аутентификации:

Basic метод передаёт имя пользователя и пароль по сети в открытом виде(закодированными в base64), что способствует возникновению проблемы безопастности в случае если соединение между клиентом и сервером не шифруется.
Digest метод передаёт только хешированную информацию, что значительно повышает конфидециальность аутентификационных данных в незащищённых сетях.

Важно: Реализация digest метода в настоящий момент не полностью соответствует стандарту, позволяя осуществить replay attack.

Backends

В зависимости от метода lighttpd позволяет использовать различные методы хранения данных необходимых для аутентификации. Для basic аутентификации:

plain
htpasswd (crypt only)
htdigest
ldap

Для digest аутентификации:

plain
htdigest

plain

Файл содержит строки с именами пользователей и паролями в открытом виде. Имя пользователя и пароль разделяются двоеточием. Например:

agent007:secret

htpasswd

Файл содержит строки с именами пользователей и зашифрованными с помощью crypt() паролями. Имя пользователя и пароль разделяются двоеточием.Например:

agent007:XWY5JwrAVBXsQ

htdigest

Файл содержит строки с именами пользователей, realm'ом и зашифрованными с помощью md5() паролями. Имя пользователя, realm и пароль разделяются двоеточием. Например:

agent007:download area:8364d0044ef57b3defcfa141e8f77b65

ldap

ldap backend обычно выполняет следующие действия для аутентификации пользователя

анонимное соединение (при загрузке plugin'а)
получение DN для фильтрации = username
аутентификация на ldap сервере
рассоединение

если четвёртый шаг проходит без ошибок, то пользователь считается авторизированным

Совет: Для создания файлов htpasswd и htdigest Вы можете воспользоваться утилитами, идущими в составе пакета apache или установить apache-tools^AUR.

Чтобы сгенерировать файл htpasswd введите команду:

$ htpasswd lighttpd.user.htpasswd username

Чтобы сгенерировать файл htdigest введите команду:

$ htdigest lighttpd.user.htdigest 'download area' username

Пример конфигурации

/etc/lighttpd/conf.d/auth.conf

server.modules += ( "mod_auth" )
## отладка
# 0 для выключения, 1 для 'auth-ok' сообщений, 2 для подробных сообщений
auth.debug                 = 0

## тип backend'а
# plain, htpasswd, ldap или htdigest
auth.backend               = "htpasswd" 

# имя файла в котором хранится информация необходимая для plain аутентификации
auth.backend.plain.userfile = "lighttpd-plain.user" 

## для htpasswd
auth.backend.htpasswd.userfile = "/full/path/to/lighttpd-htpasswd.user" 

## для htdigest
auth.backend.htdigest.userfile = "lighttpd-htdigest.user" 

## ограничения
# установка ограничений:
#
# ( <left-part-of-the-url> =>
#   ( "method" => "digest"/"basic",
#     "realm" => <realm>,
#     "require" => "user=<username>" )
# )
#
# <realm> это значение которое будет показано в диалоговом окне
#     и также будет использоваться для digest-алгоритма и
#     должно совпадать с realm'ом в htdigest файле (если используется)
#

auth.require = ( "/download/" =>
                 (
                 # метод должен быть или basic или digest
                   "method"  => "digest",
                   "realm"   => "download archiv",
                   "require" => "user=agent007|user=agent008" 
                 ),
                 "/server-info" =>
                 (
                 # Ограничение доступа к информации о сервере
                   "method"  => "digest",
                   "realm"   => "download archiv",
                   "require" => "valid-user" 
                 )
                 "/protected-folder/" =>
                 (
                   "method"  => "digest",
                   "realm"   => "download archiv",
                   "require" => "valid-user" 
                 )
               )

# Использование регулярного выражения (как альтернатива):
$HTTP["url"] =~ "/server-info|/protected-folder/" {
  auth.require = ( "" =>
                   (
                     "method"  => "digest",
                     "realm"   => "download archiv",
                     "require" => "valid-user" 
                   )
                 )
}

Кодировка по умолчанию

Чтобы установить кодировку для статических файлов, нужно добавить charset=utf-8 в директиве mimetype.assign. Например:

/etc/lighttpd/conf.d/mime.conf

mimetype.assign             = (
  ".css"          =>      "text/css; charset=utf-8",
  ".html"         =>      "text/html; charset=utf-8",
  ".htm"          =>      "text/html; charset=utf-8",
  ".js"           =>      "text/javascript; charset=utf-8",
  ".log"          =>      "text/plain; charset=utf-8",
  ".conf"         =>      "text/plain; charset=utf-8",
  ".text"         =>      "text/plain; charset=utf-8",
  ".txt"          =>      "text/plain; charset=utf-8",
  ".xml"          =>      "text/xml; charset=utf-8",
  ""              =>      "application/octet-stream",
)

Важно: Для файлов, указанных в директиве ssi.extension, добавление charset=utf-8 в mimetype.assign не работает. Единственный способ указать кодировку, это добавить в секцию <head> shtml файла строку:

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

Кодировка для листинга каталогов устанавливается директивой:

/etc/lighttpd/lighttpd.conf

dir-listing.encoding = "utf-8"

Кодировка для php файлов устанавливается в файле /etc/php/php.ini:

/etc/php/php.ini

default_charset = "utf-8"

Проксирование

Lighttpd как reverse proxy для отдачи статики

Пример конфигурации при использовании виртуальных хостов:

/etc/lighttpd/lighttpd.conf

server.modules = (
   ... "mod_proxy", ...
}

$HTTP["host"] =~ "example\.com" {
   setenv.add-request-header ( "Host" => "example.org" ) # добавляем HTTP заголовок
   $HTTP["url"] !~ "\.(js|css|gif|jpg|png|ico|txt|swf|html|htm)$" {
      proxy.server = ( "" => (( "host" => "127.0.0.1", "port" => 8080 )
   ))
   }
}

Можно также перенапрвлять только скрипты с определённым расширением:

/etc/lighttpd/lighttpd.conf

server.modules = (
   ... "mod_proxy", ...
}

$HTTP["host"] =~ "example\.com" {
   setenv.add-request-header ( "Host" => "example.org" ) # добавляем HTTP заголовок
   proxy.server = ( ".php" => (( "host" => "127.0.0.1", "port" => 8080 )),
                    ".cgi" => (( "host" => "127.0.0.1", "port" => 8080 )),
                    ".pl" => (( "host" => "127.0.0.1", "port" => 8080 ))
   )
}

В качестве альтернативы можно использовать условие $HTTP["url"]:

/etc/lighttpd/lighttpd.conf

server.modules = (
   ... "mod_proxy", ...
}

$HTTP["host"] =~ "example\.com" {
   setenv.add-request-header ( "Host" => "example.org" ) # добавляем HTTP заголовок
   $HTTP['url'] =~ "(.cgi|.pl|.php)$" {
      proxy.server = ( "" => ( host = "127.0.0.1", port = "8080" ))
   }
}

Распределние нагрузки с помощью Lighttpd

Для распределения нагрузки можно использовать следующие настройки:

/etc/lighttpd/lighttpd.conf

server.modules = (
   ... "mod_proxy", ...
}
$SERVER["socket"] == ":80" {
   proxy.balance = "hash" 
   proxy.server  = ( "" => ( ( "host" => "10.0.0.10", "port" => "80" ),
                             ( "host" => "10.0.0.11", "port" => "80" ),
                             ( "host" => "10.0.0.12", "port" => "80" ),
                             ( "host" => "10.0.0.13", "port" => "80" ),
                             ( "host" => "10.0.0.14", "port" => "80" ),
                             ( "host" => "10.0.0.15", "port" => "80" ),
                             ( "host" => "10.0.0.16", "port" => "80" ),
                             ( "host" => "10.0.0.17", "port" => "80" )
   ))
}

Доступны следующие типы балансинга:

fair - запрос обрабатывается менее нагруженным сервером
round-robin - запросы обрабатывают сервера по очереди
hash - гарантировано один и тот же uri будет обрабатываться конкретным сервером

Производительность

HTTP Keep-Alive

Отключение Keep-Alive может помочь вашему серверу, если вы страдаете от большого количества дескрипторов файлов. Значения по умолчанию:

/etc/lighttpd/lighttpd.conf

server.max-keep-alive-requests = 16
server.max-keep-alive-idle = 5
server.max-read-idle = 60
server.max-write-idle = 360

Обработка 16 запросов на одно соединение, ожидание 5 секунд прежде, чем Lighttpd закроет соединение.

Если сервер обрабатывает несколько соединений сразу под высокой нагрузкой (предположим, 500 соединений одновременно в течение 24 часов), вы можете столкнуться с проблемой нехватки дескрипторов файлов

/etc/lighttpd/lighttpd.conf

server.max-keep-alive-requests = 4
server.max-keep-alive-idle = 4

Это позволит высвободить соединения ранее, и освободит дескриптор файлов без вредные потери производительности.

Отключение Keep-Alive полностью является крайним случаем, если вы все еще хватает файловых дескрипторов:

/etc/lighttpd/lighttpd.conf

server.max-keep-alive-requests = 0

Обработчик событий

Для Linux с ядром 2.6 и выше рекомендуется следующее значение:

/etc/lighttpd/lighttpd.conf

server.event-handler = linux-sysepoll

Значение по умолчанию: poll (для Unix систем).

Обработчик сетевых соединений

Основный интерфейс для всех платформ - это системные вызовы read() и write(). Современные операционные системы имеют свои собственные системные вызовы, помогающие серверам передавать файлы так быстро, как это возможно. Чтобы установить обработчик сетевых сеодиненй используется директива server.network-backend:

/etc/lighttpd/lighttpd.conf

server.network-backend = linux-sendfile

linux-sendfile рекомендуется для маленьких файлов.
writev рекомендуется для очень больших файлов.

Максимальное количество соединений

Lighttpd - сервер, работающий в один поток. Его основной ресурс ограничивается количеством дескрипторов файлов, которые устанавливается 1024 по умолчанию в большинстве систем. Дескриптор файла — это просто число, которое представляет открытый файл или сокет. Каждый раз, когда процесс открывает новый файл или сокет, он определяет место для нового дескриптора файла. После закрытия файла или сокета эти дескрипторы используются повторно. Большая часть систем Unix накладывает ограничение на число одновременно открытых дескрипторов файлов. Эти ограничения касаются как одного процесса, так и всей системы.

Узнать ограничение дескрипторов файлов в вашей системе можно с помощью команды:

# ulimit -n

Если у вас сайт с большим трафиком, вы можете увеличить это ограничение:

/etc/lighttpd/lighttpd.conf

server.max-fds = 2048

Примеры настроек для различных CMS

phpMyAdmin

Устанавливаем необходимые пакеты:

# pacman -S lighttpd mysql php-cgi php-mcrypt phpmyadmin

Настройка поддержки php описана выше.

Раскоментируем следующие директивы в /etc/php/php.ini:

/etc/php/php.ini

extension=mcrypt.so
extension=mysql.so

Также убедитесь, что директории phpmyadmin указаны в директиве open_basedir в /etc/php/php.ini

/etc/php/php.ini

open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/:/etc/webapps/

Затем конфигурируем Lighttpd:

/etc/lighttpd/conf.d/phpmyadmin.conf

# Подкючаем необходимые модули, если этого не было сделано раньше
server.modules += ( "mod_alias", "mod_access", "mod_redirect", "mod_rewrite" )

alias.url = ( "/phpmyadmin" => "/usr/share/webapps/phpMyAdmin/")
url.rewrite = ( "^/phpMyAdmin(/.*)?$" => "/phpmyadmin$1" )

Если вы хотите, чтобы phpMyAdmin был доступен только по защищённому протоколу добавьте следюущие настройки:

/etc/lighttpd/conf.d/phpmyadmin.conf

$SERVER["socket"] == ":80" {
   $HTTP["url"] =~ "^/phpmyadmin" {
      url.redirect = ( "^/(.*)" => "https://example.com/$1" )
   }
}

Вы также можете ограничить доступ к phpMyAdmin для определённых IP адресов:

/etc/lighttpd/conf.d/phpmyadmin.conf

$HTTP["remoteip"] != "127.0.0.1" {
   $HTTP["url"] =~ "^/phpmyadmin" {
      url.access-deny = ( "" )
   }
}

Подключаем /etc/lighttpd/conf.d/phpmyadmin.conf к основному файлу настроек:

/etc/lighttpd/lighttpd.conf

include "conf.d/phpmyadmin.conf"

Запускаем сервер:

# rc.d start lighttpd

Теперь вы можете получить доступ к phpMyAdmin по адресу http://localhost/phpmyadmin или http://localhost/phpMyAdmin

Mediawiki

Устанавливаем необходимые пакеты:

# pacman -S lighttpd mysql php-cgi imagemagick ghostscript mediawiki

Настройка поддержки php описана выше. УБедитесь, что необходимые директории перечислены в директиве open_basedir в /etc/php/php.ini

/etc/php/php.ini

open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/:/etc/webapps/:/var/cache/mediawiki:/var/lib/mediawiki/

Задаём пароль для учётной записи root MySQL:

#mysqladmin -u root password пароль

Создаём базу данных для wiki:

# mysql -uroot -p${rootpasswd} --execute="create database wiki;"

Создаём пользователя для новой базы:

# mysql -uroot -p${rootpasswd} --execute="GRANT ALL PRIVILEGES ON wiki.* TO ${wiki_user}@localhost IDENTIFIED by '${userpasswd}'  WITH GRANT OPTION;"

${rootpasswd} - пароль root MySQL.
${wiki_user} - имя пользователя базы данных wiki.
${userpasswd} - пароль пользователя базы данныз wiki.

Совет: Тоже самое Вы можете проделать через web-интерфейс phpMyAdmin.

Настраиваем Lighttpd (согласно нижеприведённые настройки wiki будет доступна по адресу http://mysite/wiki):

/etc/lighttpd/conf.d/mediawiki.conf

# Подкючаем необходимые модули, если этого не было сделано раньше
server.modules += ( "mod_alias", "mod_access", "mod_redirect", "mod_rewrite" )
# Создаём alias
alias.url += ( "/wiki" => "/usr/share/webapps/mediawiki")
# Перенаправляем запросы на несуществующие файлы на index.php
$HTTP["url"] =~ "/wiki" {
   server.error-handler-404 = "/wiki/index.php"
}
# Запрещаем доступ к .htaccess файлам
$HTTP["url"] =~ "/\.ht" {
   url.access-deny = ( "" )
   server.error-handler-404 = "403"
}
# Запрещаем доступ к папкам (согласно расположению .htaccess)
$HTTP["url"] =~ "^/wiki/(cache|includes|maintenance|math|languages|serialized|images/deleted)/" {
   url.access-deny = ( "" )
   server.error-handler-404 = "403"
}
# Запрещаем выполнение html или php кода в каталоге images (http://www.mediawiki.org/wiki/Manual:Security#Upload_security)
$HTTP["url"] =~ "^/wiki/images/" {
   mimetype.assign = (
      ".html" => "text/plain",
      ".htm" => "text/plain",
      ".shtml" => "text/plain",
      ".phtml" => "text/plain",
      ".php5" => "text/plain",
      ".php" => "text/plain",
      "" => ""
   )
}
# Определяем mime-тип для файлов без расширения
$HTTP["url"] =~ "^/wiki/(.*/)?(README|FAQ|COPYING|CREDITS|HYSTORY|INSTALL|OBSOLETE|RELEASE-NOTES(.*)|TODO|UPGRADE)$" {
   mimetype.assign	= ( "" => "text/plain" )
}
# Определяем mime-тип для файлов в каталоге docs
$HTTP["url"] =~ "^/wiki/docs/" {
   mimetype.assign	= ( "" => "text/plain" )
}

Подключаем /etc/lighttpd/conf.d/mediawiki.conf к основному файлу настроек:

/etc/lighttpd/lighttpd.conf

include "conf.d/mediawiki.conf"

Запускаем сервер:

# rc.d start lighttpd

Теперь вы можете перейти по адресу http://localhost/wiki для утсановки.

Совет: Для получения коротких URL в /usr/share/webapps/mediawiki/LocalSettings.php нужно добавить:

/usr/share/webapps/mediawiki/LocalSettings.php

$wgArticlePath = "/wiki/$1";
$wgUsePathInfo = true;

Совет: Вместо директивы server.error-handler-404 = /wiki/index.php можно использовать следующие правила перезаписи:

/etc/lighttpd/conf.d/mediawiki.conf

url.rewrite-if-not-file = (
   "^/wiki/(mw-)?config(/.*)?$" => "$0",
   "^/wiki/([^?]*)(?:\?(.*))?" => "/wiki/index.php?title=$1&$2",
   "^/wiki/([^?]*)" => "/wiki/index.php?title=$1"
)

Если хотите использовать поддомен для wiki или Mediawiki будет единствуенной CMS на вашем сайте, то настройки Lighttpd будут выглядеть следующим образом:

/etc/lighttpd/conf.d/mediawiki.conf

# Подкючаем необходимые модули, если этого не было сделано раньше
server.modules += ( "mod_alias", "mod_access", "mod_redirect", "mod_rewrite" )

# Перенаправляем запросы на несуществующие файлы на index.php
$HTTP["host"] =~ "mysite\.com" { # для поддомена "wiki\.mysite\.com"
   server.document-root = "/usr/share/webapps/mediawiki"
   server.error-handler-404 = "/index.php")
# Запрещаем доступ к .htaccess файлам
   $HTTP["url"] =~ "/\.ht" {
# Предотвращаем перенапрвление запросов на запрещённый контент на /index.php (баг Lighttpd)
      url.access-deny = ( "" )
      server.error-handler-404 = "403"
   }
# Запрещаем доступ к папкам (согласно расположению .htaccess)
   $HTTP["url"] =~ "^/(cache|includes|maintenance|math|languages|serialized|images/deleted)/" {
# Предотвращаем перенапрвление запросов на запрещённый контент на /index.php (баг Lighttpd)
      url.access-deny = ( "" )
      server.error-handler-404 = "403"
   }
# Запрещаем выполнение html или php кода в каталоге images (http://www.mediawiki.org/wiki/Manual:Security#Upload_security)
   $HTTP["url"] =~ "^/images/" {
      mimetype.assign = (
         ".html" => "text/plain",
         ".htm" => "text/plain",
         ".shtml" => "text/plain",
         ".phtml" => "text/plain",
         ".php5" => "text/plain",
         ".php" => "text/plain",
         "" => ""
      )
   }
# Определяем mime-тип для файлов без расширения
   $HTTP["url"] =~ "^/(.*/)?(README|FAQ|COPYING|CREDITS|HYSTORY|INSTALL|OBSOLETE|RELEASE-NOTES(.*)|TODO|UPGRADE)$" {
      mimetype.assign	= ( "" => "text/plain" )
   }
# Определяем mime-тип для файлов в каталоге docs
   $HTTP["url"] =~ "^/docs/" {
      mimetype.assign	= ( "" => "text/plain" )
   }
}

Совет: Для получения коротких URL в /usr/share/webapps/mediawiki/LocalSettings.php нужно добавить:

/usr/share/webapps/mediawiki/LocalSettings.php

$wgArticlePath = "/$1";
$wgUsePathInfo = true;

Совет: Вместо директивы server.error-handler-404 = /index.php можно использовать следующие правила перезаписи:

/etc/lighttpd/conf.d/mediawiki.conf

url.rewrite-if-not-file = (
   "^/(mw-)?config(/.*)?$" => "$0",
   "^/([^?]*)(?:\?(.*))?" => "/index.php?title=$1&$2",
   "^/([^?]*)" => "/index.php?title=$1"
)

texvc

Устанавлиаем необходимые пакеты:

# pacman -S texvc

Затем в файле /usr/share/webapps/mediawiki/LocalSettings.php добавляем:

/usr/share/webapps/mediawiki/LocalSettings.php

$wgUseTeX           = true;
$wgMaxShellMemory = 8000000;
$wgMaxShellFileSize = 1000000;
$wgMaxShellTime = 300;

HTTPS login

Если MediaWiki Установлена в папку wiki, то конфиг будет выглядеть следующим образом:

/etc/lighttpd/conf.d/mediawiki.conf

$HTTP["scheme"] == "http" {
   $HTTP["url"] =~ "^/wiki/(.*)UserLogin" {
      url.redirect = ( "^/(.*)" => "https://unikum.dyndns.org/$1" )
   }
   $HTTP["url"] =~ "^/wiki/" {
      $HTTP["querystring"] =~ "UserLogin" {
         url.redirect = ( "^/(.*)" => "https://unikum.dyndns.org/$1" )
      }
   }
}

Drupal

Устанавливаем Drupal:

# pacman -S drupal

УБедитесь, что необходимые директории перечислены в директиве open_basedir в /etc/php/php.ini

/etc/php/php.ini

open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/:/var/lib/drupal/

Настраиваем Lighttpd:

Вариант 1: server.error-handler-404

/etc/lighttpd/lighttpd.conf

$HTTP["host"] =~ "mysite\.com$" { # "drupal\.mysite\.com" для поддомена
   server.document-root = "/usr/share/webapps/drupal"
   server.error-handler-404 = "/index.php"
# Запрет доступа (согласно .htaccess)
   url.access-deny = ( ".engine", ".inc", "info", ".install", ".make", ".module", ".profile", ".test", ".po", ".sh", "sql", ".theme", ".tpl.php", ".xtmpl", "Entries", "Repository", "Root", "Tag", "Template" )
}

Совет: При возникновении проблем с доступом при изменении настроек попробуйте отключить "Чистые ссылки" (Главная » Администрирование » Конфигурация » Адреса и поиск).

Вариант 2: mod_rewrite

/etc/lighttpd/lighttpd.conf

$HTTP["host"] =~ "mysite\.com$" { # "drupal\.mysite\.com" для поддомена
   server.document-root = "/usr/share/webapps/drupal"
   url.rewrite-if-not-file += (
      "^/rss.xml" => "/index.php?q=rss.xml",
      "^/system/test/(.*)$" => "/index.php?q=system/test/$1",
      "^/([^.?]*)\?(.*)$" => "/index.php?q=$1&$2",
      "^/search/(.*)$" => "/index.php?q=search/$1",
      "^/([^.?]*)$" => "/index.php?q=$1",
      "^/([^.?]*\.html)$" => "/index.php?q=$1",
      "^/([^.?]*\.htm)$" => "/index.php?q=$1",
   )

   url.access-deny = ( ".engine", ".inc", "info", ".install", ".make", ".module", ".profile", ".test", ".po", ".sh", "sql", ".theme", ".tpl.php", ".xtmpl", "Entries", "Repository", "Root", "Tag", "Template" )
}

MODX

Для того, чтобы в MODX заработали "Дружественные URL" в конфиг Lighttpd внесите следующие строки:

/etc/lighttpd/lighttpd.conf

url.rewrite-if-not-file += (
   "^/$" => "index.php",
   "^/(assets|manager|core|connectors)" => "$0",
   "^/(?!index(?:-ajax)?\.php)(.*)\?(.*)$" => "/index.php?q=$1&$2",
   "^/(?!index(?:-ajax)?\.php)(.*)$" => "/index.php?q=$1"
)

$HTTP["url"] =~ "^/core/" {
   url.access-deny = ( "" )
}

Также стоит запреттить доступ для всех в папку core.

См. также

Lighttpd wiki (англ.)
Документация по web-серверу Lighttpd (version 1.3.16) (рус.)
Перевод статьи «The lighttpd Web Server» (рус.)