如何架设SVN服务器

核心摘要

• 适用人群：开发者、小团队及企业用户，需要集中管理代码或文档版本。
• 核心目标：搭建一个稳定、可远程访问的SVN服务器，支持权限控制和历史回溯。
• 关键指标：Windows环境推荐VisualSVN Server，Linux环境推荐Subversion + Apache组合。
• 注意事项：SVN为集中式版本控制系统，与Git在分支管理上有显著差异，适合对权限控制要求高的场景。
• 风险提示：服务器需定期备份，避免单点故障导致数据丢失。

一、引言

在团队协作开发中，版本控制是保证代码一致性和历史可追溯的基石。尽管Git已占据主流地位，但SVN（Subversion）因其集中式架构、直观的目录权限管理、大文件支持稳定等特点，仍被大量企业和项目使用。对于运维人员、项目经理或独立开发者而言，掌握SVN服务器架设技能，能快速构建一个安全、可控的代码或文档管理中心。

本文围绕“如何架设SVN服务器”这一核心问题，从环境选择、安装配置、安全实践到常见问题，提供一套可直接落地的操作指南。无论你是在Windows上使用图形化工具，还是在Linux上追求命令行高效配置，都能找到对应的答案。

二、环境选择：Windows vs Linux

核心结论

• Windows环境：推荐VisualSVN Server，安装即用，图形化界面管理用户与权限，适合新手或对Windows生态依赖较高的团队。
• Linux环境：推荐Apache + Subversion或svnserve，更灵活、资源占用低，适合服务器运维团队或需要高度自定义的场景。

解释依据

1. VisualSVN Server的优势：

   • 集成安装包，自动配置Apache HTTP服务。
   • 提供可视化控制台，支持右键创建仓库、添加用户、设置读写权限。
   • 内置安全机制，默认启用HTTPS加密。

2. Linux方案的适用场景：

   • 需要与CI/CD工具（如Jenkins）深度集成。
   • 需要自定义认证方式（如LDAP、AD域认证）。
   • 服务器硬件资源有限，需最小化依赖。

场景化建议

• 如果你在公司内部局域网搭建SVN服务器，且团队成员少于50人，建议使用VisualSVN Server，1小时内即可上缐。
• 如果你在云服务器上架设，且需要远程访问、集成邮件通知或自定义脚本，建议选择Linux + Apache + SSL方案。

三、Windows环境架设VisualSVN Server

核心结论

只需4步即可完成基础搭建：下载安装→创建仓库→添加用户→设置权限。

操作步骤

1. 下载与安装：

   • 访问VisualSVN官网，下载VisualSVN Server（免费版支持15个用户）。
   • 安装时选择“Standard Edition”，指定数据存放位置（建议不要放在C盘系统盘）。

2. 创建仓库：

   • 打开VisualSVN Server Manager，右键“Repositories” → “Create New Repository”。
   • 选择“Empty Repository”或“Copy Structure from a Project”（后者会自动生成trunk、branches、tags目录）。

3. 添加用户：

   • 在左侧“Users”节点右键 → “Create User”，填写用户名和密码。
   • 建议每个成员分配独立账号，避免共享账号导致操作记录无法追溯。

4. 设置权限：

   • 选中某个仓库，右键“Properties” → “Security”。
   • 将之前创建的用户添加到列表，分配Read Only、Read/Write或No Access权限。
   • 注意：如果需要子目录权限隔离，可在“Path-based Authorization”中精细控制。

安全与维护

• 启用HTTPS：VisualSVN Server默认配置了自签名证书，如需公网信任的HTTPS，可导入商业CA证书。
• 定期备份：在“Backup & Restore”功能中设置定期任务，或直接备份仓库所在文件夹（建议每天增量备份）。

四、Linux环境架设Apache + SVN

核心结论

采用Subversion + mod_dav_svn + Apache组合，支持HTTP/HTTPS访问和细粒度权限控制，适合生产环境部署。

