calagopus/panel

Calagopus Panel Docker镜像说明

镜像概述

Calagopus Panel是一款采用Rust开发的开源游戏服务器管理面板，提供单节点（Panel+Wings同主机）和多节点（Panel与Wings分离）部署选项，支持扩展功能安装，适用于个人或团队管理游戏服务器集群。

核心功能

1. 多部署模式：支持单节点快速部署和多节点分布式集群管理
2. 扩展支持：通过heavy变体镜像可安装自定义扩展插件
3. 自动备份：可选配置数据库定期自动备份功能
4. 简化配置：单节点模式自动完成Panel与Wings的连接，无需手动注册节点

使用场景

• 个人/小型团队：使用单节点（AIO）镜像快速搭建游戏服务器管理平台
• 游戏服务提供商：采用多节点模式构建高可用的游戏服务器集群
• 定制需求：选择heavy变体镜像安装扩展插件满足特殊功能需求

配置说明

前提条件

确保已安装Docker和Docker Compose，验证命令：

bash
docker --version
docker compose version

若未安装，执行以下命令安装：

bash
curl -sSL https://get.docker.com/ | CHANNEL=stable bash

选项A：单节点部署（推荐）

1. 创建目录并下载Compose文件：

bash
mkdir calagopus-panel && cd calagopus-panel
curl -o compose.yml https://raw.githubusercontent.com/calagopus/panel/refs/heads/main/compose.aio.yml

2. 创建Wings配置文件（必做）：

bash
echo 'app_name: Calagopus' > wings-config.yml

3. 设置加密密钥（必填）：

bash
RANDOM_STRING=$(cat /dev/urandom | LC_ALL=C tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)
sed -i -e "s/CHANGEME/$RANDOM_STRING/g" compose.yml

4. 启动服务：

bash
docker compose up -d

访问http://<服务器IP>:8000完成初始化设置。

选项B：多节点部署

1. 下载基础版Compose文件：

bash
mkdir calagopus-panel && cd calagopus-panel
curl -o compose.yml https://raw.githubusercontent.com/calagopus/panel/refs/heads/main/compose.yml

2. 设置加密密钥：

bash
RANDOM_STRING=$(cat /dev/urandom | LC_ALL=C tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)
sed -i -e "s/CHANGEME/$RANDOM_STRING/g" compose.yml

3. 启动Panel服务：

bash
docker compose up -d

4. 在其他节点安装Wings：参考官方Wings Docker安装文档（https://github.com/calagopus/panel/blob/main/docs/wings/installation/docker.md%EF%BC%89

镜像变体说明

独立Panel镜像

单节点（AIO）镜像