Настройки apache: Как установить и настроить веб-сервер Apache

08.07.2023 alexxlab

Содержание

Главный файл настроек Apache. httpd.conf.

Для того, чтобы мы могли что-то сделать с веб-сервером Apache, потестировать его работу, что-то настроить, что-то изменить и.т.д. нам нужно обратиться к файлу его настроек.

Поэтому, давайте сейчас разберемся с таким вопросом, где в веб-сервере Apache находится файл настроек. Где мы можем что-то поменять, что-то настроить, посмотреть как настроен какой-то момент и.т.д.

Apache — это веб-сервер, который не имеет графического интерфейса. При его установке и запуске нам нечего переключать, негде покликать. У нас нет никаких графических элементов, с которыми мы могли бы повзаимодействовать.

Веб-сервер Apache управляется через командную строку или терминал операционной системы. А все настройки, которые мы можем устанавливать, хранятся в обычном текстовом файле, который называется httpd. conf.

Это самый главный настроечный файл в Apache (есть и другие настроечные файлы).

Самое главное, что нужно сейчас понять, что это обычный текстовый файл, который мы можем, соответственно, править в любом текстовом редакторе.

Где же найти этот файл?

Есть несколько вариантов, как это можно сделать.

Один из вариантов обратиться по этому адресу:

https://wiki.apache.org/httpd/DistrosDefaultLayout

Это страница, на которой приводятся различные операционные системы. В зависимости от того, какая у вас на компьютере операционная система, файл httpd.conf может находится в разных местах.

Можете перейти по ссылке, которая соответствует вашей операционной системе и посмотрите на путь, где находится файл httpd.conf.

Другой способ узнать положение файла httpd.conf — это воспользоваться вот такой командой, которую нужно ввести в командную строку в вашей операционной системе:

httpd -V

В результатах выполнения этой команды самым последним параметром вы можете увидеть положение файла httpd. conf.

Файл httpd.conf — это обычный текстовый файл и мы можем его открыть и редактировать в любом текстовом редакторе или консольном текстовом редакторе.

В этом файле довольно много настроек, но не пугайтесь, последовательно, с основными из них мы познакомимся.

И один важный момент.

Какие бы изменения вы не произвели в файле httpd.conf эти изменения будут вступать в силу только после перезагрузки сервера. Т.е. вы что-то поменяли в этом файле, эти изменения не будут работать до тех пор, пока вы не перезагрузите веб-сервер.

Имейте в виду этот момент.

Теперь, главная задача, которая стоит после этого урока, найти файл httpd.conf на вашем компьютере, открыть его и в дальнейшем мы с ним будем работать.

Документация ISPmanager 5 Lite : Конфигурация web сервера

Информация о настройках web домена хранится во внутренней базе ISPmanager. Т.е. никакие изменения, вносимые в конфиги вручную, не влияют на состояние, отображаемое в панели, и могут быть потеряны при изменении параметров из панели, если настройки, сделанные вручную, и настройки, сделанные из панели, конфликтуют. Тем не менее вы можете вносить изменения в конфигурацию сервера вручную. Эти изменения будут сохранены при редактировании домена, если это возможно.
Все настройки отдельного web домена находятся в отдельном файле. Файлы раскладываются по каталогам по имени владельца домена
Настройки доступа к каталогам (diraccess) записываются в конфиг web сервера, в тот же файл что и настройки соответствующего web домена (раньше для этого использовался .htaccess)
PHP может работать как через apache, так и через nginx (используется php-fpm). В связи с тем, что появилась возможность пользоваться php, не используя apache, при совместном использовании apache и nginx сервер apache может быть не запущен, если запрос может быть обработан средствами nginx.
Появилась возможность использовать несколько IP адресов для web домена
При включении SSL в настройках nginx создается отдельная секция server
Для ротации журналов запросов и ошибок используется logrotate

Настройка web-сервера

Следующая группа параметров используется вне зависимости от того, какой web сервер вы используете

path php-cgi

Путь до исполняемого файла php-cgi

WebDefaultAliases

