SVN服务器配置说明

1、svn服务器配置说明 1、前 言花了72小时，终于把 subversion 初步掌握了。从一个连“什么是版本控制”都不知道的门外汉，到配置出精确至每目录访问的入门者，中间还卡了一天时间。其中费了许多气力，摸索实验了多次，还差点放弃了，但是收获是巨大的。现把我的配置和学习过程写下来，供大家参考，也让初学者少走弯路。以下仅以 windows 平台为例讲解，unix/linux 平台请参考相关资料。如其中有谬误的地方，包括错别字，请联系我修订。技术在分享中进步！2、基本概念2.1、什么是版本控制简单点来说，版本控制就是数据仓库，它可以记录你对文件的每次更改。这样，就算你在昏天黑地的改了几个月后老板说

2、不要了，还是按照过去那样，你也不会抓狂，简单的恢复版本操作就搞定一切。2.2、什么是 subversionsubversion是一个自由/开源版本控制系统，它管理文件和目录可以超越时间。一组文件存放在中心版本库，这个版本库很像一个普通的文件服务器，只是它可以记录每一次文件和目录的修改，这便使你可以取得数据以前的版本，从而可以检查所作的更改。从这个方面看，许多人把版本控制系统当作一种“时间机器”。subversion可以通过网络访问它的版本库，从而使用户可以在不同的电脑上使用。一定程度上可以说，允许用户在各自的地方修改同一份数据是促进协作。进展可能非常的迅速，并没有一个所有的改变都会取得效果的通

3、道，由于所有的工作都有历史版本，你不必担心由于失去某个通道而影响质量，如果存在不正确的改变，只要取消改变。一些版本控制系统也是软件配置管理（scm）系统，这种系统经过特定的精巧设计来管理源代码，有许多关于软件开发的特性本身理解编程语言、或者提供构建程序的工具。然而，subversion不是这样一个系统，它是一个通用系统，可以管理任何类型的文件集，对你这可能是源代码，对别人，可能是一个货物报价单或者是书稿等。2.3、版本库（repository）subversion 的核心就是 repository ，中文翻译成“版本库”。就是位于服务器端，统一管理和储存数据的地方。3、安装配置3.1 安装独立

4、服务器 svnserver环境os：windows xp sp2web：apache 2.2.6svn：svn-win32-1.4.6一、准备工作1、获取 subversion 服务器程序到官方网站（/）下载最新的服务器安装程序。目前最新的是1.4.6版本，具体下载地址在：/servlets/projectdocumentlist?folderid=8100&expandfolder=8100&folderid=91 ，注意找 for apache 2.2.x 版本的。2、获取 tort

5、oisesvn 客户端程序从官方网站 获取最新的 tortoisesvn 。tortoisesvn 是一个客户端程序，用来与 subvers 服务器端通讯。subversion 自带一个客户端程序 svn.exe ,但 tortoisesvn 更好操作，提高效率。二、安装服务器端和客户端首先安装 apache 2.2.6 ，具体安装方法大家参考相关资料，或者参看我写的windows下安装apache 2.2.x。其次安装 subversion（以下简称svn）的服务器端和客户端。下载下来的服务器端是个 zip 压缩包，直接解压缩即可，比如我解压到 e:subversion 。客户端安装文件是个

6、 exe 可执行文件，直接运行按提示安装即可，客户端安装完成后提示重启。三、建立版本库（repository）运行subversion服务器需要首先要建立一个版本库（repository）。版本库可以看作是服务器上集中存放和管理数据的地方。开始建立版本库。首先建立 e:svn 空文件夹作为所有版本库的根目录。然后，进入命令行并切换到subversion的bin目录。输入如下命令：svnadmin create e:svnrepos1此命令在 e:svn 下建立一个版本库 repos1 。repos1 下面会自动生成一些文件夹和文件。我们也可以使用 tortoisesvn 图形化的完成这一步：先

7、建立空目录 e:svnrepos1 ，注意一定是要空的。然后在 repos1 文件夹上“右键-tortoisesvn-create repository here.”，然后可以选择版本库模式，这里使用默认的fsfs即可，然后就创建了一系列文件夹和文件，同命令行建立的一样。四、运行独立服务器此时 subversion 服务还没有开始，只是通过它的命令建立了版本库。继续在刚才的命令窗口输入：svnserve.exe -daemonsvnserve 将会在端口 3690 等待请求，-daemon（两个短横线）选项告诉 svnserve 以守护进程方式运行，这样在手动终止之前不会退出。注意不要关闭命令

8、行窗口，关闭窗口会把 svnserve 停止。为了验证svnserve正常工作，使用tortoisesvn - repo-browser 来查看版本库。在弹出的 url 对话框中输入：svn:/localhost/svn/repos1点 ok 按钮后就可以看见 repos1 版本库的目录树结构了，只不过这时 repos1 是个空库。你也可以使用-root选项设置根位置来限制服务器的访问目录，从而增加安全性和节约输入svnserve url的时间：svnserve.exe -daemon -root drive:pathtorepository以前面的测试作为例，svnserve 将会运行为：s

