Subversion 1.5.5 与 Apache 2.2 结合

wushi

零、序言

起因：公司使用的VSS6.0有很多缺陷，我一直想寻找一个完善并且简单易用的源代码管理工具，于是SVN进入了我的视线。

发展：Subversion可以结合Apache服务器实现远程管理源代码的功能，我当前的开发项目经常需要辗转于自己公司与客户公司之间，这个附带的彩蛋正好也解决了现在项目的远程管理问题，但是在我搜索了很多网络文章后发现，很多Subverion与Apache的配置文章已经过于陈旧，实际上无法成功的配置，但许多经验值得学习，所以整理并编写了此篇文章作为以后配置服务器的参照留存。

一、安装

安装 Apache 2.2
安装 Subversion 1.5.5

找到 Subversion 安装目录下的以下文件：


bin/mod_authz_svn.so
bin/mod_dav_svn.so

复制到 Apache 安装目录下 modules 目录中


bin/intl3_svn.dll
bin/libdb*.dll

复制到 Apache 安装目录下 bin 目录中（这里似乎并不是必须的，我猜想这里或许是为了支持 Berkeley DB 而所作的操作，但我并不打算深入研究下去）

二、环境

假设 Subversion 安装在 D:\SVN\Subversion 目录下
假设创建 D:\SVN\Repositories\ 目录作为版本库总目录
假设在 D:\SVN\Repositories\ 中创建目录iSLeeBlog，并在其中创建版本库，假设已经配置好用户授权，那么应该可以通过 svn://localhost/iSLeeBlog 访问版本库。
假设统一将Apache的SVN项目配置文件放在 D:\SVN\conf 目录下
假设Apache的默认端口号为8080

三、配置Subversion版本库管理服务器

找到创建的版本库目录下的配置文件，例如：D:\SVN\Repositories\iSLeeBlog\conf\

将 passwd 文件改名为 passwd.svn（也可以不改名，这里是为了结构更清晰）

用文本编辑器修改 svnserve.conf 文件，找到以下两行


#password-db = passwd
...
#authz-db = authz

修改为：


password-db = passwd.svn
...
authz-db = authz

这里 authz 就是授权文件的名称，在 Subversion 和 Apache 中可以使用相同的授权文件，但无法使用相同的 passwd 文件，因为 Apache 是以加密方式存储密码，而 Subversion 使用明文储存密码，所以上面将 Subversion 生成的 passwd 文件改名，说明其仅用在 Subversion 下。

思考：这里可以使用相同的帐号文件吗？显然，我对 Apache 的配置还是不太熟悉，两个帐号文件需要同步维护比较麻烦，如果您知道如何解决，请您帮助我，谢谢。

如何配置授权文件不再详述，请自行查看授权文件中自带的注释，已经解释的非常清晰。

四、配置Apache服务器

找到 Apache 安装目录下 conf/httpd.conf 文件，用文本编辑器修改：

找到以下两句取消注释：


#LoadModule dav_fs_module modules/mod_dav_fs.so
#LoadModule dav_module modules/mod_dav.so

增加以下两句


LoadModule dav_svn_module modules/mod_dav_svn.so
LoadModule authz_svn_module modules/mod_authz_svn.so

使用 Apache 安装目录下的 bin/htpasswd.exe 可执行文件生成授权文件

第一次生成，使用 -cb 参数：


htpasswd -cb [filename] [username] [password]

例如：


htpasswd -cb passwd.apache islee 123

添加新用户，使用 -b 参数：


htpasswd -b passwd.apache another 456

将生成的 passwd.apache 文件移动到 D:\SVN\Repositories\iSLeeBlog\conf 目录下

a) 配置单项目

在Apache的conf/httpd.conf文件，在末尾添加以下内容


#配置虚拟目录

#引用远程访问模块
DAV svn

#版本库路径
SVNPath D:\SVN\Repositories\iSLeeBlog

#授权文件
AuthzSVNAccessFile D:\SVN\Repositories\iSLeeBlog\conf\authz

#所有用户都需要身份验证
Satisfy Any
Require valid-user

#验证方式
AuthType Basic

#项目的名称
AuthName "iSLee's Blog Project"

#用户文件
AuthUserFile D:\SVN\Repositories\iSLeeBlog\conf\passwd.apache


b) 配置多项目

在 httpd.conf 文件末尾增加一下一句，作用是引用指定目录下的所有 project 文件


Include D:\SVN\conf\*.project

然后在指定目录，这里是 D:\SVN\conf 中创建单个项目配置文件 iSLeeBlog.project 文本文件

iSLeeBlog.project 文件中的内容同“a) 配置单项目”节中的内容完全相同，新的项目之需要继续创建 project 文件，并根据需要更改虚拟目录路径以及授权文件名称即可。

配置以后需要重启 Apache 服务器。

五、访问

如果在局域网中，那么可以输入“svn://localhost/iSLeeBlog”即可访问版本库。

如果远程访问Apache服务器，那么可以在浏览器或客户端软件中输入“http://yourdomain or IP/svn/iSLeeBlog”即可访问iSLeeBlog项目。

六、备注

Subversion 的客户端 TortoiseSVN 是一个很棒的工具，虽然它与本文无关，但多看它附带的帮助文档，你将获益匪浅

本文档由 iSLee 编写维护，最后更新日期：2009年3月6日