svn服務(wù)器配置說明

1、<p>　　SVN服務(wù)器配置說明 </p><p><b>　　1、前 言</b></p><p>　　花了72小時(shí)，終于把 Subversion 初步掌握了。從一個(gè)連“什么是版本控制”都不知道的門外漢，到配置出精確至每目錄訪問的入門者，中間還卡了一天時(shí)間。其中費(fèi)了許多氣力，摸索實(shí)驗(yàn)了多次，還差點(diǎn)放棄了，但是收獲是巨大的。現(xiàn)把我的配置和學(xué)習(xí)過程寫下來，供大家

2、參考，也讓初學(xué)者少走彎路。</p><p>　　以下僅以 Windows 平臺(tái)為例講解，Unix/Linux 平臺(tái)請(qǐng)參考相關(guān)資料。如其中有謬誤的地方，包括錯(cuò)別字，請(qǐng)聯(lián)系我修訂。</p><p><b>　　技術(shù)在分享中進(jìn)步！</b></p><p><b>　　2、基本概念</b></p><p>

3、　　2.1、什么是版本控制</p><p>　　簡單點(diǎn)來說，版本控制就是數(shù)據(jù)倉庫，它可以記錄你對(duì)文件的每次更改。這樣，就算你在昏天黑地的改了幾個(gè)月后老板說不要了，還是按照過去那樣，你也不會(huì)抓狂，簡單的恢復(fù)版本操作就搞定一切。</p><p>　　2.2、什么是 Subversion</p><p>　　Subversion是一個(gè)自由/開源版本控制系統(tǒng)，它管理文件和目

4、錄可以超越時(shí)間。一組文件存放在中心版本庫，這個(gè)版本庫很像一個(gè)普通的文件服務(wù)器，只是它可以記錄每一次文件和目錄的修改，這便使你可以取得數(shù)據(jù)以前的版本，從而可以檢查所作的更改。從這個(gè)方面看，許多人把版本控制系統(tǒng)當(dāng)作一種“時(shí)間機(jī)器”。</p><p>　　Subversion可以通過網(wǎng)絡(luò)訪問它的版本庫，從而使用戶可以在不同的電腦上使用。一定程度上可以說，允許用戶在各自的地方修改同一份數(shù)據(jù)是促進(jìn)協(xié)作。進(jìn)展可能非常的迅速，

5、并沒有一個(gè)所有的改變都會(huì)取得效果的通道，由于所有的工作都有歷史版本，你不必?fù)?dān)心由于失去某個(gè)通道而影響質(zhì)量，如果存在不正確的改變，只要取消改變。</p><p>　　一些版本控制系統(tǒng)也是軟件配置管理（SCM）系統(tǒng)，這種系統(tǒng)經(jīng)過特定的精巧設(shè)計(jì)來管理源代碼，有許多關(guān)于軟件開發(fā)的特性—本身理解編程語言、或者提供構(gòu)建程序的工具。然而，Subversion不是這樣一個(gè)系統(tǒng)，它是一個(gè)通用系統(tǒng)，可以管理任何類型的文件集，對(duì)你這可

6、能是源代碼，對(duì)別人，可能是一個(gè)貨物報(bào)價(jià)單或者是書稿等。</p><p>　　2.3、版本庫（repository）</p><p>　　Subversion 的核心就是 repository ，中文翻譯成“版本庫”。就是位于服務(wù)器端，統(tǒng)一管理和儲(chǔ)存數(shù)據(jù)的地方。</p><p><b>　　3、安裝配置</b></p><p&

7、gt;　　3.1 安裝獨(dú)立服務(wù)器 SVNServer</p><p><b>　　環(huán)境</b></p><p>　　OS：Windows XP SP2</p><p>　　Web：Apache 2.2.6</p><p>　　SVN：svn-win32-1.4.6</p><p><b>

8、;　　一、準(zhǔn)備工作</b></p><p>　　1、獲取 Subversion 服務(wù)器程序</p><p>　　到官方網(wǎng)站（http://subversion.tigris.org/）下載最新的服務(wù)器安裝程序。目前最新的是1.4.6版本，具體下載地址在：http://subversion.tigris.org/servlets/ProjectDocumentList?folde

