|
|
|
|
# SVNAdmin 系统部署与使用手册
|
|
|
|
|
- 该系统为使用PHP开发的基于web的Subversion（SVN）服务器端管理工具
|
|
|
|
|
|
|
|
|
|
- 支持功能：SVN仓库管理、SVN用户管理、SVN分组管理、目录授权、目录浏览、Hooks管理、在线dump备份、在线备份恢复、SVN用户禁用、服务器状态管理、日志管理、消息通知、更新检测...
|
|
|
|
|
|
|
|
|
|
- 演示地址：http://svnadmin.witersen.com (默认的用户名与密码都为 admin)
|
|
|
|
|
|
|
|
|
|
- 项目地址：
|
|
|
|
|
- GitHub地址：https://github.com/witersen/SvnAdminV2.0
|
|
|
|
|
- Gitee地址：https://gitee.com/witersen/SvnAdminV2.0
|
|
|
|
|
|
|
|
|
|
- 发行包：
|
|
|
|
|
- GitHub：https://github.com/witersen/SvnAdminV2.0/releases/download/v2.3/v2.3.zip
|
|
|
|
|
- Gitee：https://gitee.com/witersen/SvnAdminV2.0/attach_files/1059115/download/v2.3.zip
|
|
|
|
|
|
|
|
|
|
- 兼容性
|
|
|
|
|
- 操作系统：CentOS7（推荐）、CentOS8、Rocky、Ubuntu（Windows及其它Linux发行版正在测试兼容中）
|
|
|
|
|
- PHP版本：5.5 <= PHP < 8.0
|
|
|
|
|
- 数据库：SQLite、MySQL
|
|
|
|
|
- Subversion：1.8+
|
|
|
|
|
|
|
|
|
|
- 可以加群提建议或分享问题： QQ群 633108141
|
|
|
|
|
|
|
|
|
|
## 一、安装示例
|
|
|
|
|
|
|
|
|
|
### 1、在CentOS7.6操作系统裸机安装示例
|
|
|
|
|
|
|
|
|
|
- 安装PHP和相关扩展
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
#解压缩和网络获取工具
|
|
|
|
|
yum install -y zip unzip wget
|
|
|
|
|
|
|
|
|
|
#由于CentOS7默认源中提供的PHP版本为5.4，因此我们使用remi源安装不同php版本
|
|
|
|
|
yum install -y epel-release
|
|
|
|
|
wget http://rpms.remirepo.net/enterprise/remi-release-7.rpm
|
|
|
|
|
rpm -Uvh remi-release-7.rpm
|
|
|
|
|
|
|
|
|
|
#编辑 /etc/yum.repos.d/remi.repo 文件，将想安装的PHP版本下方的enable由0改为1
|
|
|
|
|
vim /etc/yum.repos.d/remi.repo
|
|
|
|
|
|
|
|
|
|
#开始安装php及相关扩展
|
|
|
|
|
yum install -y php
|
|
|
|
|
yum install -y php-common
|
|
|
|
|
yum install -y php-cli
|
|
|
|
|
yum install -y php-fpm
|
|
|
|
|
yum install -y php-json
|
|
|
|
|
yum install -y php-mysqlnd
|
|
|
|
|
yum install -y php-process
|
|
|
|
|
yum install -y php-json
|
|
|
|
|
yum install -y php-gd
|
|
|
|
|
yum install -y php-bcmath
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- 安装web服务器
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
#以apache为例
|
|
|
|
|
yum install -y httpd
|
|
|
|
|
systemctl start httpd
|
|
|
|
|
systemctl enable httpd
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- 安装本程序
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
#将代码包下载到 /var/www/html/ 目录并解压
|
|
|
|
|
cd /var/www/html/
|
|
|
|
|
|
|
|
|
|
#代码包从发行版获取
|
|
|
|
|
wget https://gitee.com/witersen/SvnAdminV2.0/attach_files/1059115/download/v2.3.zip
|
|
|
|
|
|
|
|
|
|
#解压
|
|
|
|
|
unzip v2.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- 安装Subversion（如果你安装过Subversion，本步骤可以略过）
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
#由于CentOS7.6默认源中的Subversion版本为1.7 因此我们需要通过安装脚本安装高版本（>=1.8）
|
|
|
|
|
|
|
|
|
|
#切换目录
|
|
|
|
|
cd /var/www/html/server/
|
|
|
|
|
|
|
|
|
|
#install.php文件可以帮助我们安装Subversion
|
|
|
|
|
php install.php
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- 修改Subversion的配置使其支持被本系统管理
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
#切换到目录
|
|
|
|
|
cd /var/www/html/server
|
|
|
|
|
|
|
|
|
|
#install.php文件可以帮助我们配置Subversion
|
|
|
|
|
php install.php
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- 启动本程序的后台进程
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
#以守护进程模式启动（通常情况下是这样）
|
|
|
|
|
php svnadmind.php start
|
|
|
|
|
|
|
|
|
|
#以调试模式启动（出问题可自行调试）
|
|
|
|
|
php svnadmin.php console
|
|
|
|
|
|
|
|
|
|
#停止（有问题或想停止服务，可自行停止）
|
|
|
|
|
php svandmin.php stop
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- 将本程序加入开机自启（可选）
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
todo ..........
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 2、在安装宝塔面板的操作系统安装示例
|
|
|
|
|
|
|
|
|
|
- 创建站点
|
|
|
|
|
- 将PHP的命令行版本更换为要求的php版本
|
|
|
|
|
- 关闭站点的 open_basedir 防跨站攻击选项
|
|
|
|
|
- 将站点的PHP版本更换为要求的PHP版本
|
|
|
|
|
- 在软件商店对应版本的php中删除禁用的函数
|
|
|
|
|
- pcntl_signal
|
|
|
|
|
- pcntl_fork
|
|
|
|
|
- pcntl_wait
|
|
|
|
|
- shell_exec
|
|
|
|
|
- passthru
|
|
|
|
|
- 安装和启动
|
|
|
|
|
- 进入server目录
|
|
|
|
|
- php install.php 进行安装和配置Subversion
|
|
|
|
|
- php svnadmind.php start 启动后台程序
|
|
|
|
|
|
|
|
|
|
### 3、在ubutntu18安装示例
|
|
|
|
|
|
|
|
|
|
- 注意以root用户执行 server/install.php 和 server/install.php 即可
|
|
|
|
|
|
|
|
|
|
### 4、在Rocky安装示例
|
|
|
|
|
|
|
|
|
|
- 无注意事项 同1
|
|
|
|
|
|
|
|
|
|
## 二、docker安装
|
|
|
|
|
|
|
|
|
|
- 暂无时间制作docker包，等待大家贡献或者自己有时间去做
|
|
|
|
|
|
|
|
|
|
## 三 、功能介绍
|
|
|
|
|
|
|
|
|
|
- 登录界面可分角色登录，配合后端实现的登录验证码更安全
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 服务器状态监控和信息统计，对当前服务器状态和SVN仓库信息更加了解
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- SVN仓库概览，提供了多种高级功能，还可根据仓库名、版本数、体积等一键排序
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 新建SVN仓库提供两种模式 随意选择
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 在线目录浏览更加方便 逐层加载，服务资源占用更低
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 通过目录面包屑可以随时回到某级目录 可以看到目录的作者、版本、提交日期、提交日志等，还可一键复制检出地址
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 仓库授权精确到文件级别，可对用户和用户组快速授权和更改权限
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 支持在线dump方式备份，备份文件可随时下载或删除
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 支持对SVN仓库钩子的管理
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 提供了常用钩子，也可以将自己的常用钩子放在这里
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 可以查看每个仓库的详细信息，一键复制详细信息更加方便
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 可以将通过dump方式备份的文件再导入仓库 实现SVN仓库的迁移
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 仓库导入过程中如果抛出了错误信息会被收集被显示 方便管理人员更好的定位问题
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 可以很方便的修改仓库名称，这会自动同步配置文件，所以无需担心
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 删除仓库也会有风险提示
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- SVN用户管理支持启用、禁用、添加备注信息，管理用户更加方便
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- SVN分组支持显示其包含的用户和分组数量 同时支持修改备注信息
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 可以对分组进行用户成员编辑，系统会贴心的提示用户是否处于禁用状态
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 用户管理支持组嵌套，同时如果你不小心搞了一个循环嵌套，系统会提示你
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 分组名支持修改，系统会帮你修改配置文件的一切，无需担心
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 系统提供了日志功能，可以对系统的运转情况做个记录啦
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 管理人员可以修改自己的账号和密码，更加安全
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 系统提供了svnserve主机和端口绑定功能 而且开启了svnserve的运行日志 为你多一层运维保障
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 看看你的数据都在哪里存储呢
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 配置邮件通知服务吧
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 风险操作可以来个提示
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 看看有没有新版本吧
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- SVN用户个人的界面 只可看到被授权的仓库路径
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- SVN用户可自己修改密码 无需联系管理人员了
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 四、待办事项
|
|
|
|
|
|
|
|
|
|
### 1、计划增加功能
|
|
|
|
|
|
|
|
|
|
- [ ] 支持常见文件在线浏览
|
|
|
|
|
- [ ] 支持文件和文件夹在线下载
|
|
|
|
|
- [x] 支持重设仓库UUID
|
|
|
|
|
- [ ] 删除仓库需要输入管理人员密码
|
|
|
|
|
- [ ] 支持修改应用根目录
|
|
|
|
|
- [ ] 支持authz、passwd文件的在线识别导入和导出
|
|
|
|
|
- [ ] docker部署
|
|
|
|
|
- [ ] 邮件发送和仓库备份等使用异步任务
|
|
|
|
|
- [ ] 支持在线仓库版本过滤、仓库版本互传
|
|
|
|
|
- [ ] 在仓库列表以突出颜色标记不被支持管理的仓库，如低版本的仓库
|
|
|
|
|
- [ ] 支持webhook
|
|
|
|
|
- [ ] 支持配置OSS进行备份
|
|
|
|
|
- [ ] 支持修改封面背景图片
|
|
|
|
|
- [ ] 仓库目录树视图中，文件或目录被授权过会有红点提示
|
|
|
|
|
- [ ] 增加多种备份方式的支持：如 svnadmin hotcopy
|
|
|
|
|
- [ ] 安装svnadmin的机器之间可进行远程同步
|
|
|
|
|
- [ ] 支持使用svnauthz-validate检查authz配置信息的正确性作为高级功能
|
|
|
|
|
- [ ] 支持使用三种认证选项（Apache+mod_dav_svn、svnserve(用户文件和SASL)、svnserve+SSH）
|
|
|
|
|
- [ ] 开发微信小程序端开发（针对提交提醒）
|
|
|
|
|
|
|
|
|
|
### 2、计划改进部分
|
|
|
|
|
|
|
|
|
|
## 五、旧版本如何升级
|
|
|
|
|
|
|
|
|
|
由于v2.3版本改动较大，因此需要使用之前版本的用户进行手动配置升级，具体操作步骤如下：
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
#假设你的代码部署在 /var/www/html/ 目录下
|
|
|
|
|
cd /var/www/html/
|
|
|
|
|
```
|
|
|
|
|
- 停止守护进程
|
|
|
|
|
```
|
|
|
|
|
#停止旧版本的守护进程
|
|
|
|
|
php server/svnadmind.php stop
|
|
|
|
|
```
|
|
|
|
|
- 升级Subversion版本（1.8+）
|
|
|
|
|
```
|
|
|
|
|
#执行脚本并选择使用第1个选项
|
|
|
|
|
php server/install.php
|
|
|
|
|
```
|
|
|
|
|
- 执行适配程序
|
|
|
|
|
```
|
|
|
|
|
#执行脚本并选择使用第2个选项
|
|
|
|
|
php server/install.php
|
|
|
|
|
```
|
|
|
|
|
- 启动守护进程
|
|
|
|
|
```
|
|
|
|
|
php server/svnadmind.php start
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 六、常见问题解答
|
|
|
|
|
|
|
|
|
|
### 1、如何将已有的SVN仓库使用此系统管理 ？
|
|
|
|
|
|
|
|
|
|
- （1）安装本系统
|
|
|
|
|
- （2）执行 php server/install.php 使用内置的功能重新配置你的Subversion
|
|
|
|
|
- （3）将已有的一个或多个SVN仓库移动到 /home/svnadmin/rep/ 目录下
|
|
|
|
|
- （4）刷新管理系统的仓库管理页面即可识别SVN仓库
|
|
|
|
|
- （5）注意此方式并不会识别SVN仓库原有的用户以及权限配置，因为我们使用了统一的配置文件来进行用户和权限管理，因此迁移仓库后还需要在管理系统重新添加用户、用户组、配置权限！
|
|
|
|
|
|
|
|
|
|
### 2、如何将数据库切换为MySQL ？
|
|
|
|
|
|
|
|
|
|
- 你只需要修改 config/database.php 将sqlite部分注释并配置你的MySQL即可
|
|
|
|
|
|
|
|
|
|
### 3、为什么只支持管理Subversion1.8+ ？
|
|
|
|
|
|
|
|
|
|
- 由于Subversion1.8 之前不支持将多个仓库配置为使用相同的权限配置文件
|
|
|
|
|
- 而我们一开始基于Subversion1.10进行开发，因此没有及时的对Subversion1.7等版本进行适配
|
|
|
|
|
|
|
|
|
|
### 4、为什么目前只支持Linux操作系统 ？
|
|
|
|
|
|
|
|
|
|
- 正在使用新方案对Windows操作系统进行支持测试
|
|
|
|
|
- 预期目标为可安装Subversion和PHP的机器都可使用本软件
|
|
|
|
|
|
|
|
|
|
### 5、仓库初始化结构模板 ？
|
|
|
|
|
|
|
|
|
|
- 我们可以在创建仓库的时候选择创建指定内容结构的仓库，如包含 "trunk" "branches" "tags" 文件夹的结构，这一结构是可选的并且可调整的，我们可以手动调整 /home/svnadmin/templete/initStruct/01/ 下的目录结构
|
|
|
|
|
|
|
|
|
|
### 6、常用钩子推荐 ？
|
|
|
|
|
|
|
|
|
|
- 我们可以在目录 /home/svnadmin/hooks/ 下增加自己常用的钩子
|
|
|
|
|
- /home/svnadmin/hooks/ 下建立文件夹 xx，名称任意
|
|
|
|
|
- 在 xx 下新建文件 hookDescription 写入对此钩子的描述文本内容
|
|
|
|
|
- 在 xx 下新建文件 hookName 写入钩子类型，如post-commit等
|
|
|
|
|
- 在 xx 下新建文件 ，以钩子类型命名，如 post-commit ，然后写入具体钩子内容
|
|
|
|
|
- 感谢 【北方糙汉子-】提供的钩子脚本
|
|
|
|
|
|
|
|
|
|
### 7、关于Subversion 权限配置中的魔力符号
|
|
|
|
|
|
|
|
|
|
- Subversion从1.5开始支持用户使用一些魔力符号如 $authenticated 、$anonymous
|
|
|
|
|
- 我们使用正则表达式对authz和passwd文件进行匹配和修改
|
|
|
|
|
- 由于时间原因，暂时不支持用户的authz文件中使用 Subversion 支持的魔力符号
|
|
|
|
|
|
|
|
|
|
### 8、关于与LDAP对接
|
|
|
|
|
|
|
|
|
|
- 与LDAP的对接将会等待一段时间，因为还需要时间使当前版本更稳定
|
|
|
|
|
|
|
|
|
|
### 9、本软件的工作模式
|
|
|
|
|
|
|
|
|
|
- 通过使 svnadmind.php 成为守护进程并监听指定端口来工作
|
|
|
|
|
- php-fpm与php-cli程序的使用TCP套接字通信
|
|
|
|
|
|
|
|
|
|
|