9、vnserve.exe -daemon -root e:svn然后tortoisesvn中的版本库浏览器url缩减为：svn:/localhost/repos1五、配置用户和权限用文本编辑器打开e:svnrepos1conf目录，修改svnserve.conf：将：# password-db = passwd改为：password-db = passwd即去掉前面的 # 注释符，注意前面不能有空格。然后修改同目录的passwd文件，增加一个帐号：将：users# harry = harryssecret# sally = sallyssecret增加帐号：users#harry = harry

10、ssecret#sally = sallyssecrettest = test六、初始化导入下面就是将我们的数据（项目）导入到这个版本库，以后就由版本库管理我们的数据。我们的任何改动都回被版本库记录下来，甚至我们自己丢失、改错数据时版本库也能帮我们找回数据。比如，我在 d:wwwroot 下有个 guestbook 文件夹，里面存放的是我编写的留言簿程序。在此文件夹上“右键 - tortoisesvn - import.” ，在弹出对话框的“url of repository”输入“svn:/localhost/repos1/guestbook”。在“import message”输入“导入整

11、个留言簿”作为注释。点 ok 后要求输入帐号。我们在用户名和密码处都输入 test 。完成后 guestbook 中的内容全部导入到了 svn:/localhost/svn/repos1/guestbook 。我们看到在 e:svnrepos1 没有任何变化，连个 guestbook 文件夹都没有建立，唯一的变化就是e:svnrepos1容量变大了。实际上我们源guestbook中的内容已经导入 repos1 版本库了，源 guestbook 文件夹可以删除了。需要注意的是，这一步操作可以完全在另一台安装了 tortoisesvn 的客户机上进行。例如运行svnserve的主机的ip是133.

12、96.121.22，则url部分输入的内容就是“svn:/2” 。七、基本操作流程1、取出（check out）取出版本库到一个工作拷贝：来到任意空目录下，比如在f分区建立一个空文件夹 f:work 。“右键 - svn checkout”。在“url of repository”中输入“svn:/localhost/svn/repos1/guestbook”，这样我们就得到了一份 guestbook 中内容的工作拷贝。2、存入（check in）/提交（commit）在工作拷贝中作出修改并提交：在 guestbook 工作拷贝中随便打开一个文件，作出修改，然后“右键

13、- svn commit. ”。这样我们就把修改提交到了版本库，版本库根据情况存储我们提交的数据。在修改过的文件上“右键 - tortoisesvn - show log” ，可以看到对这个文件所有的提交。在不同的 revision 条目上“右键 - compare with working copy”，我们可以比较工作拷贝的文件和所选 revision 版本的区别。3.2 安装 apachesvn 服务器subversion的设计包括一个抽象的网络层，这意味着版本库可以通过各种服务器进程访问。理论上讲，subversion可以使用无限数量的网络协议实现，目前实践中存在着两种服务器。 svns

14、erver：svnserve 是一个小的（也叫轻型的）、独立服务器，使用自己定义的协议和客户端。（作者注：以下称这种服务器为“svnserver服务器”，上面的安装配置就是安装svnserver服务器。） apachesvn：apache是最流行的web服务器，通过使用 mod_dav_svn 模块，apache可以访问版本库，并且可以使客户端使用http的扩展协议webdav/deltav进行访问。（作者注：以下称这种服务器为“apachesvn服务器”） 通过 http 协议访问版本库是 subversion 的亮点之一。apachesvn服务器 具备了许多 svnserve服务器 没有的

15、特性，使用上更加灵活，但是有一点难于配置，灵活通常会带来复杂性。由于 subversion 需要版本化的控制，因此标准的 http 协议不能满足需求。要让 apache 与 subversion 协同工作，需要使用 webdav（web-based distributed authoring and versioning：）web 分布式创作和版本控制）。webdav 是 http 1.1 的扩展，关于 webdav 的规范和工作原理，可以参考 ietf rfc 2518 。一、必备条件为了让你的版本库使用http网络，你必需具备以下几个条件：1. 配置好httpd 2.2.x，并且使用mod

16、_dav启动。 2. 为mod_dav安装mod_dav_svn插件。 3. 配置你的httpd.conf，使http协议能访问版本库。 下面以我的配置过程详细讲解。环境：os：windows xp sp2web：apache 2.2.6svn：svn-win32-1.4.6二、安装1、安装apache具体安装方法见：windows下安装apache 2.2.x2、安装 subversion将下载下来的 svn-win32-1.4.6.zip 直接解压即可，比如我解压到 e:subversion 。从subversion安装目录的 bin 子目录将 intl3_svn.dll、libdb44.

17、dll、mod_authz_svn.so、mod_dav_svn.so 拷贝到apache的模块目录（apache 安装目录的 modules 文件夹）。三、基本的apache配置修改apache的配置文件 httpd.conf ，使用loadmodule来加载mod_dav_svn模块。将：#loadmodule dav_module modules/mod_dav.so改成：loadmodule dav_module modules/mod_dav.so即去掉前面的“#”号。添加：loadmodule dav_svn_module modules/mod_dav_svn.so一定确定它在

