哆啦A梦

Appearance

快速开始 ​

本指南将帮助您快速安装和配置哆啦A梦，让您在几分钟内开始使用流量转发功能。

需要帮助？

📱 加入 Telegram 群组 | 🐛 GitHub Issues | 🤔 常见问题

系统要求 ​

在开始之前，请确保您的系统满足以下要求：

  • 操作系统: Linux (推荐 Ubuntu 18.04+, CentOS 7+) 或 macOS，推荐纯净系统安装
  • Docker: 20.10+
  • Docker Compose: 1.29+ 或 Docker 内置 compose 命令
  • 内存: 至少 1GB RAM
  • 存储: 至少 1GB 可用空间
  • 网络: 确保相关端口未被占用

一键安装（推荐） ​

我们提供了交互式安装脚本，会自动检测系统环境并引导您完成配置：

bash
curl -L https://github.com/bqlpfy/forward-panel/raw/refs/heads/main/panel_install.sh -o panel_install.sh && chmod +x panel_install.sh && ./panel_install.sh

安装流程说明 ​

  1. 运行脚本后选择操作：

    ===============================================
          面板管理脚本
===============================================
请选择操作：
1. 安装面板      ← 选择这个
2. 更新面板
3. 卸载面板
4. 退出
===============================================

  2. 输入配置参数：

    • 面板服务器地址: 需要节点服务器能正常访问的地址
    • 前端端口: 默认 6366
    • 后端端口: 默认 6365

  3. 自动化处理：

    • 检测 Docker 环境
    • 自动检测 IPv6 支持并选择合适的配置
    • 生成随机的数据库配置
    • 下载并启动服务

配置示例 ​

bash
当前面板服务器地址: 192.168.1.100  # 或您的公网IP
前端端口（默认 6366）: 6366         # 直接回车使用默认值
后端端口（默认 6365）: 6365         # 直接回车使用默认值

手动安装 ​

如果需要更多控制，可以手动执行以下步骤：

1. 下载项目文件 ​

bash
# 下载 docker-compose 配置（IPv4）
curl -L -o docker-compose.yml https://github.com/bqlpfy/forward-panel/raw/refs/heads/main/docker-compose-v4.yml

# 或下载 IPv6 配置
curl -L -o docker-compose.yml https://github.com/bqlpfy/forward-panel/raw/refs/heads/main/docker-compose-v6.yml

# 下载数据库初始化文件
curl -L -o gost.sql https://github.com/bqlpfy/forward-panel/raw/refs/heads/main/gost.sql

2. 创建环境配置 ​

创建 .env 文件并设置配置参数：

bash
cat > .env <<EOF
DB_NAME=your_random_db_name
DB_USER=your_random_user
DB_PASSWORD=your_random_password
JWT_SECRET=your_random_jwt_secret
SERVER_HOST=192.168.1.100:6365
FRONTEND_PORT=6366
BACKEND_PORT=6365
EOF

3. 启动服务 ​

bash
# 检查 Docker 命令
if command -v docker-compose &> /dev/null; then
    docker-compose up -d
else
    docker compose up -d
fi

验证安装 ​

1. 检查服务状态 ​

bash
# 使用 docker-compose
docker-compose ps

# 或使用 docker compose
docker compose ps

您应该看到以下服务都处于 Up 状态：

  • gost-mysql - 数据库服务
  • springboot-backend - 后端 API 服务
  • vue-frontend - 前端 Web 界面

2. 访问 Web 界面 ​

打开浏览器访问：http://your-server-ip:6366

3. 登录系统 ​

使用默认管理员账号登录：

  • 用户名: admin_user
  • 密码: admin_user

⚠️ 重要: 首次登录后请立即修改默认密码！

IPv6 支持 ​

脚本会自动检测系统的 IPv6 支持：

  • ✅ 支持 IPv6: 自动使用 IPv6 配置文件并配置 Docker IPv6 支持
  • ⚠️ 不支持 IPv6: 使用 IPv4 配置文件

Docker IPv6 配置 ​

如果检测到 IPv6 支持，脚本会自动配置：

json
{
  "ipv6": true,
  "fixed-cidr-v6": "fd00::/80"
}

端口说明 ​

端口服务说明可配置
6366Web 界面前端管理界面✅
6365API 服务后端 REST API✅
3306MySQL数据库服务（容器内部）❌
动态分配转发端口用户创建的转发规则✅

面板管理 ​

安装脚本提供了完整的生命周期管理：

更新面板 ​

bash
./panel_install.sh
# 选择 "2. 更新面板"

更新功能包括：

  • 下载最新配置文件
  • 拉取最新镜像
  • 自动执行数据库结构更新
  • 保留现有配置和数据

卸载面板 ​

bash
./panel_install.sh
# 选择 "3. 卸载面板"

⚠️ 警告: 卸载会删除所有数据，请提前备份重要信息！

获取帮助 ​

如果在安装过程中遇到问题：

  1. 💬 Telegram 群组（推荐）

  2. 🔍 故障排除

    • 查看安装日志和错误信息
    • 检查系统要求是否满足
    • 验证 Docker 和网络配置

  3. 🐛 GitHub Issues

  4. 📖 文档资源

备份建议 ​

安装完成后，建议定期备份：

bash
# 备份数据库
docker exec gost-mysql mysqldump -u $DB_USER -p$DB_PASSWORD $DB_NAME > backup_$(date +%Y%m%d).sql

# 备份配置文件
tar czf panel_backup_$(date +%Y%m%d).tar.gz .env docker-compose.yml