2026年8月 - 私有GitHub注册表

通过 GitHub CLI 或 token 从私有 GitHub 仓库安装 registry 组件。

GitHub registry 现已支持私有仓库。

今年六月，我们支持了将任意公开的 GitHub 仓库变成 registry。不少团队希望对内部代码也能这样做：设计系统、功能组件包、agent 规则和约定，这些内容往往不便公开。

现在你可以从私有仓库安装了。只要你对仓库有读权限，CLI 就能从中安装。

pnpmnpmyarnbun
pnpm dlx shadcn@latest add acme/internal-toolkit/auth-kit
Copy

零配置#

只要你已登录 GitHub CLI，无需任何额外设置。

Copygh auth login

当仓库不可公开读取时，CLI 会通过 gh 使用你已保存的凭据来读取仓库。token 始终留在 GitHub CLI 内部，不会进入 shadcn 进程。

Copy✔ Using gh credentials.
✔ Checking registry.
✔ Created 1 file:
  - lib/auth.ts

CI 支持#

在没有安装 GitHub CLI 的环境中，可以设置 GH_TOKEN 或 GITHUB_TOKEN：

CopyGH_TOKEN=github_pat_xxx npx shadcn@latest add acme/internal-toolkit/auth-kit

建议使用细粒度的 personal access token，只授权目标仓库，并赋予 Contents: Read-only 权限。

所有命令均可用#

私有仓库支持的命令与公开 GitHub registry 完全相同。

pnpmnpmyarnbun
pnpm dlx shadcn@latest list acme/internal-toolkit
Copy

pnpmnpmyarnbun
pnpm dlx shadcn@latest search acme/internal-toolkit --query auth
Copy

pnpmnpmyarnbun
pnpm dlx shadcn@latest view acme/internal-toolkit/auth-kit
Copy

pnpmnpmyarnbun
pnpm dlx shadcn@latest registry validate acme/internal-toolkit
Copy

工作原理#

• 公开仓库仍然和以前一样匿名读取，不使用任何凭据，也不会调用 GitHub CLI。
• CLI 会先尝试匿名访问，仅在仓库非公开可读时才使用你的凭证。
• 私有文件通过 GitHub 的 Contents API 读取，并锁定到已解析的 commit SHA。
• 来自 GH_TOKEN 的 token 仅发送至 api.github.com。GitHub CLI 的存储凭证由 gh 读取，而非 CLI。

完整指南请参见 Private repositories。

在本页