作者：indian

版本：v1.2

修訂：2008年1月24日11:45:35

出處：blog.kysf.net

版權(quán)：作者保留對本文的一切修改、發(fā)布等權(quán)力。任何人想要轉(zhuǎn)載本文部分或全部內(nèi)容時，必須保留包括作者、版本、修訂、出處、版權(quán)，共五項(xiàng)信息。對本文的參考引用，則不受限制。

關(guān)鍵詞：subversion, 安裝配置, 權(quán)限, 目錄訪問

1 前言
2 基本概念
　2.1 什么是版本控制
　2.2 什么是 Subversion
　2.3 版本庫（repository）
3 安裝配置
　3.1 安裝獨(dú)立服務(wù)器 SVNServer
　3.2 安裝 ApacheSVN 服務(wù)器
4 FAQ
5 參考資料

1、前 言

花了72小時，終于把 Subversion 初步掌握了。從一個連“什么是版本控制”都不知道的門外漢，到配置出精確至每目錄訪問的入門者，中間還卡了一天時間。其中費(fèi)了許多氣力，摸索實(shí)驗(yàn)了多次，還差點(diǎn)放棄了，但是收獲是巨大的。現(xiàn)把我的配置和學(xué)習(xí)過程寫下來，供大家參考，也讓初學(xué)者少走彎路。

由于本人不會 Unix/Linux （正在學(xué)習(xí)中），故僅以 Windows 平臺為例講解，Unix/Linux 平臺請參考相關(guān)資料。如其中有謬誤的地方，包括錯別字，請聯(lián)系我修訂。

技術(shù)在分享中進(jìn)步！

2、基本概念

2.1、什么是版本控制

簡單點(diǎn)來說，版本控制就是數(shù)據(jù)倉庫，它可以記錄你對文件的每次更改。這樣，就算你在昏天黑地的改了幾個月后老板說不要了，還是按照過去那樣，你也不會抓狂，簡單的恢復(fù)版本操作就搞定一切。

2.2、什么是 Subversion

Subversion是一個自由/開源版本控制系統(tǒng)，它管理文件和目錄可以超越時間。一組文件存放在中心版本庫，這個版本庫很像一個普通的文件服務(wù)器，只是它可以記錄每一次文件和目錄的修改，這便使你可以取得數(shù)據(jù)以前的版本，從而可以檢查所作的更改。從這個方面看，許多人把版本控制系統(tǒng)當(dāng)作一種“時間機(jī)器”。

Subversion可以通過網(wǎng)絡(luò)訪問它的版本庫，從而使用戶可以在不同的電腦上使用。一定程度上可以說，允許用戶在各自的地方修改同一份數(shù)據(jù)是促進(jìn)協(xié)作。進(jìn)展可能非常的迅速，并沒有一個所有的改變都會取得效果的通道，由于所有的工作都有歷史版本，你不必?fù)?dān)心由于失去某個通道而影響質(zhì)量，如果存在不正確的改變，只要取消改變。

一些版本控制系統(tǒng)也是軟件配置管理（SCM）系統(tǒng)，這種系統(tǒng)經(jīng)過特定的精巧設(shè)計來管理源代碼，有許多關(guān)于軟件開發(fā)的特性—本身理解編程語言、或者提供構(gòu)建程序的工具。然而，Subversion不是這樣一個系統(tǒng)，它是一個通用系統(tǒng)，可以管理任何類型的文件集，對你這可能是源代碼，對別人，可能是一個貨物報價單或者是書稿等。

2.3、版本庫（repository）

Subversion 的核心就是 rpository ，中文翻譯成“版本庫”。就是位于服務(wù)器端，統(tǒng)一管理和儲存數(shù)據(jù)的地方。

3、安裝配置

3.1 安裝獨(dú)立服務(wù)器 SVNServer

環(huán)境

OS：Windows XP SP2

Web：Apache 2.2.6

SVN：svn-win32-1.4.6

一、準(zhǔn)備工作

1、獲取 Subversion 服務(wù)器程序

