服务端软件
本页说明服务器可运行的服务端软件:可选的核心与版本、Java 运行时、玩家身份转发、文件的下载与缓存,以及更换版本和使用自定义 jar 的方法。本页面向服务器所有者与管理员。
工作方式
使用服务端软件的服务器运行在平台提供的 Java 运行时镜像上,服务端本身作为数据保存在服务器的世界卷中。每次启动前,平台按服务器的配置完成以下步骤:
- 从核心的官方来源读取版本信息,下载服务端及其依赖库,并逐个校验官方公布的哈希值。
- 为能够接入身份转发的版本写入转发配置,必要时安装转发组件。
- 以所选 Java 版本启动服务器,写入游戏端口、离线模式与 RCON 设置,并按创建时的确认接受 Minecraft EULA。
首次启动需要下载服务端,耗时取决于网络与核心类型;Forge 与 NeoForge 还需运行官方安装器。之后的启动只校验已下载的文件,不再访问下载站,因此下载站暂时不可用时,已安装的服务器仍可启动。
服务器也可以继续使用镜像白名单中的服务端镜像,见镜像与 Minecraft 版本。两种方式由创建或编辑服务器时的「运行方式」决定。
可选的核心
| 核心 | 说明 | 官方来源 | 可选的最早版本 |
|---|---|---|---|
| Paper | 高性能插件服务端,兼容 Bukkit 与 Spigot 插件 | PaperMC | 1.8.8 |
| Purpur | 基于 Paper,提供更多可配置的玩法选项 | PurpurMC | 1.14.1 |
| Fabric | 轻量模组加载器 | FabricMC | 1.14 |
| Quilt | 兼容 Fabric 模组的模组加载器 | QuiltMC | 1.14.4 |
| Forge | 经典模组加载器 | MinecraftForge | 1.12.2 |
| NeoForge | 源自 Forge 的模组加载器 | NeoForged | 1.20.2 |
| 原版 | Mojang 官方服务端 | Mojang | 1.7.10 |
| 自定义 jar | 上传 jar,或使用服务器文件中的 jar | 服务器所有者 | — |
版本列表默认只显示正式版本,勾选「显示预发布版本与快照」后显示预发布版本、候选版本与快照。选择游戏版本后:
- Paper 与 Purpur 选择构建,Fabric、Quilt、Forge 与 NeoForge 选择加载器版本。默认选中标记为「推荐」的项:Forge 采用其官方推荐构建,没有推荐构建时采用最新构建;其他核心采用最新的稳定构建。
- 模组与插件通过服务器文件上传到
mods或plugins目录。
Java 版本
平台提供 Java 8、17、21 与 25 的运行时。选择游戏版本后,面板显示该版本所需的最低 Java 版本,并默认选中满足要求的最早版本。可以改选更高的版本;低于要求的版本不提供,接口以 java_too_old 拒绝。部分旧版模组包只能在特定 Java 版本上运行,请按模组包的说明选择。
运行时镜像由 felis mirror-build-tools 复制到集群内镜像仓库,见运行时镜像。
玩家身份
游戏代理验证玩家的正版身份,再以 Velocity 现代转发把身份传给服务器。能够接收转发的服务器以玩家的正版 UUID 与皮肤接待玩家;不能接收转发的服务器以离线模式 UUID 接待玩家,面板在服务器页显示「身份未接入」。
| 核心 | 身份转发 |
|---|---|
| Paper、Purpur | 1.13 及以上版本由平台写入转发配置:1.19 起为 config/paper-global.yml,更早版本为 paper.yml。 |
| Fabric | 平台从 Modrinth 安装 FabricProxy-Lite 与 Fabric API。仅在 Modrinth 发布了对应游戏版本的组件时接入。 |
| Quilt | 平台从 Modrinth 安装 FabricProxy-Lite 与 Quilted Fabric API。仅在两者都发布了对应游戏版本时接入。 |
| Forge | 1.15.2 及以上版本由平台从 Modrinth 安装 Proxy Compatible Forge 并写入其配置,仅在其发布了对应游戏版本时接入。 |
| NeoForge | 平台安装 Proxy Compatible Forge,条件与 Forge 相同。 |
| 原版 | 不接入,玩家以离线模式 UUID 进入。 |
| 自定义 jar | 平台不配置转发。如需正版身份,请在服务器中自行安装并配置 Velocity 转发。 |
选择版本时,面板说明该版本是否接入身份转发。离线模式 UUID 由玩家名计算,与正版 UUID 不同,权限、白名单与存档中的玩家数据按离线 UUID 记录;之后改为接入转发的版本时,这些数据不会自动迁移。
平台安装的转发组件位于 mods 目录,文件名以 felis-managed- 开头,每次启动时按配置重新放置。服务器所有者自行放入同一组件(按模组 ID 识别)时,平台使用所有者的副本并移除自己的副本。
注意
Forge 1.13 至 1.20.1 的模组客户端在代理中切换服务器时,需要代理侧的 Ambassador 插件,Felis 的代理未安装该插件。玩家直接通过子域名进入正在运行的服务器不受影响;服务器从休眠中唤醒后,模组客户端可能需要重新连接。
下载与缓存
服务器安装时下载的文件经集群内的下载缓存取得。缓存按哈希值保存每个文件,同一版本只从官方来源下载一次,其他服务器再使用时直接从缓存读取。
- 缓存只从官方下载站下载:Mojang、PaperMC、PurpurMC、FabricMC、QuiltMC、MinecraftForge、NeoForged、Modrinth 与 Maven Central,并且只保存与请求的哈希值一致的内容。
- 服务器在下载缓存不可用时直接从官方来源下载,同样校验哈希值。
- 缓存位于控制命名空间的
felis-artifacts卷,默认申请 10Gi,超出 90% 后删除最久未使用的文件,见卷容量。
1.7 至 1.18 版本受 Log4Shell(CVE-2021-44228)影响。原版、Fabric 与 Quilt 服务器按 Mojang 公告的方式启动:1.17 与 1.18 加入 -Dlog4j2.formatMsgNoLookups=true,1.12 至 1.16.5 与 1.7 至 1.11.2 使用 Mojang 发布的日志配置文件。Paper、Purpur 与 Forge 的最新构建已修复该漏洞,请使用推荐构建。
服务器中的文件
| 路径 | 内容 |
|---|---|
.felis/ | 平台管理的文件:服务端 jar、安装器、日志配置与安装记录。 |
libraries/ | Fabric、Quilt、Forge 与 NeoForge 的依赖库,以及原版服务端解出的库。 |
mods/felis-managed-*.jar | 平台安装的身份转发组件。 |
cache/ | Paper 与 Purpur 启动时生成的文件。 |
平台每次启动时写入 eula.txt,以及 server.properties 中的 server-port、online-mode 与 RCON 设置;RCON 设置包括 broadcast-rcon-to-ops=false,平台自身执行的 RCON 命令不在游戏内向 OP 播报,也不写入日志。新服务器首次启动时 white-list 设为 false,准入由自动启动策略与唤醒名单控制;服务器所有者之后修改的白名单设置保持不变。世界备份包含整个世界卷,包括上述文件。
更换核心或版本
服务器所有者与管理员在服务器「设置」页的「服务端」一节中选择「更换服务端软件」。
- 选择核心、游戏版本、构建与 Java 版本。
- 更换核心或游戏版本时,勾选「我已备份世界,确认更换」。只更换构建或 Java 版本时无需确认。
- 选择「保存配置」。新配置在服务器下次启动时生效。
更换核心或游戏版本后,世界由新版本打开,升级后的区块无法在旧版本中使用,请先备份世界。平台移除旧版本下载的服务端文件,世界、配置、插件与模组保留;模组与插件是否兼容新版本,由服务器所有者自行确认。
使用服务端镜像的服务器也可以改用服务端软件,此时还需同意 Minecraft EULA。管理员可将使用服务端软件的服务器改回镜像。
自定义 jar
自定义 jar 用于平台未列出的服务端,例如混合端或修改版服务端。
新建服务器时:
- 在「新建服务器」中选择「自定义 jar」,将 jar 拖入「jar 文件」区域,或点击后选择文件。jar 默认上传到服务器根目录并沿用文件名;如需放在其他位置,选择「放到其他位置」并填写相对服务器根目录的路径,例如
pack/server.jar,路径中的文件夹会自动创建。 - 选择 Java 版本,同意 Minecraft EULA,然后创建服务器。服务器创建后,所选 jar 随即上传;上传失败时,对话框提供「重试上传」,服务器不会重复创建。
- 启动服务器。
如需稍后再上传 jar,可在「jar 文件」中选择「填写路径」,填写 jar 将来所在的位置。
已有服务器在「设置」页选择「更换服务端软件」和「自定义 jar」。服务器已停止时,「jar 文件」提供三种方式:
- 「服务器中的 jar」:列出服务器根目录中的 jar 文件,选择其中一个;根目录中只有一个 jar 时自动选中。
- 「上传 jar」:选择新的 jar,保存时上传到服务器根目录,同名文件被替换。
- 「填写路径」:填写 jar 相对服务器根目录的路径。
服务器运行时无法读取或上传文件,只能填写路径。
jar 须支持 server.properties 中的 RCON 设置:平台通过 RCON 判断服务器是否就绪、读取在线人数并保存世界。jar 尚未上传时,启动失败并提示上传。路径必须位于服务器目录内且以 .jar 结尾,不能位于 .felis 目录下。