docker run nginx と打っただけで、手元にないはずのNginxが数秒で起動する。
あのイメージがどこから来ているのか、気にしたことはあるでしょうか。
答えはDocker Hubです。Dockerを使っていれば、意識していなくても毎回お世話になっている場所です。
業務で毎日Dockerを触っていても、Docker Hubの中身は「pullしてくる場所」くらいの理解で止まりがちです。ところが回数制限・タグの選び方・偽物のイメージと、知らないと困る話がいくつもあります。
基本の仕組みからpushの手順、よくあるエラーまでを、公式ドキュメントとDocker HubのAPIで確かめた数字でまとめました。
この記事でわかること
- Docker Hubの役割と、レジストリ・リポジトリ・タグの関係
- 無料プランでできることと、pullの回数制限の確かめ方
- 公式イメージの見分け方(4種類のバッジ)とタグの選び方
- 自分のイメージをpushする4ステップと、よくあるエラーの対処
PARTS LIST /目次
Docker Hubとは?Dockerイメージの置き場所
Docker Hubとは、Docker社が運営するDockerイメージの公開・共有サービス(コンテナレジストリ)です。GitHubがソースコードの置き場所なら、Docker Hubはイメージの置き場所にあたります。
docker pull や docker run でレジストリを指定しなければ、Dockerは自動でDocker Hub(docker.io)を見に行きます。だから docker run nginx だけで動くわけです。
規模も桁違いです。公式イメージの累計pull数は、Docker HubのAPIで見ると次のとおりです。
レジストリ・リポジトリ・タグの関係
Docker Hubを理解するうえで、3つの言葉の大きさの違いを押さえておくと話が早くなります。
イメージ名は レジストリ/ネームスペース/リポジトリ:タグ の形をしています。nginx とだけ書いたときは、正式には docker.io/library/nginx:latest の省略形です。library は公式イメージのための特別なネームスペースです。
Docker DesktopやDockerfileとの関係
Docker Desktopは、自分のPCでコンテナを動かすためのアプリです。Docker Hubはネットの向こうにあるイメージの倉庫で、役割がまったく違います。
flowchart LR
A["Dockerfile"] -->|"docker build"| B["自分のPCの<br>イメージ"]
B -->|"docker push"| C["Docker Hub<br>(リポジトリ)"]
C -->|"docker pull"| D["別のPC・サーバーの<br>イメージ"]
D -->|"docker run"| E["コンテナ"]
Dockerfileでイメージを作り(build)、Docker Hubに上げ(push)、別の場所で取ってきて(pull)動かす(run)。この流れの真ん中にいるのがDocker Hubです。Dockerfileの書き方はDockerfileの書き方とマルチステージビルドで扱っています。
Docker Hubの料金プランと無料でできること
Docker Hubは無料のPersonalプランで使い始められます。pullだけなら、アカウントを作らなくても使えます。
有料プランとの違いは、主にプライベートリポジトリの数とpullの回数制限です。料金ページの内容を表にしました。
料金は改定されることがあるので、契約前にはDocker公式の料金ページで確かめてください。
無料(Personal)でできること
無料プランでも、個人で学習や小さな開発に使うぶんには困りません。
- 公開(public)リポジトリはいくつでも作れる
- プライベートリポジトリは1個まで作れる
- 公式イメージや他の人のイメージを検索・pullできる
- アクセストークンを発行してCI(GitHub Actionsなど)からpushできる
公開リポジトリ
誰でも検索・pullできる。数の制限なし。学習用のイメージや、OSSとして配るイメージ向け。
プライベートリポジトリ
自分と許可した人だけがpullできる。無料は1個まで。社内のアプリや設定入りのイメージ向け。
会社でDocker Desktopを使う場合は、Docker Hubとは別にライセンスの条件があります。無料で使えるのは、従業員250人未満かつ年間売上1,000万ドル未満の会社・個人利用・教育・非商用のOSSです。それ以外の会社で業務に使うなら、有料のサブスクリプションが必要です(公式のライセンス説明)。
pullの回数制限(レート制限)
Docker Hubには、pullの回数制限(レート制限)があります。CIで何度もビルドしていると、ある日突然pullが止まる原因になります。
ここは公式の情報どうしで表記がそろっていません。確かめた内容は次のとおりです。
どの数字でも言えるのは、ログインしたほうが上限が上がるということです。CIやチームで同じIPアドレスを共有している環境では、未ログインのpullがすぐに上限へ届きます。次の章の方法で、自分の環境の実際の上限を確かめておくと安心です。
Docker Hubの使い方:イメージを探してpullする
使い方の基本は「探す → タグを決める → pullする」の3つです。ブラウザで探しても、コマンドで探しても結果は同じです。
どちらで探す場合も、決めるべきはイメージの名前とタグの2つだけです。タグの決め方を間違えると、昨日まで動いていた構成がある日いきなり動かなくなります。
Webとdocker searchでイメージを探す
ブラウザなら hub.docker.com の検索欄にキーワードを入れます。公式イメージのページは hub.docker.com/_/nginx のように、ユーザー名の代わりに _ が入ったURLになります。
コマンドで探すなら docker search です。公式イメージだけに絞り込めます。
docker search nginx --filter is-official=true
Webのページには、使えるタグの一覧・環境変数の説明・docker run の例が載っています。pullする前に、このページの説明は一度読んでおくのがおすすめです。データベース系のイメージは、必須の環境変数を渡さないと起動しないものが多いためです。
docker pullとタグの指定
イメージを取ってくるのは docker pull イメージ名:タグ です。タグを省くと latest が使われます。
docker pull nginx # nginx:latest と同じ
docker pull nginx:1.31-alpine
docker pull postgres:18
latest は「最新版」というより「その時点で指されている版」です。日によって中身が変わるので、仕事で使うイメージにはバージョンを書いたタグを指定します。
docker-compose.yml や Dockerfile の FROM に latest と書くと、ビルドするたびにその時点の版が入ります。昨日まで動いていた構成が、新しいメジャー版の仕様変更で止まることもあります。postgres:18 や nginx:1.31-alpine のように、少なくともメジャー版までは固定しておきます。
タグには alpine(Alpine Linuxベースの小さいイメージ)や slim(不要なものを削った版)のような種類もあります。サイズを小さくしたいなら選択肢になりますが、ライブラリが足りずに動かないこともあるので、まずは標準のタグで動かしてから切り替えるのが無難です。
残りのpull回数を確かめる
自分の環境のpull回数の上限と残りは、公式ドキュメントにある方法で確かめられます。curl と jq を使います。
TOKEN=$(curl -s "https://auth.docker.io/token?service=registry.docker.io&scope=repository:ratelimitpreview/test:pull" | jq -r .token)
curl -s --head -H "Authorization: Bearer $TOKEN" https://registry-1.docker.io/v2/ratelimitpreview/test/manifests/latest | grep -i ratelimit
未ログインで実行したときの応答は次のとおりです(送信元のアドレスの行は省いています)。
ratelimit-limit: 100;w=3600
ratelimit-remaining: 100;w=3600
w=3600 は3,600秒、つまり1時間あたりの回数という意味です。このHEADリクエストは回数に数えられないと公式ドキュメントに書かれているので、何度実行しても上限は減りません。
信頼できるイメージの見分け方(公式バッジ)
Docker Hubには、誰でもイメージを公開できます。名前が似ているだけの非公式イメージも多いので、pullする前にバッジを確かめます。
検索結果やイメージのページには、Docker社が確認したイメージにだけバッジが付きます。バッジの付いていないイメージが危ないとは限りませんが、中身を自分で確かめる手間は増えます。
4種類のバッジの意味
公式ドキュメントでは、信頼できるコンテンツとして次の4種類が挙がっています。
迷ったら、まずDocker Official Imageから選びます。ドキュメントが整っていて、Docker社の管理のもとで定期的に更新されます。
イメージの脆弱性を自分で調べる方法は、Dockerの脆弱性診断方法(Trivy・Grype)にまとめています。
公式イメージの名前とlibrary
公式イメージは、名前に / が入らないのが目印です。nginx は公式、someone/nginx は誰かが公開したイメージです。
見分け方のコツ
公式イメージ:nginx(URLは hub.docker.com/_/nginx)
個人・企業のイメージ:ユーザー名/nginx(URLは hub.docker.com/r/ユーザー名/nginx)
チュートリアル記事のコードに ユーザー名/イメージ名 が書かれていたら、そのユーザーが何者かを一度確かめてからpullします。
自分のイメージをpushする手順
自分で作ったイメージをDocker Hubに上げる手順は4ステップです。ログインには、パスワードの代わりにアクセストークン(PAT)を使います。
pushしたイメージは、別のPCやサーバー、CIから docker pull で取ってこられるようになります。
step
1Docker Hubのアカウントを作る
hub.docker.com でサインアップします。ユーザー名はイメージ名の先頭に入るので、後から見て困らない名前にしておきます。
step
2アクセストークンを作ってdocker loginする
Docker Hubの設定画面から Personal access token を作ります。pushするなら権限は「Repo Read & Write」を選びます(既定の「Repo Public Read-only」ではpushできません)。
docker login -u ユーザー名
# Password: と聞かれたら、パスワードではなくトークンを貼り付ける
2段階認証を有効にしているアカウントでは、CLIからのログインにトークンが必須です。
step
3イメージに「ユーザー名/リポジトリ名:タグ」の名前を付ける
pushするイメージには、自分のユーザー名で始まる名前が必要です。ビルド時に付けるか、docker tag で付け直します。
docker build -t ユーザー名/myapp:1.0 .
# 既にあるイメージに名前を付けるなら
docker tag myapp:latest ユーザー名/myapp:1.0
step
4docker pushする
最後に docker push で上げます。リポジトリが無ければ、初回のpushで自動的に作られます(公開か非公開かは、アカウントの既定のプライバシー設定で決まります)。
docker push ユーザー名/myapp:1.0
非公開にしたいなら、先にDocker Hubの画面でプライベートリポジトリを作ってからpushします。無料プランでは1個までなので、どのイメージを非公開にするかは選ぶ必要があります。
用途別のおすすめ公式イメージ(node・python・mysql・nginx・postgres)
よく使う公式イメージと、タグの選び方の目安を用途別に並べました。タグはどれもDocker Hubに実在することをAPIで確かめたものです。
どのイメージも、latest ではなくメジャー版かマイナー版までを書いたタグを指定するのが基本です。
言語の実行環境:node・python・eclipse-temurin
Javaの環境を作るならDockerでJava環境構築、PythonならDockerでPython環境構築で、Dockerfileまで含めた手順を書いています。
DB・Webサーバー:mysql・postgres・nginx
DBのイメージは、起動時に MYSQL_ROOT_PASSWORD や POSTGRES_PASSWORD などの環境変数が必要です。複数のコンテナをまとめて起動するならDocker Compose入門の書き方が使えます。
Docker Hubでよくあるエラーと対処
Docker Hubまわりのエラーは、ほとんどが「回数制限」「権限」「名前の間違い」の3つのどれかです。エラーメッセージの先頭の単語を見れば、どれなのかが分かります。どれも、原因が分かれば数分で直せる種類のエラーです。
toomanyrequestsが出たらログインする
toomanyrequests で始まるエラーは、pullの回数制限に達したという意味です。
docker loginしてから、もう一度pullする(上限が上がる)- CIでは、Docker Hubのトークンをシークレットに入れてログインしてからビルドする
- 同じイメージを何度もpullしないよう、CIのキャッシュを使う
時間をおけば回数は戻りますが、CIが止まったまま待つのは現実的ではありません。ログインが一番早い対処です。
denied: requested access to the resource is denied
pushで出るこのエラーは、権限がないか、イメージ名が間違っているときに出ます。
- イメージ名が
自分のユーザー名/リポジトリ名になっているか docker loginしているか(トークンの期限切れも含む)- トークンの権限が「Repo Read & Write」以上になっているか
一番多いのは、ユーザー名を付けずに docker push myapp としてしまうケースです。この名前は docker.io/library/myapp という公式イメージの場所を指すので、権限がないと言われます。
manifest unknownやnot foundが出る
pullで manifest unknown や not found が出たら、指定したタグが存在しません。
nginx:1.99 のように存在しないバージョンを書いた、あるいは古いタグが削除された、というのがよくある原因です。Docker Hubのイメージのページの「Tags」タブで、実在するタグを確かめてから指定し直します。
M1以降のMacで「no matching manifest for linux/arm64/v8」と出たら、そのイメージにはarm64版が用意されていません。公式イメージの多くは対応しているので、別のイメージを探すか、--platform linux/amd64 を付けて動かします。
よくある質問
Docker Hubについて、使い始めるときによく出てくる疑問をまとめました。料金や回数制限は変わりやすい部分なので、契約や設定の前には公式のページも確かめてください。
Q1. Docker Hubとは何ですか?
Docker社が運営するDockerイメージの公開・共有サービス(コンテナレジストリ)です。docker pull でレジストリを指定しないと、自動でDocker Hubからイメージを取ってきます。
Q2. Docker Hubは無料で使えますか?
無料のPersonalプランがあり、公開リポジトリは無制限、プライベートリポジトリは1個まで作れます。pullだけならアカウントなしでも使えますが、回数制限が厳しくなります。
Q3. Docker Hubの回数制限はいくつですか?
公式ドキュメントは未ログインで6時間に100回、Personalで6時間に200回と書いています。一方で料金ページはPersonalを1時間に100回としていて、表記がそろっていません。実際の上限は、公式ドキュメントのcurlの方法で確かめられます。
Q4. 公式イメージかどうかはどう見分けますか?
名前に / が入っていない(nginx など)ものが公式イメージで、Docker Hubのページに「Docker Official Image」のバッジが付いています。ユーザー名/nginx は個人や企業が公開したイメージです。
Q5. Docker Hubにpushするには何が必要ですか?
Docker Hubのアカウントと、「Repo Read & Write」以上の権限を持つアクセストークンが必要です。docker login でトークンを使ってログインし、ユーザー名/リポジトリ名:タグ の名前を付けてから docker push します。
Q6. Docker HubとDocker Desktopの違いは何ですか?
Docker Desktopは自分のPCでコンテナを動かすアプリで、Docker Hubはイメージを置いておくネット上のサービスです。Docker Desktopの画面からDocker Hubのイメージを検索することもできます。
まとめ:Docker Hubは「公式イメージ+タグ固定」から始める
Docker Hubは、Dockerを使うかぎり避けて通れないイメージの置き場所です。使い方そのものは単純で、つまずきやすいのは回数制限とタグの選び方のほうです。
- イメージ名に
/がないもの(Docker Official Image)を優先する latestではなく、メジャー版以上を書いたタグを指定する- CIや共有のネットワークでは
docker loginしてからpullする - pushはアクセストークンでログインし、
ユーザー名/リポジトリ名:タグで上げる
Docker自体の仕組みから知りたいならDocker入門、使わなくなったイメージで容量が膨らんできたらdocker pruneの使い方もどうぞ。
見つかったら、Docker Hubの Tags タブでメジャー版のタグを探して書き換えます。それだけで、ある日いきなり壊れる原因を1つ減らせます。
続きを追う:X(@Tom_Java_Tech) / RSS
途中経過は、また書きます。

