Docker部署Superset是最稳定省心的方式，5分钟即可访问localhost:8088；单容器适合本地试用，Docker Compose集成PostgreSQL、Redis更适生产；需设SUPERSET_SECRET_KEY、SQLALCHEMY_DATABASE_URI等关键配置，并扩展驱动支持ClickHouse等外部数据库。
用 Docker 部署 Superset 是目前最稳定、最省心的方式——不用折腾 Python 版本，不踩依赖坑，一套命令下来，5 分钟就能打开 http://localhost:8088 开始做图表。
基础部署：单容器快速启动
适合本地试用或轻量分析场景，无需额外数据库服务：
- 拉取镜像：
docker pull apache/superset:6.0.0（推荐指定版本，避免 latest 不稳定） - 运行容器：
docker run -d -p 8088:8088 --name superset -e SUPERSET_SECRET_KEY=your-secret-key -v D:\superset-data:/app/superset_home apache/superset:6.0.0 - 注意：
-v挂载的是 Superset 的工作目录，保存仪表盘、用户设置等；默认用 SQLite，数据就存在这个目录里 - 首次启动后需手动进容器初始化：
docker exec -it superset bash→ 执行superset db upgrade→superset fab create-admin→superset init
Docker Compose 部署：生产级推荐方案
自动集成 PostgreSQL（元数据）、Redis（缓存）、Superset 应用三组件，适合长期使用或团队协作：
- 准备
docker-compose.yml（可直接用官方docker-compose-non-dev.yml） - 确保已安装
docker-composev2.20+，运行：docker compose -f docker-compose-non-dev.yml up -d - 它会自动创建数据库、执行迁移、初始化管理员账号（默认 admin/admin），全程无需手动进容器
- 查看日志确认就绪：
docker logs -f superset_app，看到INFO:superset:Superset is ready即可访问
关键配置项说明
几个容易出错但必须关注的点：
- SUPERSET_SECRET_KEY：必须设置，否则容器启动失败；用于加密 cookie 和敏感字段，建议用 32 字符随机字符串
-
SQLALCHEMY_DATABASE_URI：如需换 PostgreSQL/MySQL，通过环境变量或挂载
superset_config.py修改，例如：postgresql://superset:superset@db:5432/superset -
中文支持：挂载汉化文件到
/app/superset/translations，并在配置中设LANGUAGES = {'zh': 'Chinese'}和BABEL_DEFAULT_LOCALE = 'zh' -
端口映射：8088 是 Web 界面，若被占用可在
-p中改，如-p 9090:8088
连接外部数据库（如 OceanBase / ClickHouse）
Superset 本身不内置驱动，需扩展容器环境：
- 在
requirements-local.txt中添加对应驱动，如sqlalchemy-oceanbase或clickhouse-sqlalchemy - 构建自定义镜像或修改
docker-compose.yml的build步骤，让 pip 安装生效 - 连接时选对应方言（MySQL 兼容模式连 OceanBase，ClickHouse 选 clickhouse 方言），URL 格式按文档写，例如：
clickhouse://user:pass@host:8123/default
