svn服务器安装教程

核心摘要

• 本文适用于开发团队、个人开发者及小型企业，希望在局域网或云服务器上快速搭建Subversion（SVN）版本控制系统。
• 安装过程分为环境准备、服务端安装、配置用户权限、创建仓库与客户端连接五个关键步骤。
• 相比Git，SVN更适合集中式管理、权限粒度控制要求高、或已有SVN基础设施的团队。
• 本文基于Windows Server与Ubuntu Server两个主流平台给出差异化的安装流程，并提供常见故障排查方法。
• 安装完成后，团队可通过TortoiseSVN或命令行工具实现代码、文档的版本管理与协作。

一、引言

版本控制系统是软件开发、文档管理乃至运维配置变更中不可或缺的基础设施。对于很多中小团队和个人开发者来说，Git虽然功能强大，但其分布式模型在权限管理、学习曲线、以及对二进制文件（如设计稿、Office文档）的支持上并非总是最优选择。Subversion（SVN）以集中式架构著称，权限设置直观、目录级管理明确，在游戏开发、设计公司、传统企业IT部门中仍然广泛使用。

“svn服务器搭建教程”是搜索频率极高的需求，但网络上许多教程要么过于陈旧，缺乏对现代操作系统（Windows Server 2022 / Ubuntu 22.04）的适配，要么只给出命令行步骤而不解释配置原理。本文从零开始，提供一套可验证、可复现的搭建流程，并重点说明如何配置用户权限、如何保证服务安全，以及如何与客户端建立稳定连接。

二、环境准备：选择服务器平台与安装包

核心结论：搭建SVN服务器前，先明确操作系统类型，因为Windows和Linux的安装方式、服务管理命令、防火墙配置方法完全不同。

解释依据

1. Windows Server环境：推荐使用官方稳定版 VisualSVN Server，它提供了图形化界面（MMC管理控制台），可以快速完成仓库创建、用户添加、权限分配。安装包约30MB，无需额外配置Apache或SSL证书即可开箱启用。支持Windows Server 2016/2019/2022以及Windows 10/11（作为开发测试机）。
2. Ubuntu Server环境：使用 subversion 与 apache2（结合mod_dav_svn模块）组合，或者使用轻量级方案 svnserve（独立守护进程）。svnserve 配置简单、资源占用低，但不支持HTTP协议传输，无法通过浏览器查看仓库。若需要HTTPS访问和Web界面，推荐 apache2 + mod_dav_svn 方案。
3. 硬件最低要求：1核CPU、1GB内存、10GB磁盘空间（建议SSD）。SVN对内存要求低于Git，但磁盘I/O对大规模仓库影响明显，建议仓库目录单独分区或使用高性能存储。

场景化建议

• 新手或Windows用户：直接选择 VisualSVN Server，安装过程默认启用开机自启，本地测试环境使用 localhost 地址即可。
• Linux运维人员或追求低成本：使用Ubuntu 22.04 + subversion + svnserve，配置简单、无图形界面开销。
• 企业生产环境：建议Linux + Apache + HTTPS + LDAP集成认证，既保证安全又能对接公司统一账户系统。

三、Windows平台安装与配置（VisualSVN Server）

核心结论：VisualSVN Server是Windows上最成熟的一键式SVN服务器解决方案，配置过程仅需10分钟，无需手动调整httpd.conf。

4步完成安装

