Cubepals：——一个"给朋友开 Minecraft 服务器"的托管项目

30 秒速读：本文讲的是 Cubepals——一个”给朋友开 Minecraft 服务器”的托管项目：建服、选版本、可选加模组，复制地址发给朋友就能开玩。它既是在线服务（官网 cubepals.com），也是开源项目（代码 AGPL-3.0 免费开源，内部代号 Blockly）。结论：只想和朋友联机，直接用它的在线服务；想研究 TypeScript 托管架构或自己搭一套，再去看源码。

软件信息一览

两种用法，结论先行

取舍结论：玩，就用在线服务；学，就看源码。想”自己搭一个 Cubepals 对外营业”的人，先把下面的许可三条线看完。

安装步骤：在线开服只抓四个关键点

1. 建服时先把游戏版本定死：Cubepals 支持建服时选版本，开服前务必和朋友统一版本。中途换版本存档可能不兼容，别建完服再改。
2. 模组要”两端对齐”：可选加模组，但朋友的客户端也要装同样的模组和版本。朋友进不来服务器，八成是模组没对齐，先查这个。
3. 服务器地址就是邀请函：建好后复制服务器地址发群里，朋友在 Java 版”多人游戏”里添加服务器、粘贴地址就能进。
4. 先看定价页：cubepals.com/pricing 有方案说明，按自己开服频率和人数选，别建一堆服空转浪费。

自部署前必须看的三条许可线（独家整理）

1. 代码是 AGPL-3.0-only，有”网络服务”条款：你改了代码又对外提供服务，必须向用户提供对应版本的源码。这是 AGPL 最硬的一条，开源托管项目最常见的坑——”自己搭着玩”没事，”搭完对外营业”就必须开源你的修改。
2. blocklyd 是独立仓库、独立许可：节点守护进程在 cubepals/blocklyd 仓库下，用的是 FSL-1.1-ALv2，不是 AGPL，部署前单独核对它的条款，别按主仓库的许可想当然。
3. 品牌和站点内容不开源：Cubepals 的名字、logo、官网文案、指南文字都是权利保留的。自己搭就换成自己的品牌和文案，别直接套用，具体看仓库的 LICENSING.md。

注意事项与常见问题

• 只支持 Minecraft Java 版：基岩版（手机/主机/Win10 版）玩家用不了，跨版本联机别指望，建服前先确认朋友玩的是哪个版本。
• 官网文档是主要入口：架构设计、本地开发、贡献指南都在仓库 docs 目录里。动手改代码前先读 docs/architecture.md，别破坏既有组件边界。
• 自部署的基础设施要求不低：网络、资源配置、备份、监控这些 README 没给现成答案，生产用之前先在测试环境完整跑通一遍。
• 品牌素材别乱用：logo、站点图片、指南文案都不在代码许可范围内，二次发布前看 LICENSING.md，该替换的替换掉。

适合谁、不适合谁

适合：想和朋友快速开黑联机的 Java 版玩家；想研究 TypeScript 写的游戏托管服务架构（网站+基础设施+守护进程协作）的开发者。不适合：基岩版玩家；要商业 SLA 保障的服主；只想局域网联机的人（直接用官方服务端开 LAN 更轻更快）。

必改设置

• 建服先定版本：开服前确认服务器版本与朋友客户端版本一致，版本不一致连不上是最常见的卡点（通用建议，具体入口以官网为准）。
• 模组开关按需开：可选加模组时先确认模组与所选版本兼容，不要一次全开，逐个加更容易定位问题（通用建议）。
• 访问权限先收紧：只和朋友联机时用白名单或邀请制，不要把服务器地址公开贴到公共群聊（通用建议，具体入口以官网为准）。

常见报错与排错

• 朋友连不上：先核对地址是否复制完整、服务器是否已启动、双方游戏版本是否一致，再检查网络与防火墙。
• 加了模组后进不去：先逐个排查新加的模组与版本兼容性，定位到冲突模组后再决定留还是撤。
• 自部署前先读许可线：代码 AGPL-3.0 免费开源，但商用自部署有源码提供义务，动手前先读项目里的许可说明，不要默认随便商用。

版本对比与推荐

结论先行：只想和朋友联机的玩家直接用在线服务，想研究架构或自己搭一套的再看源码。

开源地址

前往 GitHub 开源地址

GitHub 国内访问较慢，如打不开可多刷新几次

推广

关注「软件教程管家」

回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。

相关推荐

开源项目WallpaperMachine 免费下载开发node-rs 免费下载｜Rust 原生绑定包集合开发Roundhouse 免费下载｜Ruby 静态分析开发Flatcar Container Linux 免费下载开发Nature Skills 免费下载开发bddisasm 免费下载｜轻量级 C 指令解码库