---
title: "RedisをDockerで動かす手順：compose.yamlでの永続化・redis.conf・パスワード設定【Redis 8.10系】"
url: "https://www.issoh.co.jp/tech/details/19855/"
published: 2026-11-16
updated: 2026-11-16
categories: ["データベース"]
publisher: "株式会社一創"
---

# 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で動かす手順](https://www.issoh.co.jp/tech/details/18876/)で扱っています。ここではタグの選び方と、他のコンテナからの接続に絞ります。

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

公式イメージのタグは、Docker公式イメージの定義ファイル[library/redis](https://github.com/docker-library/official-images/blob/master/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の[リリース一覧](https://github.com/redis/redis/releases/tag/8.10.3)で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](https://redis.io/docs/latest/operate/oss%5Fand%5Fstack/install/install-stack/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と起動しない時の対処](https://www.issoh.co.jp/tech/details/3935/)にまとめています。

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

アプリもコンテナで動かす場合、Redisのポートをホストに公開する必要はありません。[公式イメージの説明](https://github.com/docker-library/docs/blob/master/redis/content.md)にあるとおり、同じネットワークに参加させればコンテナ名をホスト名として接続できます。

```
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で実測解説](https://www.issoh.co.jp/tech/details/13282/)を参照してください。

### 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](https://raw.githubusercontent.com/redis/redis/8.10/redis.conf)の説明にある既定値で動きます。3600秒に1回以上、300秒に100回以上、60秒に10000回以上の変更があればRDBのスナップショット`dump.rdb`を保存し、AOFは`appendonly no`で無効です。

[Redis persistence](https://redis.io/docs/latest/operate/oss%5Fand%5Fstack/management/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](https://docs.docker.com/reference/cli/docker/compose/down/)は既定でコンテナとネットワークだけを消しますが、`-v`を付けると宣言済みの名前付きボリュームと匿名ボリュームも消します。

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

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

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

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

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

[Redis configuration](https://redis.io/docs/latest/operate/oss%5Fand%5Fstack/management/config/)は、設定ファイル無しの起動をテストと開発向けと位置づけています。`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`はコンテナの上限より余裕を残して決めます。

上限に達したときの動作は[エビクションポリシー](https://redis.io/docs/latest/develop/reference/eviction/)で選びます。データを消されては困る用途なら既定の`noeviction`で書き込みエラーにし、キャッシュ専用なら`allkeys-lru`で古いキーから追い出します。

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

[Redis security](https://redis.io/docs/latest/operate/oss%5Fand%5Fstack/management/security/)は、Redisを信頼できるクライアントだけが届く環境で使う前提に立っています。外部から届いたら、`FLUSHALL`1つで全データを消されます。

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

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

そこへDockerのポート公開が重なる点が問題です。[Dockerのポート公開の説明](https://docs.docker.com/engine/network/port-publishing/)によると、アドレスを書かない`-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](https://redis.io/docs/latest/operate/oss%5Fand%5Fstack/management/security/acl/)で名前付きユーザーを作ります。redis-cliでの認証の渡し方は[redis-cliの使い方：接続・認証・TLSの指定とSCANで安全にキーを探すコマンド一覧](https://www.issoh.co.jp/tech/details/19850/)で扱いました。

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

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

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

[Composeのサービス定義](https://docs.docker.com/reference/compose-file/services/)では、`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を立てる結合テストと起動待ちの設計](https://www.issoh.co.jp/tech/details/16961/)で解説しています。

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

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

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

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

- 開発環境や検証環境で、データは作り直せる
- CIの結合テストで、テストごとに使い捨てる（[Testcontainersとは？Dockerで作る使い捨てテスト環境｜Java・Python・Goの書き方と2.0系の移行点](https://www.issoh.co.jp/tech/details/4629/)のようなライブラリから起動する形も含む）
- 単一サーバーのキャッシュやセッションで、消えても再ログインや再計算で戻せる

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

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

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

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

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

## よくある質問

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

### 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のディレクトリを退避してください。メジャーバージョンをまたぐときは、リリースノートで廃止された設定項目を確かめ、検証環境で起動を試してから本番に適用しましょう。

## 関連記事

- [Redisとは：仕組みとデータ型・Redis 8.10系の新機能とライセンス、Dockerで動かす手順](https://www.issoh.co.jp/tech/details/18876/)：Redis本体の仕組みと版・ライセンス
- [redis-cliの使い方：接続・認証・TLSの指定とSCANで安全にキーを探すコマンド一覧](https://www.issoh.co.jp/tech/details/19850/)：コンテナ内外からの接続と調査コマンド
- [Redisの冗長化：レプリケーションとSentinelで自動フェイルオーバーを組む設定例とElastiCache Multi-AZとの比較](https://www.issoh.co.jp/tech/details/19851/)：Docker単体の次に考える冗長構成
- [Docker Composeとは｜compose.yamlの書き方と主要コマンド・仕組みをv5.7.1で実測解説](https://www.issoh.co.jp/tech/details/13282/)：composeの基本
- [GitHub Actionsのサービスコンテナ（services）｜DB・Redisを立てる結合テストと起動待ちの設計](https://www.issoh.co.jp/tech/details/16961/)：CIでRedisを立てる方法

---

出典: [RedisをDockerで動かす手順：compose.yamlでの永続化・redis.conf・パスワード設定【Redis 8.10系】](<https://www.issoh.co.jp/tech/details/19855/>)（株式会社一創）