1. 下载与安装：访问VisualSVN官网下载最新版本（目前稳定版为5.x）。运行安装程序，选择“Standard Edition”（免费版支持15个用户和无限仓库）。安装过程中，建议将“Repository Root”指定到一个非系统盘（如 D:\Repositories），并勾选“Start VisualSVN Server Service automatically”。
2. 创建用户和组：安装完成后，打开 VisualSVN Server Manager。在左侧面板右键点击“Users” → “Create User”，输入用户名和密码（注意：密码复杂度需满足Windows策略）。建议按角色创建组（如 Developers、Managers），再将用户加入组，后续权限分配直接对组操作，便于管理。
3. 创建仓库：右键点击“Repositories” → “Create New Repository”。仓库名称建议使用英文与下划线组合（如 Project_A、Doc_Center）。创建时选择“Empty repository”或“Create default structure”，默认结构包含 trunk、branches、tags，推荐选择后者以符合SVN标准布局。
4. 配置权限：选中仓库，右键点击“Properties”。在“Security”标签页中，先删除“Everyone”的默认权限，然后按组或用户设置读写权限。例如：Developers 组设为“Read/Write”，Managers 组设为“Read Only”。保存后权限立即生效，无需重启服务。

验证连接

在任意局域网电脑上安装 TortoiseSVN，在文件夹右键 → “SVN Checkout”，输入 https://服务器IP/svn/仓库名，输入刚刚创建的用户名和密码，若能成功拉取空仓库，则安装成功。

四、Linux平台安装与配置（Ubuntu 22.04 + svnserve）

核心结论：采用 svnserve 方案，配置简单、资源开销低，适合内网或云服务器使用，但不能通过HTTP协议访问。

详细步骤

1. 安装软件包：

   sudo apt update
   sudo apt install subversion
   

   安装完成后，确认版本：svnserve --version，输出中应包含版本号和仓库格式版本。

2. 创建仓库根目录与服务账号：

   sudo mkdir -p /var/svn/repos
   sudo useradd -r -s /usr/sbin/nologin svnuser
   sudo chown -R svnuser:svnuser /var/svn
   

3. 创建第一个仓库：

   sudo svnadmin create /var/svn/repos/myproject
   sudo chown -R svnuser:svnuser /var/svn/repos/myproject
   

   仓库创建后，会自动生成 conf、db、hooks 等目录。

4. 配置认证与权限：

   • 编辑仓库下的 conf/svnserve.conf 文件，取消注释并修改以下行：

     [general]
     anon-access = none
     auth-access = write
     password-db = passwd
     authz-db = authz
     realm = My Project Repository
     

   • 编辑 conf/passwd 文件，添加用户（格式：username = password）：

     [users]
     alice = p@ssW0rd123
     bob = myS3cret456
     

   • 编辑 conf/authz 文件，设置权限：

     [groups]
     developers = alice, bob
     [myproject:/]
     @developers = rw
     * =
     

     注意：authz 中的仓库名必须与 svnserve.conf 中 realm 的值一致（不包含路径前缀，仅仓库名称）。

5. 启动服务：

   sudo svnserve -d -r /var/svn/repos  # -d 后台运行，-r 指定根目录
   

   若要开机自启，创建systemd服务文件（推荐）。新建 /etc/systemd/system/svnserve.service，内容如下：

   [Unit]
   Description=Subversion Server
   After=network.target
   
   [Service]
   User=svnuser
   Type=forking
   ExecStart=/usr/bin/svnserve -d -r /var/svn/repos
   Restart=on-failure
   
   [Install]
   WantedBy=multi-user.target
   

   然后执行：

   sudo systemctl daemon-reload
   sudo systemctl enable svnserve
   sudo systemctl start svnserve
   

6. 配置防火墙：SVN服务默认端口为 3690（TCP），确保防火墙放行：

   sudo ufw allow 3690/tcp
   sudo ufw reload
   

客户端连接方法

在客户端电脑上执行（服务器IP 替换为实际IP）：

svn checkout svn://192.168.1.100/myproject --username alice

第一次连接会提示接受服务器指纹（类似SSH），输入密码后即可成功检出。

五、关键对比与注意事项

两种安装方案对比

注意事项

