快速开始

OpenDataWorks 推荐使用 Docker Compose 进行本地一键启动。本指南将帮助您在 1 分钟内跑通整个一站式智能数据工作台。

---

1. 快速启动

准备环境

确保您的系统已安装了以下基础依赖：

• Docker: 20.10+
• Docker Compose: 2.0+

一键部署运行

1. 克隆项目并进入根目录：

   git clone https://github.com/opendata-lab/opendataworks.git
   cd opendataworks

2. 准备配置文件：

   cp deploy/.env.example deploy/.env

3. 拉取镜像并启动：

   # 拉取最新的数据堆栈镜像（可选）
   docker compose -f deploy/docker-compose.dev.yml pull
   
   # 后台启动所有容器服务
   docker compose -f deploy/docker-compose.dev.yml up -d

---

2. 访问应用

服务全部启动就绪后，打开浏览器直接访问：

• 前端 Web UI: http://localhost:8081
• 后端 API: http://localhost:8080/api
• ODW MCP Server: http://localhost:8801/mcp/
• MySQL 物理库: 127.0.0.1:3316（用户 opendataworks）

数据库自动初始化

首次启动时，MySQL 容器会自动执行初始化脚本，创建 opendataworks 数据库与服务用户。后端 Spring Boot 首次加载时会自动运行 Flyway 生成表结构，无需任何手动导数操作。

---

3. 功能验证 (Smoke Test)

启动后，浏览器打开 http://localhost:8081 进入系统，并检查 http://localhost:8801/health 返回正常。

「智能查询」由独立部署的 DataAgent（opendataagent）提供。部署 DataAgent 并按仓库 deploy/README.md 的“接入 DataAgent”配置 nginx 转发后，在该模块新建会话输入 你好，请直接回复 smoke-ok。，看到流式回复即说明链路正常。

---

4. 深入阅读

如果您需要了解如何通过源码在本地启动开发环境，或者在生产环境下部署，请参考以下指南：

• 本地源码编译与生产环境部署：参见 安装部署。
• 自定义配置属性详解：参见 配置说明。