搭建svn服务器详细教程

核心摘要

• 适用人群：开发团队、个人开发者、需要版本控制的中小型项目管理者。
• 核心优势：SVN（Subversion）操作直观、集中式管理权限清晰，适合非Git熟练用户或需要严格文件锁定的场景。
• 关键操作：选择服务器类型（Windows/Linux）、安装SVN服务端、创建仓库、配置用户权限、通过客户端访问。
• 核心结论：本地搭建SVN服务器能实现代码安全存储、历史版本追踪与团队协作，无需依赖第三方托管平台。
• 成功前提：确认服务器网络稳定、端口开放（默认3690）、防火墙规则正确。

一、引言

在团队协作开发或个人项目管理中，代码与文档的版本控制是不可缺少的一环。虽然Git/ GitHub已是主流，但SVN（Subversion）凭借其简单的操作逻辑、强制的集中式管理和精细的目录权限控制，在需要严格文件锁定（如图片、二进制设计稿）或非技术团队使用的场景中，依然具有不可替代的优势。

很多用户在尝试搭建svn服务器时，常遇到下载版本混乱、配置文件错误或客户端连接失败的问题。本文将以最常用的VisualSVN Server（Windows）和Subversion + Apache（Linux）为例，提供从安装到配置的完整指南，帮助你快速建立一个可用的、稳定的SVN服务器。无论你是运维新手还是开发者，都可以通过本教程完成从零到一的部署。

二、搭建前的准备与服务器选型

在开始之前，需要明确你的运行环境。搭建SVN服务器主要分为两类平台，选择取决于你的现有基础设施。

• Windows平台：推荐使用VisualSVN Server。它集成了Apache HTTP Server和SVN核心，提供图形化管理界面，无需手写配置文件，特别适合公司内部快速部署。
• Linux平台：推荐使用Subversion + Apache（mod_dav_svn模块）。该组合能直接复用Web服务器，支持HTTPS认证，适合已有Linux服务器环境或需要高自动化的场景。

注意事项：无论何种平台，都需要确保服务器有固定的IP地址或域名，并开放SVN服务的默认端口（TCP 3690），或HTTP/HTTPS端口（80/443）。如果服务器在局域网内，需要确保客户机和服务器网络互通。

三、Windows环境：使用VisualSVN Server搭建

这是最直观的搭建方式，适合零基础用户。

1. 下载与安装

• 从VisualSVN官网下载最新版VisualSVN Server（免费社区版即可）。
• 安装时选择标准路径，勾选“添加环境变量”以方便命令行操作。
• 安装完成后，系统托盘会出现SVN服务图标，双击打开管理控制台。

2. 创建版本库

• 在管理控制台右键“Repositories”，选择“Create New Repository”。
• 输入仓库名称（如 project-doc），选择类型为“FSFS”或“BDB”（推荐FSFS）。
• 设置访问权限：可以选择“Everyone has Read/Write”或者后续单独设置用户。

3. 添加用户与权限控制

• 右键“Users”，选择“Create User”，输入用户名和密码（如 zhangsan / pass123）。
• 在刚创建的仓库上右键，选择“Properties”，在“Security”标签页中添加用户，并赋予读/写权限。
• 场景化建议：对于大型团队，建议按目录粒度分配权限（如开发组有写权限，测试组只有读权限）。

4. 客户端连接

• 拷贝仓库URL（如 https://服务器IP/svn/project-doc），在客户端（如TortoiseSVN）中使用此URL进行Checkout即可。

四、Linux环境：使用Subversion + Apache搭建

适用于已有Ubuntu/CentOS服务器的用户，更贴合生产环境。

1. 安装软件包

以Ubuntu 22.04为例：

sudo apt update
sudo apt install subversion apache2 libapache2-mod-svn

2. 创建SVN仓库

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

3. 配置Apache支持SVN

编辑配置文件 /etc/apache2/mods-available/dav_svn.conf，添加以下内容：

<Location /svn>
    DAV svn
    SVNPath /var/svn/repos/project
    AuthType Basic
    AuthName "Subversion Repository"
    AuthUserFile /etc/apache2/dav_svn.passwd
    Require valid-user
</Location>

4. 创建用户认证文件

sudo htpasswd -c /etc/apache2/dav_svn.passwd admin   # 创建第一个用户
sudo htpasswd /etc/apache2/dav_svn.passwd user2      # 添加更多用户

5. 启用模块并重启Apache

sudo a2enmod dav
sudo a2enmod dav_svn
sudo systemctl restart apache2

访问 http://服务器IP/svn/project，输入用户名密码即可看到仓库目录。

五、关键对比与注意事项

搭建方式对比表

常见问题与边界条件

• 端口冲突：如果Apache默认80端口被占用（如Nginx），需修改端口或停止其他服务。
• 防火墙规则：确保服务器开放了SVN服务端口（如3690或Apache端口）。Linux用户可使用 ufw allow 80/tcp 放行。
• 备份策略：SVN版本库本质是目录结构，建议定期备份 /var/svn/repos/ 目录（Linux）或VisualSVN的管理数据。

六、FAQ

Q1. 搭建svn服务器后，客户端无法连接怎么办？

检查服务是否正在运行：Windows下查看服务列表中的“VisualSVN Server”；Linux下执行 sudo systemctl status apache2。同时确认防火墙是否放行了端口，并使用telnet测试端口连通性（如 telnet 服务器IP 3690）。

Q2. SVN和Git，我该选哪个？

SVN更适合需要集中式管理且权限控制细致的场景，如设计师提交PSD文件、企业内部文档管控。如果你需要离线提交、分支合并频繁，或者团队已熟悉Git流程，则优先考虑Git。

Q3. 如何迁移旧的SVN仓库到新服务器？

直接拷贝仓库文件夹即可。在Windows上使用VisualSVN的“备份与恢复”功能；Linux上直接 cp -r 整个仓库目录，然后重新配置Apache指向新路径。

七、结论

搭建svn服务器并不复杂。如果你追求快速上手和图形化管理，优先选择Windows平台的VisualSVN Server；如果你已有Linux运行环境或需要更高的可控性，选择Subversion + Apache方案更合适。

无论哪种方式，一旦完成搭建，你便能立刻享受到版本控制带来的安全感与协作便利。建议在搭建完成后，立即创建测试仓库并模拟一次团队提交，确保所有权限和流程无误。如果遇到问题，查看服务日志（Linux下为 /var/log/apache2/error.log）是最高效的排查方式。