SVNAdmin2 - 基於web的SVN管理系統

witersen 發表於 2022-12-04

1. 介紹

  • SVNAdmin2 是一款透過圖形介面管理服務端SVN的web程式

  • 正常情況下配置SVN倉庫的人員許可權需要登入到伺服器手動修改 authz 和 passwd 兩個檔案,當倉庫結構和人員許可權上了規模後,手動管理就變的非常容易出錯,本系統能夠識別人員和許可權並提供管理和擴充功能。

  • SVNAdmin2 支援SVN協議檢出、HTTP協議檢出,並且支援兩種協議之間互相切換,支援docker部署或原始碼部署。

  • SVNAdmin2 支援進行LDAP的接入,進而達到使用原有的人員架構和分組規則的目的。

  • SVNAdmin2 第一個版本(20年初)被開發用來個人管理SVN倉庫使用,無意中開源後發現使用者漸多,於是開始專門維護迭代。

  • GitHub地址 Gitee地址

  • 問題求助、功能建議、更新計劃、SVN技術討論,可加QQ群:633108141

  • 專案演示地址:http://svnadmin.witersen.com (管理人員/admin/admin)

  • 系統截圖

SVNAdmin2 - 基於web的SVN管理系統

2. 相容性

docker > CentOS7 > CentOS8 > Rocky > Ubuntu

Windows下如有需求,可使用 docker 版本

PHP版本:PHP 5.5+ 推薦 PHP 7.0 +

資料庫:SQLite、MySQL

Subversion:1.8+

3. docker安裝

3.1 適用於:快速部署看效果

此方式可快速部署程式體驗效果,資料不儲存在宿主機,生產環境慎用

docker run -d --name svnadmintemp -p 80:80 -p 3690:3690 --privileged witersencom/svnadmin:2.4.3
3.2 適用於:新使用者正式使用
  • 啟動一個臨時的容器用於複製配置檔案出來
docker run -d --name svnadmintemp --privileged witersencom/svnadmin:2.4.3 /usr/sbin/init
  • 把配置檔案複製到本機的 /home/svnadmin 目錄
cd /home/ && docker cp svnadmintemp:/home/svnadmin ./
  • 刪除掉臨時容器
docker stop svnadmintemp && docker rm svnadmintemp
  • 啟動正式的容器
docker run -d -p 80:80 -p 3690:3690 -v /home/svnadmin/:/home/svnadmin/ --privileged --name svnadmin witersencom/svnadmin:2.4.3
  • 進入容器內進行檔案授權
docker exec -it svnadmin bash
chown -R apache:apache /home/svnadmin
3.3 適用於:舊使用者升級
  • 2.4.x 之前的使用者升級到2.4.x (可以聯網的使用者)
    • 進入容器內
    • yum install -y unzip
    • cd /var/www/html/server && php install.php
    • yum install -y unzip cyrus-sasl cyrus-sasl-lib cyrus-sasl-plain mod_dav_svn mod_ldap mod_php php-ldap cronie at
    • httpd -k graceful
    • chown -R apache:apache /home/svnadmin/
    • php svnadmind.php stop
    • nohup svnadmind.php start &
  • 2.4.x 之前的使用者升級到2.4.x (不可聯網的使用者)
    • 在有網路的環境下下載升級包,注意下載 update.tar.gz 而不是 update.zip
    • 提前下載好升級包並複製到容器中 /var/www/html/server/ 目錄下
    • cd /var/www/html/server/
    • tar -zxvf update.tar.gz
    • php update/index.php
    • 退出容器
    • 停止舊的容器,拉取新容器,掛載本地的資料目錄到新版本的容器即可

4. 原始碼安裝

4.1 適用於:CentOS7、Rocky等
  • 安裝解壓縮等工具
yum install -y zip unzip wget vim which
  • 安裝sasl相關依賴(svn協議檢出配置sasl認證如ldap要用到)
yum install -y cyrus-sasl cyrus-sasl-lib cyrus-sasl-plain
  • 安裝PHP和相關擴充套件(CentOS7預設源中提供的PHP版本為5.4,而我們需要 5.5+,因此使用remi源)
yum install -y epel-release yum-utils
rpm -Uvh https://mirrors.aliyun.com/remi/enterprise/remi-release-7.rpm
yum-config-manager --enable remi-php74

yum install -y php php-common php-cli php-fpm php-mysqlnd php-mysql php-pdo php-process php-json php-gd php-bcmath php-ldap
  • 安裝web伺服器(推薦 apache 可使用http協議檢出)
yum install -y httpd mod_dav_svn
systemctl start httpd
systemctl enable httpd
  • 安裝任務計劃元件(任務計劃功能用到)
yum install -y cronie at
  • 下載解壓程式碼包
cd /var/www/html/ && wget https://gitee.com/witersen/SvnAdminV2.0/releases/download/v2.4.3/2.4.3.zip