9、rID=8100&expandFolder=8100&folderID=91 ，注意找 for apache 2.2.x 版本的。</p><p>　　2、獲取 TortoiseSVN 客戶端程序</p><p>　　從官方網(wǎng)站 http://tortoisesvn.net/downloads 獲取最新的 TortoiseSVN 。TortoiseSVN 是一個(gè)客戶端程序，

10、用來與 subvers 服務(wù)器端通訊。Subversion 自帶一個(gè)客戶端程序 svn.exe ,但 TortoiseSVN 更好操作，提高效率。</p><p>　　二、安裝服務(wù)器端和客戶端</p><p>　　首先安裝 Apache 2.2.6 ，具體安裝方法大家參考相關(guān)資料，或者參看我寫的《Windows下安裝Apache 2.2.x》。</p><p>　　

11、其次安裝 Subversion（以下簡稱SVN）的服務(wù)器端和客戶端。下載下來的服務(wù)器端是個(gè) zip 壓縮包，直接解壓縮即可，比如我解壓到 E:\subversion ?？蛻舳税惭b文件是個(gè) exe 可執(zhí)行文件，直接運(yùn)行按提示安裝即可，客戶端安裝完成后提示重啟。</p><p>　　三、建立版本庫（Repository）</p><p>　　運(yùn)行Subversion服務(wù)器需要首先要建立一個(gè)版本

12、庫（Repository）。版本庫可以看作是服務(wù)器上集中存放和管理數(shù)據(jù)的地方。</p><p>　　開始建立版本庫。首先建立 e:\svn 空文件夾作為所有版本庫的根目錄。然后，進(jìn)入命令行并切換到subversion的bin目錄。輸入如下命令：</p><p>　　svnadmin create E:\svn\repos1</p><p>　　此命令在 E:\svn

13、 下建立一個(gè)版本庫 repos1 。repos1 下面會(huì)自動(dòng)生成一些文件夾和文件。</p><p>　　我們也可以使用 TortoiseSVN 圖形化的完成這一步：</p><p>　　先建立空目錄 E:\svn\repos1 ，注意一定是要空的。然后在 repos1 文件夾上“右鍵->TortoiseSVN->Create Repository here...”，然后可以選擇

14、版本庫模式，這里使用默認(rèn)的FSFS即可，然后就創(chuàng)建了一系列文件夾和文件，同命令行建立的一樣。</p><p><b>　　四、運(yùn)行獨(dú)立服務(wù)器</b></p><p>　　此時(shí) subversion 服務(wù)還沒有開始，只是通過它的命令建立了版本庫。繼續(xù)在剛才的命令窗口輸入：</p><p>　　svnserve.exe --daemon</p

15、><p>　　svnserve 將會(huì)在端口 3690 等待請(qǐng)求，--daemon（兩個(gè)短橫線）選項(xiàng)告訴 svnserve 以守護(hù)進(jìn)程方式運(yùn)行，這樣在手動(dòng)終止之前不會(huì)退出。注意不要關(guān)閉命令行窗口，關(guān)閉窗口會(huì)把 svnserve 停止。</p><p>　　為了驗(yàn)證svnserve正常工作，使用TortoiseSVN -> Repo-browser 來查看版本庫。在彈出的 URL 對(duì)話框中輸

16、入：</p><p>　　svn://localhost/svn/repos1</p><p>　　點(diǎn) OK 按鈕后就可以看見 repos1 版本庫的目錄樹結(jié)構(gòu)了，只不過這時(shí) repos1 是個(gè)空庫。</p><p>　　你也可以使用--root選項(xiàng)設(shè)置根位置來限制服務(wù)器的訪問目錄，從而增加安全性和節(jié)約輸入svnserve URL的時(shí)間：</p>&l

17、t;p>　　svnserve.exe --daemon --root drive:\path\to\repository</p><p>　　以前面的測試作為例，svnserve 將會(huì)運(yùn)行為：</p><p>　　svnserve.exe --daemon --root e:\svn</p><p>　　然后TortoiseSVN中的版本庫瀏覽器URL縮減為：

18、</p><p>　　svn://localhost/repos1</p><p><b>　　五、配置用戶和權(quán)限</b></p><p>　　用文本編輯器打開E:\svn\repos1\conf目錄，修改svnserve.conf：</p><p><b>　　將：</b></p>

