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
через защищённое соединение. Это может быть полезно, если доступ к документации требуется в сетях с ограничениями.
См. также