loudsoftware/docker-waterfall

loudsoftware/docker-waterfall镜像说明

概述

本镜像为https://github.com/PaperMC/Waterfall%E7%9A%84Docker%E5%8C%96%E5%AE%9E%E7%8E%B0%EF%BC%8CWaterfall%E6%98%AFBungeeCord%E7%9A%84%E8%BD%BB%E9%87%8F%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88%EF%BC%8C%E7%94%A8%E4%BA%8E%E4%BD%9C%E4%B8%BAMinecraft%E6%9C%8D%E5%8A%A1%E5%99%A8%E9%9B%86%E7%BE%A4%E7%9A%84%E5%89%8D%E7%AB%AF%E4%BB%A3%E7%90%86%EF%BC%8C%E5%8F%AF%E4%B8%8Eitzg/minecraft-server%E5%AE%B9%E5%99%A8%E9%85%8D%E5%90%88%E6%90%AD%E5%BB%BA%E5%A4%9A%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%BD%91%E7%BB%9C%E3%80%82%E6%B3%A8%EF%BC%9A%E8%AF%A5%E9%95%9C%E5%83%8F%E5%B7%B2%E5%81%9C%E6%AD%A2%E7%BB%B4%E6%8A%A4%EF%BC%8C%E5%BB%BA%E8%AE%AE%E4%BC%98%E5%85%88%E4%BD%BF%E7%94%A8itzg%E7%9A%84docker-bungeecord%E9%95%9C%E5%83%8F%E3%80%82

核心功能

• 作为Minecraft集群的统一入口，实现玩家在多服务器间的无缝跳转
• 支持自定义Java内存分配、运行用户权限（UID/GID）
• 提供插件目录挂载、配置文件热更新能力
• 通过环境变量灵活调整Waterfall版本及JVM参数

使用场景

• 搭建包含生存、创造、迷你游戏等多类型服务器的Minecraft网络
• 需要统一访问入口的Minecraft服务器集群部署

配置说明

环境变量

挂载卷

• /server：Waterfall工作目录，存放核心配置文件config.yml
• /plugins：插件目录，启动时自动同步至工作目录
• /config：配置文件覆盖目录，若该目录下config.yml更新则自动替换/server下的文件

端口映射

• Waterfall默认监听25577端口，建议映射至主机25565（Minecraft默认端口）：-p 25565:25577

部署示例

Docker Run命令

与itzg/minecraft-server配合时需关闭在线模式：

bash
# 启动Minecraft服务器（关闭在线验证）
docker run -d --name mc-server -e ONLINE_MODE=FALSE docker.xuanyuan.run/itzg/minecraft-server

# 启动Waterfall代理
docker run -d --name waterfall -p 25565:25577 -v $(pwd)/waterfall-data:/server docker.xuanyuan.run/loudsoftware/docker-waterfall

Docker Compose示例

yaml
version: '3'
services:
  mc-survival:
    image: docker.xuanyuan.run/itzg/minecraft-server
    environment:
      ONLINE_MODE: "FALSE"
      SERVER_NAME: "Survival"
    volumes:
      - ./survival-data:/data
  
  mc-creative:
    image: docker.xuanyuan.run/itzg/minecraft-server
    environment:
      ONLINE_MODE: "FALSE"
      SERVER_NAME: "Creative"
      GAMEMODE: "creative"
    volumes:
      - ./creative-data:/data
  
  waterfall:
    image: docker.xuanyuan.run/loudsoftware/docker-waterfall
    ports:
      - "25565:25577"
    volumes:
      - ./waterfall-data:/server
      - ./waterfall-plugins:/plugins
    depends_on:
      - mc-survival
      - mc-creative

非root用户运行

需确保挂载卷对指定用户可写：

bash
docker run -d --name waterfall -u $(id -u):$(id -g) -v $(pwd)/waterfall-data:/server docker.xuanyuan.run/loudsoftware/docker-waterfall

配置参考

Waterfall配置可参考https://www.spigotmc.org/wiki/Bungeecord-configuration-guide/