Git 仓库

配置独立的 Git 仓库访问，让 ZAI 通过 HTTPS、SSH 和 LFS 拉取与推送项目。

点连接器页头的 添加访问，在 网络与仓库 里选择 添加 Git 仓库，在独立页面中填写并保存。每项配置对应一个仓库，可以启用 HTTPS、SSH 或两种协议，使用范围继承所属连接器。 Git 仓库独立保存凭证，不引用 GitHub 或 GitLab 的 API 凭证。

仓库名称

填写便于 ZAI 辨认的名称。ZAI 能看到每个仓库的名称、可用地址以及是否允许推送，据此在多个仓库中选择，再用普通 Git 命令操作。

读取与推送

默认只读，允许 clone、fetch、pull 和 LFS 下载。勾选 允许 push 后，才允许推送提交和上传 LFS 对象。HTTPS 和 SSH 共用这个开关。

上游账号、PAT 或 SSH key 还需具备相应权限，分支保护继续生效。允许 push 表示平台提供这项能力，不代替具体任务的操作授权。子模块需要各自的 Git 仓库配置。

ZAI 提交时使用平台默认的提交身份（名称为 Z Tag）。上游对提交邮箱有要求（如 push rule、CLA 或审计）时，请 Z Tag 管理员提供该地址；项目需要其他提交身份时，也可以在任务里告诉 ZAI 用哪个名称和邮箱提交。

HTTPS

在 HTTPS 仓库地址 中填写完整地址，如 https://<主机>/<组织>/<仓库>.git，不在 URL 中放入用户名或密码。私有仓库的 认证方式 选择 密码 / PAT，填写上游要求的用户名和密码或 Token；公开仓库可以选择无需凭证。

GitLab 的 Git 读取可使用具有 read_repository 权限的 PAT，推送需要相应的写入权限。 GitHub Token 需要对目标仓库具备相应的内容权限。API 权限和 Git 权限应分别核对。

自建服务证书

默认使用系统信任的 CA。自建 HTTPS 服务可以在 自建服务 CA 中填写其 CA 的 PEM 证书；SSH 仓库使用自建 LFS 服务时，可以单独填写 LFS 服务 CA。平台校验服务主机与证书，不能通过关闭证书校验解决连接错误。

SSH 地址

填写 SSH 主机、端口、SSH 用户名 和原仓库路径。例如 git@<主机>:<组织>/<仓库>.git 的路径是 <组织>/<仓库>.git；ssh://git@<主机>:<端口>/<路径> 保留路径开头的 /。相对路径与绝对路径含义不同，不应随意互换。

相对路径的仓库即使配置了非 22 端口，ZAI 也可以用 git@<主机>:<路径> 这种常见写法访问，平台按配置的端口连接。

同一仓库（主机、用户名、路径都相同）在 ZAI 可用的连接器中只保留一份配置。相对路径的仓库在多个端口重复配置时，平台无法确定用哪一份，访问会失败。

服务器公钥

从 Git 服务的管理员处取得可信的 SSH 服务器公钥，每行一个，最多 16 行。每行的格式是 <算法> <公钥 Base64>，可以带注释；ssh-keyscan 的输出行首带有主机名（或 [主机]:端口），粘贴前要删掉，否则无法保存。

平台只连接与这些公钥匹配的服务器。服务更换 host key 后，需要先确认新公钥，再更新配置。

SSH 私钥

填写已在上游登记的私钥；加密私钥同时填写口令。私钥保存在平台，保存后不再显示，也不会交给 ZAI。编辑时私钥留空表示保留原凭证，填写新值即完成替换。

LFS

普通 clone 和 pull 会下载 LFS 文件内容。LFS 失败时，工作区可能只有 pointer 文件，不能视为完整拉取成功。

LFS 服务地址默认从仓库地址推导。SSH 仓库使用不同的 HTTPS 地址或端口时，在 LFS 服务地址 中填写实际地址，例如 https://<主机>/<组织>/<仓库>.git/info/lfs。SSH 仓库可以使用 SSH 认证后通过 HTTPS 传输对象，也可以使用上游支持的纯 SSH LFS。

对象存储与 LFS 服务不在同一源站时，在 额外 LFS 对象存储地址 中逐行登记 HTTPS 源站，不包含路径。登记源站只允许平台处理该仓库返回的具体对象操作，不开放任意对象访问。HTTPS LFS 单个对象最多 4 GiB。认证头和签名地址由平台处理，ZAI 拿不到它们。

推送中断（包括替换凭证或撤销时正在进行的推送）不代表远端已回滚，远端分支可能已经更新；需要时在上游核对仓库状态。

验证

保存后，请 ZAI 列出这个仓库的远端分支，或拉取它。其余排查见验证与排错。