19、<p>　　# password-db = passwd</p><p><b>　　改為：</b></p><p>　　password-db = passwd</p><p>　　即去掉前面的 # 注釋符，注意前面不能有空格。</p><p>　　然后修改同目錄的passwd文件，增加一個(gè)帳號(hào)：</p

20、><p><b>　　將：</b></p><p>　　[users]# harry = harryssecret# sally = sallyssecret</p><p><b>　　增加帳號(hào)：</b></p><p>　　[users]#harry = harryssecret#sally

21、 = sallyssecrettest = test</p><p><b>　　六、初始化導(dǎo)入</b></p><p>　　下面就是將我們的數(shù)據(jù)（項(xiàng)目）導(dǎo)入到這個(gè)版本庫，以后就由版本庫管理我們的數(shù)據(jù)。我們的任何改動(dòng)都回被版本庫記錄下來，甚至我們自己丟失、改錯(cuò)數(shù)據(jù)時(shí)版本庫也能幫我們找回?cái)?shù)據(jù)。</p><p>　　比如，我在 d:\wwwroo

22、t 下有個(gè) guestbook 文件夾，里面存放的是我編寫的留言簿程序。在此文件夾上“右鍵 -> TortoiseSVN -> Import...” ，在彈出對(duì)話框的“URL of repository”輸入“svn://localhost/repos1/guestbook”。在“Import message”輸入“導(dǎo)入整個(gè)留言簿”作為注釋。點(diǎn) OK 后要求輸入帳號(hào)。我們?cè)谟脩裘兔艽a處都輸入 test 。完成后 gues

23、tbook 中的內(nèi)容全部導(dǎo)入到了 svn://localhost/svn/repos1/guestbook 。</p><p>　　我們看到在 e:\svn\repos1 沒有任何變化，連個(gè) guestbook 文件夾都沒有建立，唯一的變化就是e:\svn\repos1容量變大了。實(shí)際上我們?cè)磄uestbook中的內(nèi)容已經(jīng)導(dǎo)入 repos1 版本庫了，源 guestbook 文件夾可以刪除了。</p>

24、<p>　　需要注意的是，這一步操作可以完全在另一臺(tái)安裝了 TortoiseSVN 的客戶機(jī)上進(jìn)行。例如運(yùn)行svnserve的主機(jī)的IP是133.96.121.22，則URL部分輸入的內(nèi)容就是“svn://133.96.121.22” 。</p><p><b>　　七、基本操作流程</b></p><p>　　1、取出（check out）</p

25、><p>　　取出版本庫到一個(gè)工作拷貝：</p><p>　　來到任意空目錄下，比如在f分區(qū)建立一個(gè)空文件夾 f:\work ?！坝益I -> SVN Checkout”。在“URL of repository”中輸入“svn://localhost/svn/repos1/guestbook”，這樣我們就得到了一份 guestbook 中內(nèi)容的工作拷貝。</p><p&

26、gt;　　2、存入（check in）/提交（commit）</p><p>　　在工作拷貝中作出修改并提交：</p><p>　　在 guestbook 工作拷貝中隨便打開一個(gè)文件，作出修改，然后“右鍵 -> SVN Commit... ”。這樣我們就把修改提交到了版本庫，版本庫根據(jù)情況存儲(chǔ)我們提交的數(shù)據(jù)。</p><p>　　在修改過的文件上“右鍵 -&g

27、t; TortoiseSVN -> Show Log” ，可以看到對(duì)這個(gè)文件所有的提交。在不同的 revision 條目上“右鍵 -> Compare with working copy”，我們可以比較工作拷貝的文件和所選 revision 版本的區(qū)別。</p><p>　　3.2 安裝 ApacheSVN 服務(wù)器</p><p>　　Subversion的設(shè)計(jì)包括一個(gè)抽象的網(wǎng)

