Pelican Panel 介绍与选型指南

目标：搞清 Pelican Panel 是什么（Pterodactyl 的社区分叉、当前仍为 PHP/Laravel + Filament 技术栈）、架构长什么样、功能边界在哪，并用可量化维度与 Pterodactyl、Crafty Controller、GameAP 做选型对比。本篇为认知篇，结论来自官方仓库/发布源/官网联网溯源（查询日期 2026-11-03）与本专栏部署环境的实测数据；动手部署请看本专栏 《Pelican Panel Docker Compose 部署指南》。

一、环境信息

二、软件概述

Pelican Panel 是 Pterodactyl 的社区分叉，官方仓库描述为："Free, open source game server management panel built on Laravel and Docker."（GitHub API 实查，2026-11-03）。仓库创建于 2024-03-19，正值 Pterodactyl 社区治理争议期间由社区另起炉灶，官网为 pelican.dev。

溯源要点（查询日期 2026-11-03）：

1. 技术栈没有"Go 重写"。流传的"Pelican 用 Go 重写了面板"说法与事实不符：面板本体至今仍是 PHP/Laravel 应用，本次部署实测 php artisan p:info 回显 Laravel 13.38.0、PHP 8.5.12，管理界面为 Filament v5.10.2 + Livewire v4.4.7。Go 的是 Wings——节点侧守护进程（github.com/pelican/wings），负责在游戏节点上实际拉起/管控服务器进程。
2. 真正的 Go 重写发生在 Pterodactyl 自己身上：Pterodactyl 已发布 v2.0.0-beta.2（2026-10-14），stable 线仍在 v1.15.2（2026-10-21）维护；Pelican 则走"1.0 发布候选"路线，当前最新 v1.0.0-rc.2（2026-10-22）。
3. 前端已换代。Pterodactyl 1.x 的 React/Redux 前端在 Pelican 中被 Filament（Laravel 生态管理后台框架）整体替换，登录页、后台资源页均为 Livewire 表单（本专栏部署篇实测：登录请求带服务端 HMAC 校验的快照签名）。
4. 发布节奏活跃。rc.1（2026-10-10）→ rc.2（2026-10-22）间隔 12 天；仓库最近推送 2026-11-02（GitHub API 实查），open issues 仅 9 个。
5. 许可证与 Pterodactyl 不同：Pelican Panel 为 AGPL-3.0（GitHub API 实查），Pterodactyl 为 MIT。对二次分发/闭源集成，AGPL 的网络分发条款需要评估（自托管部署无碍）。

💡 技术拓展：游戏服务器面板业界存在两类架构路线——

路线	代表	特点	取舍
控制面/数据面分离	Pterodactyl（Panel+Wings）、Pelican（Panel+Wings）、GameAP	Web 面板与节点守护进程解耦，可多节点调度、真多租户	组件多、部署重、需要 MySQL/Redis
单机一体化	Crafty Controller、auto-mcs	一个进程（或单服务）同时管 Web 与游戏进程	上手轻、资源省，但天然单节点

Pelican 属前者：面板只管控制面，游戏实例调度由节点侧 Wings（Go）执行，本篇聚焦面板本体。

三、核心架构

从官方仓库、发布说明与本专栏部署环境实测归纳：

