lukasdotcom/fantasy-manager

fantasy-manager Docker 镜像文档

1. 镜像概述和主要用途

fantasy-manager 是一个基于 Docker 容器化的应用程序，旨在提供幻想体育联赛（或类似幻想类游戏）的管理功能。该镜像封装了完整的应用运行环境，简化了部署和维护流程，使用户能够快速搭建和管理自己的幻想联赛平台。

2. 核心功能和特性

• 联赛创建与管理：支持创建多种类型的幻想联赛，自定义规则和设置
• 球员管理：提供球员数据库维护、状态更新和统计数据跟踪
• 交易系统：实现玩家之间的球员交易功能，包括提案、审批流程
• 数据统计：自动计算和展示各类统计数据，支持自定义报表生成
• 用户权限管理：基于角色的访问控制，确保系统安全
• RESTful API：提供完整的 API 接口，支持第三方集成和扩展

3. 使用场景和适用范围

• 小型到中型幻想体育联赛的管理
• 游戏社区自建幻想联赛平台
• 体育相关网站添加幻想联赛功能模块
• 教育和培训环境中的模拟管理系统
• 个人爱好者搭建私人幻想联赛

4. 使用方法和配置说明

4.1 基本要求

• Docker Engine 19.03+
• Docker Compose 1.25+ (推荐)
• 至少 1GB 可用内存
• 持久化存储需求：至少 100MB (不含数据库)

4.2 快速启动

使用 docker run 命令

bash
# 基本启动命令
docker run -d \
  --name fantasy-manager \
  -p 8080:8080 \
  -e DATABASE_URL=sqlite:///data/fantasy.db \
  -v fantasy-data:/app/data \
  lukasdotcom/fantasy-manager:latest

使用 docker-compose

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  fantasy-manager:
    image: lukasdotcom/fantasy-manager:latest
    container_name: fantasy-manager
    restart: always
    ports:
      - "8080:8080"
    environment:
      - DATABASE_URL=postgres://user:password@db:5432/fantasy
      - SECRET_KEY=your_secure_secret_key
      - ADMIN_EMAIL=admin@example.com
      - ADMIN_PASSWORD=secure_admin_password
      - LOG_LEVEL=info
    volumes:
      - fantasy-data:/app/data
    depends_on:
      - db
    networks:
      - fantasy-network

  db:
    image: postgres:13
    container_name: fantasy-db
    restart: always
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=fantasy
    volumes:
      - postgres-data:/var/lib/postgresql/data
    networks:
      - fantasy-network

networks:
  fantasy-network:
    driver: bridge

volumes:
  fantasy-data:
  postgres-data:

启动服务：

bash
docker-compose up -d

4.3 环境变量配置

4.4 持久化数据

为确保数据持久化，建议挂载以下卷：

• /app/data: 应用数据存储目录
• /app/config: 配置文件目录（如需自定义配置）
• /app/logs: 日志文件目录

5. 高级配置

5.1 自定义配置文件

创建自定义配置文件 config.yaml：

yaml
app:
  name: "My Fantasy League"
  description: "Custom fantasy league platform"
  timezone: "America/New_York"
  
database:
  connection_pool_size: 10
  migration: true
  
security:
  password_policy:
    min_length: 10
    require_upper: true
    require_lower: true
    require_number: true
    require_special: true
    
features:
  enable_trades: true
  enable_waivers: true
  enable_playoffs: true

挂载自定义配置文件：

bash
docker run -d \
  --name fantasy-manager \
  -p 8080:8080 \
  -v ./config.yaml:/app/config/config.yaml \
  -v fantasy-data:/app/data \
  lukasdotcom/fantasy-manager:latest

5.2 数据库配置

支持多种数据库后端：

SQLite (默认)

DATABASE_URL=sqlite:///data/fantasy.db

PostgreSQL

DATABASE_URL=postgres://user:password@host:port/database

MySQL/MariaDB

DATABASE_URL=mysql://user:password@host:port/database

6. 维护与更新

6.1 查看日志

bash
docker logs -f fantasy-manager

6.2 升级镜像

bash
# 使用 docker run 方式
docker stop fantasy-manager
docker rm fantasy-manager
docker pull lukasdotcom/fantasy-manager:latest
# 然后重新运行启动命令

# 使用 docker-compose 方式
docker-compose pull
docker-compose up -d

6.3 数据备份

bash
# 备份数据卷
docker run --rm -v fantasy-data:/source -v $(pwd):/backup alpine \
  tar -czf /backup/fantasy-data-backup.tar.gz -C /source .

7. 故障排除

• 无法访问应用：检查端口映射是否正确，容器是否正常运行
• 数据库连接错误：验证数据库URL配置，确保数据库服务可用
• 权限问题：检查挂载卷的权限设置，确保容器有读写权限
• 启动失败：查看容器日志获取详细错误信息 docker logs fantasy-manager

8. 更多信息

完整文档和源代码请访问 GitHub 仓库： https://github.com/Lukasdotcom/fantasy-manager

如有问题或需要支持，请在 GitHub 仓库提交 issue。