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? Если документация была установлена из исходников, вам нужно заново скачать и скомпилировать последнюю версию Apache с сайта http://httpd.apache.org/. Для пользователей пакетов (Debian, RPM) обновление документации выполняется через пакетный менеджер: apt-get update apache2-doc или yum update httpd-manual.
Можно ли получить доступ к документации через HTTPS? Да, настройте Apache для поддержки HTTPS и обеспечьте доступ к каталогу /manual через защищённое соединение. Это может быть полезно, если доступ к документации требуется в сетях с ограничениями.

См. также

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