Книга: Linux-сервер своими руками

12.6. Пример файла httpd.conf

12.6. Пример файла httpd.conf

В этом разделе приведен пример стандартной конфигурации сервера Apache (см. листинг 12.13). К каждому блоку листинга сопутствуют комментарии на русском языке, которые помогут вам разобраться с различными опциями сервера. 

##
## httpd.conf — файл конфигурации сервера HTTP Apache
##
#----------------------------------------------------------------
# Установите имя сервера
ServerName www.dhsilabs.com
ResourceConfig /dev/null
AccessConfig /dev/null
# Поддержка динамических разделяемых объектов
# (Dynamic Shared Object – DSO)
# Для более подробной информации о DSO прочтите файл README.DSO,
# входящий в дистрибутив Apache.
# Модуль расширяет возможности сервера Apache,
# добавляет в его состав новые функции.
# Подключить модуль можно так:
# LoadModule foo_module libexec/mod_foo.so
# Вы можете найти документацию по модулями в файле
# "/var/www/manual/mod"
#LoadModule mmap_static_module modules/mod_mmap_static.so
LoadModule env_module modules/mod_env.so
### The first module activates buffered logs.
# Первый модуль обеспечивает протоколирование.
# Он запишет информацию в протокол, когда буфер объемом 4К
# переполнится. Используется файл журнала access_log
#LoadModule config_buffered_log_module modules/mod_log_config_buffered.so
LoadModule config_log_module modules/mod_log_config.so
LoadModule agent_log_module modules/mod_log_agent.so
LoadModule referer_log_module modules/mod_log_referer.so
#LoadModule mime_magic_module modules/mod_mime_magic.so
LoadModule mime_module modules/mod_mime.so
LoadModule negotiation_module modules/mod_negotiation.so
LoadModule status_module modules/mod_status.so
LoadModule info_module modules/mod_infо.so
# Вы должны выбрать директиву mod_include или mod_include_xssi,
# но не обе одновременно! Директива mod_include более безопасна,
# но xxsi содержит больше функций.
LoadModule includes_module modules/mod_include.so
#LoadModule includes_module modules/mod_include_xssi.so
LoadModule autoindex_module modules/mod_autoindex.so
LoadModule dir_module modules/mod_dir.so
LoadModule cgi_module modules/mod_cgi.so
LoadModule asis_module modules/mod_asis.so
LoadModule imap_module modules/mod_imap.so
LoadModule action_module modules/mod_actions.so
#LoadModule speling_module modules/mod_speling.so
LoadModule userdir_module modules/mod_userdir.so
LoadModule proxy_module modules/libproxy.so
LoadModule alias_module modules/modalias.so
# Модуль mod_jserv должен быть объявлен до mod_rewrite,
<IfDefine HAVE_JSERV>
LoadModule jserv_module modules/mod_jserv.so
</IfDefine>
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule access_module modules/mod_access.so
LoadModule auth_module modules/mod_auth.so
LoadModule anon_auth_module modules/mod_auth_anon.so
#LoadModule dbm_auth_module modules/mod_auth_dbm.so
#LoadModule db_auth_raodule modules/mod_auth_db.so
LoadModule digest_module modules/mod_digest.so
#LoadModule cern_meta_module modules/mod_cern_meta. so
LoadModule expires_module modules/mod_expires.so
LoadModule headers_module modules/mod_headers.so
LoadModule usertrack_module modules/mod_usertrack.so
#LoadModule example_module modules/mod_example.so
#LoadModule unique_id_module modules/mod_unique_id.so
LoadModule setenvif_module modules/mod_setenvif.so
# В полном списке модулей должны быть перечислены все доступные
# модули (статических или общедоступных), чтобы достичь
# правильного порядка выполнения.
ClearModuleList
#AddModule mod_mmap_static.с
# AddModule mod_php.c
# AddModule mod_php3.c
#AddModule mod_php4.с
#AddModule mod_perl.c
# LoadModule php_module modules/mod_php.so
# LoadModule php3_module modules/mod_php4.so
#LoadModule php4_module modules/mod_php4.so
AddModule mod_env.c
AddModule mod_log_config.с
#AddModule mod_log_config_buffered.с
AddModule mod_log_agent.с
AddModule mod_log_referer.с
#AddModule mod_mime_magic.с
AddModule mod_mime.с
AddModule mod_negotiation.с
AddModule mod_status.с
AddModule mod_info.c
AddModule modinclude.c
#AddModule mod_include_xssi.с
AddModule mod_autoindex.с
AddModule mod_dir.c
AddModule mod_cgi.с
AddModule mod_asis.c
AddModule mod_imap.c
AddModule mod_actions.с
#AddModule mod_speling.с
AddModule mod_userdir.с
AddModule mod_proxy.c
AddModule mod_alias.c
# Модуль mod_jserv должен быть объявлен до mod_rewrite.
<IfDefine HAVE_JSERV>
AddModule mod_jserv.c
</IfDefine>
AddModule mod_rewrite.с
AddModule mod_access.с
AddModule mod_auth.c
AddModule mod_auth_anon.с
#AddModule raod_auth_dbm.с
#AddModule mod_auth_db.с
AddModule mod_digest.c
#AddModule mod_cern_meta.с
AddModule mod_expires.с
AddModule mod_headers.с
AddModule mod_usertrack.с
#AddModule mod_example.с
#AddModule mod_unique_id.с
AddModule mod_so.c
AddModule mod_setenvif.c
#-------------– Name Space and Server Settings -----------------
# Настройки пространства имен и сервера
# В этом разделе вы определяете, какие имена будут видеть
# пользователи вашего HTTP-сервера. Этот файл также определяет
# настройки сервера, которые раньше содержались в отдельном файле
# srm.conf. Теперь этот файл входит в состав httpd.conf.
# Директива DocumentRoot определяет местонахождение
# корневого каталога документов вашего сервера.
DocumentRoot /var/www/html
# Директива UserDir задает названия подкаталога в домашнем
# каталоге пользователя, из которого берутся документы
# в том случае, если вы активизируете возможность использования
# пользовательских каталогов.
UserDir public_html
# Директива DirectoryIndex позволяет задать название документа,
# который будет возвращен по запросу, который не содержит имя документа.
DirectoryIndex index.html index.php index.htm index.shtml index.cgi Default.htm default.htm index.php3
# Директива FancyIndexing определяет оформление каталога –
# стандартное или индексируемое.
FancyIndexing on
# Директивы AddIcon* указывают серверу, какие пиктограммы
# использовать для показа различных типов файлов
AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip
AddIconByType (TXT,/icons/text.gif) text/*
AddIconByType (IMG,/icons/image2.gif) image/*
AddIconByType (SND,/icons/sound2.gif) audio/*
AddIconByType (VID,/icons/movie.gif) video/*
AddIcon /icons/binary.gif .bin .exe
AddIcon /icons/binhex.gif .hqx
AddIcon /icons/tar.gif .tar
AddIcon /icons/world2.gif .wrl .wrl.gz .vrml .vrm .iv
AddIcon /icons/compressed.gif . Z . z .tgz .gz .zip
AddIcon /icons/a.gif .ps .ai .eps
AddIcon /icons/layout.gif .html .shtml .htm .pdf
AddIcon /icons/text.gif .txt
AddIcon /icons/c.gif .c
AddIcon /icons/p.gif .pi .py
AddIcon /icons/f.gif .for
AddIcon /icons/dvi.gif .dvi
AddIcon /icons/uuencoded.gif .uu
AddIcon /icons/script.gif .conf . sh .shar .csh .ksh .tcl
AddIcon /icons/tex.gif .tex
AddIcon /icons/bomb.gif core
AddIcon /icons/back.gif ..
AddIcon /icons/hand.right.gif README
AddIcon /icons/folder.gif ^^DIRECTORY^^
AddIcon /icons/blank.gif ^^BLANKICON^^
# Директива DefaultIcon определяет пиктограмму по умолчанию.
DefaultIcon /icons/unknown.gif
# Директива AddDescription задает описание файла
# Формат: AddDescription "описание" filename
# Директива ReadmeName определяет имя файла README по умолчанию
Формат: ReadmeName name
ReadmeName README HeaderName HEADER
# Директива IndexIgnore определяет набор файлов, которые
# будут проигнорированы при индексировании
# Формат: IndexIgnore name1 name2…
IndexIgnore . ??* *~ *# HEADER* README* RCS
# Директива AccessFileName определяет имя файла, содержащего
# директивы управления доступом
AccessFileName .htaccess
#  Директива TypesConfig задает местонахождение файла mime.types
TypesConfig /etс/httpd/conf/apache-mime.types
# С помощью директивы DefaultType можно указать MIME-тип по умолчанию ,
# для документов, тип которых сервер определить не может
DefaultType text/plain
# Директива AddEncoding разрешает вашему браузеру распаковывать
# информацию "на лету"
AddEncoding x-compress Z
AddEncoding x-gzip gz
# AddLanguage разрешает определять язык документа
AddLanguage en .en
AddLanguage fr .fr
AddLanguage de .de
AddLanguage da . da
AddLanguage el .el
AddLanguage it .it
# Директива LanguagePriority определяет приоритет языков LanguagePriority en fr de
# Директива Redirect позволяет перенаправить клиента на другой URL
# Вы можете перенаправить клиента на другой url или же url,
# который находится в вашем пространстве имен, то есть на любой
# документ, который находится в одном из подкаталогов каталога
# DocumentRoot. Вы не можете, например, перенаправить клиента
# к каталогу /etc, потому что он не находится в вашем
# пространстве имен.
# URL – это идентификатор ресурса, поэтому вы должны его
# указывать в виде протокол://адрес.домен, например,
# http://www.linux.ru. Если вы укажите просто каталог, например,
# /images, этот каталог должен быть подкаталогом каталога
# DocumentRoot, а не корневого каталога вашей основной файловой
# системы. Формат: Redirect несуществующий_url url
# С помощью директивы Alias можно предоставить доступ не только
# к файлам, находящимся в каталоге, указанном директивой
# DocumentRoot, и его подкаталогах, но и в других каталогах,
# Формат:
# Alias несуществующее_имя нормальное_имя
Alias /icons/ /var/www/icons/
# ScriptAlias определяет расположение каталога сценариев CGI
# Формат: ScriptAlias подставное_имя настоящее_имя
ScriptAlias /cgi-bin/ /var/www/cgi-bin/
ScriptAlias /protected-cgi-bin/ /var/www/protected-cgi-bin/
# С помощью директивы AddType можно добавить новый тип MIME,
# который не указан в файле apache-mime.types.
# Формат: AddType type/subtype ext1
# Обычно для модуля РНР3 (он не является частью Apache)
# директива AddType используется так:
AddType application/x-httpd-php4 .php3 .phtml .php .php4
# AddType application/x-httpd-php3-source.phps
# Для PHP/FI (PHP2) :
# AddType application/x-httpd-php.phtml
# ScriptAlias /_php/ /usr/bin/php
# Action application/x-httpd-php /usr/bin/php
# Action application/x-httpd-php3 /usr/bin/php
# Action application/x-httpd-php4
# Директива AddHandler позволяет сопоставить определенному
# типу MIME какой-нибудь обработчик.
# Формат: AddHandler action-name extl
# Для использования сценариев CGI :
AddHandler cgi-script .cgi
# Для использования генерируемых сервером файлов HTML
AddType text/html .shtml
AddHandler server-parsed .shtml
# Раскомментируйте нижерасположенную строку, чтобы включить
# функцию Apache "отправь-как-есть" (send-as-is)
#AddHandler send-as-is asis
# 
# Если вы хотите использовать карты изображений:
AddHandler imap-file map
# Для включения карт типов, используйте:
#AddHandler type-map var
# С помощью директивы Action можно определить какое-нибудь
# действие для обработчика. Например, вы можете запустить
# какую-нибудь программу для обработки файла данного типа.
# Формат: Action media/type /cgi-script/location
# Формат: Action handler-name /cgi-script/location
# Директива MetaDir определяет имя каталога, в котором сервер
# Apache может найти информационные файлы meta. Эти файлы содержат
# дополнительные заголовки HTTP, которые будут добавлены к
# документу перед его передачей клиенту.
#MetaDir .web
# Директива MetaSuffix определяет имя суффикса файла, который
# содержит meta-тэги.
#MetaSuffix .meta
# Здесь можно определить сообщения об ошибках.
# Это можно сделать тремя методами:
# 1) обыкновенный текст
# ErrorDocument 500 "The server made a boo boo.
# n.b. the (") marks it as text, it does not get output
#
# 2) локальное перенаправление
# ErrorDocument 404 /missing.html
# to redirect to local url /missing.html
# ErrorDocument 404 /cgi-bin/missing_handler .pi
# n.b. can redirect to a script or a document using server-side-includes.
#
# 3) внешнее перенаправление
# ErrorDocument 402 http://some.other_server.com/subscription_info.html
#
<Location /manual>
ErrorDocument 404 "The document you requested has not been
installed on your system. Please install the apache-manual
package.
</Location>
# Модуль mod_mime_magic позволяет серверу использовать различные
# подсказки из файла для определения его типа.
# MimeMagicFile /etc/httpd/conf/magic
# Следующие директивы необходимы для браузеров Netscape 2.x и
# Internet Explorer 4.0b2
BrowserMatch "Mozilla/2" nokeepalive
BrowserMatch "MSIE 4.0b2;" nokeepalive downgrade-1.0 force-response-1.0
# Следующие директивы отключают ответы НТТР/1.1 для браузеров,
# которые не поддерживают протокол HTTP/1.1
BrowserMatch "RealPlayer 4.0" force-response-1.0
BrowserMatch "Java/l.0" force-response-1.0
BrowserMatch "JDK/1.0" force-response-1.0
#------------------– Настройки доступа –--------------------
# В этом разделе определяются настройки сервера, которые управляют
# доступом к серверу. Раньше эти настройки находились в файле
# access.conf.
# Каждый каталог, к которому Apache может получить доступ,
# может быть сконфигурирован определенным образом. Можно
# запретить выполнение некоторых операций, доступ определенных
# пользователей или узлов сети.
# Установки доступа распространяются на весь каталог и на все его
# подкаталоги.
#  Прежде всего, конфигурируем корневой каталог для установки
#  полномочий доступа.
<Directory />
Options Indexes Includes FollowSymLinks
AllowOverride None
</Directory>
<Directory /home>
# Здесь должны быть определены директивы "Includes", "FollowSymLinks",
# "ExecCGI", "MultiViews" или любая комбинация "Indexes"
Options Indexes Includes FollowSymLinks
AllowOverride All
# Разрешает доступ всем
order allow,deny
allow from all
</Directory>
# Каталоги /var/www/cgi-bin и /var/www/protected-cgi-bin должны быть
# определены с помощью директивы ScriptAliased
<Directory /var/www/cgi-bin>
AllowOverride All
Options ExecCGI
</Directory>
<Directory /var/www/protected-cgi-bin>
order deny,allow
deny from all
allow from localhost
#allow from .your_domain.com
AllowOverride None
Options ExecCGI
</Directory>
# Разрешает отчеты о состояния сервера
<Location /server-status>
SetHandler server-status
order deny,allow
deny from all
allow from localhost, 127.0.0.1
# Установите здесь имя вашего домена
# allow from .your_domain.com
</Location>
# Разрешает доступ к файлам документации для локальной машины.
Alias /doc /usr/share/doc
<Directory /usr/share/doc>
order deny,allow
deny from all
allow from localhost, 127.0.0.1
# allow from .your_domain. com
Options Indexes FollowSymLinks
</Directory>
#-------------------– Конфигурация сервера ------------------------
# Тип сервера: inetd или standalone.
ServerType standalone
# Если вы используете тип inetd, перейдите к директиве "ServerAdmin"
# Директива Port – только для standalone-сервера.
# Если вы хотите запустить сервер Apache с использованием этого
# или любого другого порта, номер которого меньше 1024,
# вы должны обладать правами суперпользователя. Но
# даже если у вас нет таких прав, вы можете запустить сервер
# для работы с портом, номер которого превышает значение 1024.
# Обычно используется # номер 8080 или 8000.
Port 80
# Сервер Apache ведет журнал доступа других компьютеров.
# Если вы включите данную опцию, то в журнал будет записано
# доменное имя компьютера-клиента. Если эта опция выключена,
# то в журнал будет записан IP-адрес клиента. Включение данной
# опции замедляет работу сервера, так как ему требуется
# дополнительное время на ожидание ответа от сервера DNS.
HostnameLookups off
# Директивы User и Group определяют идентификаторы пользователя
# и группы.
# Данные идентификаторы присваиваются серверу, если он запущен в
# автономном режиме. Можно использовать как имена пользователей,
# так и их числовые эквиваленты – UID. По умолчанию используется
# имя пользователя nobody или apache. Из соображений безопасности
# не рекомендуется изменять это значение и присваивать имя
# реального пользователя.
User apache Group apache
# Директива ServerAdmin задает электронный адрес вебмастера вашего
# Web-узла. В случае возникновения ошибок именно по этому адресу
# будет отправлено сообщение.
ServerAdmin root@localhost
# В директиве ServerRoot указывается местонахождение файлов
# конфигурации сервера Apache.
# По умолчанию используется каталог /etc/httpd.
ServerRoot /etc/httpd
# Данная директива используется для компьютеров, которые имеют
# несколько IP-адресов. Обычно данная директива используется
# для конфигурирования виртуальных хостов.
# BindAddress *
# Прослушивать порт 80
Listen 80
# Директивы ErrorLog и TransferLog определяют расположение
# журналов сервера Apache. Обычно используется каталог
# /etc/httpd/logs, который является ссылкой на каталог
# /var/log/httpd или на любой другой.
ErrorLog logs/error_log
# LogLevel: устанавливает уровень протоколирования.
# Протоколируются предупреждающие сообщения сервера (warn)
# и ошибки. Если вы хотите протоколировать только ошибки,
# установите error
LogLevel warn
# Определяет формат файлов протокола, то есть информация,
# которая будет протоколироваться. Обычно их не нужно изменять.
LogFormat "%h %1 %u %t "%r" %>s %b "%{Referer}i" "%{UserAgent}i"" combined
LogFormat "%h %1 %u %t "%r" %>s %b" common
LogFormat "%(Referer}i –> %U" referer
LogFormat "%{User-agent}i" agent
# Можно определить тип протокола
# Если вы хотите протоколировать общую информацию
# CustomLog logs/access_log common
# Если вы хотите протоколировать referer
# CustomLog logs/referer_log referer
# Если вы хотите протоколировать название пользовательских
# агентов (браузеров)
# CustomLog logs/agent_log agent
# По умолчанию используется комбинированный тип протоколирования,
# то есть будет протоколироваться вся информация
CustomLog logs/access_log combined
# С помощью директивы PidFile указывается имя файла,
# в котором исходный процесс сервера будет регистрироваться.
PidFile /var/run/httpd.pid
# ScoreBoardFile: Этот файл используется для сохранения внутренней
# информации процесса сервера.
ScoreBoardFile /etc/httpd/httpd.Scoreboard
# Директива LockFile определяет файл блокировки, который
# используется сервером. Сервер должен быть скомпилирован с опцией
# USE_FCNTL_SERIALIZED_ACCEPT или
# USE_FLOCK_SERIALIZED_ACCEPT. Файл блокировки должен быть
# сохранен НА ЛОКАЛЬНОМ ДИСКЕ.
#
LockFile /etc/ittpd/httpd.lock
# Директива ServerName позволяет вам установить имя узла вашего
# сервера, которое будет использоваться клиентами,
# то есть установить "www" вместо реального имени сервера.
# Имя, которое вы укажете, должно быть указано в сервере DNS
# вашего домена.
ServerName new.host.name
# Директива UseCanonicalName появилась в версии Apache 1.3.
# Она разрешает использовать каноническое имя для сервера узла.
UseCanonicalName on
# Данная директива позволяет прокси-серверу, например SQUID,
# не кэшировать документы, которые не генерируются автоматически,
# то есть в процессе выполнения различных сценариев.
CacheNegotiatedDocs
# Директива Timeout задает промежуток времени в секундах,
# в течение которого сервер продолжает попытки возобновления
# приостановленной передачи данных. Значение директивы Timeout
# распространяется не только на передачу, но и на прием данных.
Timeout 300
# Директива KeepAlive разрешает постоянные соединения,
# то есть такие соединения, в которых производится более
# одного запроса за один раз.
KeepAlive off
# MaxKeepAliveRequests: Максимальное количество запросов,
# разрешенное в течение постоянного соединения. Установите 0
# для снятия ограничения. Для повышения производительности
# рекомендуется установить это число сравнительно большим.
MaxKeepAliveRequests 100
# Директива KeepAliveTimeout определяет тайм-аут для постоянного
# соединения.
KeepAliveTimeout 15
# Минимальное и максимальное число серверов в пуле
MinSpareServers 8
MaxSpareServers 20
# Количество серверов для запуска StartServers 10
# Ограничивает общее количество клиентов. Когда это число будет
# превышено, новые клиенты получат отказ, поэтому это число
# не должно быть слишком маленьким.
MaxClients 150
# После обработки определенного количества запросов, указанного
# в директиве MaxRequestsPerChild, копия сервера завершается,
# а вместо нее запускается новая.
MaxRequestsPerChild 500
# Директивы конфигурации прокси-сервера
# ProxyRequests On
# Для включения кэширования, раскомментируйте строки ниже:
# CacheRoot /var/cache/httpd
# CacheSize 5
# CacheGcInterval 4
# CacheMaxExpire 24
# CacheLastModifiedFactor 0.1
# CacheDefaultExpire 1
# NoCache a_domain.com another_domain.edu joes.garage_sale.com
####################################
# Настройки производительности SGI #
####################################
#
#
#  Для использования этой функции, раскомментируйте модуль
#  mod_mmap_static в разделе описания модулей.
<IfModule mod_mmap_static.c>
QSC on
</IfModule>
# Если вы хотите использовать буферизованное протоколирование,
# раскомментируйте модуль mod_log_config_buffered в разделе
# описания модулей.
# Для использования карты памяти, раскомментируйте эту строку:
# mmapfile /var/www/html/file_to_map_in_memory
#
# Если вы хотите настроить процессы потомки, пожалуйста,
# прочитайте документацию на вашем сервере
# http://localhost/manual/misс/perf-mja.html.
# Эта страница объясняет как привязать определенный IP-адрес
# или порт к другому процессору.
# SingleListen On
#######################
# Виртуальные серверы #
#######################
#
# Поддержка модуля perl
# Замечание: не удаляйте расположенные далее строки, иначе это может
# разрушить вашу конфигурацию.
<IfDefine PERLPROXIED>
ProxyPass /perl/ http://127.0.0.1:8200/
ProxyPassReverse /perl/ http://127.0.0.1:8200/
</IfDefine>
#  Файл, в котором находятся директивы конфигурирования
#  виртуальных узлов.
Include conf/vhosts/Vhosts.conf
#
#
# Для поддержки динамических виртуальных хостов и виртуальных
# домашних каталогов, раскомментируйте следующие строки:
# LoadModule vhost_alias_module modules/mod_vhost_alias.so
# AddModule mod_vhost_alias.c
# Include conf/vhosts/DynamicVhosts.conf
# Include conf/vhosts/VirtualHomePages.conf
# Директивы конфигурирования PHP
Include conf/addon-modules/php.conf

Оглавление книги