Pandora Panel

一个现代化的隧道管理面板，支持节点管理、流量监控、速度限制等功能。

快速开始 • 功能特性 • 文档 • 贡献

---

📋 目录

• 功能特性
• 快速开始
• 环境要求
• 配置说明
• 使用指南
• 故障排查
• 开发指南
• 贡献
• 许可证

---

✨ 功能特性

• 🚀 一键部署 - 使用 Docker Compose 快速部署
• 🔐 用户管理 - 支持多用户、角色权限控制
• 🌐 节点管理 - 多节点支持，实时状态监控
• 🔄 隧道管理 - 灵活的隧道配置和管理
• 📊 流量监控 - 实时流量统计和可视化
• ⚡ 速度限制 - 灵活的带宽控制
• 🔌 WebSocket - 实时通信，节点状态同步
• 📱 响应式设计 - 支持桌面和移动端

---

🚀 快速开始

一键部署（推荐）

只需三步，即可完成部署：

# 1. 下载配置文件
curl -O https://raw.githubusercontent.com/hi1king/Pandora-panel/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/hi1king/Pandora-panel/main/.env.example

# 2. 创建环境变量文件
cp .env.example .env

# 3. 启动服务
docker-compose up -d

访问应用

部署完成后，访问以下地址：

• 前端界面: http://your-server-ip:6366
• 后端 API: http://your-server-ip:6365
• API 文档: http://your-server-ip:6365/swagger/index.html

默认管理员账号:

• 用户名: admin_user
• 密码: admin_user

⚠️ 安全提示: 首次登录后请立即修改默认密码！

---

📦 环境要求

最低配置

• 操作系统: Linux / macOS / Windows
• Docker: 20.10+
• Docker Compose: 2.0+
• 内存: 128MB+
• 磁盘: 500MB

推荐配置

• 内存: 1GB+
• 磁盘: 1GB+
• CPU: 1 核+

安装 Docker

如果还没有安装 Docker，请参考以下命令：

Linux (Ubuntu/Debian)

curl -fsSL https://get.docker.com | sh
sudo systemctl start docker
sudo systemctl enable docker

安装 Docker Compose

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

---

⚙️ 配置说明

环境变量

编辑 .env 文件进行配置：

# 端口配置
BACKEND_PORT=6365      # 后端服务端口
FRONTEND_PORT=6366     # 前端服务端口

# 安全配置（生产环境必须修改！）
JWT_SECRET=your-random-secret-key-here

# 时区配置
TZ=Asia/Shanghai

生成安全的 JWT 密钥

# Linux/macOS
openssl rand -base64 32

# 或使用在线工具
# https://www.random.org/strings/

自定义端口

如果默认端口被占用，可以修改 .env 文件：

BACKEND_PORT=8080      # 修改为其他端口
FRONTEND_PORT=8081     # 修改为其他端口

---

📖 使用指南

服务管理

# 启动所有服务
docker-compose up -d

# 停止所有服务
docker-compose down

# 重启服务
docker-compose restart

# 查看服务状态
docker-compose ps

# 查看实时日志
docker-compose logs -f

# 查看特定服务日志
docker-compose logs -f backend
docker-compose logs -f frontend

更新服务

# 拉取最新镜像
docker-compose pull

# 重新创建并启动容器
docker-compose up -d --force-recreate

数据备份

# 备份数据库和日志
tar -czf pandora-backup-$(date +%Y%m%d-%H%M%S).tar.gz ./data ./logs

# 恢复数据
tar -xzf pandora-backup-YYYYMMDD-HHMMSS.tar.gz

清理数据

# 停止并删除所有容器、网络
docker-compose down

# 删除数据（危险操作！会丢失所有数据）
rm -rf ./data ./logs

---

🔍 故障排查

服务无法启动

检查端口占用:

# Linux/macOS
netstat -tulpn | grep 6365
netstat -tulpn | grep 6366

# Windows
netstat -ano | findstr "6365"
netstat -ano | findstr "6366"

查看详细日志:

docker-compose logs backend
docker-compose logs frontend

健康检查失败

进入容器检查:

# 进入后端容器
docker-compose exec backend sh

# 手动测试健康检查
wget -q -O- http://localhost:6365/flow/test

无法访问前端

1. 检查防火墙规则
2. 确认端口映射正确
3. 查看 frontend 日志

# 检查容器状态
docker-compose ps

# 查看前端日志
docker-compose logs frontend

数据库错误

# 检查数据目录权限
ls -la ./data

# 如果权限不正确，修复权限
sudo chown -R 1000:1000 ./data

---

📊 技术栈

后端

• 语言: Go 1.25
• 框架: Gin
• 数据库: SQLite
• WebSocket: Gorilla WebSocket
• 文档: Swagger

前端

• 框架: Vue 3
• 构建工具: Vite
• UI 库: Element Plus
• 状态管理: Pinia
• 路由: Vue Router

部署

• 容器化: Docker
• 编排: Docker Compose
• CI/CD: GitHub Actions

---

🤝 贡献

欢迎贡献代码！请遵循以下步骤：

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

代码规范

• Go 代码遵循 gofmt 格式
• 前端代码遵循 ESLint 规则
• 提交信息遵循 Conventional Commits

---

📝 更新日志

v1.0.1 (2026-01-23)

• ✨ 添加 WebSocket 心跳机制
• 🐛 修复节点状态同步问题
• ⚡ 优化数据库批量更新性能
• 🔒 增强 WebSocket 并发安全

---

🙏 致谢

Pandora Panel 基于 flux-panel 开发，感谢所有贡献者的支持！

---

📞 联系方式

• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

如果这个项目对你有帮助，请给一个 ⭐ Star！

Made with ❤️ by Pandora Panel Team