AutoStopper

插件

· 作者 Criseda

空服沉睡,玩家将其唤醒。AutoStopper 按需启动映射的 Docker 后端,并在闲置后自动停止它们。

0 本站下载 0 关注 更新于 3 周前

最新 2.3.0 · 26.2 · Velocity

一键开服(送7天)

AutoStopper - 空服休眠,玩家唤醒。

别再为空的 Minecraft 服务器付费了

AutoStopper 会让闲置的基于 Docker 的后端休眠,并在有玩家通过 Velocity 连接时立即将其唤醒。 玩家可照常使用你的网络。你只需停止运行那些无人游玩的服务器。

在 Velocity 上安装它,列出你要管理的容器,让安静的服务器进入休眠。

一个周期:玩家加入,AutoStopper 唤醒并检查服务器,玩家连接成功,当所有人离开后容器再次休眠。

为什么你会喜欢它

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

已映射的服务器处于休眠、就绪或未监控状态。仅管理已映射的服务器。

玩家看到的界面

聊天窗口显示了玩家看到的唤醒消息以及操作员看到的 /autostopper 状态概览。

快速开始

你需要一台装有 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 事件和通用的状态请求,但直接测试的后端仅为该特定后端。

帮助与文档

准备好让空服务器休眠了吗? 选择一个示例,审查 Docker 安全边界,然后安装 GitHub Releases 上发布的相同经过验证的 JAR。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源