Набор дополнительных имен, которые будут предложены автоматически при создании web домена. Вы можете использовать макрос _name_, чтобы подставить в строку основное имя домена

BackendBind

Адрес, на котором будет поднят backend (web сервер, на который будет передавать запросы frontend сервер). При одновременной установке nginx и apache backend — apache.

WebModules

Список используемых web серверов

WebUser

Имя пользователя, с правами которого работает web сервер (необходимо указывать именно имя, а не uid)

WebGroup

Группа, с правами которой работат web сервер (необходимо указывать именно имя, а не gid)

WebRestartDelay

Минимальное время, которое должно проходить между перезапусками web сервера

SSLSecureProtocols

Список протоколов, указываемых web-серверу для использования в случае, если используется повышенная безопасность SSL (например, SSLSecureProtocols TLSv1 TLSv1.1 TLSv1.2)

SSLSecureChiphers

Список шифров в формате openssl, указываемых web-серверу для использования в случае, если используется повышенная безопасность SSL (например, SSLSecureChiphers HIGH:!RC4:!aNULL:!eNULL:!MD5:!EXPORT:!EXP:!LOW:!SEED:!CAMELLIA:!IDEA:!PSK:!SRP:!SSLv2)

ApsExtRepository

Путь до xml-файла внешнего репозитория APS

Option ApsRepositoryUpdated

Наличие этой опции указывает, что при старте панели управления не нужно выполнять обновления списка APS-скриптов

Option DisableSecurePhpBin

Наличие этой опции отключает создание защищенной директории php-bin (DefaultHomeDir/php-bin/username) для пользователя и создание хардлинок для php и php. ini из домашней директории пользователя в защищенную директорию (применяется в режимах работы php как CGI или FastCGI (Apache)). Вместо этого php и php.ini будут создаваться в директории php-bin пользователя

Список доступных кодировок web домена берется из файла etc/charset. По умолчанию в нем указана только utf-8.

Настройка Apache

Во время запуска панели происходит опрос загруженных модулей apache. Так мы определяем список возможных настроек

cgi_module

возможность работы с CGI скриптами

fastcgi_module или fcgid_module

возможность работы с php в режиме fastcgi

php5_module

возможность работы c php через модуль apache

Если есть поддержка CGI и найден файл, указанный в path php-cgi, появляется возможность работы с php в режиме CGI

Далее приведен список параметров, используемых для настройки панели под конкретную конфигурацию apache.

Option ApacheITK

Добавляется, если используется apache ITK. При этом в конфиг вместо директивы SuexecUserGroup пишется AssignUserID

path apachectl

Путь до программы/скрипта, используемого для перезапуска apache. Должен уметь обрабатывать следующие параметры: -M (получить список модулей), graceful (мягкая перезагрузка), restart (жесткая перезагрузка, используется при добавлении/удалении IP адресов)

path apache-vhosts

Имя каталога, в котором будут создаваться файлы с настройками web доменов

path apache.conf

Путь до основного файла конфигурации apache. В него будут записываться директивы Listen и NameVirtualHost

ApacheWidePorts

Для указанных портов в apache будет добавляется Listen для всех IP адресов сервера. По умолчанию: 80 443. Это позволяет уменьшить количество жестких перезапусков apache.

Настройка Nginx

Во время запуска панели проверяется наличие сервиса php-fpm. Если он найден, будет доступно использовать в настройках web доменов php в режиме fastcgi.

Далее приведен список параметров, используемых для настройки панели под конкретную конфигурацию nginx.

path nginx-vhosts

Имя каталога, в котором будут создаваться файлы с настройками web доменов

path nginx-vhosts-includes

Пути до файлов с дополнительными настройками, которые будут добавлены в секцию server каждого web домена (используется директива Include)

path fpm-pool.d

Имя каталога, в котором будут создаваться файлы с настройками php-fpm

path fpm-service

Имя сервиса php-fpm. Используется для его перезапуска при добавлении новых пользователей.

path nginx-static

Используется для определения файлов, которые nginx должен отдавать самостоятельно.

path nginxctl