18、mod_dav 之后。现在你已经设置了apache和subversion，但是apache不知道如何处理subversion客户端，例如tortoisesvn。为了让apache知道哪个目录是用来作为subversion版本库，你需要使用编辑器（例如记事本）编辑apache的配置文件。在配置文件最后添加如下几行：dav svnsvnpath e:/svn/repos1这个配置告诉apache首先需要启用 dav_module，然后加载 dav_svn_module 。版本库对外的url是：http:/服务器ip/repository/ ，所有的subversion版本库在物理上位于e:/svn

19、/repos1/ 。配置完毕后重新启动 apache，打开浏览器，输入 http:/服务器ip/ repository/ 将会看到如下画面：这表示 apache 的 dav_svn 模块已经可以正常工作了。用户可以使用任何一种 subversion 的客户端通过 http 协议访问你的版本库。如果想要指定多个版本库，可以用多个 location 标签，也可以使用 svnparentpath 代替 svnpath，例如在 e:svn 下有多个版本库 repos1，repos2 等等，用如下方式指定：dav svnsvnparentpath e:/svn“svnparentpath e:/svn

20、” 表示 e:svn 下的每个子目录都是一个版本库。可以通过 http:/服务器ip/repository/repos1/，http:/服务器ip/repository/repos2/ 来访问。现在你的版本库任何人都可以访问，并且有完全的写操作权限。也就是说任何人都可以匿名读取，修改，提交，以及删除版本库中的内容(注：这时不需要配置e:svnreposconfsvnserve.conf 文件，并且也不需要启动e:subversionbinsvnserve.exe。因为提交是通过apache的dav模块处理的，而不是由svnservice处理。)。我们用 tortoisesvn 客户端验证即知。

21、显然大部分场合这是不符合需求的。那么如何进行权限设置呢，apache 提供了基本的权限设置：四、认证选项1、基本 http 认证最简单的客户端认证方式是通过 http 基本认证机制，简单的使用用户名和密码来验证一个用户的身份。apache提供了一个 htpasswd 工具来管理一个用户文件，这个文件包含用户名和加密后的密码，这些就是你希望赋予 subversion 特别权限的用户。htpasswd 可以在 apache 的 bin 安装目录下找到。具体使用方法如下：创建用户文件：htpasswd -c e:usrapache2.2binpasswd.conf username添加新用户（-m

22、表示以 md5 加密密码，可选项）：htpasswd -m e:usrapache2.2binpasswd.conf newusername更改用户密码：htpasswd -m e:usrapache2.2binpasswd.conf username删除用户（要用大写的 d ）：htpasswd d e:usrapache2.2binpasswd.conf username接下来修改 httpd.conf，在 location 标签中加入如下内容：authtype basicauthname svn reposauthuserfile e:/usr/apache2.2/bin/passwd.

23、confrequire valid-user说明：authtype basic：启用基本的验证，比如用户名/密码对。authname svn repos：当一个认证对话框弹出时，出现在认证对话框中的信息。（最好用英文，tortoisesvn 不支持中文，安装语言包除外。）authuserfile e:/usr/apache2.2/bin/passwd：指定e:usrapache2.2binpasswd为用户文件，用来验证用户的用户名及密码。require valid-user：限定用户只有输入正确的用户名及密码后才能访问这个路径重新启动 apache ，打开浏览器访问版本库。apache 会提

24、示你输入用户名和密码来认证登陆了，现在只有 passwd 文件中设定的用户才可以访问版本库。也可以配置只有特定用户可以访问，替换上述 require valid-user 为 require user tony robert 将只有用户文件中的 tony 和 robert 可以访问该版本库。有的时候也许不需要这样严格的访问控制，例如大多数开源项目允许匿名的读取操作，而只有认证用户才允许写操作。为了实现更为细致的权限认证，可以使用 limit 和 limitexcept 标签。例如：require valid-user以上配置将使匿名用户有读取权限，而限制只有 passwd 中配置的用户可以使用

25、写操作。如果这还不能满足你的要求，你希望精确的控制版本库目录访问，可以使用 apache 的 mod_authz_svn 模块对每个目录进行认证操作。2、用 mod_authz_svn 进行目录访问控制首先需要让 apache 将 mod_authz_svn 模块加载进来。在 subversion 的安装目录中找到 mod_auth_svn 模块，将其拷贝到 apache 安装目录的 modules 子目录下。修改 httpd.conf 文件，添加：loadmodule authz_svn_module modules/mod_authz_svn.so现在可以在 location 标签中使用

26、authz 的功能了。一个基本的 authz 配置如下：dav svnsvnparentpath e:/svn# our access control policyauthzsvnaccessfile e:/usr/apache2.2/bin/accesspolicy.conf# try anonymous access first, resort to real# authentication if necessary.satisfy anyrequire valid-user# how to authenticate a userauthtype basicauthname subversion repositoryauthuserfile