28、絡(luò)層，這意味著版本庫可以通過各種服務(wù)器進(jìn)程訪問。理論上講，Subversion可以使用無限數(shù)量的網(wǎng)絡(luò)協(xié)議實(shí)現(xiàn)，目前實(shí)踐中存在著兩種服務(wù)器。</p><p>　　SVNServer：svnserve 是一個(gè)小的（也叫輕型的）、獨(dú)立服務(wù)器，使用自己定義的協(xié)議和客戶端。（作者注：以下稱這種服務(wù)器為“svnserver服務(wù)器”，上面的安裝配置就是安裝svnserver服務(wù)器。） </p><p>

29、　　ApacheSVN：Apache是最流行的web服務(wù)器，通過使用 mod_dav_svn 模塊，Apache可以訪問版本庫，并且可以使客戶端使用HTTP的擴(kuò)展協(xié)議WebDAV/DeltaV進(jìn)行訪問。（作者注：以下稱這種服務(wù)器為“ApacheSVN服務(wù)器”） </p><p>　　通過 Http 協(xié)議訪問版本庫是 Subversion 的亮點(diǎn)之一。ApacheSVN服務(wù)器 具備了許多 svnserve服務(wù)器 沒

30、有的特性，使用上更加靈活，但是有一點(diǎn)難于配置，靈活通常會(huì)帶來復(fù)雜性。</p><p>　　由于 Subversion 需要版本化的控制，因此標(biāo)準(zhǔn)的 Http 協(xié)議不能滿足需求。要讓 Apache 與 Subversion 協(xié)同工作，需要使用 WebDAV（Web-based Distributed Authoring and Versioning：）Web 分布式創(chuàng)作和版本控制）。WebDAV 是 HTTP 1.

31、1 的擴(kuò)展，關(guān)于 WebDAV 的規(guī)范和工作原理，可以參考 IETF RFC 2518 。</p><p><b>　　一、必備條件</b></p><p>　　為了讓你的版本庫使用HTTP網(wǎng)絡(luò)，你必需具備以下幾個(gè)條件：</p><p>　　配置好httpd 2.2.x，并且使用mod_dav啟動(dòng)。 </p><p>　

32、　為mod_dav安裝mod_dav_svn插件。 </p><p>　　配置你的httpd.conf，使http協(xié)議能訪問版本庫。 </p><p>　　下面以我的配置過程詳細(xì)講解。</p><p><b>　　環(huán)境：</b></p><p>　　OS：Windows XP SP2</p><p&g

33、t;　　Web：Apache 2.2.6</p><p>　　SVN：svn-win32-1.4.6</p><p><b>　　二、安裝</b></p><p>　　1、安裝Apache</p><p>　　具體安裝方法見：《Windows下安裝Apache 2.2.x》</p><p>　　2

34、、安裝 Subversion</p><p>　　將下載下來的 svn-win32-1.4.6.zip 直接解壓即可，比如我解壓到 e:\subversion 。從Subversion安裝目錄的 bin 子目錄將 intl3_svn.dll、libdb44.dll、mod_authz_svn.so、mod_dav_svn.so 拷貝到Apache的模塊目錄（Apache 安裝目錄的 modules 文件夾）。&

35、lt;/p><p>　　三、基本的Apache配置</p><p>　　修改Apache的配置文件 httpd.conf ，使用LoadModule來加載mod_dav_svn模塊。</p><p><b>　　將：</b></p><p>　　#LoadModule dav_module modules/mod_dav.s

36、o</p><p><b>　　改成：</b></p><p>　　LoadModule dav_module modules/mod_dav.so</p><p>　　即去掉前面的“#”號(hào)。</p><p><b>　　添加：</b></p><p>　　LoadModul

37、e dav_svn_module modules/mod_dav_svn.so</p><p>　　一定確定它在 mod_dav 之后。</p><p>　　現(xiàn)在你已經(jīng)設(shè)置了Apache和Subversion，但是Apache不知道如何處理Subversion客戶端，例如TortoiseSVN。為了讓Apache知道哪個(gè)目錄是用來作為Subversion版本庫，你需要使用編輯器（例如記事本

38、）編輯Apache的配置文件。</p><p>　　在配置文件最后添加如下幾行：</p><p>　　<Location /repository/>DAV svnSVNPath e:/svn/repos1</Location></p><p>　　這個(gè)配置告訴Apache首先需要啟用 dav_module，然后加載 dav_svn_mo

