GHCR 免费版线报:开源项目的镜像零成本天堂

壹贰云测评 · 壹贰线报 · 容器镜像仓库篇 · 核实时点:2026-11

一、开篇一句话

GitHub Container Registry (GHCR) — 免费公开镜像;私有镜像计入 Actions 存储和包;公开镜像无限带宽;与 GitHub Packages & Actions 集成;多架构、OCI 兼容、语义化版本标签和 GitHub 组织范围。


📌 上手前 3 个细节(非更正,只是补充)

  1. 私有镜像占用 500MB Packages 存储配额——Free 个人账号每月 Packages 总存储 500MB(包含容器镜像+npm/Maven/RubyGems/NuGet等所有包),公共镜像无限存储、无限带宽、不计配额、不计 rate-limit;超 500MB 超额按 $0.25/GB 存储/$0.50/GB 传输/月计费;

  2. GHCR 与 GitHub Packages 是一套系统两个域名——ghcr.io 是容器专用域名(支持 OCI/Docker v2 协议),npm.pkg.github.com/maven.pkg.github.com 等是语言包;统一用 GitHub Token 登录、统一权限体系、统一 Actions GITHUB_TOKEN 免密钥 push;

  3. 带宽按 GitHub Actions 数据传输政策走——公共镜像拉取无 rate limit(不像 Docker Hub 200/6h 限流),私有镜像拉取走 Packages 数据传输配额,Actions 内部 VPC 拉取不走公网流量。


🎁 真免费亮点($0 永久)

能力项

免费(Free 个人/Organization公开)

公共镜像

✅ 无限数量、无限存储、无限带宽、无拉取限流

私有镜像

✅ 占用 500MB Packages 总配额(npm/Maven/Gem/NuGet 共享)

域名

ghcr.io/<owner>/<image>

协议

Docker Registry v2 + OCI 100% 兼容

多架构 manifest

✅ amd64/arm64/armv7/ppc64le/s390x,manifest list 自动分发

语义化标签

✅ 支持 :v1/:v1.2/:v1.2.3/:latest/:sha256@... 不可变摘要

组织/个人范围

✅ ghcr.io/org/image(组织)或 ghcr.io/user/image(个人)

匿名拉取公开镜像

✅ docker pull ghcr.io/owner/image:tag 无需登录

GITHUB_TOKEN 推送

✅ Actions 内 packages: write 权限直接 push 无需 PAT

粒度权限(granular perm)

✅ 按 package 设 public/private/internal、按团队设读写

自动构建 Actions

✅ .github/workflows 用 docker/build-push-action@v6 构建+多架构+SBOM+provenance

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 条必看边界

  1. 500MB Packages 是所有包共享:容器镜像 + npm/Maven/Gem/NuGet 共用 500MB,几个 Node 微服务镜像轻松打满;开源项目强烈建议把生产镜像设为 Public(不计配额);

  2. 免费档无 SLA、无 Geo-replication:相比 GHES/GHCR Enterprise,公共镜像不承诺 99.9% SLA,国内拉取速度 1-3MB/s(比 Docker Hub 快但不如国内 ACR/TCR),国内生产建议加 ACR 镜像同步或 mirror;

  3. 镜像一旦设为 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月)

版权声明

本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。