背景
相比需要 PHP 和数据库支持的方案,选择 svnWebUI 主要因其轻量级特性:仅需 Java 环境和 JAR 包即可运行,适合快速验证或中小型项目。
环境准备
- 操作系统:麒麟 V10 (X64)
- JDK:17
- SVN Server:1.45.5(具体版本视实际环境而定)
部署步骤
项目源码托管于 Gitee,当前稳定版本为 1.9.0。
下载与启动
直接下载发布版 JAR 包并启动:
wget -O svnWebUI.jar https://gitee.com/cym1102/svnWebUI/releases/download/1.9.0/svnWebUI-1.9.0.jar
启动参数中需指定端口和项目根目录。注意:该服务启动时会尝试自动重启 SVN 服务并修改仓库路径,生产环境操作前务必备份数据并通知相关人员。
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,若原有仓库不在该位置,需手动将原仓库内容复制至新目录下,否则会导致无法访问。此外,服务启动后可能会重新生成 svnserver.conf,导致原有的 passwd 和 authz 文件路径失效,需在后台重新导入用户策略。
功能使用
启动完成后,通过浏览器访问 http://IP:6060。首次登录需创建管理员账号。
- 系统配置:默认配置通常能自动识别已安装的 SVN 服务,状态显示'已启动'即表示正常。
- 仓库管理:支持新建仓库或导入现有目录。导入时确保目录结构正确,系统会自动扫描。
- 用户与组:支持新建用户或从旧
passwd文件导入。注意密码不能包含特殊字符。组管理目前存在导入authz文件不生效的情况,建议直接在界面配置。 - 权限控制:
- 全体授权:优先级最高。设为'只读'或'读写'后,所有用户均受此限制,覆盖个人授权。
- 用户/小组授权:针对特定对象设置路径权限(只读、读写、禁止)。
- 前置条件:管理员账号需先拥有全量权限,否则无法选择具体路径进行细分授权。
注意事项
该系统核心功能已满足日常需求,但在批量授权等高级操作上仍有优化空间。遇到权限冲突时,请优先检查全局授权设置。如有建议,可联系项目维护者反馈。