到官方網(wǎng)站（http://subversion.tigris.org/）下載最新的服務(wù)器安裝程序。目前最新的是1.4.6版本，具體下載地址在：http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=8100&expandFolder=8100&folderID=91 ，注意找 for apache 2.2.x 版本的。

2、獲取 TortoiseSVN 客戶端程序

從官方網(wǎng)站 http://tortoisesvn.net/downloads 獲取最新的 TortoiseSVN 。TortoiseSVN 是一個客戶端程序，用來與 subvers 服務(wù)器端通訊。Subversion 自帶一個客戶端程序 svn.exe ,但 TortoiseSVN 更好操作，提高效率。

二、安裝服務(wù)器端和客戶端

首先安裝 Apache 2.2.6 ，具體安裝方法大家參考相關(guān)資料，或者參看我寫的《Windows下安裝Apache 2.2.x》。

其次安裝 Subversion（以下簡稱SVN）的服務(wù)器端和客戶端。下載下來的服務(wù)器端是個 zip 壓縮包，直接解壓縮即可，比如我解壓到 E:\subversion 。客戶端安裝文件是個 exe 可執(zhí)行文件，直接運(yùn)行按提示安裝即可，客戶端安裝完成后提示重啟。

三、建立版本庫（Repository）

運(yùn)行Subversion服務(wù)器需要首先要建立一個版本庫（Repository）。版本庫可以看作是服務(wù)器上集中存放和管理數(shù)據(jù)的地方。

開始建立版本庫。首先建立 e:\svn 空文件夾作為所有版本庫的根目錄。然后，進(jìn)入命令行并切換到subversion的bin目錄。輸入如下命令：

此命令在 E:\svn 下建立一個版本庫 repos1 。repos1 下面會自動生成一些文件夾和文件。

我們也可以使用 TortoiseSVN 圖形化的完成這一步：

先建立空目錄 E:\svn\repos1 ，注意一定是要空的。然后在 repos1 文件夾上“右鍵->TortoiseSVN->Create Repository here...”，然后可以選擇版本庫模式，這里使用默認(rèn)的FSFS即可，然后就創(chuàng)建了一系列文件夾和文件，同命令行建立的一樣。

四、運(yùn)行獨(dú)立服務(wù)器

此時 subversion 服務(wù)還沒有開始，只是通過它的命令建立了版本庫。繼續(xù)在剛才的命令窗口輸入：

svnserve 將會在端口 3690 等待請求，--daemon（兩個短橫線）選項(xiàng)告訴 svnserve 以守護(hù)進(jìn)程方式運(yùn)行，這樣在手動終止之前不會退出。注意不要關(guān)閉命令行窗口，關(guān)閉窗口會把 svnserve 停止。

為了驗(yàn)證svnserve正常工作，使用TortoiseSVN -> Repo-browser 來查看版本庫。在彈出的 URL 對話框中輸入：

點(diǎn) OK 按鈕后就可以看見 repos1 版本庫的目錄樹結(jié)構(gòu)了，只不過這時 repos1 是個空庫。

你也可以使用--root選項(xiàng)設(shè)置根位置來限制服務(wù)器的訪問目錄，從而增加安全性和節(jié)約輸入svnserve URL的時間：

以前面的測試作為例，svnserve 將會運(yùn)行為：

然后TortoiseSVN中的版本庫瀏覽器URL縮減為：

五、配置用戶和權(quán)限

用文本編輯器打開E:\svn\repos1\conf目錄，修改svnserve.conf：

將：

改為：

即去掉前面的 # 注釋符，注意前面不能有空格。

然后修改同目錄的passwd文件，增加一個帳號：

將：

增加帳號：

六、初始化導(dǎo)入

下面就是將我們的數(shù)據(jù)（項(xiàng)目）導(dǎo)入到這個版本庫，以后就由版本庫管理我們的數(shù)據(jù)。我們的任何改動都回被版本庫記錄下來，甚至我們自己丟失、改錯數(shù)據(jù)時版本庫也能幫我們找回數(shù)據(jù)。

