【转载】svn配置文件详析

  原文在这里： svnserve配置文件详析   作者：谭元元

svnserve是SVN自带的一个轻型服务器，客户端通过使用以svn://或svn+ssh://为前缀的URL来访问svnserve服务 器，实现远程访问SVN版本库。

svnserve可以通过配置文件来设置用户和口令，以及按路径控制版本库访问权限。本文详细分析了svnserve配置文件格式，并说明如何使用配置文 件控制版本库访问权限。

本文介绍SVN的版本为1.4.4。

1) svnserve配置文件概述

svnserve配置文件通常由以下3个文本文件组成：
svn服务配置文件，该文件版本库目录的conf目录下，文件名为svnserve.conf。
用户名口令文件，该文件名在文件svnserve.conf中指定，缺省为同目录下的passwd。
权限配置文件，该文件名也在文件svnserve.conf中指定，缺省为同目录下的authz。

2) svn服务配置文件

svn服务配置文件为版本库目录中的文件conf/svnserve.conf。该文件仅由一个[general]配置段组成。

[general]配置段中配置行格式如下：
<配置项> = <值>

配置项分为以下5项：

anon-access 控制非鉴权用户访问版本库的权限。取值范围为"write"、"read"和"none"。
即"write"为可读可写，"read"为只读，"none"表示无访问权限。
缺省值：read

auth-access 控制鉴权用户访问版本库的权限。取值范围为"write"、"read"和"none"。
即"write"为可读可写，"read"为只读，"none"表示无访问权限。
缺省值：write

password-db 指定用户名口令文件名。除非指定绝对路径，否则文件位置为相对conf
目录的相对路径。
缺省值：passwd

authz-db 指定权限配置文件名，通过该文件可以实现以路径为基础的访问控制。
除非指定绝对路径，否则文件位置为相对conf目录的相对路径。
缺省值：authz

realm 指定版本库的认证域，即在登录时提示的认证域名称。若两个版本库的
认证域相同，建议使用相同的用户名口令数据文件。
缺省值：一个UUID(Universal Unique IDentifier，全局唯一标示)。

【说明】版本库认证域
在使用svn客户端访问svnserve服务器时，若需要用户登录，则提示信息如下：
[root@test root]# svn list svn://192.168.3.45/test
Authentication realm: 0d545a49-4038-0410-99b4-c66dc73f754e
Password for 'root':
在上述第2行"Authentication realm: "之后显示的字符串为认证域名称。如果在配置文件中为设定认证域，就会提示一个UUID，如上述所示。
如果在配置文件中指定了如下配置项：
realm = test
将在svn客户端提示如下：
[root@test root]# svn list svn://192.168.3.45/test
Authentication realm: test
Password for 'root':

例1：svn服务配置文件conf/svnserve.conf的内容如下：
[general]
anon-access = none
auth-access = write
password-db = ../../conf/passwd
authz-db = ../../conf/authz
realm = test

上述配置文件设定非鉴权用户无权限访问该版本库；鉴权用户可对版本库进行读写；用户名口令文件为相对版本库conf目录的文件"../../conf /passwd"；权限配置文件为相对版本库conf目录的文件"../../conf/authz"；版本库的认证域为"test"。

3) 用户名口令文件

用户名口令文件由svnserve.conf的配置项password-db指定，缺省为conf目录中的passwd。该文件仅由一个[users]配 置段组成。

[users]配置段的配置行格式如下：
<用户名> = <口令>
注意：配置行中的口令为未经过任何处理的明文。

例2：用户名口令文件conf/passwd的内容如下：
[users]
admin = admin
thinker = 123456

该文件中配置了两个用户，用户名分别为"admin"和"thinker"。其中"admin"用户的口令为"admin"；"thinker"用户的口 令为"123456"。

4) 权限配置文件

权限配置文件由svnserve.conf的配置项authz-db指定，缺省为conf目录中的authz。该配置文件由一个[groups]配置段和 若干个版本库路径权限段组成。

[groups]配置段中配置行格式如下：
<用户组> = <用户列表>
用户列表由若干个用户组或用户名构成，用户组或用户名之间用逗号","分隔，引用用户组时要使用前缀"@"(如：引用用户组"all"要使用字符 串"@all")。

版本库路径权限段的段名格式如下：
[<版本库名>:<路径>]
如版本库abc路径/tmp的版本库路径权限段的段名为"[abc:/tmp]"。
可省略段名中的版本库名。若省略版本库名，则该版本库路径权限段对所有版本库中相同路径的访问控制都有效。如：段名为"[/tmp]"的版本库路径权限段 设置了所有引用该权限配置文件的版本库中目录"/tmp"的访问权限。

版本库路径权限段中配置行格式有如下三种：
<用户名> = <权限>
<用户组> = <权限>
* = <权限>
其中，"*"表示任何用户；权限的取值范围为''、'r'和'rw'，''表示对该版本库路径无任何权限，'r'表示具有只读权限，'rw'表示有读写权 限。
注意：每行配置只能配置单个用户或用户组。

例3：权限配置文件conf/authz的内容如下：
[groups]
g_admin = admin,thinker

[admintools:/]
@g_admin = rw
* =

[test:/home/thinker]
thinker = rw
* = r

在上述配置文件中，定义了一个用户组"g_admin"，该用户组包含用户"admin"和"thinker"。然后定义了2个版本库路径权限段。其中， 版本库"admintools"只有用户组"g_admin"可读写，其他用户无任何权限；版本库"test"中路径"/home/thinker"只有 用户"thinker"有读写权限，其他用户只有可读权限。

5) 总结

在本文中，详细介绍了svnserve程序的3个配置文件。SVN管理员可以通过这3个配置文件设置svnserve服务的用户名口令，以及对版本库路径 的访问权限。这些配置文件保存后就立即生效，不需要重启svnserve服务。
需要强调的是本文介绍的配置文件只对svnserve服务有效，即客户端通过前缀为svn://或svn+ssh://的URL访问版本库有效，而对通过 前缀http://、https://或file:///的URL无效。