ultraxime/velocity

Velocity Docker镜像

概述

本项目提供Velocity的Docker镜像，Velocity是一款用于Minecraft服务器的代理服务器，支持多服务器网络搭建和玩家连接管理。源代码可在https://gitlab.com/e4333/docker-images/velocity-docker%E8%8E%B7%E5%8F%96%E3%80%82

基础镜像

• eclipse-temurin:11-jre-alpine

核心功能

1. 支持自定义Velocity版本构建镜像
2. 提供环境变量、配置文件、数据卷等多种配置方式
3. 集成server-loader工具实现插件自动下载与管理
4. 支持控制台命令执行和安全关机机制
5. 包含TCP快速打开、HAProxy协议等高级网络特性

使用场景

• 搭建多服务器的Minecraft网络，实现玩家无缝切换
• 管理Minecraft服务器的玩家连接，提升网络稳定性
• 批量部署和更新Velocity代理服务器

配置说明

构建镜像

bash
docker build \
    -t ultraxime/velocity \
   .

默认构建Velocity 3.1.1版本，可通过--build-arg VELOCITY_VERSION=<版本号>指定其他版本。

添加自定义文件

若需在构建时添加文件到/opt/velocity目录，可在Dockerfile末尾添加： COPY --chown=user:user --chmod=544 <文件> "$VELOCITY_HOME/"

启动实例

bash
docker run \
    --name velocity-instance \
    -p 0.0.0.0:25577:25577 \
    -d \
    -it \
    ultraxime/velocity

镜像暴露Minecraft代理默认端口25577。建议使用-it参数，以支持控制台命令执行和安全关机。

命令使用

镜像提供velocity入口脚本，支持以下命令：

• run：启动Velocity服务器（默认命令）
• console：执行控制台命令（需启用-it）
• stop：安全关闭服务器
• healthcheck：检查服务器健康状态

示例：发送消息给玩家

bash
docker exec velocity-instance velocity console say 欢迎来到服务器！

自定义Jar文件

可通过卷挂载或构建时复制自定义Jar文件到/opt/velocity目录：

• 若Jar文件名格式为velocity-<版本>.jar，将自动检测使用
• 其他文件名需设置环境变量VELOCITY_JAR指定

配置方式

环境变量

• VELOCITY_OPTS：调整JVM参数
• MOTD：服务器列表显示的消息
• ONLINE_MODE：是否启用Mojang身份验证
• PLAYER_IP_FORWARDING_MODE：IP转发模式（modern/legacy等）
• 更多配置项采用大写下划线格式（如SHOW_MAX_PLAYER对应show-max-player）

server-loader工具

通过/opt/velocity/server-loader.yml配置插件下载，示例：

yaml
plugins:
  - name: AsyncWorldEdit
    url: "https://github.com/SBPrime/releases/download/v3.9.4/AsyncWorldEdit-3.9.4.jar"
    version: 3.9.4

数据卷

• /opt/velocity：存储服务器相关文件（Jar、配置）
• /opt/velocity/plugins：存储插件文件

建议使用数据卷容器管理插件：

bash
docker run --name velocity-plugin -v /opt/velocity/plugins eclipse-temurin:11-jre-alpine true

扩展镜像

该镜像支持扩展，可用于打包自定义插件和配置，方便服务器更新和部署。

支持的Docker版本

已在Docker 1.41（amd64架构）上测试通过。

许可证

本程序基于GNU通用公共许可证v3或更高版本发布，详情见https://www.gnu.org/licenses/%E3%80%82