比如，我在 d:\wwwroot 下有個 guestbook 文件夾，里面存放的是我編寫的留言簿程序。在此文件夾上“右鍵 -> TortoiseSVN -> Import...” ，在彈出對話框的“URL of repository”輸入“svn://localhost/repos1/guestbook”。在“Import message”輸入“導(dǎo)入整個留言簿”作為注釋。
點(diǎn) OK 后要求輸入帳號。我們在用戶名和密碼處都輸入 test 。完成后 guestbook 中的內(nèi)容全部導(dǎo)入到了 svn://localhost/svn/repos1/guestbook 。

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

需要注意的是，這一步操作可以完全在另一臺安裝了 TortoiseSVN 的客戶機(jī)上進(jìn)行。例如運(yùn)行svnserve的主機(jī)的IP是133.96.121.22，則URL部分輸入的內(nèi)容就是“svn://133.96.121.22” 。

七、基本操作流程

1、取出（check out）

取出版本庫到一個工作拷貝：

來到任意空目錄下，比如在f分區(qū)建立一個空文件夾 f:\work 。“右鍵 -> SVN Checkout”。在“URL of repository”中輸入“svn://localhost/svn/repos1/guestbook”，這樣我們就得到了一份 guestbook 中內(nèi)容的工作拷貝。

2、存入（check in）/提交（commit）

在工作拷貝中作出修改并提交：

在 guestbook 工作拷貝中隨便打開一個文件，作出修改，然后“右鍵 -> SVN Commit... ”。這樣我們就把修改提交到了版本庫，版本庫根據(jù)情況存儲我們提交的數(shù)據(jù)。

在修改過的文件上“右鍵 -> TortoiseSVN -> Show Log” ，可以看到對這個文件所有的提交。在不同的 revision 條目上“右鍵 -> Compare with working copy”，我們可以比較工作拷貝的文件和所選 revision 版本的區(qū)別。

3.2 安裝 ApacheSVN 服務(wù)器

Subversion的設(shè)計包括一個抽象的網(wǎng)絡(luò)層，這意味著版本庫可以通過各種服務(wù)器進(jìn)程訪問。理論上講，Subversion可以使用無限數(shù)量的網(wǎng)絡(luò)協(xié)議實(shí)現(xiàn)，目前實(shí)踐中存在著兩種服務(wù)器。

• SVNServer：svnserve 是一個小的（也叫輕型的）、獨(dú)立服務(wù)器，使用自己定義的協(xié)議和客戶端。（作者注：以下稱這種服務(wù)器為“svnserver服務(wù)器”，上面的安裝配置就是安裝svnserver服務(wù)器。）
  
   
• ApacheSVN：Apache是最流行的web服務(wù)器，通過使用 mod_dav_svn 模塊，Apache可以訪問版本庫，并且可以使客戶端使用HTTP的擴(kuò)展協(xié)議WebDAV/DeltaV進(jìn)行訪問。（作者注：以下稱這種服務(wù)器為“ApacheSVN服務(wù)器”）

通過 Http 協(xié)議訪問版本庫是 Subversion 的亮點(diǎn)之一。ApacheSVN服務(wù)器 具備了許多 svnserve服務(wù)器 沒有的特性，使用上更加靈活，但是有一點(diǎn)難于配置，靈活通常會帶來復(fù)雜性。

由于 Subversion 需要版本化的控制，因此標(biāo)準(zhǔn)的 Http 協(xié)議不能滿足需求。要讓 Apache 與 Subversion 協(xié)同工作，需要使用 WebDAV（Web-based Distributed Authoring and Versioning：）Web 分布式創(chuàng)作和版本控制）。WebDAV 是 HTTP 1.1 的擴(kuò)展，關(guān)于 WebDAV 的規(guī)范和工作原理，可以參考 IETF RFC 2518 。

一、必備條件

為了讓你的版本庫使用HTTP網(wǎng)絡(luò)，你必需具備以下幾個條件：

