一、介绍
提到 MC 服务器面板,多数人先想到 Pterodactyl、MCSManager 这类系统级面板——它们独立部署在宿主机上,擅长多实例开服、进程与文件管理。而 O-Panel 走的是另一条路:它本身就是服务端里的一个 jar(插件/模组),通过浏览器访问,管的是游戏内部更细的内容。
一句话结论:传统面板帮你"开服",O-Panel 帮你"管服",两者配合才顺手。
下载地址:OPanel
| 对比维度 | 系统级面板 | O-Panel(插件/模组级) |
|---|---|---|
| 存在形态 | 独立部署在宿主机 | 服务端里的一个 jar |
| 管理对象 | 多服务端、进程、文件 | 单个服务端内部的细致内容 |
| 存档/玩家/背包 | 通常只能管文件 | 直接在网页里操作游戏数据 |
| 控制台与日志 | 支持 | 支持(彩色渲染、Tab 补全) |
| 多开能力 | 强项 | 支持多服务端,但定位不同 |
二、支持哪些服务端与版本
O-Panel 支持 Paper(含 Leaves 等 Paper 系)、Folia、Fabric、Forge、NeoForge,甚至 Pumpkin。
需要注意的变化:
-
已不再支持 CraftBukkit 与 Spigot,原 Bukkit 端全面迁移到 Paper 端。
-
版本覆盖 1.19.x 到 1.26.x 区间(26.3、26.2、26.1.x、1.21.x、1.20.x 等均有适配)。
-
前置要求:Fabric Loader 最低 0.16.14(MC 1.21.11+ 需 0.17.3),NeoForge 最低 21.1.217。
两个容易踩的坑:
-
jar 包名里的"游戏版本"指的是该包支持的最低版本,不是精确版本。
-
用 Pumpkin 端务必先查官方版本对照表,版本不匹配可能导致服务器 panic 崩溃。
三、核心功能:从基础管理到 AI 辅助运维
O-Panel 的基础功能包括存档管理(网页上传、下载、删除、切换世界存档)、玩家管理(列表、在线状态、游戏模式、OP 权限)、终端控制台(彩色日志渲染、Tab 补全、历史记录)与日志查看器。
在此基础上,官方功能清单已相当充实:
-
仪表盘:服务器运行总览。
-
背包 + 物品 NBT 编辑:还原游戏内视觉与操作,数据实时更新——系统级面板基本做不到。
-
游戏规则编辑器:不敲命令就能切换 gamerule。
-
插件管理器:启用/禁用插件或 mod,查看详细信息。
-
内置实时地图:网页里查看游戏内地图(需在设置中开启)。
-
监控页 + 定时任务:性能监控、计划任务脚本。
-
MCP 支持:接入 Claude Code、OpenClaw 等 AI 助手辅助管理。
-
开放 API:把在线人数、TPS、版本等实时状态输出到服务器官网。
-
扩展系统:2.2.0 起支持扩展,无需改核心即可加自定义 API、面板页面、事件监听。
功能看完了,接下来就是把它装起来——整个过程四步、约四分钟。
四、安装:四步走,四分钟搞定
第 1 步:下载对应 jar 包
命名格式为 opanel-<服务端>-<游戏版本>-build-<OPanel版本>.jar。项目已迁移到 github.com/opanel-mc/opanel,官网 oPanel.cn 也有入口,另支持 Modrinth、CurseForge 和官方资源库 dist.opanel.cn。
第 2 步:拖进 plugins / mods 文件夹
Paper 系放 plugins,Forge / Fabric 系放 mods。
第 3 步:重启服务器
控制台出现下面这行,说明加载成功:
[11:11:19 INFO]: [OPanel] Web server is ready on port 3000 [11:11:19 INFO]: Done (10.775s)! For help, type "help"
第 4 步:浏览器访问面板
地址 http://<服务器IP>:3000,本地即 localhost:3000。端口默认 3000,可在配置中修改。云服务器需在防火墙/安全组放行并做端口映射。
装好之后别急着上线,有一件事必须先说清楚。
五、重点避坑:默认密钥已变更
旧说法(已过时): 首次访问密钥是 123456,之后在设置页修改。
现在的实际行为: 已移除默认 123456。首次启动会在控制台打印提示,系统自动生成一个随机访问密钥,写在 opanel/INITIAL_ACCESS_KEY.txt。用初始密钥登录后,记得把该文件删掉,之后在面板设置里改成自己的密钥。
安全提醒:
-
面板默认开在 3000 端口,不要裸奔公网——用反向代理 + HTTPS,或至少用防火墙限制来源 IP。
-
密钥泄露 ≈ 服务器控制权限泄露,务必随机、够长、定期更换。
-
面板能改存档、封玩家、执行命令——把它当 root 同等级别的入口对待。
六、项目现状与参与方式
O-Panel 2.2 已发布(最新补丁 2.2.10),功能与稳定性远超早期测试版。仓库 github.com/opanel-mc/opanel,GPL-3.0 开源,约 300+ star。官网与文档为 opanel.cn。支持语言包括简中、繁中、粤语、英语、日语、法语、德语、韩语。官方还提供 AI Agent 开发扩展的 Skill:npx skills add opanel-mc/opanel。




