このDockerイメージは、起動時にMinecraft Serverの最新安定版を自動でダウンロードします。特定のバージョンや最新スナップショットを実行したり、アップグレードしたりすることもできます。詳しくはVersionsのセクションを参照してください。

最新の安定版を使うだけなら、次のコマンドを実行します。

1
docker run -d -it -p 25565:25565 -e EULA=TRUE itzg/minecraft-server

この場合、標準のサーバーポート25565がホスト側に公開されます。

Docker Compose#

上のコマンドで直接イメージを起動するより、ほかの一般的なプロジェクトと同じくDocker Composeを使うほうがおすすめです。

公式の手順は次のとおりです。

新しいディレクトリを作成する

下の内容をcompose.yamlというファイル名で保存する

そのディレクトリでdocker compose up -dを実行する

完了！クライアントからホスト名またはIPアドレスとポート25565を指定して接続する

1
services:
2
  mc:
3
    image: itzg/minecraft-server:latest
4
    pull_policy: daily
5
    tty: true
6
    stdin_open: true
7
    ports:
8
      - "25565:25565"
9
    environment:
10
      EULA: "TRUE"
11
    volumes:
12
      # attach the relative directory 'data' to the container's /data path
13
      - ./data:/data

Composeファイルを変更した後は、もう一度docker compose up -dを実行すれば反映されます。

docker compose logs -fでログを追い、docker compose psで状態を確認し、docker compose stopでコンテナを停止できます。

Dockerを使い始めたばかりだと、volumesが少し分かりにくいかもしれません。実際はそれほど複雑ではなく、ディレクトリ構成は例えば次のようになります。

1
Your-MC-Server-Folder
2
├── data
3
│   ├── config
4
│   ├── eula.txt
5
│   ├── kubejs
6
│   ├── mods
7
│   ├── server.properties
8
│   └── world
9
└── docker-compose.yml

Your-MC-Server-Folderの中にあるdataが、Modやワールドデータを置く場所です。先にDocker Composeを実行してコンテナ側でデータを生成してもいいですし、既存のデータをdataへ移動しても構いません。

LoaderとMod#

compose.yamlの変数を変更するだけで、Mod入りのサーバーも起動できます。以下は自分が使っている設定です。SetupMCを使って設定を生成することもできます。

1
services:
2
  mc:
3
    image: itzg/minecraft-server:latest
4
    tty: true
5
    stdin_open: true
6
    ports:
7
      - "25565:25565"
8
      - "24454:24454/udp"
9
    environment:
10
      EULA: "TRUE"
11
      TYPE: "NEOFORGE"
12
      VERSION: "1.21.1"
13
      INIT_MEMORY: "4G"
14
      MAX_MEMORY: "12G"
15
      MOTD: "A Minecraft Server"
16
      TZ: "Asia/Tokyo"
17
      DIFFICULTY: "hard"
18
    volumes:
19
      - "./data:/data"