Superset Fork 镜像文档

1. 镜像概述

Superset Fork 镜像是基于 Apache Superset 版本进行定制化修改的 Docker 镜像。Apache Superset 是一款现代化的企业级商业智能(BI)Web 应用，支持数据探索、可视化和交互式仪表盘创建。本 Fork 版本在保留核心功能的基础上，可能包含额外的功能增强、bug 修复或特定场景优化。

主要用途：

• 数据探索与可视化分析
• 交互式仪表盘创建与分享
• 企业级商业智能报表生成
• 多数据源整合与分析

2. 核心功能和特性

2.1 基础功能

• 丰富的数据可视化图表类型（折线图、柱状图、饼图、散点图等）
• 支持多种数据源连接（SQL、NoSQL、云存储等）
• 强大的 SQL 编辑器与查询构建器
• 交互式仪表盘与报表创建
• 用户与权限管理系统

2.2 Fork 版本可能包含的增强特性

• 额外的数据可视化插件
• 增强的权限控制功能
• 性能优化与扩展能力提升
• 自定义主题与品牌定制
• 额外的数据导出格式支持
• 特定数据源的优化适配

3. 使用场景和适用范围

适用场景

• 企业内部数据报表与分析平台
• 数据科学团队的数据探索工具
• 业务监控与实时数据仪表盘
• 跨部门数据共享与协作平台
• 客户数据可视化展示系统

适用范围

• 中小企业数据分析需求
• 大型企业部门级 BI 解决方案
• 数据科学与分析团队
• 业务监控与决策支持系统
• 教育机构数据教学与展示

4. 使用方法和配置说明

4.1 Docker Run 快速启动

bash
docker run -d \
  --name superset-fork \
  -p 8088:8088 \
  -e "SECRET_KEY=your_secret_key_here" \
  -e "SQLALCHEMY_DATABASE_URI=postgresql://user:password@db-host:5432/superset" \
  -v superset-data:/app/superset_home \
  [镜像名称]:[标签]

4.2 Docker Compose 配置示例

yaml
version: '3.8'

services:
  superset:
    image: [镜像名称]:[标签]
    container_name: superset-fork
    restart: always
    ports:
      - "8088:8088"
    environment:
      - SECRET_KEY=your_secret_key_here
      - SQLALCHEMY_DATABASE_URI=postgresql://superset:superset@db:5432/superset
      - SUPERSET_ENV=production
      - FLASK_APP=superset
      - PYTHONPATH=/app
      - GUNICORN_WORKERS=4
      - GUNICORN_TIMEOUT=120
    volumes:
      - superset-data:/app/superset_home
    depends_on:
      - db
    networks:
      - superset-network

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

networks:
  superset-network:
    driver: bridge

volumes:
  superset-data:
  postgres-data:

4.3 初始化系统

首次启动后，需要初始化管理员账户和数据库：

bash
# 进入容器
docker exec -it superset-fork /bin/bash

# 初始化数据库
superset db upgrade

# 创建管理员账户
superset fab create-admin

# 初始化角色和权限
superset init

# 加载示例数据（可选）
superset load_examples

5. 环境变量配置

6. 持久化数据

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

bash
# Superset 主目录（包含配置、缓存、日志等）
-v superset-data:/app/superset_home

# 如果使用本地数据库（不推荐生产环境）
-v superset-db:/app/superset_home/db

7. 访问和使用

7.1 访问应用

启动容器后，通过以下地址访问 Superset Web 界面：

http://[服务器IP或域名]:8088

7.2 初始登录

使用初始化时创建的管理员账户登录，或使用镜像可能预配置的默认账户：

• 默认用户名: admin
• 默认密码: admin（建议首次登录后立即修改）

8. 常见问题解决

8.1 服务启动失败

• 检查 SECRET_KEY 是否正确配置
• 验证数据库连接信息
• 查看容器日志获取详细错误信息: docker logs superset-fork

8.2 数据源连接问题

• 确保数据库网络可访问
• 检查数据库驱动是否已安装（部分数据源可能需要额外驱动）
• 验证连接凭据和权限

8.3 性能优化

• 增加 GUNICORN_WORKERS 数量（建议设置为 CPU 核心数 * 2 + 1）
• 配置外部缓存（如 Redis）
• 优化数据库查询性能和索引

9. 维护和更新

9.1 镜像更新

bash
# 拉取最新镜像
docker pull [镜像名称]:[标签]

# 停止并删除现有容器
docker stop superset-fork
docker rm superset-fork

# 使用新镜像启动
docker run ... (使用之前的启动命令)

9.2 数据库备份

bash
# 备份数据库（以 PostgreSQL 为例）
docker exec superset-db pg_dump -U superset superset > superset_backup.sql

# 恢复数据库
cat superset_backup.sql | docker exec -i superset-db psql -U superset -d superset

9.3 日志查看

bash
# 查看应用日志
docker logs -f superset-fork

# 查看特定时间段日志
docker logs --since 30m superset-fork