· 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 可按设置出预览部署。
私有仓库 — 多一步权限
- 在拥有该私有仓的 GitHub 账号或组织上安装 Vercel GitHub App
- 安装时(或之后在 GitHub → Settings → Applications)授权该私有仓,或按安全策略授权全部仓库
- 若组织限制第三方应用,所有者可能需在 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 私有影响的是授权,不是功能是否存在。
延伸阅读
- Invest AI 发布手册(含未接 Git 时的 Git vs CLI):
xingai-invest-aidocs/deploy/release-runbook.md - 新组织接线时以当前 Vercel + GitHub 文档中的 Install & authorize 为准。