unzip v2.4.3.zip
  • 安裝Subversion(如果你安裝過Subversion,本步驟可以略過)(注意需要Subversion >= 1.8)
cd /var/www/html/server/
#選項1
php install.php
  • 修改Subversion的配置使其支援被本系統管理
cd /var/www/html/server
#選項1或選項2
php install.php
  • 為資料目錄授權屬主和屬組。php指令碼web呼叫是以apache身份執行,因此apache使用者需要對資料目錄有權
  • 如果你使用其它web伺服器如nginx tomcat 可以透過瀏覽器訪問 你的機器IP/server/own.php 來獲取屬主和屬組
chown -R apache:apache /home/svnadmin
  • 手動啟動後臺程式(啟動方式一)

    #pwd
    /var/www/html
    
    #後臺執行
    nohup php svnadmind.php start >/dev/null 2>&1 &
    
    #停止後臺
    php svnandmin.php stop
    
    #除錯模式
    php svnadmin.php console
    
  • 透過系統管理啟動後臺程式(啟動方式二)

    • 新建系統服務檔案 svnserve.service(centos一般為 /usr/lib/systemd/system/svnserve.service、ubuntu 一般為 /lib/systemd/system/svnserve.service)
      • 寫入以下內容(注意根據自己的程式碼部署路徑調整)
    [Unit]
    Description=SVNAdmin
    After=syslog.target network.target
    
    [Service]
    Type=simple
    ExecStart=/usr/bin/php /var/www/html/server/svnadmind.php start
    
    [Install]
    WantedBy=multi-user.target
    
    • 操作服務
    #啟動
    systemctl daemon-reload
    systemctl start svnadmind
    
    #檢視狀態
    systemctl status svnadmind
    
    #加入開機自啟動
    systemctl enable svnadmind
    
4.2 適用於:寶塔皮膚
4.3 適用於:ubutntu18
  • 步驟同1(注意需要以root使用者執行 server/install.php 和 server/svnadmind.php )
  • 在ubuntu中軟體包名稱多與CentOS系列不同,需要使用者自行處理
sudo apt-get update

sudo apt-get install -y apache2
sudo apt-get install -y php
sudo apt-get install -y php-cli
sudo apt-get install -y php-fpm

sudo a2enmod proxy_fcgi setenvif
sudo systemctl restart apache2
sudo a2enconf php7.2-fpm
sudo systemctl reload apache2

sudo apt-get install -y php-json

sudo apt-get install -y php7.2-mysql
sudo apt-get install -y php-mysql

sudo apt-get install -y sqlite3

sudo apt-get install -y php7.2-sqlite

sudo apt-get install -y php-gd

sudo systemctl restart apache2

sudo apt-get install -y subversion subversion-tools

cd /var/www/html

wget xxx.zip

unzip xxx.zip

#選項2
sudo server/install.php

chown -R apache:apache /home/svnadmin/

su root

nohup php server/svnadmind.php start &
4.4 適用於:舊使用者升級
  • 2.4.x 之前的使用者升級到2.4.x
    • yum install -y unzip
    • cd /var/www/html/server && php install.php
    • yum install -y unzip cyrus-sasl cyrus-sasl-lib cyrus-sasl-plain mod_dav_svn mod_ldap mod_php php-ldap cronie at
    • httpd -k graceful (如果web伺服器不是apache則不需要重啟)
    • chown -R apache:apache /home/svnadmin/(如果web伺服器不是apache可看上方關於 own.php 使用說明)
    • php svnadmind.php stop
    • nohup svnadmind.php start & (如果你有自己的啟動方式則使用自己的啟動方式)
  • 2.4.x 之後的升級
    • 執行 php code/server/install.php,沒有升級包則需要手動升級
    • 手動升級,直接重新下載安裝包覆蓋之前的程式碼即可
    • 由於下載的新程式碼沒有之前的配置資訊,所重新修改自己的配置檔案
      • 資料庫配置資訊web/config/database.php
      • 主目錄配置資訊 web/config/svn.php
      • 二進位制檔案配置檔案 web/config/bin.php

5. 常見問題解答

5.1 使用此係統管理管理之前的倉庫 ?
  • 確認之前SVN倉庫的版本,如果是1.8+則無需擔心,如果是1.8以下,則需要簡單升級下倉庫

  • 安裝本系統

  • 執行 php server/install.php 使用內建的功能重新配置你的Subversion

  • 將已有的一個或多個SVN倉庫移動到 /home/svnadmin/rep/ 目錄下

  • 在導航SVN倉庫中執行同步列表,即可識別SVN倉庫

  • 注意:如果你原來是一個倉庫一套配置檔案的方式,則還需要按照截圖的方式稍微調整下你的配置檔案。因為現在是多個倉庫一套配置檔案的管理方式。

SVNAdmin2 - 基於web的SVN管理系統