Используется для перезапуска nginx при добавлении новых web доменов. Должна обрабатывать параметры: reload (перечитать настройки web доменов), restart (перезапустить nginx, используется при добавлении/удалении IP адресов), stop/start (запустить nginx, используется при конвертации настроек в случае добавления/удаления web сервера)

path nginx-configtest

Используется для проверки корректности содержимого конфигурационных файлов Nginx. .+\.(jpg|jpeg|gif|png|svg|js|css|mp3|ogg|mpe?g|avi|zip|gz|bz2?|rar|swf)$ { try_files $uri $uri/ @fallback; }

ForwardedSecret

В случае, если вы переправляете запросы из nginx в панель, мы определяем обратный адрес по HTTP заголовку X-Forwarded-For. Злоумышленник получает возможность подменить обратный адрес, используя этот заголовок, что, в свою очередь, позволяет ему воспользоваться чужими COOKIE для выполнения запросов от имени другого пользователя. Панель игнорирует заголовок X-Forwarded-For, если запрос не содержит заголовка X-Forwarded-Secret с таким же значением, как то, что записано в конфиге.

Перезапуск web сервера

Попытка перезапуска web сервера происходит через 2 секунды после последнего изменения настроек. Если в течение этого времени происходят другие изменения, то перезапуск будет отложен еще на 2 секунды. Дополнительно вы можете задать параметр WebRestartDelay — минимальную задержку между последовательными перезапусками web сервера.

В случае, если изменения не затрагивали списка прослушиваемых IP адресов/портов, делается мягкая перезагрузка web сервера, в противном случае сервер перезапускается полностью.

Шаблоны конфигурационных файлов web-сервера

Начиная с версии 5.64 конфигурация web-сервера осуществляется с помощью нового механизма, описанного в статье Шаблонизатор конфигурационных файлов .

Данный раздел относится только к панелям управления, установленных ранее выхода версии 5.64 или не имеющих параметра Option EnableWebTemplate в конфигурационном файле

Для того, чтобы администратор сервера мог влиять на формирование конфигурационных файлов web-сервера для конкретного web-домена, реализованы шаблоны конфигурационных файлов, создаваемых ISPmanager 5.

Шаблоны не переопределяют тех настоек, что производит ISPmanager, а лишь позволяют добавлять дополнительные строки.

Файлы шаблонов находятся:

etc/templates/apache-vhost.template — шаблон файла конфигурации web-домена для web-сервера Apache
etc/templates/nginx-vhost.template — шаблон файла конфигурации web-домена для web-сервера Nginx

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

Макросы имеют вид: __{ИМЯ_ПАРАМЕТРА}__, имена параметров всегда полностью в верхнем регистре

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

Примеры макросов для параметров сессии:

_NAME_ — имя web-домена
_OWNER_ — имя пользователя-владельца web-домена
_ALIASES_ — список псевдонимов web-домена
_EMAIL_ — email администратора web-домена
_DIRINDEX_ — список индексных страниц web-домена
_CHARSET_ — кодировка страниц web-домена по умолчанию

Дополнительные макросы:

_HOSTNAME_ — доменное имя сервера, на котором установлена панель управления
_LISTEN_ON_ — список пар типа IP-адрес:порт, используемых web-доменом

Пример

Чтобы добавить в location / сервера строки, составим следующий шаблон

server {	
  server_name __NAME__ __ALIASES__;        
  location / {        
  try_files $uri $uri/ /index. php?$args;        
  rewrite /wp-admin$ $scheme://$host$uri/ permanent; 
  }  
}

Обратите внимание, строка server_name _NAME_ _ALIASES_; должна обязательно присутствовать в шаблоне, иначе ISPmanager не определит в какой server добавить данные и добавить еще один server в конец файла.

Ротация журналов

Все журналы web сервера записываются в каталог httpd-logs, недоступный пользователям. В домашнем каталоге пользователя создается каталог logs куда создаются жесткие ссылки на журналы посещений и ошибок web доменов пользователя. Кроме того, в каталог logs сохраняются старые копии журналов после ротации.

ISPmanager 5 использует logrotate для ротации журналов web сервера.

