Linux系统Docker部署Apache Superset并实现远程访问详细流程

<think>我们正在使用Docker部署Apache Superset。根据引用，有多种方法，包括使用docker-compose和直接运行容器。 步骤： 1. 安装Docker和Docker Compose（如果还没有安装的话）。 2. 获取Superset的代码或使用官方镜像。 3. 使用docker-compose启动（推荐）或者使用docker run命令。 根据引用[1]和引用[4]，我们可以选择两种方式之一：克隆仓库并使用docker-compose，或者下载ZIP包然后使用docker-compose。 引用[2]给出了直接运行容器的方法，但注意这种方法可能需要手动初始化数据库等步骤。 为了简化部署，推荐使用docker-compose方式，因为官方提供了docker-compose.yml文件。 详细步骤： 方法一（使用docker-compose，来自引用[1]和[4]）： 1. 安装Docker和Docker Compose。 2. 克隆Superset仓库（或者下载ZIP并解压）： - 克隆：`git clone https://github.com/apache/superset.git` - 或者下载ZIP（从GitHub页面）并解压。 3. 进入解压后的目录（如果是克隆，则进入superset目录）。 4. 使用docker-compose启动（注意：这里可能需要设置环境变量，比如TAG，但默认使用最新版本）： - 在superset目录下，运行：`docker-compose -f docker-compose-non-dev.yml up -d` - 或者使用引用[1]中的命令：`docker compose up -d`（注意：新版本的Docker Compose插件使用`docker compose`命令，而旧版使用`docker-compose`） 方法二（直接运行容器，来自引用[2]）： 1. 拉取镜像：`docker pull amancevice/superset:latest` 2. 运行容器： ``` docker run -d -p 8088:8088 --name superset -v /opt/module/superset:/home/superset amancevice/superset:latest ``` 3. 然后需要初始化数据库（进入容器内执行）： ``` docker exec -it superset superset db upgrade docker exec -it superset superset init ``` 注意：方法二需要手动执行初始化命令，并且需要挂载卷以持久化数据。方法一通过docker-compose文件已经配置好了相关服务（包括数据库初始化）。 因此，推荐使用方法一，因为docker-compose方式更完整，包含了数据库（PostgreSQL）、缓存（Redis）等，并且初始化自动完成。 但是，根据引用[3]，如果不想使用最新版本，可以指定TAG。在docker-compose方式中，可以通过修改docker-compose.yml文件中的环境变量来指定版本。 步骤总结（采用docker-compose方式）： 1. 确保已安装Docker和Docker Compose（版本要求：Docker Compose版本与文件兼容，建议使用较新版本）。 2. 下载Superset源码： ``` git clone https://github.com/apache/superset.git cd superset ``` 或者从GitHub下载ZIP包并解压，然后进入目录。 3. （可选）如果需要指定版本，修改`.env`文件（如果没有则创建），设置`TAG=你要的版本`，或者修改`docker-compose-non-dev.yml`中的`x-superset-image`行（但推荐使用环境变量）。 4. 启动服务： ``` docker-compose -f docker-compose-non-dev.yml up -d ``` 或者（如果使用Docker Compose V2插件）： ``` docker compose -f docker-compose-non-dev.yml up -d ``` 5. 等待所有容器启动完成（可能需要几分钟，因为要初始化数据库和创建管理员账号等）。 6. 访问`http://localhost:8088`（默认端口8088）使用Superset。初始用户名和密码通常是admin/admin。 注意：如果端口8088已被占用，可以在docker-compose文件中修改端口映射。 另外，引用[1]提到了使用cpolar内网穿透实现公网访问，但这不是部署必须的。 问题：如何验证部署成功？ 答：访问localhost:8088，看到登录界面即成功。 如果遇到问题，可以查看日志： docker-compose -f docker-compose-non-dev.yml logs 安全提示：初始部署后，应立即更改admin用户的密码。 以上步骤参考了引用[1][2][3][4]。</think>### 在 Docker 中部署 Apache Superset 的详细步骤 #### 1. **安装 Docker 和 Docker Compose** - 确保系统已安装 Docker 和 Docker Compose（最低要求：Docker 20.10+，Compose v2.2+） - 安装命令（CentOS 示例）： ```bash sudo yum install -y docker sudo systemctl start docker sudo systemctl enable docker 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 ``` #### 2. **获取 Superset 部署文件** - **方法一（推荐）**：克隆官方仓库 ```bash git clone https://github.com/apache/superset.git cd superset ``` - **方法二**：下载 ZIP 包（适用于无 Git 环境）[^4] 访问 [Superset GitHub](https://github.com/apache/superset) → 点击 "Download ZIP" → 解压后进入目录 #### 3. **启动容器** - 使用 Docker Compose 部署（自动初始化数据库）： ```bash docker-compose -f docker-compose-non-dev.yml up -d ``` 此命令将启动以下服务： - PostgreSQL 数据库 - Redis 缓存 - Superset 应用（端口 `8088`） - Celery 任务队列 #### 4. **验证部署** - 检查容器状态： ```bash docker-compose -f docker-compose-non-dev.yml ps ``` 所有服务应为 `running` 状态 - 访问 Web 界面： ``` http://localhost:8088 ``` 初始账号：`admin`，密码：`admin` #### 5. **持久化配置（可选）** - **挂载配置文件**：编辑 `docker-compose-non-dev.yml`，在 `superset` 服务下添加卷： ```yaml volumes: - ./superset_config.py:/app/superset/superset_config.py ``` - **数据持久化**：默认已通过 Docker 卷保存数据库数据（`superset_db` 卷） #### 6. **版本管理** - 指定版本：修改 `.env` 文件中的 `TAG` 变量[^3]： ```env TAG=2.1.0 # 替换为所需版本 ``` #### 7. **常见问题处理** - **端口冲突**：修改 `docker-compose-non-dev.yml` 中的端口映射： ```yaml ports: - "9090:8088" # 主机端口:容器端口 ``` - **初始化失败**：手动执行数据库迁移： ```bash docker exec -it superset_app superset db upgrade docker exec -it superset_app superset init ``` > **关键提示**： > - 首次启动需等待 3-5 分钟完成数据库初始化 > - 生产环境务必修改默认密码 > - 建议通过 Nginx 配置 HTTPS 加密[^1] --- ### 相关问题 1. **如何配置 Superset 连接外部数据库（如 MySQL/Snowflake）？** 2. **Superset 如何实现定时数据刷新和报警功能？** 3. **在 Docker 中如何备份和恢复 Superset 的元数据？** 4. **Superset 的性能优化有哪些最佳实践？** [^1]: Linux CentOS 使用 Docker 部署 Apache Superset 并实现远程分析数据 [^2]: 使用 docker 部署 apache superset [^3]: Docker 助力：零基础极速部署 Apache Superset [^4]: Linux 系统 Docker 部署 Apache Superset 并实现远程访问详细流程