cym1102/svnwebui

svnWebUI

介绍

svnWebUI是一款SVN服务端Web图形化管理工具，旨在简化SVN服务器搭建与配置流程。 GitHub地址：https://github.com/cym1102/svnWebUI QQ技术交流群1：*** QQ技术交流群2：560797506 ：

功能说明

作为图形化Subversion配置工具，svnWebUI解决了传统SVN服务端依赖手写配置文件的繁琐问题。尽管Git已广泛应用，但SVN在公司内部文档管理与共享等场景中仍具优势，其概念简单，适合非技术人员使用。现有图形界面工具普遍存在安装复杂、依赖环境老旧（如CSVN依赖Python 2）等问题，而Windows平台的VisualSVN缺乏Web界面且需远程桌面配置，安全性较低。本工具致力于提供现代化SVN服务端管理体验，类比Gitea的便捷性。

技术说明

基于Solon框架开发的Java项目，默认使用H2本地数据库（无需额外安装），同时兼容MySQL。使用前需先安装Subversion。 演示地址：[***] 用户名：admin 密码：admin

安装说明

普通安装（需预先安装依赖）

1. 安装Java运行环境与Subversion

   • Ubuntu：

     apt update
     apt install openjdk-11-jdk
     apt install subversion
     

   • CentOS：

     yum install java-11-openjdk
     yum install subversion
     

   • Windows： 下载JDK安装包（[***] JAVA_HOME设为JDK安装目录，Path添加JDK安装目录\bin，重启电脑。

2. 下载发行包

   • Linux：

     wget -O /home/svnWebUI/svnWebUI.jar http://file.nginxwebui.cn/svnWebUI-1.4.0.jar
     

   • Windows：直接通过浏览器下载[***]

3. 启动程序

   • Linux：

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

   • Windows：

     java -jar -Dfile.encoding=UTF-8 D:/home/svnWebUI/svnWebUI.jar --server.port=6060
     

   参数说明（非必填）： --server.port：端口（默认6060） --project.home：配置文件目录（默认/home/svnWebUI/，存放仓库、数据库文件等） --database.type=mysql：使用MySQL数据库（默认H2） --database.url、--database.username、--database.password：MySQL连接参数。

Docker安装（推荐，集成Subversion、Apache2，支持HTTP访问）

支持x86/x86_64/arm64平台，包含完整运行环境。

1. 安装Docker环境

   • Ubuntu：apt install docker.io
   • CentOS：yum install docker

2. 拉取镜像：

   docker pull cym1102/svnwebui:latest
   

3. 启动容器：

   docker run -itd -v /home/svnWebUI:/home/svnWebUI --privileged=true -p 6060:6060 -p 3690:3690 cym1102/svnwebui:latest
   

   注意：需映射6060（Web界面）和3690（SVN默认端口）；/home/svnWebUI目录挂载用于持久化数据（配置、数据库、日志等），升级镜像时需备份此目录。

编译与开机启动

• 编译：Maven打包 mvn clean package；Docker构建 docker build -t svnwebui:latest .
• 开机启动（systemd）： 创建服务文件 /etc/systemd/system/svnwebui.service：

  [Unit]
  Description=SvnWebUI
  After=syslog.target network.target
  [Service]
  Type=simple
  User=root
  Group=root
  WorkingDirectory=/home/svnWebUI
  ExecStart=/usr/bin/java -jar /home/svnWebUI/svnWebUI.jar
  Restart=always
  [Install]
  WantedBy=multi-user.target
  

  执行命令：

  systemctl daemon-reload
  systemctl enable svnwebui.service
  systemctl start svnwebui.service
  

使用说明

访问 [***] 进入系统，首次使用需注册管理员账户，登录后可进行：

• 个人管理：查看所属仓库、修改密码
• 服务管理：查看Subversion服务状态，执行启停/重启
• 仓库管理：创建/编辑仓库，获取SVN访问地址
• 授权管理：对用户/小组进行仓库目录级权限配置
• 用户/小组管理：添加编辑用户（区分管理员/普通用户）及小组。

找回密码

若忘记密码，停止服务后执行：

java -jar svnWebUI.jar --project.home=/home/svnWebUI/ --project.findPass=true

（--project.home为实际配置目录），程序将打印所有用户的用户名与密码。