SVN 与 Apache 集成配置：基于 HTTP 协议的多人协作环境搭建

在团队开发中，版本控制是协作的基石。Subversion（SVN）作为一款成熟稳定的集中式版本控制系统，至今仍在许多企业和团队中广泛使用。将 SVN 与 Apache HTTP Server 集成，可以通过 HTTP/HTTPS 协议提供版本控制服务，带来更好的权限管理、跨平台兼容性以及更友好的防火墙穿透能力。本文将详细介绍如何搭建一个基于 HTTP 协议的 SVN 多人协作环境。

为什么选择 Apache + SVN 集成方案

SVN 支持多种访问协议，包括 svn://、svn+ssh:// 和 http://。其中，基于 Apache 的 HTTP 访问方式具有以下优势：

• 权限管理精细：借助 Apache 的认证和授权模块，可以按目录、按用户或按用户组设置读写权限。
• 防火墙友好：HTTP/HTTPS 端口通常默认开放，无需额外配置防火墙规则。
• 支持 HTTPS 加密：通过 SSL 证书即可实现数据传输加密，保障代码安全。
• 与现有系统集成方便：可以复用已有的 LDAP、Active Directory 等认证体系。
• 浏览器可浏览：配合 ViewVC 等工具，可以直接在浏览器中查看仓库内容。

环境准备

本文以 CentOS 7 / RHEL 7 为例进行演示，其他 Linux 发行版的操作类似。

安装必要软件

yum install -y httpd subversion mod_dav_svn

安装完成后，确认 mod_dav_svn 模块已正确安装：

ls /etc/httpd/modules/ | grep dav_svn

应该能看到 mod_dav_svn.so 和 mod_authz_svn.so 两个模块文件。

创建 SVN 仓库

选择一个合适的存储路径，例如 /var/svn：

mkdir -p /var/svn
svnadmin create /var/svn/project

创建完成后，仓库目录结构如下：

/var/svn/project/
├── conf/
├── db/
├── hooks/
├── locks/
└── format

配置 Apache 集成 SVN

加载 SVN 模块

编辑 Apache 主配置文件 /etc/httpd/conf/httpd.conf，确保以下模块被加载：

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

通常安装 mod_dav_svn 后，这些配置会自动添加到 /etc/httpd/conf.modules.d/ 目录下的配置文件中，无需手动修改主配置文件。

配置 SVN 虚拟主机

在 /etc/httpd/conf.d/ 目录下创建 svn.conf 文件：

<VirtualHost *:80>
    ServerName svn.example.com
    DocumentRoot /var/www/html

    <Location /svn>
        DAV svn
        SVNParentPath /var/svn
        SVNListParentPath On

        # 认证配置
        AuthType Basic
        AuthName "SVN Repository"
        AuthUserFile /etc/svn-auth-users
        Require valid-user

        # 授权配置
        AuthzSVNAccessFile /etc/svn-authz.conf
    </Location>

    ErrorLog /var/log/httpd/svn_error.log
    CustomLog /var/log/httpd/svn_access.log combined
</VirtualHost>

关键配置项说明：

• SVNParentPath：指定 SVN 仓库的父目录，Apache 会自动识别该目录下的所有仓库。
• SVNListParentPath On：允许列出所有仓库，方便查看。
• AuthUserFile：指定用户密码文件路径。
• AuthzSVNAccessFile：指定权限控制文件路径。

配置用户认证

创建用户

使用 htpasswd 命令创建用户：

htpasswd -cm /etc/svn-auth-users alice
htpasswd -m /etc/svn-auth-users bob
htpasswd -m /etc/svn-auth-users charlie

• -c 表示创建新文件（仅首次使用）。
• -m 表示使用 MD5 加密密码。

配置权限控制

编辑 /etc/svn-authz.conf 文件：

[groups]
developers = alice, bob
testers = charlie

[/]
* = r

[project:/]
@developers = rw
@testers = r
* =

[project:/trunk]
@developers = rw
@testers = r

[project:/branches]
@developers = rw
@testers = r

[project:/tags]
@developers = rw
@testers = r

权限规则说明：

• * = r：所有认证用户默认可读。
• @developers = rw：开发组拥有读写权限。
• @testers = r：测试组只有读权限。
• * =：未认证用户无任何权限。

启动服务并验证

启动 Apache

systemctl start httpd
systemctl enable httpd

设置目录权限

确保 Apache 运行用户（通常为 apache）对 SVN 仓库有读写权限：

chown -R apache:apache /var/svn
chmod -R 755 /var/svn

验证访问

在浏览器中访问 http://svn.example.com/svn/project，输入用户名和密码后，应该能看到仓库的目录结构。

使用 SVN 客户端进行检出测试：

svn checkout http://svn.example.com/svn/project/trunk myproject --username alice

启用 HTTPS 加密

在生产环境中，建议启用 HTTPS 以保障数据传输安全。

生成自签名证书（测试环境）

openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout /etc/pki/tls/private/svn.key \
  -out /etc/pki/tls/certs/svn.crt

修改 Apache 配置

<VirtualHost *:443>
    ServerName svn.example.com

    SSLEngine on
    SSLCertificateFile /etc/pki/tls/certs/svn.crt
    SSLCertificateKeyFile /etc/pki/tls/private/svn.key

    <Location /svn>
        DAV svn
        SVNParentPath /var/svn
        AuthType Basic
        AuthName "SVN Repository"
        AuthUserFile /etc/svn-auth-users
        Require valid-user
        AuthzSVNAccessFile /etc/svn-authz.conf
    </Location>
</VirtualHost>

重启 Apache 后，即可通过 https://svn.example.com/svn/project 访问。

常见问题与排查

1. 403 Forbidden 错误：检查目录权限和 SELinux 设置。可临时执行 setenforce 0 测试是否为 SELinux 导致，若确认则需配置正确的 SELinux 布尔值或上下文。

2. 无法列出仓库：确认 SVNListParentPath On 已配置，且 SVNParentPath 路径正确。

3. 提交时提示权限不足：检查 AuthzSVNAccessFile 中的路径写法是否正确，注意仓库名前有斜杠。

4. SELinux 相关：执行 chcon -R -t httpd_sys_content_t /var/svn 或使用 semanage fcontext 进行持久化配置。

总结

通过将 SVN 与 Apache 集成，我们搭建了一个基于 HTTP 协议的多人协作版本控制环境。该方案具备精细的权限控制、良好的跨平台兼容性以及可扩展的加密传输能力。在实际部署中，建议结合团队规模和网络环境，合理规划仓库结构、用户组划分以及备份策略，从而构建一个稳定高效的协作开发平台。

未经允许不得转载：任鹏个人博客 » SVN 与 Apache 集成配置：基于 HTTP 协议的多人协作环境搭建