©
Dokumen ini menggunakan Manual laman web PHP Cina Lepaskan
git-daemon - 一个非常简单的Git仓库服务器
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”上监听9418.它等待连接请求服务,并在服务启用时提供服务。
它会验证该目录是否具有魔术文件“git-daemon-export-ok”,并且它会拒绝导出任何未明确标记为导出的Git目录(除非--export-all
指定了该参数)。如果您将某些目录路径作为git daemon
参数传递,则可以将报价进一步限制为包含这些参数的白名单。
默认情况下,只有upload-pack
服务已启用,供应git fetch-pack
和git ls-remote
客户,这是从调用git fetch
,git pull
和git clone
。
这非常适合只读更新,即从Git存储库中提取。
一个upload-archive
也存在服务git archive
。
--strict-paths
准确地匹配路径(即当真实路径为“/foo/repo.git”或“/foo/repo/.git”时不允许“/ foo / repo”)并且不执行用户相对路径。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>
为了支持虚拟主机,可以使用内插路径模板来动态构建备用路径。该模板支持由客户端提供的目标主机名的%H,但转换为全部小写,%CH表示规范主机名,%IP表示服务器IP地址,%P表示端口号,%D表示绝对路径指定的存储库。插值后,路径将根据目录白名单进行验证。
--export-all
允许从类似Git存储库(具有objects
和refs
子目录)的所有目录中提取,即使它们没有该git-daemon-export-ok
文件。
--inetd
让服务器作为inetd服务运行。意味着--syslog。与--detach,--port,--listen,--user和--group选项不兼容。
--listen=<host_or_ipaddr>
监听特定的IP地址或主机名。如果支持,IP地址可以是IPv4地址或IPv6地址。如果不支持IPv6,则--listen = hostname也不受支持,并且 - 必须给予listen。可以给予不止一次。与--inetd
选项不兼容。
--port=<n>
听取另一个端口。与--inetd
选项不兼容。
--init-timeout=<n>
建立连接和接收到客户端请求之间的时间(以秒为单位)(通常是一个相当低的值,因为它应该基本上立即)。
--timeout=<n>
特定客户端子请求超时(以秒为单位)。这包括服务器处理子请求所用的时间以及等待下一个客户端请求所花费的时间。
--max-connections=<n>
并发客户端的最大数量,默认为32.将其设置为零,无限制。
--syslog
记录到syslog而不是stderr。请注意,这个选项并不意味着--verbose,因此默认情况下只会记录错误条件。
--user-path --user-path=<path>
允许在请求中使用〜用户符号。当指定不带参数时,对git:// host /〜alice / foo的请求将作为访问foo
用户主目录中存储库的请求alice
。如果--user-path=path
指定,则将同一请求作为访问path/foo
用户主目录中的存储库的请求alice
。
--verbose
记录有关传入连接和请求文件的详细信息。
--reuseaddr
绑定侦听套接字时使用SO_REUSEADDR。这允许服务器在不等待旧连接超时的情况下重新启动。
--detach
从外壳分离。意味着--syslog。
--pid-file=<file>
保存进程ID file
。守护进程运行时忽略--inetd
。
--user=<user> --group=<group>
在进入服务循环之前更改守护进程的uid和gid。如果只--user
给出没有--group
,则使用用户的主要组ID。该选项的值给出,getpwnam(3)
并且getgrnam(3)
不支持数字ID。
使用这些选项时出错是错误的--inetd
; git daemon
如果需要,可以在产卵之前使用inet守护进程的功能来实现。
像很多切换用户ID的程序一样,守护进程不会重置环境变量,比如$HOME
它运行git程序时,比如upload-pack
和receive-pack
。使用此选项时,您可能还想在启动守护程序之前将其设置并导出HOME
到主目录<user>
,并确保该目录中的任何Git配置文件都可读<user>
。
--enable=<service> --disable=<service>
默认情况下,启用/禁用整个服务站点。请注意,如果服务器被标记为可覆盖,并且存储库通过配置项启用该服务,则每个存储库仍可以启用服务禁用的整个网站。
--allow-override=<service> --forbid-override=<service>
允许/禁止覆盖每个存储库配置的站点范围默认值。默认情况下,所有服务都可能被覆盖。
--no-informative-errors
当信息错误被打开时,git-daemon将向客户端报告更多详细错误,将“没有这样的存储库”与“未导出的存储库”等条件区分开来。这对客户来说更方便,但可能会泄露有关未导出存储库存在的信息。如果未启用信息性错误,则所有错误都会向客户报告“拒绝访问”。缺省值是--no-informative-errors。
--access-hook=<path>
每次客户端连接时,首先运行带有服务名称(例如“upload-pack”)的<path>指定的外部命令,存储库路径,主机名(%H),规范主机名(%CH),IP地址%IP)和TCP端口(%P)作为其命令行参数。外部命令可以决定通过以非零状态退出来退出服务(或通过以零状态退出来允许它)。它还可以查看$ REMOTE_ADDR和$REMOTE_PORT
环境变量,以便在做出此决定时了解请求者。
外部命令可以选择将一行写入其标准输出,以便在拒绝服务时作为错误消息发送给请求方。
<directory>
要添加到允许目录的白名单的目录。除非指定了--strict-paths,否则它还将包含每个指定目录的子目录。
这些服务可以使用此命令的命令行选项进行全局启用/禁用。如果需要更细粒度的控制(例如,允许git archive
仅针对几个选定的存储库运行守护进程),则可以使用每个存储库配置文件启用或禁用它们。
upload-pack
这个服务git fetch-pack
和git ls-remote
客户。它是默认启用的,但是一个版本库可以通过设置daemon.uploadpack
配置项来禁用它false
。
upload-archive
这个服务git archive --remote
。它默认是禁用的,但是一个存储库可以通过设置daemon.uploadarch
配置项来启用它true
。
receive-pack
这为git send-pack
客户提供服务,允许匿名推送。它在默认情况下是禁用的,因为no
在协议中有认证(换句话说,任何人都可以将任何东西推入存储库,包括删除参考)。这仅适用于每个人都很友善的封闭局域网环境。此服务可通过将daemon.receivepack
配置项目设置为启用true
。
我们在/ etc / services中假设如下
$ grep 9418 /etc/services git 9418/tcp # Git Version Control System
git守护进程作为inetd服务器
要设置git daemon
一个inetd服务来处理列入白名单的目录集/ 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服务器
要设置git daemon
为处理不同虚拟主机的存储库的inetd服务,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
将包含所支持的每个虚拟主机名的子目录。此外,两台主机都简单地将存储库发布为git://www.example.com/software/repo.git
。对于1.4.0之前的客户端,/software
也可以创建符合链接到相应的默认存储库。
git守护程序作为虚拟主机的常规守护程序
要设置git daemon
为基于其IP地址处理多个虚拟主机的存储库的常规非inetd服务,请像下面这样启动守护进程:
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地址相对应。
选择性启用/禁用每个存储库的服务
要启用git archive --remote
和禁用git fetch
存储库,请在存储库中的配置文件(即,和)config
旁边的文件中包含以下内容。HEADrefsobjects
[daemon] uploadpack = false uploadarch = true
git daemon
如果IP地址可用,会将REMOTE_ADDR设置为与其连接的客户端的IP地址。REMOTE_ADDR将在服务执行时调用的挂钩环境中可用。