# Lighttpd (Русский)

Эта страница нуждается в сопроводителе

Статья не гарантирует актуальность информации. Помогите русскоязычному сообществу поддержкой подобных страниц. См. Команда переводчиков ArchWiki

Информация в этой статье или разделе устарела

Причина: rc.d references. Needs update, see Systemd (Русский). (Обсудить)

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

## Установка

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

    # pacman -S lighttpd

## Настройка

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

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

    $ 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/`.

Tip: Вы можете копировать текст из примеров прямо в `/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`.

Tip: Для корректной обработки различных типов файлов нужно определить 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"

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

    # 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"

Tip: Чтобы файлы с некоторым расширением исполнялись безо всякой спец. программы, просто не указывайте никакую 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.

Tip: Если вы хотите, чтобы в 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.

В `/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 виртуальный хостинг лишён этого недостатка.
Tip: Некоторые 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"

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

    /etc/cron.daily/lighttpd

    #!/bin/bash

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

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

Tip: Вы также можете использовать условия (имя хоста или 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

Tip: Вы также можете задать уровен сжатия с помощью директивы 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

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

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

    /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"
    }

Tip: Для исключения из листинга скрытых файлов используется директива 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 сервере
- рассоединение

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

Tip: Для создания файлов htpasswd и htdigest Вы можете воспользоваться утилитами, идущими в составе пакета apache или установить apache-toolsAUR из 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.

Tip: Тоже самое Вы можете проделать через 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 для утсановки.

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

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

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

Tip: Вместо директивы 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" )
       }
    }

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

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

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

Tip: Вместо директивы 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" )
    }

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

#### Вариант 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» (рус.)

Categories:

- Русский
- Networking (Русский)