技术博客

← 全部文章

· Platform (Vercel + GitHub) · applies across XingAI apps

私有仓库也能用 Vercel Git 自动部署

一句话

Vercel 的「push 就自动部署」不限于公开仓库 — 私有(private)仓库也可以,只要在 GitHub 侧完成 Vercel GitHub App 的安装与授权。是否自动部署,取决于 有没有在 Vercel 里 Connect Git 以及 Vercel 能否读该仓库;与 public / private 无必然关系(私库只是多一步权限)。这和 vercel deploy CLI 手动发版 是两条独立路径。

常见误解

很多人以为 Vercel 的 Connect Git Repository 只对 公开 GitHub 仓有效 — 尤其当你一直用 vercel deploy 发版、仪表盘仍显示 Connect Git 时。仓库可见性和是否接入 Git 是两回事。

事实: Vercel 可连接 公开或私有 仓库。私有仓只需明确授权,让 Vercel GitHub App 能读触发构建的代码。

实际怎么工作

公开与私有

在 Vercel 项目里 Connect Git Repository 可选公开或私有仓。连接成功后,推送到配置的生产分支(常见 main)会触发生产部署;其他分支/PR 可按设置出预览部署。

私有仓库 — 多一步权限

  1. 在拥有该私有仓的 GitHub 账号或组织上安装 Vercel GitHub App
  2. 安装时(或之后在 GitHub → Settings → Applications)授权该私有仓,或按安全策略授权全部仓库
  3. 若组织限制第三方应用,所有者可能需在 Organization settings → Third-party access 批准 Vercel

在 Vercel 能列出并 clone 该私有仓之前,连接会失败或未完成 — 这是权限问题,不是「不支持私有仓」。

与 Vercel CLI 无关

机制触发构建的方式
Git 集成git push(或 merge)到 Vercel 监听的分支
CLI在本机对已 link 的项目执行 vercel deploy(或 --prod)

可只用 CLI、只用 Git、或两者并存。用 CLI 不会自动隐藏「Connect Git」提示 — 只是你还没开 push 驱动部署。

一句话收束

按 push 自动部署不限制公开仓。 私有仓请连接 Vercel 与 GitHub,并授予 Vercel GitHub App 对该仓库的访问(并满足组织第三方策略)。公开 vs 私有影响的是授权,不是功能是否存在。

延伸阅读