データベース

RedisをDockerで動かす手順:compose.yamlでの永続化・redis.conf・パスワード設定【Redis 8.10系】

RedisをDockerで動かす手順:compose.yamlでの永続化・redis.conf・パスワード設定【Redis 8.10系】

公式redisイメージなら、Redisはdocker runの1行で起動できます。ただし既定のままでは、コンテナを作り直すとデータが消え、パスワード無しのRedisがネットワークに公開される場合もあるのが実情です。この記事では公式ドキュメントをもとに、タグの選び方、compose.yamlでの永続化、redis.confの落とし穴、パスワードとhealthcheckの設定を整理し、本番で使ってよい条件まで示します。

まとめ:DockerのRedisはタグ固定・ボリューム・認証の3点を先に決める

RedisをDockerで動かすときは、起動コマンドより先に3つを決めます。イメージはredis:8.10.3のように版まで固定し、/dataには名前付きボリュームを割り当て、パスワードとポートの公開範囲を設定します。

公式イメージは保護モードが無効で、-p 6379:6379はホストの全アドレスに公開されます。開発機でも127.0.0.1:6379:6379と書くか、コンテナ間だけで使うならポートを公開しません。

永続化はRDBの既定保存にAOFを足す構成が基本で、設定はredis.confにまとめます。正本データを置く、自動フェイルオーバーが要るといった条件では、Docker単体での運用を選びません。

公式redisイメージのタグを選び、docker runで起動して接続を確かめる手順

Redisそのものの仕組みやデータ型、Redis 8の新機能を試す最短の起動手順はRedisとは:仕組みとデータ型・Redis 8.10系の新機能とライセンス、Dockerで動かす手順で扱っています。ここではタグの選び方と、他のコンテナからの接続に絞ります。

8.10.3・8-alpine・latestの違いと本番でタグを版まで固定する理由

公式イメージのタグは、Docker公式イメージの定義ファイルlibrary/redisで確認できます。2026年11月16日時点では、latest・8・8.10・8.10.3がすべてDebian trixieベースの8.10.3を指し、Alpine版は8.10.3-alpine(Alpine 3.23)です。8.10.3はGitHubのリリース一覧で10月26日に公開された最新の安定版で、8.12-rc3はプレリリースにあたります。

タグの例 指す版(2026年11月時点) 向く用途
redis:8.10.3 8.10.3で固定 本番・ステージング
redis:8.10 8.10系の最新パッチ 開発環境
redis:latest その時点の最新安定版 手元での試用のみ
redis:7.4.12 7.4系の最新パッチ 既存環境の版合わせ

latestは8.12が安定版になった時点で中身が変わり、再作成したコンテナだけが新しい版で動きます。本番では版まで固定しましょう。

docker runで起動しredis-cliのPINGで疎通とバージョンを確かめる

Run Redis Open Source on Dockerの手順に沿って起動し、コンテナ内のredis-cliで確かめます。公開先を127.0.0.1に限る理由は後の章で説明します。

# 版を固定して起動する(ホストの127.0.0.1だけに公開)
docker run -d --name redis -p 127.0.0.1:6379:6379 redis:8.10.3

# PONG が返れば疎通できている
docker exec -it redis redis-cli PING

# サーバーの版を確かめる
docker exec -it redis redis-cli INFO server | grep redis_version

起動しない、すぐ終了するといった症状はdocker logs redisで原因を見ます。run・start・execの使い分けはDockerコンテナ起動・実行コマンドの使い分け|run・start・execと起動しない時の対処にまとめています。

ユーザー定義ネットワークで別コンテナからホスト名redisで接続する

アプリもコンテナで動かす場合、Redisのポートをホストに公開する必要はありません。公式イメージの説明にあるとおり、同じネットワークに参加させればコンテナ名をホスト名として接続できます。

docker network create app-net
docker run -d --name redis --network app-net redis:8.10.3

# 使い捨てのコンテナから、ホスト名 redis で接続する
docker run -it --rm --network app-net redis:8.10.3 redis-cli -h redis PING

既定のbridgeネットワークではコンテナ名で名前解決できないため、自作のネットワークかcomposeが作るネットワークを使います。

docker composeでRedisを定義し名前付きボリュームでデータを永続化する設定

オプションはcompose.yamlに書いてGitで管理します。composeの基本的な書き方とコマンドはDocker Composeとは|compose.yamlの書き方と主要コマンド・仕組みをv5.7.1で実測解説を参照してください。

