拓冰网站定制 
Spring AI Alibaba DataAgent生产部署完整指南Docker Compose一键部署、多模型调度与安全加固【免费下载链接】DataAgentSpring AI Alibaba DataAgent项目地址: https://gitcode.com/gh_mirrors/da/DataAgentSpring AI Alibaba DataAgent 是一款基于 Spring AI Alibaba 构建的企业级智能数据分析师支持 Text-to-SQL、Python 深度分析与智能报告生成。本文带你完成 DataAgent 生产环境部署通过 Docker Compose 一键拉起前后端与数据库配置多模型调度并落实 API Key 与 Python 沙盒安全加固让 NL2SQL 智能体稳定运行在你的服务器上。一、部署前的架构速览DataAgent 由三个核心部分组成Nuxt 前端、Spring Boot 后端和 MySQL 管理库。后端内置模型注册表可在运行时动态切换不同的 LLM 与 Embedding 模型并兼容所有 OpenAI 接口规范的模型服务如 Qwen、DeepSeek、Ollama 自建网关。 完整分层架构与工作流设计可参考 docs/ARCHITECTURE.md。二、Docker Compose 一键部署步骤项目已内置完整的生产部署文件位于 docker-file/ 目录无需自己写镜像。1. 理解服务编排核心编排文件 docker-file/docker-compose.yml 定义了 5 个服务服务镜像/构建作用端口mysqlmysql:8.0管理库nl2sql_db仅内网backend本地构建后端 API8065frontend本地构建Nginx 前端3000mysql-datamysql:8.0示例业务数据源仅内网postgres-datapostgres:15示例业务数据源仅内网几个值得注意的设计构建流程自动化docker-file/Dockerfile-backend 采用多阶段构建先在 Temurin 17 容器中mvn install打包最终镜像只包含一个app.jardocker-file/Dockerfile-frontend 则用 Node 构建 Nuxt 产物交由 Nginx 托管。健康检查保障启动顺序后端通过depends_oncondition: service_healthy确保两个数据库就绪后才启动避免数据库还没起来应用先崩的经典故障。Nginx 反代 SSE 流式接口docker-file/config/nginx.conf 关闭了proxy_buffering和gzip并设置proxy_read_timeout 24h这正是 AI 流式输出SSE能实时刷新的关键。2. 执行部署命令# 克隆仓库 git clone https://gitcode.com/gh_mirrors/da/DataAgent # 配置大模型 API Key以阿里云百炼为例 export AI_DASHSCOPE_API_KEYsk-xxxxxxxx # 一键启动全部服务 docker compose -f docker-file/docker-compose.yml up -d --build构建完成后前端访问http://你的服务器IP:3000后端 APIhttp://你的服务器IP:8065如果只需要单独的示例数据源MySQL 13306 / PostgreSQL 15432还可以用 docker-file/docker-compose-datasource.yml 独立拉起其中预置了docker-file/config/mysql/product_db.sql等模拟业务数据方便验证分析效果。3. 关键环境变量速查变量说明AI_DASHSCOPE_API_KEY大模型服务 API Key必填DATA_AGENT_DATASOURCE_URL管理库 JDBC 连接串DATA_AGENT_DATASOURCE_USERNAME/_PASSWORD管理库账号密码DATA_AGENT_DATASOURCE_SQL_INIT设为always时自动初始化表结构与示例数据DATAAGENT_SANDBOX_IMAGEPython 沙盒基础镜像生产建议固定 digestDATAAGENT_PYPI_INDEX_URLPython 包索引地址生产建议指向私有代理⚠️ Compose 文件中的 root/root 密码仅适合快速验证生产环境请务必修改数据库密码并通过环境变量注入不要写入镜像。三、多模型调度一次接入随时切换DataAgent 内置模型注册表AiModelRegistry.java支持在界面上管理多个 LLM 和 Embedding 模型并按智能体绑定不同模型。1. 在界面上新增模型登录后进入「模型配置」页面点击新增模型两种接入方式标准提供商如 OpenAI、DeepSeek、Qwen 等只需填写模型名称 API Key。自建/本地模型Ollama、企业网关由于系统基于 Spring AI 架构只要你的网关符合 OpenAI 接口协议填写base-url和completions-path即可系统会拼接成http://host:port/v1/chat/completions这样的完整调用地址。前端调用入口见 />需要特别留意当前版本提供了 Key 管理能力但后端尚未默认开启X-API-Key鉴权校验。如需对外开放 API请按 docs/ADVANCED_FEATURES.md 的说明在后端拦截器中补充校验逻辑后再暴露端口。2. 收紧 Python 沙盒DataAgent 的 Python 深度分析在 Spring AI Alibaba Sandbox 的任务级容器中执行默认即限制 CPU、内存、超时与并发。生产环境还应做到固定镜像 digest将DATAAGENT_SANDBOX_IMAGE从latest标签改为固定 digest并在镜像内使用非 root 用户。只走私有 PyPI 代理设置DATAAGENT_PYPI_INDEX_URL指向企业代理禁止沙盒直连公网并在代理侧做恶意包与 CVE 扫描。零凭据注入不向沙盒传入数据库、模型、OSS 或 Docker 凭据。完整配置与故障排查表见 docs/ADVANCED_FEATURES.md 的「Python 执行环境配置」章节。3. 网络与端口最小化Compose 中管理库与示例数据源均未映射宿主机端口仅通过内网data-agent-network通信。对外只暴露 3000Nginx与 8065API。建议再套一层防火墙/网关8065 只放行内网或加鉴权。前端 Nginx 已配置 SSE 专用类型与转发头X-Forwarded-For等置于反向代理之后时注意保留proxy_buffering off。4. 凭据与初始化配置所有密码、API Key 一律走环境变量或外部配置后端镜像启动时优先读取/app/config/application.yml外部配置见 docker-file/Dockerfile-backend 的ENTRYPOINT方便不重建镜像即可调整。生产库的表结构导入方式参考 docs/QUICK_START.mdSQL 文件位于data-agent-management/src/main/resources/sql/。五、部署验证清单上线后建议按此顺序自检docker compose -f docker-file/docker-compose.yml ps— 5 个容器全部 healthy/running。浏览器打开 3000 端口能看到智能体列表页。创建智能体 → 绑定数据源 → 验证连接 → 初始化数据源参考 docs/QUICK_START.md 第 5 节。提交一个 SQL 分析问题确认流式报告正常输出。提交一个包含 Python 步骤的问题确认沙盒执行成功且执行完docker ps无dataagent-sandbox-*残留容器。用 Postman 测试模型 API 连通性排查模型调用失败问题。六、延伸阅读快速开始与环境要求docs/QUICK_START.md架构设计与工作流docs/ARCHITECTURE.mdAPI Key、MCP 与沙盒高级配置docs/ADVANCED_FEATURES.md知识配置语义模型/业务知识最佳实践docs/KNOWLEDGE_USAGE.md开发者指南向量库、模型依赖等扩展docs/DEVELOPER_GUIDE.md掌握以上三步——Compose 一键部署、多模型灵活调度、沙盒与凭据加固——你的 DataAgent 就可以在生产环境稳定对外提供数据洞察服务了。【免费下载链接】DataAgentSpring AI Alibaba DataAgent项目地址: https://gitcode.com/gh_mirrors/da/DataAgent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Spring AI Alibaba DataAgent生产部署完整指南：Docker Compose一键部署、多模型调度与安全加固
Spring AI Alibaba DataAgent生产部署完整指南Docker Compose一键部署、多模型调度与安全加固【免费下载链接】DataAgentSpring AI Alibaba DataAgent项目地址: https://gitcode.com/gh_mirrors/da/DataAgentSpring AI Alibaba DataAgent 是一款基于 Spring AI Alibaba 构建的企业级智能数据分析师支持 Text-to-SQL、Python 深度分析与智能报告生成。本文带你完成 DataAgent 生产环境部署通过 Docker Compose 一键拉起前后端与数据库配置多模型调度并落实 API Key 与 Python 沙盒安全加固让 NL2SQL 智能体稳定运行在你的服务器上。一、部署前的架构速览DataAgent 由三个核心部分组成Nuxt 前端、Spring Boot 后端和 MySQL 管理库。后端内置模型注册表可在运行时动态切换不同的 LLM 与 Embedding 模型并兼容所有 OpenAI 接口规范的模型服务如 Qwen、DeepSeek、Ollama 自建网关。 完整分层架构与工作流设计可参考 docs/ARCHITECTURE.md。二、Docker Compose 一键部署步骤项目已内置完整的生产部署文件位于 docker-file/ 目录无需自己写镜像。1. 理解服务编排核心编排文件 docker-file/docker-compose.yml 定义了 5 个服务服务镜像/构建作用端口mysqlmysql:8.0管理库nl2sql_db仅内网backend本地构建后端 API8065frontend本地构建Nginx 前端3000mysql-datamysql:8.0示例业务数据源仅内网postgres-datapostgres:15示例业务数据源仅内网几个值得注意的设计构建流程自动化docker-file/Dockerfile-backend 采用多阶段构建先在 Temurin 17 容器中mvn install打包最终镜像只包含一个app.jardocker-file/Dockerfile-frontend 则用 Node 构建 Nuxt 产物交由 Nginx 托管。健康检查保障启动顺序后端通过depends_oncondition: service_healthy确保两个数据库就绪后才启动避免数据库还没起来应用先崩的经典故障。Nginx 反代 SSE 流式接口docker-file/config/nginx.conf 关闭了proxy_buffering和gzip并设置proxy_read_timeout 24h这正是 AI 流式输出SSE能实时刷新的关键。2. 执行部署命令# 克隆仓库 git clone https://gitcode.com/gh_mirrors/da/DataAgent # 配置大模型 API Key以阿里云百炼为例 export AI_DASHSCOPE_API_KEYsk-xxxxxxxx # 一键启动全部服务 docker compose -f docker-file/docker-compose.yml up -d --build构建完成后前端访问http://你的服务器IP:3000后端 APIhttp://你的服务器IP:8065如果只需要单独的示例数据源MySQL 13306 / PostgreSQL 15432还可以用 docker-file/docker-compose-datasource.yml 独立拉起其中预置了docker-file/config/mysql/product_db.sql等模拟业务数据方便验证分析效果。3. 关键环境变量速查变量说明AI_DASHSCOPE_API_KEY大模型服务 API Key必填DATA_AGENT_DATASOURCE_URL管理库 JDBC 连接串DATA_AGENT_DATASOURCE_USERNAME/_PASSWORD管理库账号密码DATA_AGENT_DATASOURCE_SQL_INIT设为always时自动初始化表结构与示例数据DATAAGENT_SANDBOX_IMAGEPython 沙盒基础镜像生产建议固定 digestDATAAGENT_PYPI_INDEX_URLPython 包索引地址生产建议指向私有代理⚠️ Compose 文件中的 root/root 密码仅适合快速验证生产环境请务必修改数据库密码并通过环境变量注入不要写入镜像。三、多模型调度一次接入随时切换DataAgent 内置模型注册表AiModelRegistry.java支持在界面上管理多个 LLM 和 Embedding 模型并按智能体绑定不同模型。1. 在界面上新增模型登录后进入「模型配置」页面点击新增模型两种接入方式标准提供商如 OpenAI、DeepSeek、Qwen 等只需填写模型名称 API Key。自建/本地模型Ollama、企业网关由于系统基于 Spring AI 架构只要你的网关符合 OpenAI 接口协议填写base-url和completions-path即可系统会拼接成http://host:port/v1/chat/completions这样的完整调用地址。前端调用入口见 />需要特别留意当前版本提供了 Key 管理能力但后端尚未默认开启X-API-Key鉴权校验。如需对外开放 API请按 docs/ADVANCED_FEATURES.md 的说明在后端拦截器中补充校验逻辑后再暴露端口。2. 收紧 Python 沙盒DataAgent 的 Python 深度分析在 Spring AI Alibaba Sandbox 的任务级容器中执行默认即限制 CPU、内存、超时与并发。生产环境还应做到固定镜像 digest将DATAAGENT_SANDBOX_IMAGE从latest标签改为固定 digest并在镜像内使用非 root 用户。只走私有 PyPI 代理设置DATAAGENT_PYPI_INDEX_URL指向企业代理禁止沙盒直连公网并在代理侧做恶意包与 CVE 扫描。零凭据注入不向沙盒传入数据库、模型、OSS 或 Docker 凭据。完整配置与故障排查表见 docs/ADVANCED_FEATURES.md 的「Python 执行环境配置」章节。3. 网络与端口最小化Compose 中管理库与示例数据源均未映射宿主机端口仅通过内网data-agent-network通信。对外只暴露 3000Nginx与 8065API。建议再套一层防火墙/网关8065 只放行内网或加鉴权。前端 Nginx 已配置 SSE 专用类型与转发头X-Forwarded-For等置于反向代理之后时注意保留proxy_buffering off。4. 凭据与初始化配置所有密码、API Key 一律走环境变量或外部配置后端镜像启动时优先读取/app/config/application.yml外部配置见 docker-file/Dockerfile-backend 的ENTRYPOINT方便不重建镜像即可调整。生产库的表结构导入方式参考 docs/QUICK_START.mdSQL 文件位于data-agent-management/src/main/resources/sql/。五、部署验证清单上线后建议按此顺序自检docker compose -f docker-file/docker-compose.yml ps— 5 个容器全部 healthy/running。浏览器打开 3000 端口能看到智能体列表页。创建智能体 → 绑定数据源 → 验证连接 → 初始化数据源参考 docs/QUICK_START.md 第 5 节。提交一个 SQL 分析问题确认流式报告正常输出。提交一个包含 Python 步骤的问题确认沙盒执行成功且执行完docker ps无dataagent-sandbox-*残留容器。用 Postman 测试模型 API 连通性排查模型调用失败问题。六、延伸阅读快速开始与环境要求docs/QUICK_START.md架构设计与工作流docs/ARCHITECTURE.mdAPI Key、MCP 与沙盒高级配置docs/ADVANCED_FEATURES.md知识配置语义模型/业务知识最佳实践docs/KNOWLEDGE_USAGE.md开发者指南向量库、模型依赖等扩展docs/DEVELOPER_GUIDE.md掌握以上三步——Compose 一键部署、多模型灵活调度、沙盒与凭据加固——你的 DataAgent 就可以在生产环境稳定对外提供数据洞察服务了。【免费下载链接】DataAgentSpring AI Alibaba DataAgent项目地址: https://gitcode.com/gh_mirrors/da/DataAgent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考