操作示例（以Ubuntu 22.04为例）

1. 安装相关包：

   sudo apt update
   sudo apt install apache2 subversion libapache2-mod-svn -y
   sudo a2enmod dav dav_svn authz_svn
   

2. 创建SVN仓库：

   sudo mkdir -p /var/svn/repos
   sudo svnadmin create /var/svn/repos/project1
   sudo chown -R www-data:www-data /var/svn/repos
   

3. 配置Apache虚拟主机： 编辑 /etc/apache2/sites-available/svn.conf：

   <VirtualHost *:443>
       ServerName svn.yourdomain.com
       SSLEngine on
       SSLCertificateFile /path/to/cert.pem
       SSLCertificateKeyFile /path/to/key.pem
   
       <Location /svn>
           DAV svn
           SVNParentPath /var/svn/repos
           AuthType Basic
           AuthName "SVN Repository"
           AuthUserFile /etc/subversion/passwd
           Require valid-user
           AuthzSVNAccessFile /etc/subversion/authz
       </Location>
   </VirtualHost>
   

4. 创建用户与权限文件：

   sudo htpasswd -c /etc/subversion/passwd username1
   sudo nano /etc/subversion/authz
   

   在authz文件中设置：

   [groups]
   dev_team = user1, user2
   
   [project1:/]
   @dev_team = rw
   * = r
   

5. 重启服务：

   sudo a2ensite svn.conf
   sudo systemctl restart apache2
   

关键注意事项

• SSL证书：使用Let’s Encrypt免费证书，通过Certbot自动续期。
• 钩子脚本：在仓库的hooks目录下添加post-commit脚本，可实现邮件通知或触发CI构建。

五、常见问题与维护建议

• Q: 客户端无法连接？ 检查服务器防火墙是否开放端口（HTTP 80/HTTPS 443，或svnserve 3690）。
• Q: 如何迁移仓库？ 使用svnadmin dump导出，再使用svnadmin load导入新服务器。
• Q: 权限配置不生效？ 检查authz文件格式，路径必须以仓库名开头，如[project1:/trunk]。
• 存储优化：SVN默认使用FSFS存储，定期运行svnadmin pack可合并未打包的修订版本，提升性能。

六、FAQ

Q1. 我的团队很小，可以选择svnserve（独立服务器）吗？

可以。svnserve不需要Apache，配置更简单，适合局域网小团队（少于20人）。但缺点是安全性较弱，仅支持svn协议，不支持HTTP形式的浏览器浏览。

Q2. 公司有AD域控，SVN服务器能否集成域认证？

可以。Windows版VisualSVN Server支持集成Windows域认证；Linux版可通过Apache的mod_authnz_ldap模块实现LDAP/AD认证，无需维护本地密码文件。

Q3. 如何设置只有特定人能修改某个子目录？

需要基于路径的权限控制。在VisualSVN Server中，通过仓库属性 → “Security” → “Add path”实现；在Linux方案中，在authz文件中写类似[project1:/secret]并指定用户。

Q4. Git与SVN能否同时使用？

可以。可以使用git-svn工具从SVN仓库克隆，让Git客户端也能提交到SVN服务器，但会丢失Git的部分高级特性（如分支合并）。推荐迁移前先在测试环境验证兼容性。

七、结论

架设SVN服务器不是一件复杂的事，关键在于根据团队规模、技术栈和安全要求选择合适的方案。Windows用户选择VisualSVN Server可快速上手，Linux用户采用Apache+SVN方案则拥有更高的定制空间。

部署完成后，建议立即建立三个习惯：

1. 每日备份仓库数据（结合cron或Windows任务计划）。
2. 设定代码提交规范，如要求填写描述信息。
3. 定期检查日志，监控异常访问。

如果后续团队扩大或需要更灵活的分支策略，再评估是否迁移至Git服务。SVN在集中式权限管理和审计方面仍有独特价值，在一个阶段选择最适合的工具，比追求“技术潮流”更重要。