39、dule 。版本庫對(duì)外的URL是：http://服務(wù)器IP/repository/ ，所有的Subversion版本庫在物理上位于e:/svn/repos1/ 。</p><p>　　配置完畢后重新啟動(dòng) Apache，打開瀏覽器，輸入 http://服務(wù)器IP/ repository/ 將會(huì)看到如下畫面：</p><p>　　這表示 Apache 的 dav_svn 模塊已經(jīng)可以正常工作了

40、。用戶可以使用任何一種 Subversion 的客戶端通過 Http 協(xié)議訪問你的版本庫。</p><p>　　如果想要指定多個(gè)版本庫，可以用多個(gè) Location 標(biāo)簽，也可以使用 SVNParentPath 代替 SVNPath，例如在 e:\svn 下有多個(gè)版本庫 repos1，repos2 等等，用如下方式指定：</p><p>　　<Location /repository

41、/>　DAV svn　SVNParentPath e:/svn</Location></p><p>　　“SVNParentPath e:/svn ” 表示 e:\svn 下的每個(gè)子目錄都是一個(gè)版本庫?？梢酝ㄟ^ http://服務(wù)器IP/repository/repos1/，http://服務(wù)器IP/repository/repos2/ 來訪問。</p><p>

42、　　現(xiàn)在你的版本庫任何人都可以訪問，并且有完全的寫操作權(quán)限。也就是說任何人都可以匿名讀取，修改，提交，以及刪除版本庫中的內(nèi)容(注：這時(shí)不需要配置E:\svn\repos\conf\svnserve.conf 文件，并且也不需要啟動(dòng)E:\subversion\bin\svnserve.exe。因?yàn)樘峤皇峭ㄟ^Apache的dav模塊處理的，而不是由svnservice處理。)。我們用 TortoiseSVN 客戶端驗(yàn)證即知。</p&g

43、t;<p>　　顯然大部分場合這是不符合需求的。那么如何進(jìn)行權(quán)限設(shè)置呢，Apache 提供了基本的權(quán)限設(shè)置：</p><p><b>　　四、認(rèn)證選項(xiàng)</b></p><p>　　1、基本 HTTP 認(rèn)證</p><p>　　最簡單的客戶端認(rèn)證方式是通過 HTTP 基本認(rèn)證機(jī)制，簡單的使用用戶名和密碼來驗(yàn)證一個(gè)用戶的身份。Apac

44、he提供了一個(gè) htpasswd 工具來管理一個(gè)用戶文件，這個(gè)文件包含用戶名和加密后的密碼，這些就是你希望賦予 Subversion 特別權(quán)限的用戶。htpasswd 可以在 Apache 的 bin 安裝目錄下找到。具體使用方法如下：</p><p>　　創(chuàng)建用戶文件：htpasswd -c E:\usr\Apache2.2\bin\passwd.conf username</p><p&

45、gt;　　添加新用戶（-m 表示以 MD5 加密密碼，可選項(xiàng)）：htpasswd [-m] E:\usr\Apache2.2\bin\passwd.conf Newusername</p><p>　　更改用戶密碼：htpasswd [-m] E:\usr\Apache2.2\bin\passwd.conf username</p><p>　　刪除用戶（要用大寫的 D ）：htpa

46、sswd –D E:\usr\Apache2.2\bin\passwd.conf username</p><p>　　接下來修改 httpd.conf，在 Location 標(biāo)簽中加入如下內(nèi)容：</p><p>　　AuthType BasicAuthName "svn repos"AuthUserFile E:/usr/Apache2.2/bin/passwd.

47、confRequire valid-user</p><p><b>　　說明：</b></p><p>　　AuthType Basic：啟用基本的驗(yàn)證，比如用戶名/密碼對(duì)。</p><p>　　AuthName "svn repos"：當(dāng)一個(gè)認(rèn)證對(duì)話框彈出時(shí)，出現(xiàn)在認(rèn)證對(duì)話框中的信息。（最好用英文，TortoiseSV

48、N 不支持中文，安裝語言包除外。）</p><p>　　AuthUserFile E:/usr/Apache2.2/bin/passwd：指定E:\usr\Apache2.2\bin\passwd為用戶文件，用來驗(yàn)證用戶的用戶名及密碼。</p><p>　　Require valid-user：限定用戶只有輸入正確的用戶名及密碼后才能訪問這個(gè)路徑</p><p>　

