Git
English ▾ 主题 ▾ 最新版本 ▾ git-upload-pack 最后更新于 2.45.1

名称

git-upload-pack - 将打包的对象发送回 git-fetch-pack

概要

git-upload-pack [--[no-]strict] [--timeout=<n>] [--stateless-rpc]
		  [--advertise-refs] <directory>

描述

git fetch-pack 调用,了解另一方缺少哪些对象,并在打包后发送它们。

此命令通常不会由最终用户直接调用。该协议的 UI 位于 git fetch-pack 端,并且程序对旨在用于从远程存储库拉取更新。对于推送操作,请参阅 git send-pack

选项

--[no-]strict

如果 <directory> 不是 Git 目录,则不要尝试 <directory>/.git/。

--timeout=<n>

在 <n> 秒的空闲时间后中断传输。

--stateless-rpc

仅使用 stdin 和 stdout 执行单个读写循环。这适合 HTTP POST 请求处理模型,其中程序可以读取请求,写入响应,并且必须退出。

--http-backend-info-refs

git-http-backend[1] 用于提供 $GIT_URL/info/refs?service=git-upload-pack 请求。请参阅 gitprotocol-http[5] 中的“智能客户端”以及 gitprotocol-v2[5] 文档中的“HTTP 传输”。git-receive-pack[1] 也理解此选项。

<directory>

要从中同步的存储库。

环境

GIT_PROTOCOL

用于协商线协议的内部变量。服务器管理员可能需要配置某些传输以允许传递此变量。请参阅 git[1] 中的讨论。

GIT_NO_LAZY_FETCH

从部分存储库(即使用 --filter 克隆的存储库)克隆或获取时,服务器端的 upload-pack 可能需要从其上游获取额外对象才能完成请求。默认情况下,upload-pack 会拒绝执行此类延迟获取,因为 git fetch 可能会运行源存储库配置和钩子中指定的任意命令(并且 upload-pack 尝试即使在不受信任的 .git 目录中也能安全运行)。

这是通过让 upload-pack 在内部将 GIT_NO_LAZY_FETCH 变量设置为 1 来实现的。如果要覆盖它(因为您是从部分克隆中获取,并且确定您信任它),可以显式地将 GIT_NO_LAZY_FETCH 设置为 0

安全

大多数 Git 命令不应在不受信任的 .git 目录中运行(请参阅 git[1] 中的“安全”部分)。upload-pack 尝试避免其正在服务的存储库中的任何危险配置选项或钩子,使其能够安全地克隆不受信任的目录并在生成的克隆上运行命令。

为了提高安全性,您可能能够以备用用户身份运行 upload-pack。详细信息将取决于平台,但在许多系统上,您可以运行

git clone --no-local --upload-pack='sudo -u nobody git-upload-pack' ...

另请参阅

GIT

git[1] 套件的一部分

scroll-to-top