阿里云 Linux 上搭建 SVN,软件安装通常不复杂,容易漏掉的是仓库权限、端口放行和服务开机启动。下面以阿里云 Linux 3 为例,从安装 Subversion 到验证访问,走一遍适合小团队使用的配置流程。
准备服务器与访问规则
准备一台已完成初始化的阿里云 Linux 云服务器,并确认可以通过 SSH 登录。操作账号需要有 sudo 权限。安装前先更新系统软件包:
sudo dnf update -y
SVN 的 svn:// 服务默认使用 TCP 3690 端口。进入阿里云控制台,找到实例关联的安全组,在入方向添加 TCP 3690 规则。来源地址尽量限制为公司出口 IP 或 VPN 网段,避免长期向所有地址开放。
服务器如果启用了 firewalld,还要单独放行系统防火墙。安全组和系统防火墙各自控制流量,只配置一处可能仍然无法连接:
sudo firewall-cmd –permanent –add-port=3690/tcp
sudo firewall-cmd –reload
安装 Subversion 并创建仓库
使用 dnf 安装 Subversion:
sudo dnf install -y subversion
安装后运行 svnserve --version,确认命令可用。接着创建仓库存放目录,并建立名为 project 的仓库:
sudo mkdir -p /data/svn
sudo svnadmin create /data/svn/project
仓库目录必须允许 svnserve 运行账号读取和写入。生产环境建议创建专用系统账号,例如 svn,再把仓库目录所有权交给该账号;不要让服务长期以 root 身份运行。仓库也不要放在网站公开目录下,配置文件和密码文件更不能提交进代码库。
配置用户认证与仓库权限
创建仓库后,Subversion 会在仓库目录下生成 conf 文件夹,其中有 svnserve.conf、passwd 和 authz。编辑 svnserve.conf,启用认证与授权:
anon-access = none
auth-access = write
password-db = passwd
authz-db = authz
realm = team-project
配置项前要去掉注释符号,并检查拼写和格式。passwd 文件中可以按以下格式添加用户:
alice = 替换为强密码
bob = 替换为另一组强密码
这里的内容只是格式示例,部署时要使用强密码。SVN 自带的密码文件适合简单场景;用户较多,或需要统一身份认证时,应评估更合适的认证方案。还要检查 passwd 和 authz 的文件权限,避免无关系统账号读取凭据。
在 authz 中按组分配权限,例如让 alice 和 bob 都属于开发组,并允许该组读写仓库:
[groups]
dev = alice,bob
[/]
@dev = rw
* = r
以上设置允许其他用户读取仓库。如果仓库只应对指定成员开放,把 * = r 改为 * =,再为需要访问的用户或组单独授权。提交前检查权限规则,避免无意间开放读取或写入。
配置 systemd 服务并设置开机启动
先确认 svnserve 的实际安装路径:
command -v svnserve
下面假设路径为 /usr/bin/svnserve,且系统中已经创建 svn 专用账号。新建 systemd 服务文件:
sudo vi /etc/systemd/system/svnserve.service
写入以下内容:
[Unit]
Description=Subversion Server
After=network.target
[Service]
Type=simple
User=svn
Group=svn
ExecStart=/usr/bin/svnserve –foreground -r /data/svn
Restart=on-failure
[Install]
WantedBy=multi-user.target
如果使用了不同的服务账号、组名或程序路径,需要同步修改 User、Group 和 ExecStart。保存文件后重新加载 systemd,并启动服务、启用开机启动:
sudo systemctl daemon-reload
sudo systemctl enable –now svnserve
sudo systemctl status svnserve
启动失败时,先看 status 输出和系统日志,重点核对 svnserve 路径、仓库目录权限及启动参数。也可以运行 ss -lntp | grep 3690,确认服务是否正在监听端口。
检出测试并排查常见问题
假设团队在维护内部的库存管理系统,服务器公网地址为 203.0.113.10,仓库名为 project。开发者安装 SVN 客户端后,可以用下面的命令检出:
svn checkout svn://203.0.113.10:3690/project
首次连接时输入前面配置的用户名和密码。若连接超时,依次检查阿里云安全组、服务器防火墙和 svnserve 监听状态;若能检出却不能提交,检查 authz 中该用户是否有写权限,并确认仓库目录允许 svn 服务账号写入。
正式迁移项目前,先提交一份测试文件,再让另一名成员检出并尝试提交。这样能验证认证、读写权限和连接配置,而不必等到多人开始使用后才发现权限遗漏。
日常维护与安全注意事项
- 限制端口来源:安全组中的 3690 端口只开放给可信网络。需要远程协作时,优先通过 VPN 或受控网络访问。
- 定期备份:可使用 svnadmin hotcopy 对仓库进行一致性备份,并将备份保存到独立磁盘或对象存储。只把备份留在同一台云服务器上,无法应对服务器故障。
- 检查运行状态:定期查看服务状态、磁盘空间和系统日志,及时安装安全更新,并妥善保管账号凭据。
- 确认传输方式:svn:// 不等同于 HTTPS 加密传输,不适合直接暴露在不可信网络中。需要通过公网安全访问时,可使用 VPN,或部署支持 HTTPS 的 Apache SVN 方案。
阿里云 Linux SVN服务器搭建完成后,先用测试仓库验证检出、提交、权限和备份恢复,再迁移正式项目。小团队使用 svnserve 通常可以满足基础版本管理需求;端口访问范围和账号权限则应在投入使用前检查清楚。