Apache HTTP Server 版本2.2
說明 | 允許用戶從自己的主目錄中提供頁面(使用"/~username") |
---|---|
狀態(tài) | 基本(B) |
模塊名 | userdir_module |
源文件 | mod_userdir.c |
此模塊允許使用類似http://example.com/~user/
的語法來訪問用戶網(wǎng)站目錄。
說明 | 用戶網(wǎng)站目錄的位置 |
---|---|
語法 | UserDir directory-filename |
作用域 | server config, virtual host |
狀態(tài) | 基本(B) |
模塊 | mod_userdir |
UserDir
指令指定了用戶目錄下的一個(gè)實(shí)實(shí)在在的目錄,存放了該用戶提供訪問的文檔。Directory-filename可以是以下幾種形式之一:
disabled
停止所有用戶名到目錄的轉(zhuǎn)換,但不包括明確使用enabled
啟用的(見下面)目錄。disabled
并跟隨一個(gè)以空格分隔的用戶名列表(其中的用戶即使出現(xiàn)在enabled
的用戶列表中,也不會(huì)進(jìn)行目錄轉(zhuǎn)換)。enabled
并跟隨一個(gè)以空格分隔的用戶名列表。此列表中的用戶允許進(jìn)行目錄轉(zhuǎn)換,即使有一個(gè)全局的disabled
關(guān)閉了此操作,但是,如果同時(shí)出現(xiàn)在disabled
的用戶列表中,則不執(zhí)行轉(zhuǎn)換操作。如果在Userdir
指令中,既沒有enabled
也沒有disabled
關(guān)鍵詞,則其參數(shù)將被視為文件匹配模式,用于轉(zhuǎn)換成目錄名。對(duì)http://www.foo.com/~bob/one/two.html
的請(qǐng)求會(huì)被轉(zhuǎn)換為:
UserDir 指令 | 轉(zhuǎn)換后的路徑 |
---|---|
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 |
下列指令將發(fā)送重定向到客戶端:
UserDir 指令 | 轉(zhuǎn)換后的路徑 |
---|---|
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 ./
"可能會(huì)把"/~root
映射到"/
"而這可能不是我們想要的。強(qiáng)烈建議在配置文件中包含一個(gè)"UserDir disabled root
"聲明。更多信息請(qǐng)參見Directory
指令和安全提示。
舉例:
允許某些用戶使用UserDir
指令,而禁止其他用戶:
UserDir disabled
UserDir enabled user1 user2 user3
允許大多數(shù)用戶使用UserDir
指令,而禁止一小部分用戶:
UserDir enabled
UserDir disabled user4 user5 user6
還可以指定任選其一的(alternative)用戶網(wǎng)站目錄:
Userdir public_html /usr/web http://www.foo.com/
對(duì)http://www.foo.com/~bob/one/two.html的請(qǐng)求,會(huì)首先嘗試獲取"~bob/public_html/one/two.html",其次是"/usr/web/bob/one/two.html",最后產(chǎn)生一個(gè)到http://www.foo.com/bob/one/two.html的重定向。
如果要增加重定向,則必須放在列表的最后。因?yàn)锳pache不能判斷重定向是否成功,所以如果不放在最后,那么它只是一個(gè)替換地址。
2.1.4及以后的版本中,默認(rèn)不開啟用戶網(wǎng)站目錄。在未設(shè)置UserDir
指令的情況下將使用"UserDir public_html
"默認(rèn)值。