kouleen/velocity repository overview

⁠🚀 kouleen/velocity - High Performance Minecraft Proxy

⁠Introduction

kouleen/velocity is a lightweight, high-performance Minecraft proxy server powered by the Velocity engine, built on Alpine Linux + OpenJDK. It offers superior performance and security for connecting multiple Minecraft backend servers (Paper, Spigot, Purpur...).

⁠Core Features

✅ Velocity Native – High performance, modern, secure proxy
✅ Ultra Lightweight – Alpine Linux base, tiny footprint
✅ Auto Configuration – Generates velocity.toml automatically
✅ Data Persistence – Configs, forwarding secrets, plugins preserved
✅ Stable & Secure – Modern player forwarding security
✅ Low Latency – Optimized for large server networks
✅ Timezone Set – Asia/Shanghai (Beijing time)

⁠Default Port

• 25565: Velocity proxy default port

⁠Quick Start (Recommended)

docker run -d \
  --name velocity \
  --restart always \
  -p 25565:25565 \
  -v velocity-volumes:/app \
  kouleen/velocity:tagname

⁠Full Mount (Config + Plugins)

docker run -d \
  --name velocity \
  --restart always \
  -p 25565:25565 \
  -v velocity-volumes:/app \
  -v ./velocity-plugins:/app/plugins \
  kouleen/velocity:tagname

⁠Container Directory Structure

/app                      # Root directory
/app/velocity.toml        # Main config
/app/plugins              # Plugins folder

⁠Common Management Commands

# Attach to console
docker attach velocity

# Detach without stopping
Ctrl + P + Q

# View logs
docker logs -f velocity

# Restart proxy
docker restart velocity

# Stop / remove
docker stop velocity
docker rm -f velocity

⁠Use Cases

• Minecraft network proxy (Lobby + Survival + Minigames)
• Cross-server teleportation
• High-traffic public server networks
• Compatible with Paper, Spigot, Purpur, Fabric backend

⁠FAQ

⁠Q1: Is this better than BungeeCord?

Yes — Velocity is faster, more secure, and modern.

⁠Q2: Will configs be lost?

No — mount /app to persist everything.

⁠Q3: Can I use plugins?

Yes — place plugins in /app/plugins.

⁠Q4: Does it support 1.20+?

Yes — Velocity supports latest Minecraft versions.

⁠Author Info

🐳 Docker Hub: kouleen⁠
📦 Image: kouleen/velocity⁠

⁠💡 Fast, secure, modern proxy! Leave a ⭐ Star if you like it!

⁠🚀 kouleen/velocity - 高性能 Minecraft 群组代理端镜像

⁠镜像简介

kouleen/velocity 是基于 Alpine Linux + OpenJDK 构建的 Velocity 高性能 Minecraft 代理端镜像。 相比传统 BungeeCord 更高效、更安全、延迟更低，用于搭建 MC 多服群组（大厅服+生存服+小游戏服），无缝跨服、稳定流畅。

⁠核心特性

✅ 原生 Velocity 核心：无魔改、现代架构、性能远超 BungeeCord

✅ 超轻量：Alpine 底层，体积小、资源占用极低

✅ 自动生成配置：首次启动自动生成 velocity.toml

✅ 数据持久化：配置、密钥、插件、信息永久保存

✅ 高安全性：现代化玩家跨服验证，防假冒玩家

✅ 低延迟高并发：适合大型群组服、高在线服务器

✅ 时区准确：默认北京时间，日志时间正常

⁠默认端口

• 25565：Velocity 代理监听端口

⁠快速使用（推荐一键启动）

docker run -d \
  --name velocity \
  --restart always \
  -p 25565:25565 \
  -v velocity-volumes:/app \
  kouleen/velocity:tagname

⁠完整挂载（配置+插件）

docker run -d \
  --name velocity \
  --restart always \
  -p 25565:25565 \
  -v velocity-volumes:/app \
  -v ./velocity-plugins:/app/plugins \
  kouleen/velocity:tagname

⁠容器内目录结构

/app                      # 代理根目录
/app/velocity.toml        # 主配置文件
/app/plugins              # 插件目录

⁠常用管理命令

# 进入控制台
docker attach velocity

# 退出控制台（不关闭服务）
Ctrl + P + Q

# 查看日志
docker logs -f velocity

# 重启代理
docker restart velocity

# 停止/删除
docker stop velocity
docker rm -f velocity

⁠适用场景

• Minecraft 多服务器群组网络（大厅服+生存服+小游戏服）
• 大型公会服、公益服、高在线群组服
• 无缝跨服传送、玩家数据互通
• 兼容后端：Paper、Spigot、Purpur、Fabric 等

⁠常见问题

⁠Q1：Velocity 和 BungeeCord 有什么区别？

Velocity 是新一代代理，更快、更安全、资源占用更低，现代服务器群组首选。

⁠Q2：配置文件会丢失吗？

挂载 /app 目录后，配置、密钥、插件永久保存不丢失。

⁠Q3：可以安装插件吗？

可以，将插件放入 /app/plugins 目录重启即可。

⁠Q4：支持最新 MC 版本吗？

支持，持续更新至最新 Minecraft 版本。

⁠作者信息

🐳 Docker Hub: kouleen⁠ 📦 镜像地址: kouleen/velocity⁠

⁠💡 群组服神器！流畅跨服不卡顿，好用欢迎点个 ⭐ Star！