Apache模块 mod_userdir

说明 允许用户从自己的主目录中提供页面(使用"/~username")
状态 基本(B)
模块名 userdir_module
源文件 mod_userdir.c

概述

此模块允许使用类似http://example.com/~user/的语法来访问用户网站目录。

UserDir 指令

说明 用户网站目录的位置
语法 UserDir _directory-filename_
作用域 server config, virtual host
状态 基本(B)
模块 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指令和安全提示

举例:

允许某些用户使用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"默认值。

参见