设置和配置
获取和创建项目
基本快照
分支与合并
共享和更新项目
检查和比较
打补丁
调试
电子邮件
外部系统
服务器管理
指南
管理
底层命令
- 2.43.1 → 2.50.1 无更改
-
2.43.0
2023-11-20
- 2.22.1 → 2.42.4 无更改
-
2.22.0
2019-06-07
- 2.18.1 → 2.21.4 无变更
-
2.18.0
2018-06-21
- 2.3.10 → 2.17.6 无更改
-
2.2.3
2015-09-04
- 2.1.4 无更改
-
2.0.5
2014-12-17
描述
此远程辅助程序使用指定的<command>连接到远程 Git 服务器。
写入指定<command>标准输入的数据被假定发送到 git:// 服务器、git-upload-pack、git-receive-pack 或 git-upload-archive(取决于情况),并且从<command>标准输出读取的数据被假定是从相同的服务接收的。
命令和参数由未转义的空格分隔。
以下序列具有特殊含义
- '% '
-
命令或参数中的文字空格。
- %%
-
文字百分号。
- %s
-
替换为 Git 想要调用的服务名称(receive-pack、upload-pack 或 upload-archive)。
- %S
-
替换为 Git 想要调用的服务长名称(git-receive-pack、git-upload-pack 或 git-upload-archive)。
- %G(必须是参数中的第一个字符)
-
此参数将不会传递给<command>。相反,它将导致辅助程序开始向远程端发送 git:// 服务请求,其中服务字段设置为适当的值,仓库字段设置为参数的其余部分。默认是不发送此类请求。
如果远程端是通过某个隧道访问的 git:// 服务器,这很有用。
- %V(必须是参数中的第一个字符)
-
此参数将不会传递给<command>。相反,它设置 git:// 服务请求中的 vhost 字段(设置为参数的其余部分)。默认是不在此类请求中发送 vhost(如果发送)。
示例
当您使用诸如 "git fetch <URL>"、"git clone <URL>"、"git push <URL>" 或 "git remote add <nick> <URL>" 等命令时,如果 <URL> 以 ext::
开头,Git 会透明地使用此远程辅助程序。示例:
- "ext::ssh -i /home/foo/.ssh/somekey user@host.example %S foo/repo"
-
类似于 host.example:foo/repo,但使用 /home/foo/.ssh/somekey 作为密钥对,并使用 user 作为远程端的用户。这避免了编辑 .ssh/config 的需要。
- "ext::socat -t3600 - ABSTRACT-CONNECT:/git-server %G/somerepo"
-
表示可通过 git 协议在抽象命名空间地址 /git-server 访问的路径为 /somerepo 的仓库。
- "ext::git-server-alias foo %G/repo"
-
表示使用辅助程序 "git-server-alias foo" 访问的路径为 /repo 的仓库。仓库路径和请求类型不通过命令行传递,而是作为协议流的一部分,与 git:// 协议通常一样。
- "ext::git-server-alias foo %G/repo %Vfoo"
-
表示使用辅助程序 "git-server-alias foo" 访问的路径为 /repo 的仓库。协议流中传递的远程服务器主机名将是 "foo"(这允许多个虚拟 Git 服务器共享一个链路层地址)。
- "ext::git-server-alias foo %G/repo% with% spaces %Vfoo"
-
表示使用辅助程序 "git-server-alias foo" 访问的路径为
/repo
with
spaces
的仓库。协议流中传递的远程服务器主机名将是 "foo"(这允许多个虚拟 Git 服务器共享一个链路层地址)。 - "ext::git-ssl foo.example /bar"
-
表示使用辅助程序 "git-ssl foo.example /bar" 访问的仓库。请求类型可以通过辅助程序使用环境变量确定(见上文)。