path logrotate.d

Указывает каталог, куда будут сохраняться настройки logrotate (отдельные файлы для каждого web домена)

LogrotateInfiniteValue

Указывает количество хранимых архивов, если в панели указано бесконечное значение

Анализаторы журналов

Теоретически, ISPmanager может работать с любыми анализаторами журналов.

На данный момент через интерфейс могут быть установлены:

awstats
webalizer

path analyzer.d

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

При установке анализатора журналов в конфиг панели записывается следующая секция:

Analyzer awstats {
  ConfPath /etc/awstats/awstats.__NAME__.conf
  BinPath /usr/lib/cgi-bin/awstats.pl
  Lang en
  Lang ru
}

ConfPath

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

BinPath

указывает путь до исполняемого файла

Lang

указывает поддерживаемые языки. Секция Analyzer может содержать любое количество таких строк

При включении анализатора журналов из каталога etc/template берется соответствующий шаблон скрипта (имя файла совпадает с именем анализатора). В нем происходит подстановка всех макросов (список макросов можно узнать, включив дебаг для модуля web) и копируется в каталог analyzer. d. Дополнительно формируется конфиг. Из etc/template берется соответствующий файл с расширением .conf, в нем так же заменяются все макросы и он сохраняется в файл, имя которого указано в

ConfPath (вместо _NAME_ подставляется имя web домена).

Полученный скрипт вызывается всякий раз при ротации журнала через logrotate. Если вы задали периодический анализ, вызов этого скрипта будет добавлен в планировщик.

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

AwstatsEncoding — кодировка генерируемых awstats html-страниц отчетов
WebalizerEncoding — кодировка генерируемых webalizer html-страниц отчетов

По умолчанию данные параметры имеют значение «utf-8»

Переконфигурирование web-сервера

В процессе эксплуатации web-сервера и панели управления может возникнуть ситуация, когда нужно произвести полную переконфигурацию web-сервера.

При этом действии конфигурационные файлы всех созданных с помощью панели управления web-доменов будут созданы заново.

Внимание! Данное действие не сохранит изменения в конфигурационных файлах, внесенные вручную!

Для выполнения операции последовательно нужно выполнить следующие функции:

webreconfigure.initialize с параметром shutdown=on
webreconfigure.restore

Пример выполнения с помощью mgrctl для ISPmanager Lite:

/usr/local/mgr5/sbin/mgrctl -m ispmgr webreconfigure.initialize shutdown=on
/usr/local/mgr5/sbin/mgrctl -m ispmgr webreconfigure.restore

Файлы конфигурации — Apache HTTP Server версии 2.4

Apache HTTP Server версии 2.4

Apache > HTTP-сервер > Документация > Версия 2.4

Доступные языки: de | ru | фр | я | ко | tr

В этом документе описываются файлы, используемые для настройки Apache HTTP Сервер.

Основные файлы конфигурации
Синтаксис файлов конфигурации
Модули
Область применения директив
Файлы . htaccess

См. также

Комментарии

HTTP-сервер Apache настраивается путем помещения директив в обычный текст файлы конфигурации. Основной файл конфигурации обычно называется httpd.conf . Расположение этого файла установлено в время компиляции, но может быть переопределен с помощью -f флаг командной строки. Кроме того, могут быть другие файлы конфигурации. добавлено с помощью Включить директивы, а подстановочные знаки могут использоваться для включения многих конфигураций. файлы. Любая директива может быть помещена в любую из этих конфигураций. файлы. Изменения в основные файлы конфигурации вносятся только распознается httpd при его запуске или перезапуске.

Сервер также считывает файл, содержащий типы MIME-документов; имя файла задается директивой TypesConfig , и mime.types по умолчанию.

Файлы конфигурации httpd содержат по одной директиве в строке. Обратная косая черта «\» может использоваться как последний символ в строке. чтобы указать, что директива продолжается на следующей строке. Между ними не должно быть других символов или пробелов. обратную косую черту и конец строки.

Аргументы директив разделяются пробелом. Если аргумент содержит пробелы, вы должны заключить этот аргумент в кавычки.