compose.yamlの最小構成と/dataに名前付きボリュームを割り当てる書き方

公式イメージは、データを/dataに書き出します。ここに名前付きボリュームを割り当てると、コンテナを削除しても中身が残ります。

services:
  redis:
    image: redis:8.10.3
    command: ["redis-server", "--save", "60", "1", "--appendonly", "yes"]
    ports:
      - "127.0.0.1:6379:6379"
    volumes:
      - redis-data:/data
    restart: unless-stopped

volumes:
  redis-data:

docker compose up -dで起動し、docker compose exec redis redis-cli CONFIG GET appendonlyでyesが返れば設定は効いています。ホストのディレクトリを直接マウントする場合、公式イメージは起動時に/dataの所有者を自動で直しますが、SKIP_FIX_PERMS=1(8.0.2以降)でこの処理を止めた環境ではchown -R redis:redisが必要です。

既定のRDB保存とappendonly yesのAOFを併用する永続化の設定値

設定ファイルを渡さずに起動したRedisは、redis.confの説明にある既定値で動きます。3600秒に1回以上、300秒に100回以上、60秒に10000回以上の変更があればRDBのスナップショットdump.rdbを保存し、AOFはappendonly noで無効です。

Redis persistenceによると、RDBだけでは障害時に直近数分の書き込みを失う前提になります。AOFをappendfsync everysec(既定)で有効にすると、失う範囲は最大1秒ぶんです。Redis 7.0以降のAOFは複数ファイルに分かれ、/data/appendonlydirに置かれます。

公式ドキュメントはRDBとAOFの併用を勧め、AOF単独は推奨していません。両方が有効なら、再起動時の復元にはAOFが使われます。

RDBだけで運用中のデータにAOFを足すとき再起動で消さない切り替え手順

RDBで運用してきたRedisに、compose.yamlへ--appendonly yesを足して再作成するだけの切り替えは危険です。永続化のドキュメントは、設定を変えて再起動するだけの手順はデータ消失につながると太字で警告しています。稼働中のRedisで先にAOFを有効にします。

# 1. 念のため現在の dump.rdb をホストへ退避する
docker compose cp redis:/data/dump.rdb ./dump.rdb.bak

# 2. 稼働中のRedisでAOFを有効にする
docker compose exec redis redis-cli CONFIG SET appendonly yes

# 3. 書き換えの完了を待つ(0・0・ok になるまで)
docker compose exec redis redis-cli INFO persistence \
  | grep -E 'aof_rewrite_in_progress|aof_rewrite_scheduled|aof_last_bgrewrite_status'

値が揃ってから設定ファイルにappendonly yesを書いて作り直し、DBSIZEでキー数が切り替え前と一致するかを確かめてください。

compose down -vや–rmでボリュームごとデータが消える条件

データが消える原因の多くは、ボリュームの消し方です。docker compose downは既定でコンテナとネットワークだけを消しますが、-vを付けると宣言済みの名前付きボリュームと匿名ボリュームも消します。

# コンテナとネットワークだけ消える(redis-data は残る)
docker compose down

# 名前付きボリュームまで消える。データを捨てるときだけ使う
docker compose down -v

# 残っているボリュームを確かめる
docker volume ls

ボリューム無しでdocker runすると、/dataにはランダム名の匿名ボリュームが作られる仕組みです。Dockerのボリュームの説明によると、匿名ボリュームはコンテナ削除後も残る一方、--rm付きならコンテナと一緒に消えます。残っていても新しいコンテナは引き継がないため、データが消えたように見えるわけです。

redis.confをマウントして設定を管理する手順とbind・保護モードの落とし穴

Redis configurationは、設定ファイル無しの起動をテストと開発向けと位置づけています。commandに引数を並べる方法は数項目までにとどめ、それ以上はredis.confにまとめます。

設定ディレクトリをマウントしredis-serverにredis.confを渡す手順

ホストの./redisディレクトリにredis.confを置き、コンテナの/usr/local/etc/redisへマウントします。ファイル単体ではなくディレクトリごとマウントするのは、Redisが設定ファイルを書き換えたり追加したりする場合があり、公式ドキュメントがマウント先を書き込み可能にするよう求めているためです。

