SVN Web 管理后台 svnWebUI 部署与使用

背景

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

系统环境

麒麟 V10，X64 JDK 17 SVN 1.45.5

服务部署

项目地址：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 服务，需提前备份生产环境数据并通知相关人员。默认仓库地址为 /home/svnWebUI，若不指定路径，原有仓库将不可用。建议指定 project.home 参数映射原有仓库目录。

启动后原有项目的 svnserver.conf 内容会重新生成，passwd 和 authz 文件路径变更可能导致用户无权限访问，需在后台导入用户并按原策略赋权。

启动命令示例：

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

启动后需将原有仓库目录复制到 /home/svn/repo 目录，之后即可登录后台使用服务。

使用方法

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

2. 系统配置 默认为自动识别，SVN 状态显示已启动即可。

3. 添加仓库

   • 新建仓库：支持中英文名称。
   • 导入库：将原有仓库目录复制到 /home/svn/repo，确认后在列表中可见。

4. 添加用户

   • 新建用户：密码不能含有特殊字符。
   • 导入用户：使用原有仓库的 passwd 文件导入。

5. 添加组

   • 新建小组：支持中英文名称。
   • 导入小组：导入原有仓库 authz 文件（测试未生效，原因待查）。

6. 赋权

   • 全体授权：
     • 禁用：所有用户无访问权限。
     • 只读：所有用户有只读权限，优先级高于用户或小组授权。
     • 读写：所有用户有读写权限，优先级高于用户或小组授权。

7. 用户授权

   • 前置条件：管理员账号需拥有所有权限，否则无法选择具体路径。
   • 操作：勾选用户，选择路径分配权限（只读、读写、禁止）。若不需细分，选择根目录即可。
   • 注意：若全体授权已分配权限，其优先级高于用户授权。例如全体授权赋予读写权限时，用户授权中的禁用设置无效。