Apache: Модуль Apache mod

RU EN

Пункт 208. Модуль Apache mod_userdir

Этот модуль позволяет получить доступ к пользовательским каталогам с использованием http://example.com/~user/ синтаксиса.

Директива UserDir

Описание:	Расположение пользовательских каталогов
Синтаксис:	`UserDir directory-filename [directory-filename] ...`
Контекст:	конфигурация сервера, виртуальный хост
Положение дел:	База
Модуль:	mod_userdir

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

Имя каталога или шаблон, как показано ниже.
Ключевое слово disabled . Это отключает все преобразования имени пользователя в каталог, кроме тех, которые явно названы ключевым enabled словом (см. ниже).
Ключевое слово disabled , за которым следует список имен пользователей, разделенных пробелами. Для имен пользователей, которые появляются в таком списке, никогда не будет выполняться преобразование каталогов, даже если они появляются в enabled предложении.
Ключевое слово enabled , за которым следует список имен пользователей, разделенных пробелами. Для этих имен пользователей будет выполняться преобразование каталогов, даже если действует глобальное отключение, но не в том случае, если они также появляются в предложении disabled .

Если ни the, enabled ни disabled ключевые слова не появляются в Userdir директиве, аргумент рассматривается как шаблон имени файла и используется для преобразования имени в спецификацию каталога. Запрос на http://www.example.com/~bob/one/two.html будет переведен на:

Используется директива UserDir	Переведенный путь
Пользовательский каталог public_html	~боб/public_html/один/два.html
Каталог пользователя /usr/web	/usr/веб/боб/один/два.html
Каталог пользователя /home/*/www	/home/bob/www/one/two.html

Следующие директивы будут отправлять перенаправления клиенту:

Используется директива UserDir	Переведенный путь
Каталог пользователя http://www.example.com/users	http://www.example.com/users/bob/one/two.html
Каталог пользователя http://www.example.com/*/usr	http://www.example.com/bob/usr/one/two.html
Каталог пользователя http://www.example.com/~*/	http://www.example.com/~bob/one/two.html

Будьте осторожны при использовании этой директивы; например, "UserDir ./" будет отображаться "/~root" на "/" - что, вероятно, нежелательно. Настоятельно рекомендуется, чтобы ваша конфигурация включала UserDir disabled root объявление " ". См. также Directory директиву и страницу «Советы по безопасности» для получения дополнительной информации.

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

Чтобы разрешить нескольким пользователям иметь UserDir каталоги, но не всем остальным, используйте следующее:

 UserDir отключен
UserDir включен user1 user2 user3

Чтобы разрешить большинству пользователей иметь UserDir каталоги, но запретить это некоторым, используйте следующее:

 UserDir отключен пользователь4 пользователь5 пользователь6

Также можно указать альтернативные каталоги пользователей. Если вы используете команду типа:

 UserDir "public_html" "/usr/web" "http://www.example.com/"

С запросом на http://www.example.com/~bob/one/two.html , сначала попытается найти страницу ~bob/public_html/one/two.html , затем /usr/web/bob/one/two.html , и, наконец, отправит редирект на http://www.example.com/bob/one/two.html .

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

Подстановка пользовательского каталога не активна по умолчанию в версиях 2.1.4 и более поздних. В более ранних версиях UserDir public_html предполагалось, что UserDir директива отсутствует.

Объединение деталей

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

Смотрите также

Учебник по пользовательским веб-каталогам