# GitWeb 如果你對項目有讀寫權限或只讀權限，你可能需要建立起一個基于網頁的簡易查看器。Git 提供了一個叫做 GitWeb 的 CGI 腳本來做這項工作。  Figure 4-1. GitWeb 的網頁用戶界面 如果你想要查看 GitWeb 如何展示你的項目，并且在服務器上安裝了輕量級網絡服務器比如 `lighttpd` 或 `webrick`， Git 提供了一個命令來讓你啟動一個臨時的服務器。在 Linux 系統的電腦上，`lighttpd` 通常已經安裝了，所以你只需要在項目目錄里執行 `git instaweb` 命令即可。如果你使用 Mac 系統， Mac OS X Leopard 系統已經預安裝了 Ruby，所以 `webrick` 或許是你最好的選擇。如果不想使用 lighttpd 啟動 `instaweb` 命令，你需要在執行時加入 `--httpd` 參數。 ~~~ $ git instaweb --httpd=webrick [2009-02-21 10:02:21] INFO WEBrick 1.3.1 [2009-02-21 10:02:21] INFO ruby 1.8.6 (2008-03-03) [universal-darwin9.0] ~~~ 這個命令啟動了一個監聽 1234 端口的 HTTP 服務器，并且自動打開了瀏覽器。這對你來說十分方便。當你已經完成了工作并想關閉這個服務器，你可以執行同一個命令，并加上 `--stop` 選項： ~~~ $ git instaweb --httpd=webrick --stop ~~~ 如果你現在想為你的團隊或你托管的開源項目持續的運行這個頁面，你需要通過普通的 Web 服務器來設置 CGI 腳本。一些 Linux 發行版的軟件庫有 `gitweb` 包，可以通過 `apt` 或 `yum` 來安裝，你可以先試試。接下來我們來快速的了解一下如何手動安裝 GitWeb。首先，你需要獲得 Git 的源代碼，它包含了 GitWeb ，并可以生成自定義的 CGI 腳本： ~~~ $ git clone git://git.kernel.org/pub/scm/git/git.git $ cd git/ $ make GITWEB_PROJECTROOT="/opt/git" prefix=/usr gitweb SUBDIR gitweb SUBDIR ../ make[2]: `GIT-VERSION-FILE' is up to date. GEN gitweb.cgi GEN static/gitweb.js $ sudo cp -Rf gitweb /var/www/ ~~~ 需要注意的是，你需要在命令中指定 `GITWEB_PROJECTROOT` 變量來讓程序知道你的 Git 版本庫的位置。現在，你需要在 Apache 中使用這個 CGI 腳本，你需要為此添加一個虛擬主機： ~~~ <VirtualHost *:80> ServerName gitserver DocumentRoot /var/www/gitweb <Directory /var/www/gitweb> Options ExecCGI +FollowSymLinks +SymLinksIfOwnerMatch AllowOverride All order allow,deny Allow from all AddHandler cgi-script cgi DirectoryIndex gitweb.cgi </Directory> </VirtualHost> ~~~ 再次提醒，GitWeb 可以通過任何一個支持 CGI 或 Perl 的網絡服務器架設；如果你需要的話，架設起來應該不會很困難。現在，你可以訪問 `http://gitserver/` 在線查看你的版本庫。