背景
用户需要使用 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 服务,部署前需提前备份生产数据并通知相关人员。官方文档未提及此行为。
- 仓库路径:默认仓库目录为
/home/svnWebUI。若不指定路径,启动后 SVN 会重启并将路径设为/home/svnWebUI/repo,原有仓库将不可用。需将原有仓库复制到project.home指定的 repo 目录下。例如指定/home/svn,则根路径变为/home/svn/repo。 - 配置文件:启动后原
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,即可登录使用。
使用方法
-
登录
- 地址:http://IP:6060
- 账号:首次登录需设置管理员账号密码。
-
系统配置
- 均为默认配置,SVN 正常启动后状态显示为已启动。
-
添加仓库
- 进入仓库管理,支持新建或导入库。
- 导入库:将原有仓库目录复制到
/home/svn/repo即可识别。
-
添加用户
- 进入用户管理,支持新建或导入用户。
- 注意:密码不能包含特殊字符。
-
添加组
- 进入小组管理,支持新建或导入组。
- 导入组:导入原有仓库 authz 文件(测试中可能不生效)。

