SQLBot Docker部署完全手册：从零开始搭建智能问数平台

SQLBot作为一款基于大语言模型和RAG技术的智能问数系统，为企业提供了开箱即用的智能数据分析能力。本文将为您详细讲解如何通过Docker快速部署SQLBot智能问数平台，让您在30分钟内完成整个安装配置过程。

📦 环境准备与系统要求

在开始部署之前，请确保您的服务器满足以下基本要求：

• 操作系统: Linux (推荐Ubuntu 20.04+或CentOS 7+)
• Docker版本: Docker 20.10.0+
• 硬件配置: 最低4核CPU、8GB内存、50GB存储空间
• 网络要求: 能够访问Docker Hub镜像仓库

🚀 一键部署SQLBot

SQLBot提供了多种部署方式，其中Docker部署是最快速便捷的方法：

方法一：使用Docker Run命令

docker run -d \
  --name sqlbot \
  --restart unless-stopped \
  -p 8000:8000 \
  -p 8001:8001 \
  -v ./data/sqlbot/excel:/opt/sqlbot/data/excel \
  -v ./data/sqlbot/file:/opt/sqlbot/data/file \
  -v ./data/sqlbot/images:/opt/sqlbot/images \
  -v ./data/sqlbot/logs:/opt/sqlbot/app/logs \
  -v ./data/postgresql:/var/lib/postgresql/data \
  --privileged=true \
  dataease/sqlbot

方法二：使用Docker Compose

创建docker-compose.yml文件：

version: '3.8'
services:
  sqlbot:
    image: dataease/sqlbot
    container_name: sqlbot
    restart: always
    privileged: true
    ports:
      - 8000:8000
      - 8001:8001
    environment:
      POSTGRES_SERVER: localhost
      POSTGRES_PORT: 5432
      POSTGRES_DB: sqlbot
      POSTGRES_USER: root
      POSTGRES_PASSWORD: Password123@pg
      PROJECT_NAME: "SQLBot"
      DEFAULT_PWD: "SQLBot@123456"
    volumes:
      - ./data/sqlbot/excel:/opt/sqlbot/data/excel
      - ./data/sqlbot/file:/opt/sqlbot/data/file
      - ./data/sqlbot/images:/opt/sqlbot/images
      - ./data/sqlbot/logs:/opt/sqlbot/app/logs
      - ./data/postgresql:/var/lib/postgresql/data

然后执行：

docker-compose up -d

⚙️ 配置说明与优化建议

端口配置说明

• 8000端口: 主Web服务端口，用于访问SQLBot管理界面
• 8001端口: API服务端口，用于系统间调用和数据交互

数据持久化配置

SQLBot通过卷挂载实现数据持久化，确保以下目录得到正确配置：

• /opt/sqlbot/data/excel: Excel文件存储
• /opt/sqlbot/data/file: 通用文件存储
• /opt/sqlbot/images: 图片资源存储
• /opt/sqlbot/app/logs: 系统日志目录
• /var/lib/postgresql/data: 数据库数据目录

环境变量优化

根据实际需求调整以下环境变量：

# 数据库配置
POSTGRES_DB=sqlbot
POSTGRES_USER=your_username
POSTGRES_PASSWORD=your_strong_password

# 安全配置
SECRET_KEY=your_secure_secret_key
BACKEND_CORS_ORIGINS=http://your-domain.com

# 日志配置
LOG_LEVEL=INFO
SQL_DEBUG=False

🔍 部署验证与访问

部署完成后，通过以下步骤验证安装：

1. 检查容器状态:

docker ps -a | grep sqlbot

2. 查看日志输出:

docker logs sqlbot

3. 访问系统:

• 在浏览器打开: http://服务器IP:8000
• 默认用户名: admin
• 默认密码: SQLBot@123456

🛠️ 常见问题排查

端口冲突处理

如果8000或8001端口被占用，可以修改映射端口：

-p 8080:8000 -p 8081:8001

权限问题解决

如果遇到权限错误，确保数据目录有正确权限：

chmod -R 755 ./data

内存不足处理

如果系统内存不足，可以调整Docker内存限制或增加交换空间。

📊 性能优化建议

1. 资源分配: 为SQLBot容器分配足够的内存和CPU资源
2. 数据库优化: 配置PostgreSQL性能参数
3. 缓存配置: 启用Redis缓存提升响应速度
4. 负载均衡: 在生产环境中使用Nginx进行负载均衡

🔄 升级与维护

版本升级

docker pull dataease/sqlbot:latest
docker stop sqlbot
docker rm sqlbot
# 重新执行部署命令

数据备份

定期备份挂载的数据卷：

tar -czf sqlbot-backup-$(date +%Y%m%d).tar.gz ./data

🎯 总结

通过本文的详细指导，您应该已经成功部署了SQLBot智能问数平台。SQLBot的开箱即用特性让您能够快速搭建企业级智能数据分析系统，结合大语言模型的强大能力，为业务决策提供有力支持。

记得在首次登录后及时修改默认密码，并根据实际业务需求配置相应的数据源和模型参数。SQLBot的灵活性和易集成性使其能够适应各种复杂的业务场景，是企业数字化转型的得力助手。