
别再为空的 Minecraft 服务器付费了
AutoStopper 会让闲置的基于 Docker 的后端休眠,并在有玩家通过 Velocity 连接时立即将其唤醒。 玩家可照常使用你的网络。你只需停止运行那些无人游玩的服务器。
在 Velocity 上安装它,列出你要管理的容器,让安静的服务器进入休眠。

为什么你会喜欢它
- 它自动为你唤醒服务器。 玩家通过正常的 Velocity 路由选择一台休眠服务器。
AutoStopper 会在容器启动并准备就绪后立即将其连接。无需客户端模组,也无需替换
/server命令。 - 它等待的是 Minecraft,而不仅仅是 Docker。 运行中的容器并不等于就绪的服务器。 AutoStopper 会等待真实的 Minecraft 状态回复、Docker 健康检查,或两者兼有,并对每次探测和命令设置超时期限。
- 它能应对突然涌入的玩家。 如果十名玩家同时到达,他们共享一次启动过程,并在服务器响应后一同连接。
- 它只操作你映射的内容。
monitored_servers中未列出的枢纽、大厅及其他服务器永远不会被启动、停止或拦截。 - 错误提示清晰明了。 失败的停止操作会以受限退避策略重试,且绝不会假装服务器已停止。无效的重载配置会使上一版配置继续运行。玩家会看到简短友好的提示信息;原始的 Docker 输出则保留在你的日志中。

玩家看到的界面