• Web 层：Laravel 13 + Filament v5 管理面板（Packages 实测含 filament、forms、notifications、support、tables、actions、infolists、schemas、widgets），Livewire v4 驱动交互；入口由内置 Caddy 反向代理到 PHP-FPM（9000 端口），supervisord 统一托管 php-fpm、queue-worker、caddy 三进程。
• 数据层：MariaDB/MySQL（实测 DB_CONNECTION=mariadb）+ Redis（实测 CACHE_STORE/SESSION_DRIVER/QUEUE_CONNECTION 全部 redis）。
• 调度层：Laravel 调度器 + Redis 队列（实测调度心跳回显 Running ['artisan' health:queue-check-heartbeat]，含队列健康监控任务，rc.1 起新增）。
• 插件体系：/plugins 目录动态加载插件配置（/plugins/config/*.php）。因插件在运行时注册服务提供者与路由，官方显式禁用了配置缓存——实测 php artisan config:cache 回显 WARN Configuration caching has been disabled. Reason: This application uses dynamic plugins.（详解见本专栏 《Pelican Panel v1.0.0-rc.2 配置参数详解》）。
• 数据面（节点侧）：Pelican Wings（github.com/pelican/wings，Go），把每个游戏服务器跑在独立沙箱里（官方仓库描述原文："runs each game server in its own Docker container"），面板通过 Wings API（daemon 连接端口/SFTP 端口等，实测 p:node:make 参数含 --daemonListeningPort/--daemonConnectingPort/--daemonSFTPPort）与节点通信。
• 认证体系：邮箱+口令、2FA（p:user:disable2fa 实测存在）、Passkey（rc.1 changelog："Tighten passkey origin checks and log every failure"）；活动日志在模型层改为 append-only（rc.1 changelog）。

四、功能特性

按官方发布说明（rc.1/rc.2 changelog 实查）与 CLI 实测（--help 全量抓取，见本专栏 CLI 篇）归纳：

1. 用户与 RBAC：多用户、角色化管理员（rc.1："Hide activity of role-based admins from server activity logs"）、CLI 建号/删号/关 2FA（p:user:make/delete/disable2fa）。
2. 节点管理：p:node:make 一条命令登记节点（内存/磁盘/CPU 超卖比例、daemon 三端口、SFTP 别名、基础目录等 20+ 参数实测在 help 中）；p:node:configuration 可导出节点配置（yaml/json 两种格式）。
3. 服务器运维：p:server:bulk-power 对批量服务器/节点执行 start/stop/restart/kill；仪表盘电源操作触发 webhook（rc.2："Fire power webhooks for dashboard power actions"）。
4. 计划任务：p:schedule:process 处理数据库内计划任务；rc.2 修复了卡死的 schedule:run 导致任务停摆 24 小时的问题。
5. Egg 生态：p:egg:check-updates/update-index/normalize 维护游戏模板索引，支持 yaml egg 文件导入（rc.2 修复项）。
6. 插件系统：p:plugin:list/make/install/update/disable/uninstall/composer 全套 CLI（官方 Artisan 文档页实查），webhook 也改为插件体系承载（rc.1："Added plugin system for webhooks and removed discord webhooks"）。
7. 备份与存储：S3 并发分片上传（rc.1："Support for concurrent S3 part uploads"）、孤儿备份清理（p:maintenance:prune-backups）。
8. API：REST API 线格式已用测试夹具冻结并纳入 CI 校验（rc.1："Freeze the API wire format with a test fixture suite"、"Validate the generated OpenAPI specs in CI"），插件 manifest 新增 api_version 字段。
9. 运维维护：p:maintenance:prune-images（清理 Wings 节点侧残留的游戏运行时副本，每日调度自动跑）、p:maintenance:clean-service-backups、p:maintenance:fix-database-grants。

五、快速开始（官方最小形态）

官方分发形态为 Compose 编排（面板 + MariaDB + Redis 三件套）。最小可用骨架（完整逐行实测与排障见本专栏 《Pelican Panel Docker Compose 部署指南》，此处仅示意）：

services:
  database:
    image: mariadb:10.11
    environment:
      MYSQL_ROOT_PASSWORD: "q1w2e3r4"
      MYSQL_DATABASE: "panel"
      MYSQL_USER: "pelican"
      MYSQL_PASSWORD: "q1w2e3r4"
  cache:
    image: redis:alpine
  panel:
    image: ghcr.io/pelican/panel:v1.0.0-rc.2
    ports:
      - "8132:8132"
    environment:
      APP_URL: "http://192.168.1.172:8132"
      DB_CONNECTION: "mariadb"
      DB_HOST: "database"
      DB_DATABASE: "panel"
      DB_USERNAME: "pelican"
      DB_PASSWORD: "q1w2e3r4"
      CACHE_STORE: "redis"
      SESSION_DRIVER: "redis"
      QUEUE_CONNECTION: "redis"
      REDIS_HOST: "cache"
    volumes:
      - pelican-data:/pelican-data

起栈后访问 http://<主机>:8132，首次进入 /installer Web 安装向导；创建管理员并置 APP_INSTALLED=true 后，根路径跳转 /login。演示账号可用 root / q1w2e3r4（本专栏部署篇即以此实测登录闭环）。

六、适用场景与限制

适合：

• 自建 Minecraft/帕鲁等多种游戏服的多节点托管（面板 + 若干 Wings 节点横向扩展）；
• 从 Pterodactyl 迁移、或认同社区治理路线的用户（同源代码基，egg/节点概念延续）；
• 需要真多租户（面向玩家分发账号、配额、子用户）的服主社群；
• 想要现代 Filament 后台、活跃发布节奏（rc 周更级）的用户。

限制与风险（均有依据）：

1. v1.0 尚未 GA：当前为发布候选（rc.2），rc.1→rc.2 两周内仍有 15 项修复（changelog 实查），生产使用需接受滚动升级。
2. AGPL-3.0：与 Pterodactyl（MIT）不同，闭源二次分发/SaaS 集成需评估网络服务条款。
3. 插件生态刚起步：本专栏部署环境实测 php artisan p:plugin:list 回显 No plugins installed，第三方插件量级远小于 Pterodactyl 的 egg 市场。
4. 部署依赖链重：控制面需要 MariaDB + Redis，节点侧还要单独部署 Wings——单机只想跑一个 MC 服的用户用不上这套（选 Crafty Controller 类一体化面板更省）。
5. 官方文档站不稳定：实测 https://docs.pelican.dev 连接失败（curl 返回 000，2026-11-03），文档入口以 pelican.dev 与 GitHub README/官方 Artisan Commands 页为准。
6. 社区规模：2.4k star，约为 Pterodactyl（9.5k）的四分之一，第三方教程与问答存量差距明显。

七、同类选型对比

量化数据查询日期 2026-11-03（star 经 shields.io 徽章接口取数；Crafty/GameAP 数据为站内既有实测记录）：

解读与选择建议：

• 要"分叉血统 + 现代 Filament 后台 + 活跃 rc 节奏"，且能接受 AGPL 与 1.0 前夜：选 Pelican。它与 Pterodactyl 同源，egg/节点概念延续，迁移成本低，发布节奏（12 天一个 rc）明显快于 Pterodactyl stable 线。
• 要"最大生态 + 对外售卖 + 最稳的长期支持"：选 Pterodactyl。9.5k star、egg 市场断层领先；但 v2 的 Go 重写还在 beta，stable 线前端技术栈偏旧。
• 单机管一堆 MC 服、不想养 MySQL/Redis：选 Crafty Controller（站内实测四篇：《Crafty Controller 介绍与选型指南》）。
• 要 Go 单二进制轻量控制面+数据面：选 GameAP（站内实测：《GameAP 介绍与选型指南》）。

💡 说明：star 数只反映社区关注度，不等于工程质量；本组里 Pelican 与 Pterodactyl 的功能面高度同源（分叉关系），真正的分水岭在**许可证（AGPL vs MIT）、治理路线与前端技术栈（Filament vs React）**三点。

八、参考链接

• 官方仓库：https://github.com/pelican/panel
• 节点守护进程（Go）：https://github.com/pelican/wings
• 官网：https://pelican.dev
• 发布源（releases.atom）：https://github.com/pelican/panel/releases.atom
• 对比对象：Pterodactyl https://pterodactyl.io/ 、Crafty Controller https://craftycontrol.com 、GameAP https://gameap.com
• 站内相关：《Pelican Panel Docker Compose 部署指南》、《Pelican Panel v1.0.0-rc.2 配置参数详解》、《Pelican Panel v1.0.0-rc.2 常用 CLI 命令与工具详解》

（以上联网数据查询日期均为 2026-11-03；技术栈与 CLI 数据来自本专栏部署环境 2026-11-02/03 实测。）