# compose.yaml
services:
  redis:
    image: redis:8.10.3
    command: ["redis-server", "/usr/local/etc/redis/redis.conf"]
    volumes:
      - ./redis:/usr/local/etc/redis
      - redis-data:/data
    restart: unless-stopped

volumes:
  redis-data:
# ./redis/redis.conf(Docker向けに必要な項目だけを書く)
bind * -::*
protected-mode yes
port 6379
dir /data
save 3600 1 300 100 60 10000
appendonly yes
appendfsync everysec
maxmemory 512mb
maxmemory-policy noeviction
include /usr/local/etc/redis/auth.conf

最終行のincludeはパスワードを別ファイルに分ける指定で、中身は後の章で作ります。DockerfileでCOPYする方法は、設定変更のたびに再ビルドが要ります。

公式redis.confのbind 127.0.0.1で他コンテナから繋がらない理由

GitHubにある8.10のredis.confを丸ごとコピーして使うと、アプリのコンテナから接続できなくなります。このファイルの既定はbind 127.0.0.1 -::1で、コンテナ自身のループバックでしか待ち受けないためです。

保護モードも絡みます。redis.confではprotected-mode yesが既定で、defaultユーザーにパスワードが無いと127.0.0.1・::1・Unixソケットからの接続しか受け付けません。公式イメージの既定設定では保護モードが無効になっているため、設定ファイルを渡した途端に挙動が変わります。

コンテナでは入口をDockerのポート公開で絞り、Redis側はbind * -::*で全インターフェースを待ち受けます。-付きの::*は、IPv6が無い環境でも起動を失敗させない書き方です。保護モードは有効のまま、パスワードを設定して接続を通します。

CONFIG SETが再起動で消える問題とCONFIG REWRITEの書き込み権限

CONFIG SET maxmemory 1gbのように稼働中に変えた設定は、redis.confには反映されません。コンテナを再作成すると元の値に戻ります。

残すには、redis.confを編集して再起動するか、CONFIG REWRITEでファイルへ書き戻します。後者はマウント先が書き込み可能でないと失敗し、include先のファイルは書き換えません。チームでは、redis.confをGitで管理してCONFIG REWRITEを使わない方が差分を追えます。

コンテナのメモリ上限より小さくmaxmemoryとエビクション方針を決める

64ビット環境のRedisは、maxmemoryが既定の0だとメモリに上限を設けません。composeのmem_limitなどでコンテナに上限を付けていると、超えた時点でカーネルにプロセスを止められます。RDBの保存やAOFの書き換えはforkした子プロセスで行い、永続化用のバッファも別に使うので、maxmemoryはコンテナの上限より余裕を残して決めます。

上限に達したときの動作はエビクションポリシーで選びます。データを消されては困る用途なら既定のnoevictionで書き込みエラーにし、キャッシュ専用ならallkeys-lruで古いキーから追い出します。

Docker上のRedisにパスワードを設定し、外部公開を防ぐ認証とポートの指定

Redis securityは、Redisを信頼できるクライアントだけが届く環境で使う前提に立っています。外部から届いたら、FLUSHALL1つで全データを消されます。

保護モード無効の公式イメージと-p 6379:6379が全アドレスに公開する危険

Redis本体はバージョン3.2.0から、パスワード無しで全インターフェースを待ち受けるとループバック以外の接続を拒む保護モードを持っています。ところが公式イメージの説明には、保護モードを既定で無効にしていると明記されています。

そこへDockerのポート公開が重なる点が問題です。Dockerのポート公開の説明によると、アドレスを書かない-p 6379:6379はホストの全アドレス(0.0.0.0と[::])に公開され、ホストの外からも届きます。Dockerはこれを「既定では安全でない」と書いています。

  • アプリもコンテナで動かす:portsを書かず、composeのネットワーク内だけで使う
  • ホストのツールから触る:"127.0.0.1:6379:6379"と書き、ループバックに限る
  • 別サーバーのアプリから使う:パスワードとTLSを設定し、ファイアウォールで送信元を絞る

まず直すのは、compose.yamlに残った"6379:6379"の1行です。

.envのパスワードを–requirepassで渡す開発用の書き方と見える場所

手元の開発環境なら、composeが自動で読む.envにパスワードを書き、コマンドライン引数で渡す方法が手軽です。.envは.gitignoreに入れてリポジトリに含めません。

