前阵子有位朋友问我他想开一个二十人左右的小服几个朋友一起玩既想要暮色森林这类大型 Mod又想要类似 Essentials、地皮、登录那样现成的插件到底该用 Forge 还是 Paper。这个问题的标准答案其实是两个都不用选直接用 Arclight。这不是什么冷门黑科技而是我用了三年多、给好几批服务器做过迁移之后最稳的选择。这篇文章就把整套搭建流程、配置细节和踩坑经验完整写出来照着做一个下午就能把服务端从空目录跑到公网可进。1. 先弄明白 Arclight 到底解决了什么问题1.1 每个服主都会撞上的二选一难题做 Minecraft 服务器这些年我见过太多人第一步就卡死。传统服务端阵营是分裂的Spigot、Paper 这类改良端拥有一整套成熟的 Bukkit 插件生态但跑不了 Forge 的 ModForge / Fabric 系服务端能跑大型模组插件支持却几乎为零。很多教程会直接替你做出取舍可现实是不少玩家的需求本来就是既要又要——既想要一个地形生成 Mod 改变世界体验又希望登录、圈地、经济这类插件能直接用。以前遇到这种需求常规操作是开两个服一个 Forge 服跑 Mod一个 Paper 服跑插件中间再想办法同步数据。我最早也这么干过维护两套服务端、两套插件配置、两套备份脚本半夜出问题排查起来是真的痛苦。后来看到 Arclight 这种混合型服务端思路一下子清爽了一个进程一个世界Mod 和插件共存在同一个服务器里。1.2 混合内核是怎么通吃两边的Arclight 的技术路线说白了是在 Forge 的加载体系里通过 Mixin 技术对原版核心类做注入然后实现出 Bukkit API 供插件调用。Forge 负责识别和加载 ModArclight 在它之上加了一层翻译器让那些为 Bukkit 写的插件以为自己跑在原生 Spigot 上。理解了这个原理你就能记住两条红线。第一插件生态上限是 Bukkit/Spigot 级别依赖 Paper 独有 API 的插件在 Arclight 上会跑不起来第二Mod 和插件访问的是同一套世界数据理论上能互相看到对方的内容但任何一方对世界的处理过于激进都可能把另一边带崩。这不是 Arclight 的缺陷而是所有混合端共同的边界。提前知道边界在哪能给你省下后面大量排错时间。1.3 版本矩阵与选版原则Arclight 不是每个 MC 版本都有它是跟着 Forge 的大版本走的。我接触过的版本里1.16.5、1.17.1、1.18.2、1.19.2、1.20.1 都有对应的 Arclight 版本其中 1.16.5 和 1.20.1 在社区里的使用量最大周边资料也最全。选版本有个基本判断不要追新去找 Mod 生态最成熟的稳定版本。哪怕官方已经出到更新的版本只要你的目标 Mod 还没跟上 Arclight 的对应版本就得继续留在老版本上。对开服而言稳定永远排在新前面。2. 部署前的三项准备版本、Java、机器2.1 Java 版本错一档就起不来这里我必须先讲一个自己吃过大亏的点。Arclight 1.16.5 用 Java 8 就能跑但 1.17 之后的原版 Minecraft 强制要求更高版本的 Java而 Arclight 官方在 1.18 以上的版本推荐用 Java 17 运行。我当年图省事拿系统默认的 Java 8 去启动 1.18.2 的服务端报错信息里全是类版本异常折腾了大半个小时才反应过来是 JDK 版本的问题。建议直接装 OpenJDK 17装完之后在命令行执行java -version确认当前默认版本。如果你机器上同时装了好几个 Java记得在启动脚本里用完整路径指定 java 可执行文件别依赖系统 PATH。环境变量这玩意儿很容易被别的软件改掉一旦默认版本变了服务端就悄悄起不来了到时候排查方向很容易跑偏。2.2 云服务器还是本机开服这个选择直接决定了你的网络架构和维护方式。如果玩家规模很小、主要是局域网里的朋友一台配置尚可的家用电脑本机开服就够了重点是把路由器端口映射配好想要公网稳定访问大多数人的选择是买一台云服务器。云服务器选购的底线配置我一般按二十人以内、原版加少量 Mod来算2 核 4G 是起步线4 核 8G 用起来才从容。很多人问购买云服务器大概多少钱国内厂商的轻量应用服务器搞活动时2 核 4G 一年几十块到一百多就能拿下别在带宽上省3M 上行起步。不管是云服务器还是本机开服内存都比 CPU 更容易成为瓶颈预算有限时优先加内存。2.3 系统时间这种小细节也别忽略这是我做定时备份时才踩到的坑。服务器虚拟机或者云主机的系统时间如果漂移了crontab 的执行时间、日志时间戳、部分插件的冷却计算全都会乱。Linux 下用timedatectl查看时间状态确保 NTP 时间为 activeWindows 服务器则在时间设置里开启自动同步。这一步五分钟搞定但能避免后面排查问题时长日志都对不上号的尴尬。3. 从空目录到可进服完整部署流程3.1 下载与目录结构规划去 GitHub 上 Arclight 仓库的 Releases 页面下载对应版本。文件名里同时包含 Forge 版本和 Arclight 版本号比如arclight-forge-1.20.1-1.0.x.jar。下载前扫一眼该版本的 Known Issues有些版本对特定 Mod 或 Java 版本有已知问题提前避开比事后排查省事。目录结构我建议里外里规划得干净一点。我习惯把所有服务端放在/opt/mc下每个服一个独立子目录/opt/mc/arclight1201/ ├── arclight-forge-1.20.1-1.0.x.jar ├── start.sh ├── eula.txt ├── server.properties ├── mods/ ├── plugins/ ├── worlds/ ├── logs/ └── backups/提前把 backups 目录建好后面做定时备份时就不用临时改脚本。把服务端 jar 和 mods、plugins 目录分开摆放的意义在于当你想排查某个 Mod 或插件是不是有问题时可以直接把对应目录临时改名快速定位责任方完全不用动整个服务端。3.2 首次启动与 EULA 处理第一次运行直接执行java -Xmx4G -Xms4G -jar arclight-forge-1.20.1-1.0.x.jar nogui。启动过程会做两件事生成必要的配置文件和目录然后提示你同意 EULA。Mojang 的服务端协议要求管理员显式同意在生成的eula.txt里把eulafalse改成eulatrue再启动即可这是所有 Java 版服务端统一的规定。注意第一次启动可能会卡在 Downloading... 或者 Applying patches 阶段这是 Arclight 在自动下载依赖并应用补丁耐心等它跑完就好。如果长时间没动静检查一下服务器访问外网下载源是否正常这属于网络环境问题不是服务端文件坏了。等控制台出现 Done 提示服务端就正常起来了。3.3 启动脚本与内存参数不要每次都在命令行里手敲参数写一个start.sh一劳永逸。基础版长这样#!/bin/bash cd $(dirname $0) java -Xms4G -Xmx4G -jar arclight-forge-1.20.1-1.0.x.jar nogui如果需要后台运行并记录日志配合 nohup 重定向输出#!/bin/bash cd $(dirname $0) nohup java -Xms4G -Xmx4G -jar arclight-forge-1.20.1-1.0.x.jar nogui logs/latest.log 21 关于内存分配我强烈建议把-Xms和-Xmx设成一样的值避免 JVM 在运行中反复扩缩内存。这对 Minecraft 这种长时间运行的 Java 进程有明显的稳定性收益。4G 是个平衡点小于 2G 跑新版本加 Mod 很容易触发内存不足大于 8G 对大多数小服又是浪费。3.4 公网访问与端口开放服务端默认监听 25565 端口。如果是云服务器光改服务端配置没用必须去云厂商控制台的防火墙或安全组里放行 TCP 25565 入方向如果是家用宽带本机开服需要到路由器里做端口映射把外网 25565 映射到内网开服机器的 IP。很多人问知道了服务器的公网 IP 怎么访问其实就是在 Minecraft 多人游戏里添加服务器填上公网IP:25565就能进服。如果你家用宽带没有公网 IPv4常见方案是找一台有公网 IP 的轻量服务器做内网穿透把本机的 25565 端口映射出去。这类方案的原理就是用反向代理把数据转发到内网服务端。要注意的是穿透方案会引入额外网络延迟对 PvP 这类对延迟敏感的玩法影响比较明显能拿到公网 IP 就直接用公网 IP别绕弯子。4. 配置文件逐项拆解别照抄网上模板4.1 server.properties 关键项这个文件是服务器的总开关每一项都有实际意义。我最常调整的几个配置项推荐值说明server-port25565服务端监听端口改之前先想好防火墙策略online-modetrue保持 true否则任何人都能以任意 ID 登录盗号风险极高white-listfalse熟人服建议开 true配合白名单管理view-distance8视距每加 1 都会显著增加服务器负载simulation-distance6实体模拟范围Mod 服建议调低max-players20在线人数上限防止服务器被挤爆motd自定义简介服务器列表显示的文字别写敏感内容difficultyhard按玩法自定这里特别提醒 view-distance 和 simulation-distance 这对组合。很多新手只改视距忽略了模拟距离导致玩家离得很远还能触发生成区块里的大量实体活动服务器负载居高不下。实际上模拟距离对性能的影响比视距还大Mod 服建议把 simulation-distance 设到 5 到 6玩家体感几乎没差别性能却能明显改善。4.2 JVM 优化参数怎么选网上很多教程让你直接抄 Aikars Flags这套 GC 参数确实是给 Java 服务端优化的经典方案但它原本是面向 Paper 类服务端的。Arclight 的底层是 Forge 混血结构我的实测经验是完整 Aikar 参数在 Arclight 上也能用但对小内存机器收益有限不如先做好三个基础项固定堆大小、使用 G1GC、开启 AlwaysPreTouch。java -Xms4G -Xmx4G -XX:UseG1GC -XX:AlwaysPreTouch -XX:MaxGCPauseMillis200 -jar arclight-forge-1.20.1-1.0.x.jar noguiAlwaysPreTouch 会让 JVM 启动时一次性申请并触碰所有内存避免运行中途向系统申请内存带来的卡顿代价只是启动时间稍长对服务器来说完全值得。如果你发现服务器出现周期性的卡顿几秒然后恢复优先检查 GC 和内存分配而不是第一时间怀疑某个 Mod 有问题。4.3 白名单、OP 与权限管理Arclight 里 OP 命令和 Bukkit 权限体系是打通的。先用控制台执行op 玩家名给管理员权限再在 plugins 目录里装一个权限组插件比如 LuckPerms做精细管理。开服最容易犯的错误是随手发 OP 给几个信任的朋友权限一放开就收不回来了后患无穷。白名单建议从开服第一天就启用哪怕现在只有几个熟人。在 server.properties 里设置white-listtrue然后用whitelist add 玩家名逐个添加。这比事后再去对付熊孩子、回档、清理物品要轻松一万倍。真心话白名单是成本最低的安全措施没有之一。5. Mod 与插件混跑的五条实战心得5.1 装 Mod版本匹配与前置依赖Arclight 支持的是 Forge 系 Mod不是 Fabric 系。下载时看清楚平台和对应 MC 版本把 jar 放进 mods 目录重启服务端控制台就会显示加载了哪些 Mod。如果加了某个 Mod 服务端起不来八成是缺前置 Mod日志里会出现 Missing or unsupported mandatory dependencies 之类的提示去把前置补上就行。版本匹配这事儿我见太多人栽过。Mod 的构建目标版本必须和 Arclight 所属的 MC 版本一致1.20.1 的 Arclight 只能装 1.20.1 的 Mod不存在向下兼容。下载前先看文件名或介绍页确认是 for 1.20.x 再放进去。另外不要一次堆几十个 Mod 再启动先加几个、启动验证、再加这样出了问题能快速定位不用对着密密麻麻的加载日志发呆。5.2 装插件认清 Paper 与 Spigot 的边界Arclight 能运行的是 Bukkit/Spigot 体系插件。实际操作中EssentialsX、登录、地皮、箱子锁、家园这类纯功能性插件在 Arclight 上基本都能正常工作。但依赖 NMSnet.minecraft.server 内部类或 Paper 独有 API 的插件不行这类插件往往在介绍页写了类似 Paper 1.20 的要求看到 Paper 字样就要警惕。我给大家一个判断标准插件作者声明支持 Spigot 1.20.1 的大概率能在 Arclight 上跑声明只支持 Paper 的就别抱侥幸。因为 Arclight 的兼容层实现的是 Bukkit API不是完整的 Spigot 实现更不是 Paper 的超集。装插件之前先花两分钟看介绍页比装完报错再排查省太多时间。5.3 冲突排查的固定流程Mod 和插件混跑冲突是迟早的事。我的排查顺序固定为四步第一步翻logs/latest.log搜索 ERROR 和 WARN第二步按时间倒序看崩溃前最后几十行真正的报错通常就在那里第三步禁用最近添加的插件或 Mod第四步二分定位把可疑对象分批试。这里有个小技巧维护一份最近改动清单。每次加新 Mod 或插件就在清单里记一行写上时间、名称、来源。出了问题时优先从最近改动的项开始排查命中率极高。别指望一次装十个 Mod 八个插件然后靠运气跑起来分层加载、分批验证才是正路这也是我做服务器运维这几年最值得分享的习惯。6. 日常运维不能省备份、崩溃日志、更新6.1 定时备份与保留策略服务器数据就三样worlds 目录、server.properties、以及插件和 Mod 的配置文件。最简单的备份方案是用 crontab 定时打包#!/bin/bash BACKUP_DIR/opt/mc/arclight1201/backups WORLD_DIR/opt/mc/arclight1201/worlds STAMP$(date %Y%m%d_%H%M%S) tar -czf $BACKUP_DIR/worlds_$STAMP.tar.gz $WORLD_DIR find $BACKUP_DIR -name *.tar.gz -mtime 7 -delete直接 tar 打包运行中的世界目录理论上可能出现轻微不一致但对小型服务器来说只要不是在高峰期大规模写入区块时执行完全够用。更严谨的做法是先通过控制台执行save-all触发完整存档再执行备份。把 crontab 设为每天凌晨 4 点执行保留最近 7 天的备份文件这是我在多台服务器上验证过最省心的组合。6.2 崩溃报告怎么读服务端崩溃后目录里会出现 crash-reports 文件夹下面按时间生成 txt 文件。别看到英文报错就发懵重点看三个地方崩溃原因描述段通常开头几行写明 Description、涉及的类名、StackTrace 中出现的 Mod 或插件名。如果 StackTrace 里出现某个特定 Mod 的类名基本可以锁定责任方。如果崩溃报告指向某个插件先禁用这个插件重启验证如果指向 Mod去它的 GitHub 或社区搜报错关键行大部分已知问题都能搜到对应方案。真找不到解决方案就把完整日志和崩溃报告放出来附上服务端版本、MC 版本、Java 版本、Mod 和插件列表老玩家一眼就能帮你缩小范围。信息给得越全别人帮你的效率越高。6.3 更新与回滚的正确姿势不要在有玩家在线的时候直接替换服务端 jar。标准流程是先全服广播维护通知停服完整备份替换 jar清空旧 Mod 或插件缓存部分 Mod 会生成 cache 目录最后启动验证。注意跨大版本升级不要直接换 jar 就完事世界文件格式和 Mod 兼容性都可能出问题最好先在测试服验证一遍再上正式服。Arclight 每个版本的更新日志值得看升级前确认没有破坏性变更。我见过有服主跳过两个小版本直接升级结果一个旧插件彻底不能用了被迫回滚备份。回滚本身不复杂但折腾玩家的体验非常差。顺带一提升级前先检查系统时间是否准确不然备份文件名的时间戳和日志容易对不上回滚时容易拿错文件。最后再分享一条个人经验如果你的服务器以后要长线运营有条件的话单独建一台测试服配置尽量接近正式服专门用来试新 Mod、新插件和版本升级。我在没建测试服之前每次更新都是提心吊胆生怕哪个兼容性问题把正式服搞崩建了测试服之后几乎所有问题都在上线前被拦下了。这套正式服 测试服的架构改动不大但对长期开服的省心程度是质的提升。