1. 配置好httpd 2.2.x，并且使用mod_dav啟動。
2. 為mod_dav安裝mod_dav_svn插件。
3. 配置你的httpd.conf，使http協(xié)議能訪問版本庫。

下面以我的配置過程詳細(xì)講解。

環(huán)境：

OS：Windows XP SP2

Web：Apache 2.2.6

SVN：svn-win32-1.4.6

二、安裝

1、安裝Apache

具體安裝方法見：《Windows下安裝Apache 2.2.x》

2、安裝 Subversion

將下載下來的 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 文件夾）。

三、基本的Apache配置

修改Apache的配置文件 httpd.conf ，使用LoadModule來加載mod_dav_svn模塊。

將：

改成：

即去掉前面的“#”號。

添加：

一定確定它在 mod_dav 之后。

現(xiàn)在你已經(jīng)設(shè)置了Apache和Subversion，但是Apache不知道如何處理Subversion客戶端，例如TortoiseSVN。為了讓Apache知道哪個目錄是用來作為Subversion版本庫，你需要使用編輯器（例如記事本）編輯Apache的配置文件。

在配置文件最后添加如下幾行：

這個配置告訴Apache首先需要啟用 dav_module，然后加載 dav_svn_module 。版本庫對外的URL是：http://服務(wù)器IP/repository/ ，所有的Subversion版本庫在物理上位于e:/svn/repos1/ 。

配置完畢后重新啟動 Apache，打開瀏覽器，輸入 http://服務(wù)器IP/ repository/ 將會看到如下畫面：

這表示 Apache 的 dav_svn 模塊已經(jīng)可以正常工作了。用戶可以使用任何一種 Subversion 的客戶端通過 Http 協(xié)議訪問你的版本庫。

如果想要指定多個版本庫，可以用多個 Location 標(biāo)簽，也可以使用 SVNParentPath 代替 SVNPath，例如在 e:\svn 下有多個版本庫 repos1，repos2 等等，用如下方式指定：

“SVNParentPath e:/svn ” 表示 e:\svn 下的每個子目錄都是一個版本庫。可以通過 http://服務(wù)器IP/repository/repos1/，http://服務(wù)器IP/repository/repos2/ 來訪問。

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

顯然大部分場合這是不符合需求的。那么如何進(jìn)行權(quán)限設(shè)置呢，Apache 提供了基本的權(quán)限設(shè)置：

四、認(rèn)證選項(xiàng)

1、基本 HTTP 認(rèn)證

最簡單的客戶端認(rèn)證方式是通過 HTTP 基本認(rèn)證機(jī)制，簡單的使用用戶名和密碼來驗(yàn)證一個用戶的身份。Apache提供了一個 htpasswd 工具來管理一個用戶文件，這個文件包含用戶名和加密后的密碼，這些就是你希望賦予 Subversion 特別權(quán)限的用戶。htpasswd 可以在 Apache 的 bin 安裝目錄下找到。具體使用方法如下：

接下來修改 httpd.conf，在 Location 標(biāo)簽中加入如下內(nèi)容：

說明：

AuthType Basic：啟用基本的驗(yàn)證，比如用戶名/密碼對。

AuthName "svn repos"：當(dāng)一個認(rèn)證對話框彈出時，出現(xiàn)在認(rèn)證對話框中的信息。（最好用英文，TortoiseSVN 不支持中文，安裝語言包除外。）

AuthUserFile E:/usr/Apache2.2/bin/passwd：指定E:\usr\Apache2.2\bin\passwd為用戶文件，用來驗(yàn)證用戶的用戶名及密碼。

Require valid-user：限定用戶只有輸入正確的用戶名及密碼后才能訪問這個路徑

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

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

以上配置將使匿名用戶有讀取權(quán)限，而限制只有 passwd 中配置的用戶可以使用寫操作。

如果這還不能滿足你的要求，你希望精確的控制版本庫目錄訪問，可以使用 Apache 的 mod_authz_svn 模塊對每個目錄進(jìn)行認(rèn)證操作。

2、用 mod_authz_svn 進(jìn)行目錄訪問控制

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