# .env(Gitに含めない)
REDIS_PASSWORD=ここに長いランダム文字列

# compose.yaml(redisサービスの抜粋)
    command: ["redis-server", "/usr/local/etc/redis/redis.conf", "--requirepass", "${REDIS_PASSWORD}"]
    environment:
      REDISCLI_AUTH: ${REDIS_PASSWORD}

コマンドライン引数はredis.confと同じ書式に--を付けたもので、設定ファイルの後に足されます。REDISCLI_AUTHはredis-cliが読む環境変数で、healthcheckの認証に使います。ただし引数も環境変数もdocker inspectで読めるため、共用サーバーでは使いません。

requirepassを別ファイルに分けincludeで読み込みGit管理から外す

共用サーバーや本番では、パスワードだけを書いたファイルを作り、redis.confの最終行からincludeで読み込みます。redis.confの説明どおり、上書きを目的とするincludeは最終行に置きます。

# パスワードを生成して ./redis/auth.conf に書く
printf 'requirepass %s\n' "$(openssl rand -hex 32)" > ./redis/auth.conf
chmod 600 ./redis/auth.conf

# .gitignore に追加する
echo 'redis/auth.conf' >> .gitignore

Redisは高速にパスワードを試せるため、公式ドキュメントは長いパスワードを求めています。AUTHは平文で流れるので、ホストをまたぐ通信ではTLSも検討しましょう。requirepassは全クライアント共通の従来方式で、アプリと運用者で権限を分けたいならRedis 6からのACLで名前付きユーザーを作ります。redis-cliでの認証の渡し方はredis-cliの使い方:接続・認証・TLSの指定とSCANで安全にキーを探すコマンド一覧で扱いました。

healthcheckとdepends_onでアプリをRedisの準備完了まで待たせる設定

起動直後のRedisは、まだ接続を受け付けていないことがあります。healthcheckで状態を判定し、アプリ側のdepends_onで待たせます。

認証付きのRedisをPONGの有無で判定するhealthcheckの書き方

Composeのサービス定義では、testに判定コマンドを書き、interval・timeout・retries・start_periodで間隔を決めます。

    healthcheck:
      test: ["CMD-SHELL", "redis-cli ping | grep -q PONG"]
      interval: 5s
      timeout: 3s
      retries: 10
      start_period: 10s

grep -q PONGを挟むのは、redis-cliがエラーを受け取っても終了コード0で終わるからです。認証無しのpingにはNOAUTHエラーが返り、終了コードだけでは正常と誤認します。REDISCLI_AUTHを環境変数に入れておけば、認証してからpingを送ります。

パスワードをinclude用のファイルに分けた構成では、ファイルから読み込みます。composeは$を変数展開に使うため、シェルの$は$$と書きます。

      test: ["CMD-SHELL", "REDISCLI_AUTH=\"$$(sed -n 's/^requirepass //p' /usr/local/etc/redis/auth.conf)\" redis-cli ping | grep -q PONG"]

depends_onのservice_healthyでアプリの起動順と再接続を設計する

アプリのサービスにcondition: service_healthyを書くと、Redisのhealthcheckが通るまでアプリのコンテナは作られません。restart: trueを足すと、composeがRedisのサービスを更新したときにアプリも再起動します。

  app:
    build: .
    environment:
      REDIS_HOST: redis
      REDIS_PORT: "6379"
      REDIS_PASSWORD: ${REDIS_PASSWORD}
    depends_on:
      redis:
        condition: service_healthy
        restart: true

depends_onが効くのはcomposeでの起動・更新時だけなので、アプリのクライアントには再接続とリトライも設定します。CIで同じ起動待ちを組む方法はGitHub Actionsのサービスコンテナ(services)|DB・Redisを立てる結合テストと起動待ちの設計で解説しています。

Docker上のRedisを本番で使う条件と、マネージドサービスへ移す判断の基準

判断の軸は、データを失ったときとサーバーが止まったときに何が起きるかです。

開発環境・CI・単一サーバーのキャッシュならDockerのRedisで足りる条件

次のいずれかに当てはまるなら、この記事の構成で運用して構いません。

この範囲なら、版の固定、名前付きボリューム、パスワード、ポートを公開しないことの4つで足ります。/data/dump.rdbは定期的に別の場所へ退避しておきます。

正本データや自動フェイルオーバーが要る場面でDocker単体運用を見送る判断

