1
{
2
  "registry-mirrors": [
3
    "https://docker.m.daocloud.io",
4
    "https://docker.1panel.live/"
5
  ]
6
}

1
services:
2

3
  # 备份预热:启动restore-tar-backup脚本，如果在backups目录中有备份tar包，便对data目录进行覆盖，并在执行后停止。
4
  restore-backup:
5
    image: itzg/mc-backup:2026.3.2   # 检查镜像名
6
    restart: "no"
7
    entrypoint: restore-tar-backup
8
    volumes:
9
      - ./minecraft-data:/data       # 服务器文件
10
      - ./mc-backups:/backups:ro     # 备份文件夹
11

12
  # 服务器本体容器
13
  mc_bmp:
14
    image: itzg/minecraft-server:java21-jdk  # 检查镜像名
15
    container_name: mc_bmp                   # 自定义容器显示名称
16
    healthcheck:                             # 容器健康检查
17
      interval: 30s                          # 多久检查一次
18
      timeout: 60s                           # 单次检查的超时时间
19
      retries: 10                            # 连续失败多少次算不健康
20
      start_period: 300s                     # 容器启动后多久才开始检查（等待启动时间）
21
    ports:
22
      - 25565:25565                          # 游戏连接端口
23
      - 2222:2222                            # SSH命令传入端口
24
    restart: unless-stopped
25
    environment:
26
      EULA: "true"
27
      ENABLE_SSH: true                       # 开启SSH命令传入
28
      TYPE: FORGE                            # 游戏类型
29
      VERSION: 1.20.1                        # 游戏版本
30
      FORGE_VERSION: 47.4.10                 # Forge版本
31
      MEMORY: "8G"                           # 内存分配
32
      GENERIC_PACK: /modpacks/BMC4_Server_Pack_v54.zip   # (整合包)服务器压缩文件位置
33

34
      # JVM虚拟机优化参数
35
      JVM_OPTS: "-server"
36
      JVM_XX_OPTS: "-XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=20 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=16M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:SurvivorRatio=32 -XX:MaxTenuringThreshold=1 -XX:+UseStringDeduplication -XX:+UseCompressedOops -XX:+UseCompressedClassPointers"
37
      JVM_DD_OPTS: "-Dfml.readTimeout=180 -Dfml.debugRegistryEntries=true -Dfile.encoding=UTF-8"
38

39
      TZ: "Asia/Shanghai"                    # 时区
40
      OVERRIDE_SERVER_PROPERTIES: "false"    # 是否覆盖Server_properties文件
41
      DIFFICULTY: "normal"                   # 游戏难度
42
      MAX_TICK_TIME: "-1"
43
      VIEW_DISTANCE: "6"                     # 视距
44
      ALLOW_FLIGHT: "true"                   # 是否允许飞行
45
      OPS: "RoL1n_SrP"                       # 管理员
46
      MAX_PLAYERS: 10                        # 最大玩家数
47
      PVP: "false"                           # 是否开启PVP
48
      LEVEL_TYPE: "biomesoplenty"
49
      RCON_PASSWORD: "yourpassword"          # Rcon、SSH共用密码
50
    volumes:
51
      - ./modpacks:/modpacks:ro              # 只读(整合包)服务器压缩文件
52
      - ./minecraft-data:/data               # 服务器游戏数据
53

54
    # 仅当备份预热脚本结束后才进行服务器加载
55
    depends_on:
56
      restore-backup:
57
        condition: service_completed_successfully
58

59
  # 常驻备份容器
60
  backups:
61
    image: itzg/mc-backup:2026.3.2           # 检查镜像名
62

63
    # 仅在 mc_bmp 容器健康运行后才运行此容器
64
    depends_on:
65
      mc_bmp:                                # 检查服务器容器名(Services名称)
66
        condition: service_healthy
67
    environment:
68
      BACKUP_INTERVAL: "2h"                  # 每2小时进行一次备份
69
      PRUNE_BACKUPS_COUNT: 8                 # 最大备份文件数量
70
      BACKUP_ON_STARTUP: true                # 是否在启动时进行备份
71
      RCON_HOST: mc_bmp                      # Rcon所连接的(服务器)容器名(Services名称)
72
      INITIAL_DELAY: 30m                     # 在启动后30min才执行计时/备份
73
      PAUSE_IF_NO_PLAYERS: false             # 是否在无玩家时暂停计时/备份
74
      PLAYERS_ONLINE_CHECK_INTERVAL: 5m      # 间隔5分钟检查服务器中是否有玩家
75
    volumes:
76
      - ./minecraft-data:/data:ro            # 只读服务器文件数据
77
      - ./mc-backups:/backups                # 备份文件目录

1
version: "3"
2
services:
3
  restore-backup:
4
    image: itzg/mc-backup:2026.3.2
5
    restart: "no"
6
    entrypoint: restore-tar-backup
7
    volumes:
8
      - ./minecraft-data:/data
9
      - ./mc-backups:/backups:ro
10

11
  mc_paper:                                 # 这里的服务名定义为 mc_paper
12
    image: itzg/minecraft-server:java21-jdk
13
    container_name: mc_paper                # 容器名也是 mc_paperr
14
    ports:
15
      - "25565:25565"
16
      - "2222:2222"
17
    environment:
18
      EULA: "TRUE"
19
      ENABLE_SSH: true
20
      TYPE: "PAPER"                         # 游戏类型为 Paper
21
      VERSION: "1.21.4"                     # 游戏版本
22
      VIEW_DISTANCE: 8
23
      MEMORY: 4G
24
      ENABLE_WHITELIST: "FALSE"             # 是否启用白名单
25
      OPS: "RoL1n_SrP"
26
      ONLINE_MODE: "TRUE"                   # 是否开启正版验证
27
      SERVER_NAME: "SrP-Server"             # 服务器名称
28
      MOTD: "It's provided by RoL1n."       # 服务器列表欢迎语
29
      ICON: "/icon.png"                     # 这里可以自定义你的服务器图标(容器内路径)
30
      OVERRIDE_SERVER_PROPERTIES: "FALSE"
31
      RCON_PASSWORD: "yourpassword"
32
    tty: true
33
    stdin_open: true
34
    restart: unless-stopped
35
    volumes:
36
      - ./minecraft-data:/data
37
      - ./icon.png:/icon.png                # 需要在这里挂载上服务器图标位置(容器 "外->内" 路径映射)
38
    depends_on:
39
      restore-backup:
40
        condition: service_completed_successfully
41

42
  backups:
43
    image: itzg/mc-backup:2026.3.2
44
    depends_on:
45
      mc_paper:                             # 注意这里的服务名
46
        condition: service_healthy
47
    environment:
48
      BACKUP_INTERVAL: "2h"
49
      PRUNE_BACKUPS_COUNT: 8
50
      BACKUP_ON_STARTUP: true
51
      RCON_HOST: mc_paper                   # 这里也是服务名
52
      INITIAL_DELAY: 30m
53
      PAUSE_IF_NO_PLAYERS: false
54
      PLAYERS_ONLINE_CHECK_INTERVAL: 5m
55
    volumes:
56
      - ./minecraft-data:/data:ro
57
      - ./mc-backups:/backups