5.2 如何將資料庫切換為MySQL ?
  • 建立資料庫 svnadmin
  • 將安裝包中的MySQL檔案 templete/database/mysql/svnadmind.sql 匯入資料庫
  • 修改 config/database.php 將sqlite部分註釋並配置你的MySQL即可
  • 注意:若php版本過低而MySQL版本>=8.0,則會提示:The server requested authentication method unknown to the client,只需要升級php版本或者修改MySQL資料庫的配置資訊即可
5.3 為什麼只支援管理Subversion1.8+ ?
  • 因為目前是透過多個倉庫讀取一套配置檔案的方式,而subversion1.8+才支援這種方式
  • 預計在 2.5.x 版本向下適配,支援管理 Subversion 1.5+
5.4 為什麼目前只支援Linux作業系統 ?
  • 系統中使用了一些多程式的方案,而這在Windows下實現需要花費更多的時間

  • 短期內沒有支援Windows部署的計劃

  • Windows下使用可透過docker版本

5.5 倉庫初始化結構模板 ?
  • 我們可以在建立倉庫的時候選擇建立指定內容結構的倉庫,如包含 "trunk" "branches" "tags" 資料夾的結構,這一結構是可選的並且可調整的,我們可以手動調整 /home/svnadmin/templete/initStruct/01/ 下的目錄結構
5.6 常用鉤子推薦 ?
  • 我們可以在目錄 /home/svnadmin/hooks/ 下增加自己常用的鉤子
    • /home/svnadmin/hooks/ 下建立資料夾 xx,名稱任意
    • 在 xx 下新建檔案 hookDescription 寫入對此鉤子的描述文字內容
    • 在 xx 下新建檔案 hookName 寫入鉤子型別,如post-commit等
    • 在 xx 下新建檔案 ,以鉤子型別命名,如 post-commit ,然後寫入具體鉤子內容
5.7 管理員找回密碼
  • 使用預設的SQLite資料庫
#使用sqlite資料庫

yum install -y sqlite-devel

cd /home/svnadmin

sqlite3 svnadmin.db

.header on

.mode column

select * from admin_users;
  • 使用MySQL資料庫
    • 使用視覺化工具登入到資料庫檢視 admin_users 資料表資訊即可
5.8 關於大檔案下載中斷問題
  • 當下載1G以及以上的大檔案會出現下載被中斷的問題,是因為檔案下載為了安全沒有使用http檔案直鏈,而是透過php校驗後讀取檔案流下載,所以會存在一個php-fpm最大執行時間的問題,因此你可以透過 設定 php-fpm.conf 配置檔案的 request_terminate_timeout 為0 來取消超時限制
5.9 如果配置了多個倉庫模板,如何在建立倉庫時指定使用某個倉庫模板?
例如: 
在 /home/svnadmin/templete/initStruct/01 下面配置第一個倉庫結構模板
在 /home/svnadmin/templete/initStruct/02 下面配置第二個倉庫結構模板
如果在web中建立時,如何選用預設的 /home/svnadmin/templete/initStruct/02 下面的倉庫結構模板?
【解決方案】
由於時間問題,開發時並沒有對此功能做更多的詳細開發,因此只預留了配置檔案層面的修改途徑,後續會將倉庫模板功能加入到web配置,無需手動命令列管理
可以透過修改 config/svn.php 中的 templete_init_struct_01 值來修改
5.10 配置了自定義倉庫模板但是建立倉庫時沒有生效
注意配置自定義倉庫模板的位置 
通常的位置在 /home/svnadmin/templete/initStruct/01 下面 
而不是在專案程式碼相關的位置
5.11 資料長度超過8192 請向上調整引數:SOCKET_READ_LENGTH
【出現問題原因】
svn的使用者量和許可權配置數量增加,超過了預設值
【解決方案】
修改 config/daemon.php 檔案中的 SOCKET_READ_LENGTH 和 SOCKET_WRITE_LENGTH 
設定到133693415 位元組也就是大約小於128M貌似都是可以的,再大沒有測試過
修改後別忘記要重啟守護程式,重啟守護程式的方式根據安裝方式的不同而不同(不重啟會出問題)
【適用版本】
2.1.0+

6. ❤️ 捐贈感謝

  • 本人工作之餘大部分的時間精力都投入在了 SVNAdmin2
  • 如果有可能,希望得到各位使用者的捐贈鼓勵,捐贈更多代表的是認可,作者會繼續動力更新的!
捐贈者 渠道 時間
[email protected]穿褲衩的狐狸 QQ 2021-08-19
[email protected] 微信 2022-10-10
[email protected]_ 微信 2022-11-16
[email protected]小吳飛刀丶mike 微信 2022-11-16
[email protected]_zhu Gitee 2022-11-18
[email protected]三多~(๑°3°๑) 支付寶 2022-11-28
[email protected]*h 微信 2022-11-30
SVNAdmin2 - 基於web的SVN管理系統 SVNAdmin2 - 基於web的SVN管理系統