sshkeda/minecraft-server-on-orange-cloud
游戏在 Cloudflare 上运行 Paper Minecraft Java 服务器,无人游玩时休眠、有人连接时自动唤醒。
项目介绍
这个项目把 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。
快速使用
-
安装依赖:
bun install --frozen-lockfile -
登录部署工具 Alchemy,提示时选择 OAuth 和 All Scopes:
bun scripts/setup-alchemy.ts -
创建
.env,主机名需尚无 DNS 记录:MINECRAFT_EULA=true MINECRAFT_SPECTRUM_HOST=play.example.com MINECRAFT_PLAYERS=Alice,Bob -
部署;脚本会展示变更并请求确认,加
--dry-run只预览:bun scripts/deploy.ts -
在 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 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- PaperMC/Paper面向服主的高性能 Minecraft Java 服务端,同时为插件开发者提供 API。
- rivet-dev/open-orange让现有 Cloudflare Workers 与 Durable Objects 无需改代码,运行在 AWS、GCP、Azure 或自有服务器上。
- Pumpkin-MC/Pumpkin用 Rust 重写的 Minecraft 服务端,面向想摆脱 JVM、又要保持原版机制的服主。
- PojavLauncherTeam/PojavLauncher让没有电脑的玩家在 Android 手机上运行 Minecraft: Java 版,兼容多数版本与 Forge/Fabric 模组。
- rociiu/talorys把聊天、记忆、任务、笔记和定时提醒装进你自己的 Cloudflare 账号,单用户使用,无需自建服务器。