Apache模塊 mod_userdir · Apache 2.2 中文官方文檔

# Apache模塊 mod_userdir | [說明](#calibre_link-11) | 允許用戶從自己的主目錄中提供頁面(使用"/~username") | | --- | --- | | [狀態](#calibre_link-12) | 基本(B) | | [模塊名](#calibre_link-13) | userdir_module | | [源文件](#calibre_link-14) | mod_userdir.c | ### 概述此模塊允許使用類似`http://example.com/~user/`的語法來訪問用戶網站目錄。 ## UserDir 指令 | [說明](#calibre_link-18) | 用戶網站目錄的位置 | | --- | --- | | [語法](#calibre_link-19) | `UserDir _directory-filename_` | | [作用域](#calibre_link-20) | server config, virtual host | | [狀態](#calibre_link-21) | 基本(B) | | [模塊](#calibre_link-22) | mod_userdir | `UserDir`指令指定了用戶目錄下的一個實實在在的目錄，存放了該用戶提供訪問的文檔。_Directory-filename_可以是以下幾種形式之一： * 一個目錄名或如下所示的匹配模式： * 關鍵詞`disabled`停止_所有_用戶名到目錄的轉換，但不包括明確使用`enabled`啟用的(見下面)目錄。 * 關鍵詞`disabled`并跟隨一個以空格分隔的用戶名列表(其中的用戶即使出現在`enabled`的用戶列表中，也_不會_進行目錄轉換)。 * 關鍵詞`enabled`并跟隨一個以空格分隔的用戶名列表。此列表中的用戶允許進行目錄轉換，即使有一個全局的`disabled`關閉了此操作，但是，如果同時出現在`disabled`的用戶列表中，則不執行轉換操作。如果在`Userdir`指令中，既沒有`enabled`也沒有`disabled`關鍵詞，則其參數將被視為文件匹配模式，用于轉換成目錄名。對`http://www.foo.com/~bob/one/two.html`的請求會被轉換為： | UserDir 指令 | 轉換后的路徑 | | --- | --- | | UserDir public_html | ~bob/public_html/one/two.html | | UserDir /usr/web | /usr/web/bob/one/two.html | | UserDir /home/*/www | /home/bob/www/one/two.html | 下列指令將發送重定向到客戶端： | UserDir 指令 | 轉換后的路徑 | | --- | --- | | UserDir http://www.foo.com/users | http://www.foo.com/users/bob/one/two.html | | UserDir http://www.foo.com/*/usr | http://www.foo.com/bob/usr/one/two.html | | UserDir http://www.foo.com/~*/ | http://www.foo.com/~bob/one/two.html | **注意：使用此指令時要很小心，例如"`UserDir ./`"可能會把"`/~root`映射到"`/`"而這可能不是我們想要的。強烈建議在配置文件中包含一個"`UserDir disabled root`"聲明。更多信息請參見`Directory`指令和[安全提示](#calibre_link-263)。** 舉例：允許某些用戶使用`UserDir`指令，而禁止其他用戶： ``` UserDir disabled UserDir enabled user1 user2 user3 ``` 允許大多數用戶使用`UserDir`指令，而禁止一小部分用戶： ``` UserDir enabled UserDir disabled user4 user5 user6 ``` 還可以指定任選其一的(alternative)用戶網站目錄： ``` Userdir public_html /usr/web http://www.foo.com/ ``` 對http://www.foo.com/~bob/one/two.html的請求，會首先嘗試獲取"~bob/public_html/one/two.html"，其次是"/usr/web/bob/one/two.html"，最后產生一個到http://www.foo.com/bob/one/two.html的重定向。如果要增加重定向，則必須放在列表的最后。因為Apache不能判斷重定向是否成功，所以如果不放在最后，那么它只是一個替換地址。 2.1.4及以后的版本中，默認不開啟用戶網站目錄。在未設置`UserDir`指令的情況下將使用"`UserDir public_html`"默認值。 ### 參見 * [用戶網站目錄](#calibre_link-268)