現(xiàn)在可以在 Location 標(biāo)簽中使用 authz 的功能了。一個基本的 authz 配置如下：

AuthzSVNAccessFile 指向的是 authz 的策略文件，詳細(xì)的權(quán)限控制可以在這個策略文件中指定。訪問文件 accesspolicy.conf 的語法與svnserve.conf和 Apache 的配置文件非常相似，以（#）開頭的行會被忽略；在它的簡單形式里，每一小節(jié)命名一個版本庫和一個里面的路徑；認(rèn)證用戶名是在每個小節(jié)中的選項(xiàng)名；每個選項(xiàng)的值描述了用戶訪問版本庫的級別：r（只讀）或者rw（讀寫），如果用戶沒有提到或者值留空，訪問是不允許的； * 表示所有用戶，用它控制匿名用戶的訪問權(quán)限；@符號區(qū)分組和用戶。如：

使用 SVNParentPath 代替 SVNPath 來指定多個版本庫的父目錄時，其中所有的版本庫都將按照這個策略文件配置。例如上例中 tony 將對所有版本庫里的 /tags 目錄具有讀寫權(quán)限。如果要對具體每個版本庫配置，用如下的語法：

這樣項(xiàng)目1的 project1_committer 組只能對 repos1 版本庫下的文件具有寫權(quán)限而不能修改版本庫 repos2 ，同樣項(xiàng)目2的 project2_commiter 組也不能修改 repos1 版本庫的文件。

4、FAQ

1、路徑或權(quán)限不足時將出現(xiàn)錯誤信息提示：

http://localhost （路徑不對）
Error * PROPFIND request failed on '/' PROPFIND of '/': 200 OK (http://localhost)

http://localhost/svn （權(quán)限不足）
Error * PROPFIND request failed on '/svn' PROPFIND of '/svn': 403 Forbidden (http://localhost)

http://localhost/svn/repos （正常顯示）

http://localhost/repos （權(quán)限不允許）
Error * PROPFIND request failed on '/repos' PROPFIND of '/repos': 405 Method Not Allowed (http://localhost)

2、不啟動E:\subversion\bin\svnserve.exe ，但啟動了ApacheSVN ，訪問（tortoiseSVN –> Repo – browser）或提交（SVN Commit）情形如下：

現(xiàn)象：svn://localhost/svn/repos 不能訪問或提交，提示：Error * Can't connect to host 'localhost': 由于目標(biāo)機(jī)器積極拒絕，無法連接。 但 file:///e:/svn/repos 和 http://localhost/svn/repos 可以訪問或提交。

原因：svn:// 是獨(dú)立服務(wù)器 svnserver 自己的協(xié)議。file:/// 是本地訪問，即服務(wù)器端和客戶端在一個機(jī)器上。

參考資料：
Subversion 官方網(wǎng)站：Subversion 的官方網(wǎng)站，提供最權(quán)威的介紹和最新的下載。
Subversion 中文手冊：Subversion 簡體中文官方網(wǎng)站翻譯的中文手冊。
TortoiseSVN 中文文檔：Subversion 簡體中文官方網(wǎng)站翻譯的 TortoiseSVN 中文文檔。
我用SVN中文論壇：國內(nèi)人氣非常旺的 SVN 中文交流論壇。
《用Apache和Subversion搭建安全的版本控制環(huán)境》：IBM 工程師寫的基于 Linux 的 SVN 教程。
百度百科：由全體網(wǎng)民共同撰寫的百科全書

~ 全文完~

　　　　　　　　　　印第安

　　　　　　2007年12月23日23:37:41　v1.0 初稿
　　　　　　2007年12月25日2:24:53　v1.1 更新。更改了幾處路徑，使之更加便于Win下調(diào)試。全文重新排版，閱讀條理更清晰。
　　　　　　2008年1月24日11:45:35　v1.2 修訂。修改幾處書寫錯誤（謝謝山東濟(jì)南的網(wǎng)易博友242）；修改1個關(guān)鍵配置路徑。