Директивы в файлах конфигурации нечувствительны к регистру, но аргументы директив часто чувствительны к регистру. Линии которые начинаются с символа решетки «#», считаются комментарии и игнорируются. Комментарии могут быть , а не . включается в ту же строку, что и директива конфигурации. Пробел перед директивой игнорируется, поэтому вы можете сделать отступ директив для ясности. Пустые строки также игнорируются.

Значения переменных, определенных с помощью Define или переменных среды оболочки, могут использоваться в строках файла конфигурации с использованием синтаксиса

${VAR} .

Если «VAR» является именем допустимой переменной, значение этой переменной равно подставляется в это место в строке конфигурационного файла, и обработка продолжается, как если бы этот текст был найден непосредственно в файле конфигурации. Переменные, определенные с помощью Define take приоритет над переменными среды оболочки. Если переменная «VAR» не найдена, символы ${VAR} остаются без изменений, и записывается предупреждение. Имена переменных не могут содержать двоеточия «:», чтобы избежать конфликтов с Синтаксис RewriteMap

Только переменные среды оболочки, определенные до запуска сервера можно использовать в расширениях. Переменные среды, определенные в сам файл конфигурации, например, с SetEnv , вступает в силу слишком поздно, чтобы его можно было использовать для расширения в файле конфигурации.

Максимальная длина строки в обычных конфигурационных файлах после замена переменных и соединение любых непрерывных строк примерно 16 МБ. В файлах .htaccess максимальная длина 8190 символов.

Вы можете проверить файлы конфигурации на наличие синтаксических ошибок без запуска сервера с помощью

 apachectl
 configtest

или командная строка -t вариант.

Вы можете использовать mod_info -DDUMP_CONFIG для дамп конфигурации со всеми включенными файлами и средой переменные разрешены и все комментарии и несоответствия и секций удаленный. Однако выходные данные не отражают слияние или переопределение это может произойти для повторяющихся директив.

httpd — это модульный сервер. Это означает, что только самые основные функции включены в главный сервер. Расширенный функции доступны через модули, которые можно загрузить в httpd. По умолчанию базовый набор модулей включены в сервер во время компиляции. Если сервер скомпилирован для использования динамически загружаемых модулей, то модули могут быть скомпилированы отдельно и добавлены в в любое время с помощью LoadModule директива. В противном случае httpd необходимо перекомпилировать для добавления или удаления модулей. Директивы конфигурации могут быть включены при условии наличие определенного модуля, заключив их в блок. Однако, блоков не требуется, а в некоторых случаях может маскировать тот факт, что вы пропустили важный модуль.

Чтобы увидеть, какие модули в данный момент скомпилированы на сервер, вы можете использовать параметр командной строки -l . Вы также можете посмотреть какие модули загружаются динамически с помощью -M вариант командной строки.

Директивы, размещенные в основных конфигурационных файлах, относятся к весь сервер. Если вы хотите изменить конфигурацию для только часть сервера, вы можете ограничить свои директивы поместить их в , , , , и разделы. Эти разделы ограничивают применение директивы, которые они прилагают к конкретной файловой системе местоположения или URL-адреса. Они также могут быть вложены друг в друга, что позволяет очень мелкозернистая конфигурация.

httpd может обслуживать множество различных веб-сайтов одновременно. Это называется Виртуал Хостинг. Директивы также можно ограничить, поместив их внутри <Виртуальный хост> разделы, чтобы они применялись только к запросам на конкретного веб-сайта.

Хотя большинство директив можно разместить в любом из этих разделы, некоторые директивы не имеют смысла в некоторых контекстах. Например, директивы, контролирующие создание процессов, могут только размещаться в контексте основного сервера. Чтобы узнать, какие директивы могут быть размещены в каких разделах, проверьте контекст директива. Для получения дополнительной информации мы предоставляем подробную информацию в разделах «Как каталог», «Местоположение» и «Файлы». работа.

