SVN WebUI 管理后台部署及配置指南

背景

用户需要使用 Web 管理页面管理 SVN，对比国产开源管理后台 svnadmin 与 svnWebUI 的功能和部署方式后，选择 svnWebUI。原因是部署方便，仅需 JAR 包和 Java 环境，无需额外服务。

系统环境

• 操作系统：麒麟 V10 x64
• JDK 版本：JDK 17
• SVN 版本：SVN 1.x

服务部署

项目地址：https://gitee.com/cym1102/svnWebUI/#svnwebui（当前版本 1.9.0）

下载软件

wget -O svnWebUI.jar https://gitee.com/cym1102/svnWebUI/releases/download/1.9.0/svnWebUI-1.9.0.jar

注意事项

启动服务后会自动重启 SVN 服务，部署前需提前备份生产数据并通知相关人员。官方文档未提及此行为。

1. 仓库路径：默认仓库目录为 /home/svnWebUI。若不指定路径，启动后 SVN 会重启并将路径设为 /home/svnWebUI/repo，原有仓库将不可用。需将原有仓库复制到 project.home 指定的 repo 目录下。例如指定 /home/svn，则根路径变为 /home/svn/repo。
2. 配置文件：启动后原 svnserver.conf 会被重新生成，passwd 和 authz 文件路径变更，导致用户无权限。需在后台导入用户并按原有策略赋权。

启动命令

nohup java -jar -Dfile.encoding=UTF-8 svnWebUI.jar --server.port=6060 --project.home=/home/svn >/dev/null &

参数说明：

• server.port：指定服务端口，用于访问后台。
• project.home：指定仓库目录。

启动后适配仓库目录至 /home/svn/repo，即可登录使用。

使用方法

1. 登录

   • 地址：http://IP:6060
   • 账号：首次登录需设置管理员账号密码。

2. 系统配置

   • 均为默认配置，SVN 正常启动后状态显示为已启动。

3. 添加仓库

   • 进入仓库管理，支持新建或导入库。
   • 导入库：将原有仓库目录复制到 /home/svn/repo 即可识别。

4. 添加用户

   • 进入用户管理，支持新建或导入用户。
   • 注意：密码不能包含特殊字符。

5. 添加组

   • 进入小组管理，支持新建或导入组。
   • 导入组：导入原有仓库 authz 文件（测试中可能不生效）。