?
本文檔使用 PHP中文網(wǎng)手冊 發(fā)布
命名
git-daemon - 一個非常簡單的Git倉庫服務(wù)器
概要
git daemon [--verbose] [--syslog] [--export-all] [--timeout=<n>] [--init-timeout=<n>] [--max-connections=<n>] [--strict-paths] [--base-path=<path>] [--base-path-relaxed] [--user-path | --user-path=<path>] [--interpolated-path=<pathtemplate>] [--reuseaddr] [--detach] [--pid-file=<file>] [--enable=<service>] [--disable=<service>] [--allow-override=<service>] [--forbid-override=<service>] [--access-hook=<path>] [--[no-]informative-errors] [--inetd | [--listen=<host_or_ipaddr>] [--port=<n>] [--user=<user> [--group=<group>]]] [<directory>…]
描述
一個非常簡單的TCP Git守護進程，通常在端口“DEFAULT_GIT_PORT”上監(jiān)聽9418.它等待連接請求服務(wù)，并在服務(wù)啟用時提供服務(wù)。
它會驗證該目錄是否具有魔術(shù)文件“git-daemon-export-ok”，并且它會拒絕導(dǎo)出任何未明確標記為導(dǎo)出的Git目錄（除非--export-all指定了該參數(shù)）。如果您將某些目錄路徑作為git daemon參數(shù)傳遞，則可以將報價進一步限制為包含這些參數(shù)的白名單。
默認情況下，只有upload-pack服務(wù)已啟用，供應(yīng)git fetch-pack和git ls-remote客戶，這是從調(diào)用git fetch，git pull和git clone。
這非常適合只讀更新，即從Git存儲庫中提取。
一個upload-archive也存在服務(wù)git archive。
選項
--strict-paths
準確地匹配路徑（即當真實路徑為“/foo/repo.git”或“/foo/repo/.git”時不允許“/ foo / repo”）并且不執(zhí)行用戶相對路徑。git daemon將在此選項啟用且未指定白名單時拒絕啟動。
--base-path=<path>
將所有路徑請求重新映射為相對于給定路徑。這是一種“混帳根” -如果您運行git daemon與--base-path=/srv/git在example.com，那么如果您稍后嘗試拉git://example.com/hello.git，git daemon將解釋路徑/srv/git/hello.git。
--base-path-relaxed
如果啟用了--base-path并且回購查找失敗，則使用此選項git daemon將嘗試查找而無需為基本路徑添加前綴。這對于切換到--base-path用法很有用，同時仍然允許舊的路徑。
--interpolated-path=<pathtemplate>
為了支持虛擬主機，可以使用內(nèi)插路徑模板來動態(tài)構(gòu)建備用路徑。該模板支持由客戶端提供的目標主機名的％H，但轉(zhuǎn)換為全部小寫，％CH表示規(guī)范主機名，％IP表示服務(wù)器IP地址，％P表示端口號，％D表示絕對路徑指定的存儲庫。插值后，路徑將根據(jù)目錄白名單進行驗證。
--export-all
允許從類似Git存儲庫（具有objects和refs子目錄）的所有目錄中提取，即使它們沒有該git-daemon-export-ok文件。
--inetd
讓服務(wù)器作為inetd服務(wù)運行。意味著--syslog。與--detach，--port，--listen，--user和--group選項不兼容。
--listen=<host_or_ipaddr>
監(jiān)聽特定的IP地址或主機名。如果支持，IP地址可以是IPv4地址或IPv6地址。如果不支持IPv6，則--listen = hostname也不受支持，并且 - 必須給予listen。可以給予不止一次。與--inetd選項不兼容。
--port=<n>
聽取另一個端口。與--inetd選項不兼容。
--init-timeout=<n>
建立連接和接收到客戶端請求之間的時間（以秒為單位）（通常是一個相當?shù)偷闹?，因為它?yīng)該基本上立即）。
--timeout=<n>
特定客戶端子請求超時（以秒為單位）。這包括服務(wù)器處理子請求所用的時間以及等待下一個客戶端請求所花費的時間。
--max-connections=<n>
并發(fā)客戶端的最大數(shù)量，默認為32.將其設(shè)置為零，無限制。
--syslog
記錄到syslog而不是stderr。請注意，這個選項并不意味著--verbose，因此默認情況下只會記錄錯誤條件。
--user-path --user-path=<path>
允許在請求中使用?用戶符號。當指定不帶參數(shù)時，對git：// host /?alice / foo的請求將作為訪問foo用戶主目錄中存儲庫的請求alice。如果--user-path=path指定，則將同一請求作為訪問path/foo用戶主目錄中的存儲庫的請求alice。
--verbose
記錄有關(guān)傳入連接和請求文件的詳細信息。
--reuseaddr
綁定偵聽套接字時使用SO_REUSEADDR。這允許服務(wù)器在不等待舊連接超時的情況下重新啟動。
--detach
從外殼分離。意味著--syslog。
--pid-file=<file>
保存進程ID file。守護進程運行時忽略--inetd。
--user=<user> --group=<group>
在進入服務(wù)循環(huán)之前更改守護進程的uid和gid。如果只--user給出沒有--group，則使用用戶的主要組ID。該選項的值給出，getpwnam(3)并且getgrnam(3)不支持數(shù)字ID。
使用這些選項時出錯是錯誤的--inetd; git daemon如果需要，可以在產(chǎn)卵之前使用inet守護進程的功能來實現(xiàn)。
像很多切換用戶ID的程序一樣，守護進程不會重置環(huán)境變量，比如$HOME它運行g(shù)it程序時，比如upload-pack和receive-pack。使用此選項時，您可能還想在啟動守護程序之前將其設(shè)置并導(dǎo)出HOME到主目錄<user>，并確保該目錄中的任何Git配置文件都可讀<user>。
--enable=<service> --disable=<service>
默認情況下，啟用/禁用整個服務(wù)站點。請注意，如果服務(wù)器被標記為可覆蓋，并且存儲庫通過配置項啟用該服務(wù)，則每個存儲庫仍可以啟用服務(wù)禁用的整個網(wǎng)站。
--allow-override=<service> --forbid-override=<service>
允許/禁止覆蓋每個存儲庫配置的站點范圍默認值。默認情況下，所有服務(wù)都可能被覆蓋。
--no-informative-errors
當信息錯誤被打開時，git-daemon將向客戶端報告更多詳細錯誤，將“沒有這樣的存儲庫”與“未導(dǎo)出的存儲庫”等條件區(qū)分開來。這對客戶來說更方便，但可能會泄露有關(guān)未導(dǎo)出存儲庫存在的信息。如果未啟用信息性錯誤，則所有錯誤都會向客戶報告“拒絕訪問”。缺省值是--no-informative-errors。
--access-hook=<path>
每次客戶端連接時，首先運行帶有服務(wù)名稱（例如“upload-pack”）的<path>指定的外部命令，存儲庫路徑，主機名（％H），規(guī)范主機名（％CH），IP地址％IP）和TCP端口（％P）作為其命令行參數(shù)。外部命令可以決定通過以非零狀態(tài)退出來退出服務(wù)（或通過以零狀態(tài)退出來允許它）。它還可以查看$ REMOTE_ADDR和$REMOTE_PORT環(huán)境變量，以便在做出此決定時了解請求者。
外部命令可以選擇將一行寫入其標準輸出，以便在拒絕服務(wù)時作為錯誤消息發(fā)送給請求方。
<directory>
要添加到允許目錄的白名單的目錄。除非指定了--strict-paths，否則它還將包含每個指定目錄的子目錄。
服務(wù)
這些服務(wù)可以使用此命令的命令行選項進行全局啟用/禁用。如果需要更細粒度的控制（例如，允許git archive僅針對幾個選定的存儲庫運行守護進程），則可以使用每個存儲庫配置文件啟用或禁用它們。
upload-pack
這個服務(wù)git fetch-pack和git ls-remote客戶。它是默認啟用的，但是一個版本庫可以通過設(shè)置daemon.uploadpack配置項來禁用它false。
upload-archive
這個服務(wù)git archive --remote。它默認是禁用的，但是一個存儲庫可以通過設(shè)置daemon.uploadarch配置項來啟用它true。
receive-pack
這為git send-pack客戶提供服務(wù)，允許匿名推送。它在默認情況下是禁用的，因為no在協(xié)議中有認證（換句話說，任何人都可以將任何東西推入存儲庫，包括刪除參考）。這僅適用于每個人都很友善的封閉局域網(wǎng)環(huán)境。此服務(wù)可通過將daemon.receivepack配置項目設(shè)置為啟用true。
例子
我們在/ etc / services中假設(shè)如下
$ grep 9418 /etc/services git 9418/tcp # Git Version Control System
git守護進程作為inetd服務(wù)器
要設(shè)置git daemon一個inetd服務(wù)來處理列入白名單的目錄集/ pub / foo和/ pub / bar下的任何存儲庫，請在/ etc / inetd中將以下條目全部放在一行中：
git stream tcp nowait nobody /usr/bin/git git daemon --inetd --verbose --export-all /pub/foo /pub/bar
git守護程序作為虛擬主機的inetd服務(wù)器
要設(shè)置git daemon為處理不同虛擬主機的存儲庫的inetd服務(wù)，www.example.com并在一行中www.example.org放入類似下面的條目/etc/inetd：
git stream tcp nowait nobody /usr/bin/git git daemon --inetd --verbose --export-all --interpolated-path=/pub/%H%D /pub/www.example.org/software /pub/www.example.com/software /software
在此示例中，根級目錄/pub將包含所支持的每個虛擬主機名的子目錄。此外，兩臺主機都簡單地將存儲庫發(fā)布為git://www.example.com/software/repo.git。對于1.4.0之前的客戶端，/software也可以創(chuàng)建符合鏈接到相應(yīng)的默認存儲庫。
git守護程序作為虛擬主機的常規(guī)守護程序
要設(shè)置git daemon為基于其IP地址處理多個虛擬主機的存儲庫的常規(guī)非inetd服務(wù)，請像下面這樣啟動守護進程：
git daemon --verbose --export-all --interpolated-path=/pub/%IP/%D /pub/192.168.1.200/software /pub/10.10.220.23/software
在本例中，根級目錄/pub將包含每個支持的虛擬主機IP地址的子目錄。盡管存儲庫仍然可以通過主機名訪問，但前提是它們與這些IP地址相對應(yīng)。
選擇性啟用/禁用每個存儲庫的服務(wù)
要啟用git archive --remote和禁用git fetch存儲庫，請在存儲庫中的配置文件（即，和）config旁邊的文件中包含以下內(nèi)容。HEADrefsobjects
[daemon] uploadpack = false uploadarch = true
環(huán)境
git daemon如果IP地址可用，會將REMOTE_ADDR設(shè)置為與其連接的客戶端的IP地址。REMOTE_ADDR將在服務(wù)執(zhí)行時調(diào)用的掛鉤環(huán)境中可用。