次の条件では、1台のDockerホストにRedisを置く運用を選びません。

  • Redisが正本で、1秒ぶんの書き込み消失も許されない注文・決済・在庫などのデータを持つ
  • ホストの停止がそのままサービス停止になり、数分以内の自動復旧が求められる
  • 複数のアプリサーバーから共有され、Redisを止めるメンテナンス時間が取れない

自動フェイルオーバーが要るなら、レプリカとSentinelの構成(Redisの冗長化:レプリケーションとSentinelで自動フェイルオーバーを組む設定例とElastiCache Multi-AZとの比較)か、マネージドサービス(AWSでRedisを使う方法:ElastiCache・MemoryDB・EC2の選び分けと接続手順)へ移すのが筋です。正本データをRedisに置いているなら、RDBとの役割分担も見直す時期です。データベース設計・移行支援では、キャッシュ層を含むデータの置き場所の整理から相談を受けています。

よくある質問

よく検索される質問に答えます。

DockerのRedisを再起動したらデータが消えたのはなぜですか?

多くは、/dataにボリュームを割り当てずに起動し、コンテナを作り直したことが原因です。新しいコンテナは前の匿名ボリュームを引き継がず、docker compose down -vや--rmではボリュームごと消えます。名前付きボリュームを/dataに割り当て、AOFを有効にしてください。docker restartのようにコンテナを残した再起動なら、既定のRDB保存の範囲でデータは戻ります。

ホストのredis-cliやGUIツールからDockerのRedisに繋がりません。

まずportsでホストへ公開しているかを確かめます。公開していなければ、接続できるのは同じDockerネットワーク内のコンテナだけです。公開しているのに繋がらないなら、マウントしたredis.confがbind 127.0.0.1 -::1のままでないかを見てください。bind * -::*に変え、パスワードを設定すれば接続できます。

6379以外のポート番号でDockerのRedisを起動するには?

ホスト側の番号だけを変えるのが簡単です。-p 127.0.0.1:16379:6379と書けば、ホストの16379番がコンテナの6379番につながり、Redisの設定は変えずに済みます。同じホストで複数のRedisを動かすときも、ホスト側の番号だけを分けてください。コンテナ間の通信は公開ポートと無関係で、サービス名と6379番で接続します。

Docker上のRedisのバックアップはどう取ればよいですか?

RDBファイルは書き込み完了後に置き換えられるため、稼働中でもコピーして構いません。docker compose cp redis:/data/dump.rdb ./backup/で取り出し、日付を付けて別のストレージへ送ります。8.10.0からはBACKUPコマンド群で、書き込みを止めずにバックアップを作る方法も加わりました。AOFのディレクトリは、書き換え中にコピーすると壊れたバックアップになります。

Docker上のRedisのバージョンを上げる手順は?

compose.yamlのタグをredis:8.10.3から新しい版へ書き換え、docker compose pullとdocker compose up -dでコンテナを作り直す流れです。名前付きボリュームはそのまま引き継がれます。戻す場合に備えて、作業前にdump.rdbとAOFのディレクトリを退避してください。メジャーバージョンをまたぐときは、リリースノートで廃止された設定項目を確かめ、検証環境で起動を試してから本番に適用しましょう。

関連記事

お気に入りに入れた記事の一覧

一創の公式 SNS

X では毎朝の新着記事と IT ニュースの速報を、YouTube・TikTok・Instagram・LinkedIn・Facebook では記事の解説動画を配信しています。

資料請求

今日のトレンド記事 直近 24 時間で、いつもより多く読まれている記事

  1. 2026.11.13 テックブログ 宝くじ公式サイト不正アクセス:4,436名の対象確認とパスワード再設定、変更された仕組み
  2. 2026.11.13 テックブログ KARTEの不正アクセス:全機能停止で利用企業がタグ・配信・データ連携を確かめる手順
  3. 2026.01.30 テックブログ Xで「人間であることを確認」と顔認証が出る理由と対処|ライブネスチェックとOpenAIの生体認証SNS構想
  4. 2026.11.13 テックブログ Rust 1.100.0とは|never型の安定化とCargo依存クールダウンの変更点【2026年11月】
  5. 2026.03.18 テックブログ Base44とは?Wix傘下のAIアプリ開発ツールの料金・日本語対応・安全性【2026年10月】

RELATED POSTS 関連記事

目次