搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

sshkeda/minecraft-server-on-orange-cloud

游戏

在 Cloudflare 上运行 Paper Minecraft Java 服务器,无人游玩时休眠、有人连接时自动唤醒。

332
7
TypeScript
MIT
创建于 1 天前

项目介绍

这个项目把 Paper Minecraft Java 服务器完整部署在 Cloudflare 账号里。玩家通过 TCP 连接到你自己域名下的主机名,Spectrum 把连接交给 Worker 和 Durable Object,后者启动 Paper 容器并在启动期间转发字节。世界数据大约每 5 分钟保存到 R2,无人在线 10 分钟后容器保存并关机以停止计费,下一位玩家连接时约 30 秒唤醒。

它省去了维护 VPS 和配置端口转发,但并非免费,且依赖多项 Cloudflare 产品提前开通。

费用与前置条件

README 给出的固定成本为每月 25–30 美元:5 美元的 Workers Paid 套餐,加上域名所在区域必须使用 Pro(月付 25 美元、年付 20 美元)或 Business,因为 Spectrum 不支持免费区域。容器唤醒期间另按 官方定价 计费:每天游玩约两小时增加约 5 美元/月,永不休眠则约 40–90 美元/月。

环境要求:macOS 或 Linux(需 glibc,不支持 Windows 和 Alpine)、Bun 1.4.4+、Node.js 22.12+、正在运行的 Docker、已开通 R2 和 workers.dev 子域名的 Workers Paid 账号、Pro/Business 区域,并接受 Minecraft EULA。

快速使用

  1. 安装依赖:

    bun install --frozen-lockfile
    
  2. 登录部署工具 Alchemy,提示时选择 OAuth 和 All Scopes:

    bun scripts/setup-alchemy.ts
    
  3. 创建 .env,主机名需尚无 DNS 记录:

    MINECRAFT_EULA=true
    MINECRAFT_SPECTRUM_HOST=play.example.com
    MINECRAFT_PLAYERS=Alice,Bob
    
  4. 部署;脚本会展示变更并请求确认,加 --dry-run 只预览:

    bun scripts/deploy.ts
    
  5. 在 Minecraft 中打开 多人游戏 → 添加服务器 并填入主机名。若服务器在休眠,首次连接会将其唤醒,约 30 秒后刷新或重新加入即可。

修改 .env 后重新部署即可应用设置。MINECRAFT_WHITELIST 默认 true;MINECRAFT_VERSION 和 MINECRAFT_PAPER_BUILD 必须同时设置,且需 Minecraft 1.21 或更新版本。下载世界时,在 R2 中打开部署时打印的 backupBucket,取 survival/latest.tar.gz。停止容器计费可运行 bun alchemy destroy --stage production --profile default scripts/stack.ts,stage 和 profile 需与部署时一致。

使用约束

  • 每个 stage 只能有一个世界,没有控制台、插件或模组。
  • 只保留最新检查点。容器非正常停止会丢失上次成功保存后的进度,通常几分钟,若 R2 保存持续失败则更长。
  • 世界和它的压缩副本必须同时放进容器的 12 GB 磁盘。
  • 任何 Minecraft 连接都会唤醒服务器,包括服务器列表刷新;世界越大唤醒越慢。
  • Pro 和 Business 区域每个只允许一条到 Worker 的 Spectrum 路由,除非有 Spectrum Enterprise,否则第二个公开 stage 需要另一个区域。
  • Spectrum 到 Worker 的路由和 Alchemy 都处于 beta。
  • 世界不能迁移到更旧的 Minecraft 版本,需要为这种情况新建 stage。

HotRepo 点评

仓库本身是一套小型 TypeScript 部署工具,并未改动服务端软件,只是把 Cloudflare 的 Spectrum、Workers、Durable Objects、Containers 和 R2 串在未经修改的 Paper 服务器外围。核心取舍在 README 中写得很清楚:空闲休眠压低容器费用,但每月 25–30 美元的固定支出和 Pro/Business 区域要求,使轻度使用反而比便宜的 VPS 更贵。12 GB 磁盘和只保留最新检查点的备份方式,是采用前值得对照现有世界体积确认的实际限制。HotRepo 在 2026-11-22 的新项目榜记录到该项目,一小时内 Star 从 112 增至 139,新增 27;没有 GitHub 日榜名次记录,也没有 Hacker News 讨论数据。

本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。

相关推荐

  1. PaperMC/Paper面向服主的高性能 Minecraft Java 服务端,同时为插件开发者提供 API。Java12,781
  2. rivet-dev/open-orange让现有 Cloudflare Workers 与 Durable Objects 无需改代码,运行在 AWS、GCP、Azure 或自有服务器上。TypeScript107
  3. Pumpkin-MC/Pumpkin用 Rust 重写的 Minecraft 服务端,面向想摆脱 JVM、又要保持原版机制的服主。Rust12,616
  4. PojavLauncherTeam/PojavLauncher让没有电脑的玩家在 Android 手机上运行 Minecraft: Java 版,兼容多数版本与 Forge/Fabric 模组。Java9,468
  5. rociiu/talorys把聊天、记忆、任务、笔记和定时提醒装进你自己的 Cloudflare 账号,单用户使用,无需自建服务器。TypeScript1,383