httpd обеспечивает децентрализованное управление конфигурацией через специальные файлы, размещенные внутри веб-дерева. Специальные файлы обычно называются .htaccess , но любое имя может быть указанный в AccessFileName директива. Директивы размещены в файлах .htaccess применяются к каталогу, в который вы помещаете файл, и все подкаталоги. Файлы .htaccess следуют за тот же синтаксис, что и у основных файлов конфигурации. С Файлы .htaccess считываются при каждом запросе, изменения сделанные в этих файлах, вступают в силу немедленно.

Чтобы узнать, какие директивы можно поместить в .htaccess файлов, проверьте контекст директива. Администратор сервера далее контролирует, что директивы могут быть помещены в файлы .htaccess с помощью настройка AllowOverride в основных файлах конфигурации.

Для получения дополнительной информации о . htaccess файлы, см. руководство по .htaccess.

Обратите внимание:
Это не раздел вопросов и ответов. Комментарии, размещенные здесь, должны указывать на предложения по улучшению документации или сервера и могут быть удалены нашими модераторами, если они либо реализованы, либо считаются недействительными/не по теме. Вопросы о том, как управлять HTTP-сервером Apache, следует направлять либо на наш IRC-канал #httpd, на Libera.chat, либо в наши списки рассылки.

Файлы конфигурации — HTTP-сервер Apache

HTTP-сервер Apache версии 2.2

В этом документе описываются файлы, используемые для настройки сервера Apache. HTTP-сервер.

Основные файлы конфигурации
Синтаксис файлов конфигурации
Модули
Область применения директив
Файлы .htaccess

Apache настроен путем размещения директив в виде простого текста файлы конфигурации. Основной файл конфигурации обычно называется httpd. conf . Расположение этого файла установлено в время компиляции, но может быть переопределен с помощью -ф флаг командной строки. Кроме того, могут быть другие файлы конфигурации. добавлено с помощью Включить директивы, а подстановочные знаки могут использоваться для включения многих конфигураций. файлы. Любая директива может быть помещена в любую из этих конфигураций. файлы. Изменения в основные файлы конфигурации вносятся только распознается Apache при его запуске или перезапуске.

Сервер также считывает файл, содержащий типы MIME-документов; имя файла задается TypesConfig 9директива 0030, и mime.types по умолчанию.

Файлы конфигурации Apache содержат по одной директиве в строке. Обратная косая черта «\» может использоваться как последний символ в строке. чтобы указать, что директива продолжается на следующей строке. Между ними не должно быть других символов или пробелов. обратную косую черту и конец строки.

Директивы в файлах конфигурации нечувствительны к регистру, но аргументы директив часто чувствительны к регистру. Линии которые начинаются с символа решетки "#", считаются комментарии и игнорируются. Комментарии 9 мая0047 не быть включается в строку после директивы конфигурации. Пустые строки и пробелы перед директивой игнорируются, поэтому вы можете сделать отступ директив для ясности.

Вы можете проверить файлы конфигурации на наличие синтаксических ошибок без запуска сервера с помощью apachectl configtest или командная строка -t вариант.

Apache — это модульный сервер. Это означает, что только самые основные функции включены в главный сервер. Расширенный функции доступны через модули, которые можно загрузить в Апач. По умолчанию базовый набор модулей включены в сервер во время компиляции. Если сервер скомпилирован для использования динамически загружаемых модулей, то модули могут быть скомпилированы отдельно и добавлены в в любое время с помощью Модуль загрузки директива. В противном случае Apache необходимо перекомпилировать для добавления или удаления модулей. Директивы конфигурации могут быть включены при условии наличие определенного модуля, заключая их в блок .

Чтобы увидеть, какие модули в данный момент скомпилированы на сервер, вы можете использовать параметр командной строки -l .

Apache может обслуживать множество различных веб-сайтов одновременно. Это называется Виртуал Хостинг. Директивы также можно ограничить, поместив их внутри <Виртуальный хост> разделы, чтобы они применялись только к запросам на конкретного веб-сайта.

Apache обеспечивает децентрализованное управление конфигурацией через специальные файлы, размещенные внутри веб-дерева. Специальные файлы обычно называются .htaccess , но любое имя может быть указанный в AccessFileName директива.