SVN Web 管理工具 svnWebUI 部署与权限配置实战

背景

相比需要 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。首次登录需创建管理员账号。

1. 系统配置：默认配置通常能自动识别已安装的 SVN 服务，状态显示'已启动'即表示正常。
2. 仓库管理：支持新建仓库或导入现有目录。导入时确保目录结构正确，系统会自动扫描。
3. 用户与组：支持新建用户或从旧 passwd 文件导入。注意密码不能包含特殊字符。组管理目前存在导入 authz 文件不生效的情况，建议直接在界面配置。
4. 权限控制：
   • 全体授权：优先级最高。设为'只读'或'读写'后，所有用户均受此限制，覆盖个人授权。
   • 用户/小组授权：针对特定对象设置路径权限（只读、读写、禁止）。
   • 前置条件：管理员账号需先拥有全量权限，否则无法选择具体路径进行细分授权。

注意事项

该系统核心功能已满足日常需求，但在批量授权等高级操作上仍有优化空间。遇到权限冲突时，请优先检查全局授权设置。如有建议，可联系项目维护者反馈。