GitHub Container Registry(ghcr.io)は、GitHubが運営するコンテナイメージの保管・配布サービスです。料金の結論を先に書くと、2026年10月時点でコンテナイメージのストレージと帯域はパブリック・プライベートを問わず無料です。GitHubは課金方針を変える場合、少なくとも1か月前に利用者へ知らせるとしています。一方、npmやMavenなどコンテナ以外のGitHub Packagesにはプラン別の無料枠と超過課金があり、料金を見るときはこの2つを分けて読む必要があります。この記事では、無料の範囲と例外、Docker Hub・Amazon ECRとの料金差、classic PATでの docker login からGitHub Actionsでのpushまでの手順、公式ドキュメントにある制限を、2026年10月13日に確認した一次情報で整理します。
まとめ:ghcr.ioの料金と使い方の要点
- コンテナイメージは現在無料:ストレージも帯域も、プライベートイメージを含めて課金されません。変更時は最低1か月前に通知されます。
- 課金があるのはコンテナ以外のPackages:npm・Maven・NuGetなどはGitHub Freeで500MB・月1GBの無料枠があり、超過分はストレージが1GB・月あたり0.25ドル、データ転送が1GBあたり0.50ドルです。
- Docker Hubとの差はpull制限:Docker Hubは未認証と無料のPersonalにpull回数の上限があります。ghcr.ioの公式ドキュメントにはpull回数の上限表がありません。
- 認証はclassic PATかGITHUB_TOKEN:GitHub Packagesはfine-grained PATに対応していません。Actionsからは
GITHUB_TOKENとpackages: writeでpushします。 - 戻せない操作がある:一度パブリックにしたパッケージはプライベートに戻せません。5,000ダウンロードを超えたバージョンを含む公開パッケージは、自分では削除できません。
ghcr.ioとは|GitHub Packagesの中のコンテナレジストリ
コンテナレジストリは、Dockerなどのコンテナイメージをpush(登録)・pull(取得)するための保管庫です。種類や選定基準の全体像はコンテナレジストリとは?種類・選び方から企業の導入判断まで解説にまとめています。ghcr.ioはGitHubが運営するレジストリで、GitHubのアカウントや組織と同じ権限体系でイメージを管理できます。
GitHub Packagesとの関係
ghcr.ioは、GitHub Packagesというパッケージ配布機能の一部です。GitHub Packagesにはnpm・Maven・NuGet・RubyGemsなどのレジストリも含まれ、料金ページもPackagesとして1枚にまとめられています。同じページの中で、コンテナイメージだけが「現在無料」という注記で例外扱いされています。料金を確かめるときは、読んでいる記述がコンテナイメージの話か、Packages全体の話かを先に見分けてください。
イメージ名の書式と名前空間
イメージ名は ghcr.io/名前空間/イメージ名:タグ の形で書きます。名前空間には個人アカウント名か組織名が入り、リポジトリ名ではありません。公式ドキュメントは、リポジトリ名と同じ名前でタグ付けしても、コマンドラインからpushしたイメージは既定ではリポジトリに連携されないと明記しています。連携の方法は後の手順の章で説明します。OCI形式のイメージを扱え、Windowsイメージのforeign layerにも対応しています。
GitHub Container Registryの料金【2026年10月時点】
コンテナイメージのストレージ・帯域の料金
GitHubのGitHub Packagesの課金ドキュメントには、「Container image storage and bandwidth for the Container registry is currently free」と書かれています。続けて、方針を変える場合は少なくとも1か月前に通知するとしています。この無料扱いはプライベートイメージにも及ぶため、プライベートで運用してもCI/CDで何度pushやpullをしても、コンテナイメージの保存と転送には料金がかかりません。
この「無料」は「currently(現時点で)」付きで、恒久的な無料の約束ではありません。備え方は後の章で扱います。
コンテナ以外のPackagesの無料枠と超過単価
npm・Maven・NuGetなどコンテナ以外のパッケージでは、パブリックパッケージの利用は無料です。プライベートリポジトリのパッケージには、プランごとに次の無料枠があります。データ転送の無料枠は毎月リセットされ、どこからのデータ受信(アップロード)も無料です。
| プラン | ストレージ | データ転送(月) |
|---|---|---|
| GitHub Free(個人) | 500MB | 1GB |
| GitHub Pro | 2GB | 10GB |
| GitHub Free(組織) | 500MB | 1GB |
| GitHub Team | 2GB | 10GB |
| GitHub Enterprise Cloud | 50GB | 100GB |
このストレージ枠はActionsのアーティファクトと共有です。GitHub Actionsの課金ドキュメントによると、超過分の単価は「アーティファクトとPackagesの共有ストレージ」で1GB・月あたり0.25ドルです。Actionsのキャッシュは共有枠に含まれず、リポジトリごとに10GBの別枠になっています。旧来の解説で「キャッシュも同じ枠を使う」と書かれているものは、現在のドキュメントと合いません。Actionsの分単価や無料枠全体はGitHub Actionsの料金|2026年改定後の分単価・無料枠とコスト削減の判断基準で扱っています。
ストレージは1時間ごとの使用量を月単位に換算して課金し、データ転送はGBごとに課金します。データ転送の単価は課金ドキュメントの本文には無く、GitHubの料金計算ツールに「additional data transfer out outside of Actions $0.50 USD per GB」とあります。Actionsの外へのダウンロードが1GBあたり0.50ドルです。支払い方法を登録していないアカウントは、無料枠を使い切った時点で利用が止まり、請求は発生しません。
GitHub Actions経由のダウンロードの扱い
Actionsのワークフローが GITHUB_TOKEN でログインしてパッケージをダウンロードした場合、その転送量はリポジトリ所有者の使用量に数えられません。どのトークンを使うかで扱いが変わるのは、セルフホストランナーの場合だけです。
| 認証方法 | GitHubホストランナー | セルフホストランナー |
|---|---|---|
| GITHUB_TOKEN | 無料 | 無料 |
| Personal access token | 無料 | 有料 |
この表はコンテナ以外のPackagesに効く規則です。コンテナイメージは現在すべて無料なので、ghcr.ioだけを使うなら今は影響しません。コンテナイメージに課金が始まったときにこの規則が適用されるかは発表されていませんが、現行のPackagesの規則では GITHUB_TOKEN による転送がどのランナーでも無料なので、セルフホストランナーでもPATではなく GITHUB_TOKEN でログインしておくのが無難です。セルフホストランナーの構成はGitHubセルフホストランナーとは?導入手順とhosted版の違い【2026年版】を参照してください。
プライベートとパブリックの料金差と可視性の制約
コンテナイメージに限れば、可視性で料金は変わりません。公開範囲は誰に見せるかで決めて構いませんが、元に戻せない操作があります。
アクセス制御と可視性のドキュメントによると、初めて公開したパッケージの可視性は既定でプライベートです。組織のパッケージでは、組織(Enterpriseに属していればEnterprise全体)のメンバーだけが見られるInternalも選べます。そして「Once you make a package public, you cannot make it private again」とあるとおり、一度パブリックにすると、プライベートには戻せません。社内向けのイメージを試しに公開する運用は避けてください。
リポジトリに連携したパッケージは、既定でそのリポジトリのアクセス権限を引き継ぎますが、可視性は引き継ぎません。プライベートリポジトリに連携していても、パッケージ側をパブリックにすれば誰でもpullできます。権限を自動で引き継ぐのは、公開する前に連携していた場合だけです。公開後にパッケージの設定画面から連携したときや、組織が自動の引き継ぎを無効にしているときは、既存の権限のままになります。
Docker Hub・Amazon ECRとの料金比較
| 項目 | ghcr.io | Docker Hub | Amazon ECR(東京) |
|---|---|---|---|
| 保存料金 | 現在無料 | プラン料金に含む | 0.10ドル/GB・月 |
| 無料のプライベート | 可(現在無料) | Personalは1リポジトリまで | 新規顧客は1年間 月500MB |
| pullの公表上限 | 公式に記載なし | 未認証・Personalに6時間ごとの回数上限 | APIの毎秒上限(引き上げ申請可) |
| 有料プラン | なし | Pro 月9ドル(年払い)〜 | なし(従量) |
| 相性のよい環境 | GitHub Actions | 汎用 | ECS・EKS |
数字は2026年10月13日時点の各社公式ページの値です。
Docker Hubのpull制限と有料プラン
Docker公式のDocker Hubの利用上限のドキュメントでは、pull回数の上限は6時間あたり、未認証がIPv4アドレスまたはIPv6の/64サブネットごとに100回、ログインしたPersonalが200回です。Pro・Team・Businessは無制限(フェアユースの範囲)です。一方、Dockerの料金ページはPersonalを「100 Docker Hub pulls/hr」と表記しており、同じ会社の中で表記が割れています。
2026年10月13日に、未認証でDocker Hubのレート制限確認用イメージ(ratelimitpreview/test)のmanifestを取得すると、応答ヘッダーは ratelimit-limit: 100;w=3600(3,600秒あたり100回)でした。自分の環境で上限に当たっているか調べるときは、ドキュメントの数字より、このヘッダーを見るほうが確実です。
TOKEN=$(curl -s "https://auth.docker.io/token?service=registry.docker.io&scope=repository:ratelimitpreview/test:pull" | jq -r .token)
curl -sI -H "Authorization: Bearer $TOKEN" https://registry-1.docker.io/v2/ratelimitpreview/test/manifests/latest | grep -i ratelimit
上限を外す有料プランは、Proが年払いで月9ドル(月払いは11ドル)、Teamが1ユーザーあたり年払いで月15ドル(月払いは16ドル)、Businessが1ユーザーあたり月24ドルです。CIでDocker Hubのベースイメージを何度もpullするチームは、未認証やPersonalのままだと上限に当たりやすくなります。対策は、ログインしてpullする(Personalで6時間200回、有料プランなら無制限)か、使うベースイメージを自分のghcr.ioの名前空間に複製してそこからpullするかです。
Amazon ECRの東京リージョン単価
Amazon ECRのプライベートリポジトリは、AWS Price List APIの東京リージョン(ap-northeast-1、2026年9月11日公開分)で、ストレージが1GB・月あたり0.10ドルです。ECRの料金ページによると、ECRへのデータ受信と、同じリージョン内のサービスへの転送は無料です。インターネットへの転送には、通常のAWSデータ転送料金がかかります。プライベートリポジトリは、ECRの新規顧客に限り1年間、月500MBまで無料です。パブリックリポジトリには、月50GBまで無料で保存できる枠があります。pull回数の上限は無い代わりに、ECRのサービスクォータでAPIの呼び出し回数に上限があり、manifestを取得する BatchGetImage は東京を含む各リージョンで毎秒2,000回です。
ECS・EKSで同じリージョンからpullするなら、ECRは転送料がかからず、保存料だけで済みます。逆に、AWSの外(オンプレミスのKubernetesや他クラウド)へ大量に配るならインターネット転送の料金が積み上がるため、ghcr.ioのほうが費用は読みやすくなります。ECRへのpush手順はAmazon ECRとは?料金・ECSとの違いとDockerイメージのpush手順【2026年版】、AzureはAzure Container Registry(ACR)の仕組みと料金プラン、Google CloudはArtifact Registryの仕組みと料金で扱っています。
docker loginからpushまでの手順
classic PATでのdocker login
GitHub Packagesは、Personal access token(classic)での認証にだけ対応しています。fine-grained PATではdocker loginできません。トークンには次のスコープを付けます。
read:packages:イメージのpullとメタデータの参照write:packages:pullとpush、メタデータの書き込みdelete:packages:イメージの削除
画面で write:packages を選ぶと、広い権限を持つ repo スコープも自動で選ばれます。公式ドキュメントはこれを避ける方法として、https://github.com/settings/tokens/new?scopes=write:packages を開いて作成する手順を案内しています。組織がSAML SSOを必須にしている場合は、トークンのSSOを有効にしてください。classicとfine-grainedの違いや有効期限の決め方はGitHub PAT(Personal Access Token)とは?作成手順・fine-grainedとclassicの違い・有効期限と組織ポリシー【2026年版】で扱っています。
read -rs CR_PAT
export CR_PAT
echo "$CR_PAT" | docker login ghcr.io -u USERNAME --password-stdin
1行目で入力を待つので、トークンを貼り付けてEnterを押します。Login Succeeded と表示されれば認証は完了です。export CR_PAT=ghp_... のようにトークンをコマンドに直接書くと、シェルの履歴に残ります。read -s で画面に出さずに読み込み、--password-stdin で標準入力から渡します。
ビルド・pushとリポジトリ連携
Dockerfileに org.opencontainers.image.source ラベルを書いておくと、pushした時点でイメージがリポジトリに連携されます。公開前に連携したことになるので、組織が自動の引き継ぎを無効にしていなければ、リポジトリの権限を引き継ぎ、そのリポジトリのワークフローからも扱えるようになります。
LABEL org.opencontainers.image.source=https://github.com/OWNER/REPO
LABEL org.opencontainers.image.description="社内APIのイメージ"
上の2行は既存のDockerfileに追記します。続けて、Dockerfileのあるディレクトリで次を実行します。OWNERは個人アカウント名か組織名、REPOはリポジトリ名、IMAGEはイメージ名に置き換えてください。
docker build -t ghcr.io/OWNER/IMAGE:1.0.0 .
docker push ghcr.io/OWNER/IMAGE:1.0.0
description は512文字まで表示されます。公開するイメージなら、org.opencontainers.image.licenses にSPDX識別子(256文字まで)でライセンスを書けます。社内向けのイメージには付けなくて構いません。ラベルを付けずにpushしたイメージは、パッケージ設定の画面で後から連携できます。その場合は権限を引き継がないため、同じ画面の「Manage Actions access」などで、使うリポジトリやユーザーに権限を個別に付けます。
ログインなしでの公開イメージ取得の確認
パブリックなイメージは、docker loginしなくてもpullできます。docker pullの裏側で行われる、匿名トークンの取得とmanifestの要求を次のコマンドで再現できます。2026年10月13日に、ghcr.ioのトークン発行エンドポイントから匿名トークンを取得し、公開イメージ ghcr.io/github/github-mcp-server:latest のmanifestを要求したところ、HTTP 200が返りました。Docker Hubと違い、応答に ratelimit 系のヘッダーは付いていませんでした。
TOKEN=$(curl -s "https://ghcr.io/token?scope=repository:github/github-mcp-server:pull" | jq -r .token)
curl -sI -H "Authorization: Bearer $TOKEN" \
-H "Accept: application/vnd.oci.image.index.v1+json" \
https://ghcr.io/v2/github/github-mcp-server/manifests/latest
ヘッダーが無いことは、上限が無いことの保証にはなりません。GitHubは上限を公表していないので、大規模な配布では失敗時の再試行を組み込んでおくのが安全です。
GitHub ActionsでghcrへpushするCI例
Actionsからpushする場合はPATを使わず、ワークフローに自動で発行される GITHUB_TOKEN で認証します。次の例は、mainへのpushでイメージをビルドし、ブランチ名とコミットSHAのタグを付けてpushします。アクションのバージョンは2026年10月13日時点の最新リリース(checkout v7.0.1、login-action v4.6.0、metadata-action v6.2.0、build-push-action v7.4.0)のメジャー版です。
name: build-and-push
on:
push:
branches: [ main ]
jobs:
build:
runs-on: ubuntu-latest
permissions:
contents: read
packages: write
steps:
- uses: actions/checkout@v7
- uses: docker/login-action@v4
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
- id: meta
uses: docker/metadata-action@v6
with:
images: ghcr.io/${{ github.repository }}
tags: |
type=ref,event=branch
type=sha
- uses: docker/build-push-action@v7
with:
push: true
tags: ${{ steps.meta.outputs.tags }}
labels: ${{ steps.meta.outputs.labels }}
要点は permissions の packages: write です。これが無いとpushが権限エラーで失敗します。GITHUB_TOKEN の既定権限の決まり方はGitHub Actionsのpermissions|GITHUB_TOKENの既定権限と最小権限の設計で解説しています。ワークフローからpushしたパッケージは、そのリポジトリに自動で連携されます。
よくある失敗は、同じ名前空間に手元のPCから先に同名のイメージをpushしていて、それがリポジトリに連携されていないケースです。公式ドキュメントのとおり、この状態では GITHUB_TOKEN にpushの権限がありません。パッケージ設定の「Manage Actions access」でリポジトリを追加するか、ラベルで連携してから再実行します。キャッシュやマルチアーキテクチャまで含めた組み立てはGitHub ActionsでDockerイメージをビルドする|push先とキャッシュ・マルチアーキの設計を参照してください。
ghcr.ioの制限とつまずきやすい条件
公式ドキュメントに書かれている制限をまとめます。
| 項目 | 内容 |
|---|---|
| レイヤーのサイズ | 1レイヤー10GBまで |
| アップロード | 10分でタイムアウト |
| PATの種類 | classicのみ(ActionsはGITHUB_TOKEN可) |
| 可視性の変更 | パブリックからプライベートへ戻せない |
| 公開パッケージの削除 | 5,000ダウンロード超のバージョンがあると不可 |
| 削除後の復元 | 30日以内で同名が未使用なら可 |
出典はコンテナレジストリの利用とパッケージの削除と復元のドキュメントです。5,000ダウンロードを超えた公開パッケージを消したいときは、GitHubサポートへの問い合わせが必要です。
この制限から、ghcr.ioを選ばないほうがよい場面がはっきりします。機械学習のモデルを焼き込んだイメージのように1レイヤーが10GBを超えるもの、回線が細い拠点から数GBのレイヤーを送るため10分を超えうるものは、ghcr.ioには向きません。また、classic PATは個人に紐づくため、GitHubの外にある本番のKubernetesがプライベートイメージをpullする構成では、退職者のトークンが失効した日に本番のpullが止まります。この場合は、組織で管理するマシンユーザーのトークンを使うか、実行環境と同じクラウドのレジストリ(ECR・Artifact Registry・ACR)を選ぶ判断になります。
将来の課金に備える運用
コンテナイメージが無料なのは「現時点で」の扱いです。課金の条件は発表されていませんが、無料を前提に溜めたイメージは、課金が始まれば保存量としてそのまま対象になりえます。1か月前の通知で慌てないよう、次の3つは今のうちに整えておきます。
- タグの付かないバージョン(同じタグを上書きしたときに残る古いイメージ)を定期的に削除する
latestだけで運用せず、コミットSHAやバージョン番号のタグで履歴を追えるようにし、本番ではタグを上書きされても変わらない@sha256:のダイジェストで固定する- マルチステージビルドで不要なレイヤーを落とし、1イメージのサイズを抑える
削除はActionsで自動化できます。actions/delete-package-versions は最新が2024年1月16日公開のv5.0.0で、その後リリースが出ていません。1回の実行で消せるのは100バージョンまでです。マルチアーキテクチャのイメージを運用しているなら、次の設定は使わないでください(理由は例の後に書きます)。次の例は、タグの付かないバージョンを直近10件だけ残して消す設定です。
name: cleanup-untagged
on:
schedule:
- cron: '0 3 * * 1'
jobs:
cleanup:
runs-on: ubuntu-latest
permissions:
packages: write
steps:
- uses: actions/delete-package-versions@v5
with:
package-name: IMAGE
package-type: container
min-versions-to-keep: 10
delete-only-untagged-versions: 'true'
GITHUB_TOKEN でパッケージを削除するには、そのリポジトリがパッケージに対して admin 権限を持っている必要があります。ワークフローでpushしたパッケージなら自動で付きますが、手元からpushしたものは設定画面で付与します。マルチアーキテクチャのイメージは、プラットフォーム別のmanifestがタグ無しのバージョンとして並ぶため、この設定でタグ付きのイメージまで壊れるという報告がIssue #162(2026年10月時点で未解決)に上がっています。マルチアーキで運用しているなら、このアクションでタグ無しを一括削除する設定は使わないでください。CI/CDのパイプライン全体を見直す場合は、DevOps・CI/CD導入支援の相談も受け付けています。
よくある質問
GitHub Container Registry(ghcr.io)の料金はいくらですか?
2026年10月時点で、コンテナイメージのストレージと帯域はプライベートも含めて無料です。方針を変える場合は最低1か月前に通知されます。npmなどコンテナ以外のPackagesは、無料枠を超えるとストレージ1GB・月0.25ドル、転送1GBあたり0.50ドルです。
プライベートイメージにすると課金されますか?
現時点では課金されません。ただし、一度パブリックにしたパッケージはプライベートに戻せません。
ghcr.ioにfine-grained tokenでログインできますか?
できません。GitHub PackagesはPersonal access token(classic)での認証にだけ対応しています。Actionsからは GITHUB_TOKEN を使います。
GitHub Actionsからpullやpushをしても無料ですか?
イメージの保存と転送は無料です。ただし、ビルドを動かすランナーの実行時間はActionsの料金として別に数えられます(パブリックリポジトリの標準ランナーとセルフホストランナーは無料)。
無料枠を超えるとどうなりますか?
コンテナ以外のPackagesの話です。支払い方法が未登録なら利用が止まるだけで請求はなく、登録済みなら超過分が課金されます。