快速开始
你需要一台装有 Docker Engine 和 Docker Compose v2 的 Linux 主机。以下配置将在 Java 25 环境下部署 Velocity 4.2,并包含一个由 AutoStopper 管理休眠与唤醒的 Minecraft 服务器。无需手动下载任何东西:代理会在启动时从 Modrinth 安装 AutoStopper。
1. 将此保存为 docker-compose.yml,放在一个空目录中:
services:
# 让 Velocity 能够检查、启动和停止容器,仅此而已。
# 它是唯一接触 Docker socket 的服务。
autostopper-docker:
image: wollomatic/socket-proxy:1.13.1@sha256:3935b709275e4ec35d6ed5a5c4a1f0d01ed31eec5e7234efc3357ecd47689002
restart: unless-stopped
user: "0:0"
read_only: true
cap_drop:
- ALL
command:
- -listenip=0.0.0.0
- -allowfrom=velocity
- -allowGET=^(/v[0-9.]+)?/(_ping|containers/[a-zA-Z0-9_.-]+/json)$
- -allowPOST=^(/v[0-9.]+)?/containers/[a-zA-Z0-9_.-]+/(start|stop)$
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
networks:
- autostopper-internal
velocity:
image: itzg/mc-proxy:2026.8.0-java25
environment:
TYPE: "VELOCITY"
VELOCITY_VERSION: "4.2.0"
VELOCITY_BUILD_ID: "30"
# 在启动时安装最新的 AutoStopper 版本。若要固定版本,请写入 autostopper:<version>。MINECRAFT_VERSION 仅用于选择下载内容(支持 1.7.2 到 26.2 的任何版本)。
MODRINTH_PROJECTS: "autostopper"
MINECRAFT_VERSION: "1.21.4"
ports:
- "25565:25577"
volumes:
- ./velocity_server:/server
networks:
- minecraft
- autostopper-internal
depends_on:
- autostopper-docker
restart: unless-stopped
# 一个由 AutoStopper 管理的服务器。可按相同方式添加更多。
survival:
image: itzg/minecraft-server:java21
container_name: survival-server
environment:
EULA: "TRUE"
TYPE: "PURPUR"
VERSION: "1.21.4"
ONLINE_MODE: "FALSE"
volumes:
- ./survival_data:/data
networks:
- minecraft
restart: "no" # AutoStopper 负责启动和停止它;Docker 不应重启它
stop_grace_period: 60s # 停止时保存世界所需的时间
networks:
minecraft:
autostopper-internal:
internal: true
2. 启动它 执行 docker compose up -d。首次启动将下载所有依赖并生成配置文件。
3. 告知 Velocity 有关服务器的信息。 在 velocity_server/velocity.toml 中,替换示例服务器和引用它们的示例强制主机:
[servers]
survival = "survival:25565"
try = ["survival"]
[forced-hosts]
在同一文件的现有 [advanced] 部分中,设置 read-timeout = 180000,以便在 Velocity 放弃玩家之前给休眠服务器足够的唤醒时间(默认为 30 秒)。
4. 告知 AutoStopper 要管理哪个容器。 在
velocity_server/plugins/autostopper/config.yml 中,将 monitored_servers: [] 替换为:
monitored_servers:
- server_name: survival # velocity.toml 中的名称
container_name: survival-server # docker-compose.yml 中的 container_name
5. 重启并检查。 运行 docker compose restart velocity。代理日志应显示
endpoint auto: tcp://autostopper-docker:2375 (socket-proxy sidecar) 以及
AutoStopper startup preflight healthy: 1 mapping(s) checked.
到此为止。如果没有玩家在线超过 5 分钟,服务器将进入休眠状态;下一位加入的玩家会将其唤醒。/autostopper status 可显示每台服务器的状态。始终在线的枢纽不应放入 monitored_servers。其他 Velocity 线路的现成文件位于 examples,配置参考 涵盖了调优说明。
Docker 安全警告。 访问
/var/run/docker.sock等同于在 Docker 宿主机上拥有 root 权限。示例配置将 Velocity 与该 socket 隔离:一个小型 socket 代理持有 socket,并仅允许 Velocity 检查、启动和停止容器。除非你将代理固定到后端服务器,否则 Velocity 仍可停止或启动任意容器 并读取容器的环境变量。建议使用专用主机或虚拟机,仅安装受信任的插件,并在操作前阅读 安全指南。
合理的默认值
| 设置项 | 默认值 |
|---|---|
| 不活跃超时时间 | 5 分钟 |
| 就绪检测 | Minecraft 状态回复,总超时限制为 120 秒 |
| 自动停止尝试次数 | 3 次,退避间隔在 60 至 300 秒之间封顶 |
| 插件关闭超时 | 10 秒 |
| 管理的服务器 | 无(需添加映射后才生效) |
所有值均可配置,并以原子快照的形式进行验证。请参阅 配置参考。
命令
| 命令 | 权限 |
|---|---|
/autostopper, /as |
所有人 |
/autostopper help |
所有人(根据权限过滤显示可用内容) |
/autostopper status [server] |
autostopper.command.status |
/autostopper start, stop, restart <server> |
autostopper.command.start, .stop, .restart |
/autostopper hold, release <server> |
autostopper.command.hold, .release |
/autostopper reload |
autostopper.command.reload |
autostopper.admin 授予上述所有命令权限。AutoStopper 永远不会替换 Velocity 的 /server 命令。
测试支持
一个 Java 21 JAR 已在五种完整的运行时环境中经过测试。请将代理镜像与 Velocity 版本保持在同一行。
| 环境线 | 代理镜像 | Java | Velocity |
|---|---|---|---|
| Legacy (最低要求) | itzg/mc-proxy:2026.8.0-java21 |
21 | 3.5.1 build 615 |
| Stable 4.0 (生产环境) | itzg/mc-proxy:2026.8.0-java25 |
25 | 4.0.0 build 6 |
| Stable 4.1 (生产环境) | itzg/mc-proxy:2026.8.0-java25 |
25 | 4.1.0 build 22 |
| Stable 4.2 (推荐) | itzg/mc-proxy:2026.8.0-java25 |
25 | 4.2.0 build 30 |
| Preview (快照版) | itzg/mc-proxy:2026.8.0-java25 |
25 | 4.2.1-SNAPSHOT build 41 |
Velocity 4 需要 Java 25。预览线跟踪的是 PaperMC 的快照版本,并非生产环境基线。完整的候选版本已针对真实的 Purpur 1.21.4 后端进行了测试,包括实际协议客户端、同时加入、空闲停止、重启、永远无法就绪的服务器以及失败停止重试。Minecraft 版本 1.7.2 至 26.2 被列出,因为 AutoStopper 仅使用 Velocity 事件和通用的状态请求,但直接测试的后端仅为该特定后端。
帮助与文档
- 故障排除 涵盖了你在聊天或日志中可能遇到的所有失败情况
- 配置参考
- 安全指南
- 从 2.2.0 迁移到 2.3.0(即插即用;可选迁移至 socket 代理)
- 从 1.1.2 迁移到 2.0.0
- 完整安装指南
- 更新日志
- 报告问题
准备好让空服务器休眠了吗? 选择一个示例,审查 Docker 安全边界,然后安装 GitHub Releases 上发布的相同经过验证的 JAR。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