49、　重新啟動(dòng) Apache ，打開瀏覽器訪問版本庫。Apache 會(huì)提示你輸入用戶名和密碼來認(rèn)證登陸了，現(xiàn)在只有 passwd 文件中設(shè)定的用戶才可以訪問版本庫。也可以配置只有特定用戶可以訪問，替換上述 "Require valid-user" 為 "Require user tony robert" 將只有用戶文件中的 tony 和 robert 可以訪問該版本庫。</p><

50、p>　　有的時(shí)候也許不需要這樣嚴(yán)格的訪問控制，例如大多數(shù)開源項(xiàng)目允許匿名的讀取操作，而只有認(rèn)證用戶才允許寫操作。為了實(shí)現(xiàn)更為細(xì)致的權(quán)限認(rèn)證，可以使用 Limit 和 LimitExcept 標(biāo)簽。例如：</p><p>　　<LimitExcept GET PROPFIND OPTIONS REPORT>require valid-user</LimitExcept></p

51、><p>　　以上配置將使匿名用戶有讀取權(quán)限，而限制只有 passwd 中配置的用戶可以使用寫操作。</p><p>　　如果這還不能滿足你的要求，你希望精確的控制版本庫目錄訪問，可以使用 Apache 的 mod_authz_svn 模塊對(duì)每個(gè)目錄進(jìn)行認(rèn)證操作。</p><p>　　2、用 mod_authz_svn 進(jìn)行目錄訪問控制</p><p

52、>　　首先需要讓 Apache 將 mod_authz_svn 模塊加載進(jìn)來。在 Subversion 的安裝目錄中找到 mod_auth_svn 模塊，將其拷貝到 Apache 安裝目錄的 modules 子目錄下。修改 httpd.conf 文件，添加：</p><p>　　LoadModule authz_svn_module modules/mod_authz_svn.so</p>&

53、lt;p>　　現(xiàn)在可以在 Location 標(biāo)簽中使用 authz 的功能了。一個(gè)基本的 authz 配置如下：</p><p>　　<Location /repository/>DAV svnSVNParentPath e:/svn# our access control policyAuthzSVNAccessFile E:/usr/Apache2.2/bin/accesspoli

54、cy.conf# try anonymous access first, resort to real# authentication if necessary.Satisfy AnyRequire valid-user# how to authenticate a userAuthType BasicAuthName "Subversion repository"AuthUserFile E:/

55、usr/Apache2.2/bin/passwd.conf</Location></p><p>　　AuthzSVNAccessFile 指向的是 authz 的策略文件，詳細(xì)的權(quán)限控制可以在這個(gè)策略文件中指定。訪問文件 accesspolicy.conf 的語法與svnserve.conf和 Apache 的配置文件非常相似，以（#）開頭的行會(huì)被忽略；在它的簡單形式里，每一小節(jié)命名一個(gè)版本庫和一

56、個(gè)里面的路徑；認(rèn)證用戶名是在每個(gè)小節(jié)中的選項(xiàng)名；每個(gè)選項(xiàng)的值描述了用戶訪問版本庫的級(jí)別：r（只讀）或者rw（讀寫），如果用戶沒有提到或者值留空，訪問是不允許的； * 表示所有用戶，用它控制匿名用戶的訪問權(quán)限；@符號(hào)區(qū)分組和用戶。如：</p><p>　　[groups]committers = paulex, richarddevelopers = jimmy, michel, spark, sean[/

57、]* = r@committers = rw [/branches/dev]@developers = rw [/tags]tony = rw [/private]* = @committers= r</p><p>　　使用 SVNParentPath 代替 SVNPath 來指定多個(gè)版本庫的父目錄時(shí)，其中所有的版本庫都將按照這個(gè)策略文件配置。例如上例中 tony 將對(duì)所有版本庫里的 /t

58、ags 目錄具有讀寫權(quán)限。如果要對(duì)具體每個(gè)版本庫配置，用如下的語法：</p><p>　　[groups]project1_committers = paulex, richardproject2_committers = jimmy, michel, spark, tony, Robert[repos1:/] * = r @ project1_committer = rw[repos2:/]