壹贰云测评 · 壹贰线报 · 容器镜像仓库篇 · 核实时点:2026-11
一、开篇一句话
GitHub Container Registry (GHCR) — 免费公开镜像;私有镜像计入 Actions 存储和包;公开镜像无限带宽;与 GitHub Packages & Actions 集成;多架构、OCI 兼容、语义化版本标签和 GitHub 组织范围。
📌 上手前 3 个细节(非更正,只是补充)
私有镜像占用 500MB Packages 存储配额——Free 个人账号每月 Packages 总存储 500MB(包含容器镜像+npm/Maven/RubyGems/NuGet等所有包),公共镜像无限存储、无限带宽、不计配额、不计 rate-limit;超 500MB 超额按 $0.25/GB 存储/$0.50/GB 传输/月计费;
GHCR 与 GitHub Packages 是一套系统两个域名——
ghcr.io是容器专用域名(支持 OCI/Docker v2 协议),npm.pkg.github.com/maven.pkg.github.com等是语言包;统一用 GitHub Token 登录、统一权限体系、统一 Actions GITHUB_TOKEN 免密钥 push;带宽按 GitHub Actions 数据传输政策走——公共镜像拉取无 rate limit(不像 Docker Hub 200/6h 限流),私有镜像拉取走 Packages 数据传输配额,Actions 内部 VPC 拉取不走公网流量。
🎁 真免费亮点($0 永久)
能力项 | 免费(Free 个人/Organization公开) |
|---|---|
公共镜像 | ✅ 无限数量、无限存储、无限带宽、无拉取限流 |
私有镜像 | ✅ 占用 500MB Packages 总配额(npm/Maven/Gem/NuGet 共享) |
域名 |
|
协议 | Docker Registry v2 + OCI 100% 兼容 |
多架构 manifest | ✅ amd64/arm64/armv7/ppc64le/s390x,manifest list 自动分发 |
语义化标签 | ✅ 支持 |
组织/个人范围 | ✅ |
匿名拉取公开镜像 | ✅ |
GITHUB_TOKEN 推送 | ✅ Actions 内 |
粒度权限(granular perm) | ✅ 按 package 设 public/private/internal、按团队设读写 |
自动构建 Actions | ✅ |
Webhooks / Dependabot | ✅ Package 发布事件触发 workflow、Dependabot 自动更新镜像引用 |
包页(Package page) | ✅ README/元数据/下载统计/版本列表/关联仓库 |
安全扫描 | ✅ Dependabot alerts + Secret scanning 公共镜像默认启用;GHAS Advanced Security 付费 |
签名与供应链 | ✅ Cosign/Sigstore 签名 + SLSA 3 provenance(Actions 内置)+ SBOM 生成 |
Immutability / Tag retention | ✅ 可配置 tag retention rule 自动清理旧 tag |
Codespaces 集成 | ✅ 一键在 Codespaces 里拉镜像跑开发环境 |
成本 | $0 永久,公开镜像无配额上限 |
🔧 4 步上手(10 分钟跑通)
Step 1:创建 PAT(个人本地推送)或直接用 GITHUB_TOKEN(CI 推送)
# .github/workflows/release.yml —— Actions 内推送,免 PAT
name: Publish to GHCR
on:
push:
branches: [main]
tags: ['v*']
jobs:
build-push:
runs-on: ubuntu-latest
permissions:
contents: read
packages: write # 关键:给 GITHUB_TOKEN 开包写入权限
steps:
- uses: actions/checkout@v4
- name: Login to GHCR
uses: docker/login-action@v3
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
- name: Build & push multi-arch
uses: docker/build-push-action@v6
with:
context: .
push: true
platforms: linux/amd64,linux/arm64
tags: |
ghcr.io/${{ github.repository }}:latest
ghcr.io/${{ github.repository }}:${{ github.ref_name }}
cache-from: type=gha
cache-to: type=gha,mode=max
provenance: true
sbom: true
Step 2:本地登录拉取私有镜像
# 用 GitHub 用户名 + PAT(勾选 write:packages/read:packages)
echo $GITHUB_PAT | docker login ghcr.io -u <你的GitHub用户名> --password-stdin
docker pull ghcr.io/<owner>/<image>:latest
Step 3:本地推送到个人/组织
docker tag myapp:latest ghcr.io/<yourname>/myapp:v1.0.0
docker push ghcr.io/<yourname>/myapp:v1.0.0
Step 4:匿名拉取公共镜像(免登录,无限流)
docker pull ghcr.io/OWNER/IMAGE:TAG
# 例:docker pull ghcr.io/coder/coder:latest
🎯 6 张能力卡
🐙 Git-native 一体化
代码(Repo)→ CI(Actions)→ 镜像(GHCR)→ 部署(Releases/Webhook)全在 GitHub 一个账号里,不需要 Docker Hub 单独维护账号和 PAT。
⚡ 公共镜像零成本无限量
开源项目公开镜像存储/带宽/拉取次数全无限,没有 Docker Hub 200 次/6h 的限流,CI/CD 多节点并发拉取也不会 429。
🔧 Actions 原生集成
docker/login-action + docker/build-push-action + GITHUB_TOKEN 一套 YAML 搞定多架构构建、缓存、SBOM、provenance、签名;还能用 docker/metadata-action 自动生成 OCI 标签。
🏢 组织范围 + 粒度权限
镜像放在组织下(ghcr.io/org/image),按 team 授 read/write/admin;支持 internal 可见性(组织成员可见)、可禁用继承自仓库的默认权限。
🛡️ 供应链安全内置
Actions 内建 SLSA 3 provenance + SBOM SPDX/CycloneDX 生成 + Cosign/Sigstore 镜像签名 + Dependabot alerts 镜像 CVE 告警,比 Docker Hub 免费档安全能力更强。
🌐 多架构 + OCI
Docker v2 + OCI 100% 兼容,manifest list 一条 docker pull 自动匹配 amd64/arm64;兼容 Helm Chart、WASM、AI 模型等所有 OCI Artifacts。
⚠️ 3 条必看边界
500MB Packages 是所有包共享:容器镜像 + npm/Maven/Gem/NuGet 共用 500MB,几个 Node 微服务镜像轻松打满;开源项目强烈建议把生产镜像设为 Public(不计配额);
免费档无 SLA、无 Geo-replication:相比 GHES/GHCR Enterprise,公共镜像不承诺 99.9% SLA,国内拉取速度 1-3MB/s(比 Docker Hub 快但不如国内 ACR/TCR),国内生产建议加 ACR 镜像同步或 mirror;
镜像一旦设为 Public 即公开不可"半公开":匿名可拉、匿名可看 layers 元数据;敏感/商业镜像必须 Private 或用内部 GHES/GitLab CR。
✅ 适合 / ❌ 不适合
✅ 适合:
开源项目要把 Docker 镜像和代码放一起(README/Release/Issues 都能直接引用包)
重度 GitHub Actions 用户(GITHUB_TOKEN 免密钥、VPC 内网拉取)
组织内私有镜像用量小(500MB 内几个基础镜像够跑 CI)
想规避 Docker Hub 限流的 CI/CD 流水线
❌ 不适合:
大量私有镜像存储(500MB 很快满,超量 $0.50/GB/月)
国内生产业务直连(建议国内 ACR/TCR 镜像同步加速)
企业级需求(Geo-replication / VPC peering / 审计日志要 GitHub Enterprise Cloud $21/用户/月)
📊 8 款容器 Registry 横向对比(免费档)
平台 | 公开镜像 | 私有镜像/存储 | 拉取限流 | 国内速度 | 多架构 | 供应链 | 自动构建 |
|---|---|---|---|---|---|---|---|
GHCR | ✅ 无限 | 500MB Packages 共享 | ❌ 公共无限 | ⭐⭐⭐ | ✅ amd64/arm64 | ✅ SBOM+签名+SLSA | ✅ Actions |
Docker Hub | ✅ 无限 | 1 私有 | 200/6h认证 | ⭐⭐(需加速) | ✅ | ⚠️ Scout基础付费 | ✅ Auto Build |
阿里云 ACR 个人版 | ✅ 公开无限 | 500MB 私有 | ❌ 公共无限 | ⭐⭐⭐⭐⭐ VPC内网 | ✅ | ⚠️ 扫描300次/月 | ✅ 云构建120min |
GitHub Packages (其他) | ✅ 语言包 | 500MB Packages 共享 | ❌ 无 | ⭐⭐⭐ | - | ✅ Dependabot | ✅ Actions |
Quay.io (Red Hat) | ✅ 公开 | 无免费私有 | ❌ 公共无限 | ⭐⭐ | ✅ | ✅ Clair 扫描 | ⚠️ 需 quay.io 账户 |
GHES/GCR Enterprise | ❌ | 付费企业版 | 企业SLA | ⭐⭐⭐⭐ | ✅ | ✅ 高级安全 | ✅ |
Harbor 自建 | ✅ 自定 | 自定磁盘 | 自定 | ⭐⭐⭐⭐⭐内网 | ✅ | ✅ Trivy+Notary | ⚠️ 自己维护 |
Cloudflare R2+Registry | ✅ 无限 | 10GB 免费 | ❌ 无限 | ⭐⭐⭐⭐ | ✅ | ⚠️ 自接Cosign | ⚠️ 自建CI |
💰 付费档参考
GitHub Free:$0 永久(500MB Packages / 2000 Actions 分钟 / 无限公共仓库与公共镜像)
GitHub Pro:$4/用户·月(2GB Packages / 3000 Actions 分钟 / 高级工具)
GitHub Team:$4/用户·月(2GB Packages / 3000 Actions 分钟 / 团队权限)
GitHub Enterprise Cloud:$21/用户·月(50GB Packages / 50,000 Actions 分钟 / SAML SSO / Audit log / Geo-replication / GHAS 可选)
超额:Packages 存储 $0.25/GB/月,传输 $0.50/GB,Actions $0.008/min
一键直达入口
GHCR 官方地址:https://github.com/features/packages · https://ghcr.io 官方文档:https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry 一键迁移工具:https://github.com/docker/build-push-action(docker/login-action 支持一键切到 ghcr.io)
关键词:
GHCR/GitHub镜像/GHCR免费/容器仓库/GHCR对比入口指引:注册 GitHub → Settings → Developer settings → Personal access tokens → 生成 classic PAT 勾选
write:packages/read:packages/delete:packages→ 本地docker login ghcr.io -u <用户名>→ Actions YAML 写 permissions.packages: write → push!
你日常是用 Docker Hub、GHCR 还是国内云厂商的镜像仓库?有没有踩过 Docker Hub 429 限流的坑?欢迎在评论区分享你的选择和经验~
壹贰线报 · 官方文档核实 文中配额与规则以 GitHub 官方 docs 为准(核实时点:2026年11月)