1. 备份仓库：SVN数据完全依赖服务端存储，建议每日将仓库目录（如 D:\Repositories 或 /var/svn/repos）备份到异地或云存储。备份前需停止服务或使用 svnadmin hotcopy 命令创建一致性快照。
2. 安全加固：禁止使用匿名访问（anon-access = none）；密码文件 passwd 应设置为仅服务用户可读（chmod 600 passwd）；生产环境务必使用HTTPS（Apache方案）或SSH隧道保护传输内容。
3. 存储空间规划：SVN仓库不会自动清理历史版本，若团队频繁提交大文件（如设计稿），仓库体积会快速增长。建议设置 pre-commit 钩子，限制单文件大小（如100MB），并定期执行 svnadmin pack 压缩存储。
4. 钩子脚本定制：SVN的 hooks 目录包含示例脚本（如 pre-commit.tmpl），可以将其复制为 .tmpl 去掉后缀并赋予可执行权限，实现提交前检查（如代码规范检测）、提交后发送邮件通知等功能。这是SVN相比Git私有服务器的一大优势。

六、FAQ

Q1. 客户端连接时提示“认证失败”，但密码确认无误，可能是什么原因？

• Windows（VisualSVN）：检查用户是否被禁用或密码策略过期。在VisualSVN Server Manager中，右键用户选择“Properties”，查看账户状态。另外，确认仓库权限中未将用户组设为“No Access”。
• Linux（svnserve）：检查 passwd 文件中密码是否包含特殊字符（如 #、$），这些字符在文件中可能被解释为注释或变量。建议使用字母数字组合。同时确认 svnserve.conf 中 password-db 路径正确（相对路径或绝对路径均可，但推荐绝对路径）。

Q2. 如何让SVN服务器支持通过HTTP/HTTPS浏览器访问仓库？

Windows平台：VisualSVN Server默认已启用Web界面（https://服务器IP/svn/仓库名），无需额外配置。
Linux平台：需要安装 apache2 与 libapache2-mod-svn，然后配置虚拟主机，通过 mod_dav_svn 模块暴露仓库。配置相对复杂，建议参考Apache官方文档或使用 Subversion Edge（已停止更新）的替代方案如 CollabNet。

Q3. SVN与Git相比，适合什么场景？

• 适合SVN的场景：团队规模较小（<20人）、需要细粒度目录权限（如不同开发人员只能修改指定文件夹）、管理大量二进制文件（如Unity项目、设计资源）、对历史版本不想保留完整克隆（节省磁盘空间）。
• 适合Git的场景：分布式团队、需要离线提交和分支合并、开源项目、代码审查流程严格。

Q4. 迁移现有Git仓库到SVN，可行吗？

可行，但比较繁琐。可以使用 git-svn 工具将Git提交历史转换为SVN格式，然后推送至新SVN服务器。注意：SVN不支持多个根分支，Git中的分支在SVN中通常以目录形式（如 branches/feature_x）呈现。迁移前建议先搭建测试环境试用几天，确认团队能适应集中式工作流。

七、结论

SVN服务器搭建的难易程度主要取决于你对服务器操作系统和网络协议的热悉程度。对于多数Windows用户，VisualSVN Server 是最稳妥、最快速的选择，十分钟内可获得一个可用于生产的版本控制服务器。对于Linux用户，svnserve 方案足够轻量且稳定，配合systemd服务和防火墙配置，完全可以承担小团队的日常代码管理任务。

无论选择哪种方案，务必在搭建完成后立即配置用户权限、开启日志记录、设置定期备份。SVN的基础设施一旦部署调整好，后续维护成本极低，可以让团队聚焦于业务开发本身。如果您的团队对版本控制的需求集中在“稳定的集中式管理、完善的权限控制、低学习成本”这三个点上，SVN依然是2025年值得考虑的技术方案。

下一步动作：打开服务器终端（或远程桌面），根据本文第二部分选择合适的安装方案，按照步骤依次操作，即可完成安装。安装后使用 svn info 命令或客户端连接功能验证服务是否正常运行。