22.6. Обращение к локальному руководству Apache

Проблема

Разработчики Apache тщательно подготовили документацию для пользователей. Полная версия руководства находится по адресу http://httpd.apache.org/docs-2.0/. Однако, чтобы изучать руководство без постоянного подключения к интернету и с более быстрой загрузкой страниц, полезно иметь локальную копию документации.

Решение

Если вы установили Apache, скомпилировав его из исходных текстов, документация обычно автоматически сохраняется в каталоге, указанном в параметре --datadir. В случае настройки, описанной в Раздел 22.2, это будет каталог /var/www/httpd/manual. Чтобы просматривать страницы напрямую из этого каталога, откройте соответствующий HTML-файл с помощью браузера, однако учтите, что гиперссылки внутри документации могут не работать корректно без веб-сервера.

Более удобный способ — запустить локальный веб-сервер Apache и обращаться к руководству через браузер. Чтобы настроить доступ к документации на локальном сервере, выполните следующие шаги:

1. Запустите Apache, если он ещё не запущен:
   # apachectl start

2. Откройте браузер и введите следующий адрес:
   http://localhost/manual/

Теперь документация Apache будет доступна в интерактивном режиме. Вы сможете переходить по гиперссылкам и изучать все материалы без необходимости подключения к интернету.

Комментарий

Если Apache был установлен из предустановленных пакетов, например, через менеджеры пакетов в дистрибутивах Linux, документация может не быть включена в основную установку и потребует установки дополнительного пакета. Для систем на базе Debian или Ubuntu пакет называется apache2-doc. Установите его с помощью следующей команды:

# apt-get install apache2-doc

Для систем на базе RPM, таких как Red Hat и CentOS, установите пакет httpd-manual (или apache2-manual в некоторых дистрибутивах):

# yum install httpd-manual

После установки документации через пакетный менеджер она будет автоматически доступна по адресу http://localhost/manual/, если Apache запущен. Убедитесь, что конфигурация веб-сервера позволяет доступ к этой директории.

Дополнительные советы и рекомендации по документации Apache

Если вы хотите сделать документацию доступной для других пользователей в локальной сети, настройте Apache для доступа к каталогу /manual с внешних IP-адресов, например, добавив следующие директивы в конфигурационный файл httpd.conf:

<Directory "/var/www/httpd/manual">
    Options Indexes FollowSymLinks
    AllowOverride None
    Require ip 192.168.1.0/24
</Directory>

Эта настройка разрешит доступ к руководству Apache для всех устройств, находящихся в сети с IP-адресами 192.168.1.0/24. Замените диапазон на тот, который соответствует вашей локальной сети.

Часто задаваемые вопросы по локальной документации Apache

См. также

Документация Apache 2.0