Skip to content
animesao Logo
ANIMESAO
RU / EN
Активная разработка · v0.6.x v0.6.7

Cardinal Panel

Панель управления серверами и хостингом на Cardinal

Полнофункциональная веб-панель управления игровыми серверами и контейнерами на базе Nuxt 4, Vue 3, Drizzle ORM (SQLite / MySQL) и WebSocket-консоли, взаимодействующая с нодами через Cardinal Wings.

Исходный код на GitHub

Обзор проекта

Cardinal Panel — это современная графическая панель управления серверами (включая Minecraft Paper, Fabric, BungeeCord, Discord-ботов и кастомные приложения), работающая поверх рантайма Cardinal через агент Cardinal Wings.

Панель не взаимодействует с контейнерами хоста напрямую: управление происходит централизованно через REST API демона wings. Каждый сервер идентифицируется стабильным именем `srv-<uuid>`, что гарантирует сохранность данных и отсутствие привязки к случайным системным ID.

Стек реализации: Nuxt 4, Vue 3, TypeScript, Tailwind CSS, Drizzle ORM (поддержка SQLite из коробки и MySQL), WebSocket для интерактивной консоли, Monaco Editor для редактирования файлов конфигурации и двухфакторная аутентификация (2FA).

Архитектура и взаимодействие

Браузер ──► Cardinal Panel (Nuxt, :3000) ──► Wings-нода (:8080) ──► Cardinal serve ──► Контейнер. Все консольные сессии, файлы и бэкапы изолированы и проходят через авторизованный API.

Пример использования: 
curl -fsSL https://raw.githubusercontent.com/animesao/cardinal-panel/main/install.sh | sudo bash

Возможности и статус функций

WebSocket консоль в реальном времениРеализовано

Интерактивный ввод команд и отображение цветных ANSI-логов через xterm/ansi-to-html

Файловый менеджер и Monaco EditorРеализовано

Управление файлами сервера, подсветка синтаксиса и безопасный SFTP

Детерминированная адресация серверовРеализовано

Именование `srv-<uuid>`, сохраняющее конфигурацию при переустановке

Управление несколькими нодамиРеализовано

Подключение и мониторинг нескольких узлов Cardinal Wings через API

Технологии и примитивы:
Nuxt 4Vue 3TypeScriptTailwind CSSDrizzle ORMSQLiteMySQLWebSocketMonaco Editor
Сайт animesao.work.gd · MIT

MIT LicensePermissive

Исходный код сайта animesao.work.gd (Nuxt 4, Vue 3, Tailwind CSS 4), архитектурные схемы и инженерные заметки полностью открыты под лицензией MIT. Разрешено коммерческое и частное использование, модификация и адаптация при сохранении уведомления об авторстве.

Разрешено
  • ✓Коммерческое использование
  • ✓Модификация кода и стилей
  • ✓Распространение
  • ✓Частное использование
Ограничения
  • ✕Ограничение ответственности
  • ✕Отсутствие гарантий
Условия
  • ℹСохранение уведомления об авторских правах (c) 2026 animesao
Официальный текст лицензииSPDX: MIT
MIT License

Copyright (c) 2026 animesao

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.