单机版部署

🚀 AskTable 单机版现已支持免费下载、安装和使用。

💪 这篇指南将帮助您在本地环境快速部署 AskTable，并结合自己的内部数据来使用～

继续下载、安装和使用 AskTable 即表示您已阅读并同意《软件下载安装及使用协议》。

前提条件

硬件

最低配置要求：2核CPU、4G内存、10G硬盘。支持 x86 和 ARM 两种架构,部分国产系统如麒麟V10SP1需在各个容器中添加privileged: true获取最高权限⚠️

操作系统

Linux 系统 需要安装以下软件：
1. Docker：Docker 安装文档。
2. Docker Compose：用来打包部署 AskTable 和 MySQL 数据库。Docker Compose 安装文档。
macOS 系统 需要安装以下软件：
1. Docker Desktop：是 macOS 桌面电脑上的应用程序，包含 Docker 和 Docker Compose。安装文档。

快速部署

将以下内容保存为 docker-compose.yml 文件：

services:
  asktable:
    # AskTable
    image: registry.cn-shanghai.aliyuncs.com/datamini/asktable-all-in-one:latest  # 中国大陆地区
    # image: datamini/asktable-all-in-one:latest   # 其他地区
    privileged: true
    container_name: asktable
    depends_on:
      - asktable_mysql
    ports:
      - 8000:80
    environment:
      TZ: Asia/Shanghai
      BASE_URL: http://127.0.0.1:8000          # 【须修改】容器对外暴露的地址（即从外部比如浏览器访问的地址）
      LLM_API_KEY: your_api_key_here           # 【须修改】AI 模型令牌，是以“asktable-”开头的字符串。登录 AskTable(https://cloud.asktable.com/?dialog=deployment) 获取。
      MYSQL_HOST: asktable_mysql               # MySQL 数据库地址（该 MySQL 是 AskTable 数据库，并不是希望利用 AskTable 去查询的数据库，后者需要在 Web 页面上添加）
      MYSQL_USER: asktable                     # MySQL 数据库用户名
      MYSQL_PASSWORD: asktable                 # MySQL 数据库密码
      MYSQL_DB: asktable                       # MySQL 数据库名称
      MYSQL_ROOT_PASSWORD: asktable            # 用于初始化示例数据
      VDB_ADDRESS: http://asktable_vdb:6333    # 向量数据库地址
      VDB_API_KEY: asktable                    # 向量数据库 API KEY
    volumes:
      - ./asktable_data:/asktable
  
  asktable_mysql:
    image: registry.cn-shanghai.aliyuncs.com/dminfra/mysql:8.0.27  # 中国大陆地区
    # image: mysql:8.0.27   # 其他地区
    privileged: true
    container_name: asktable_mysql
    ports:
      - "3306:3306"
    environment:
      TZ: Asia/Shanghai
      MYSQL_ROOT_PASSWORD: asktable
      MYSQL_DATABASE: asktable
      MYSQL_USER: asktable
      MYSQL_PASSWORD: asktable
    volumes:
      - ./mysql_data:/var/lib/mysql

  asktable_vdb:
    image: registry.cn-shanghai.aliyuncs.com/dminfra/qdrant:v1.11.5
    privileged: true
    container_name: asktable_vdb
    ports:
      - "6333:6333"
      - "6334:6334"
    environment:
      RUN_MODE: production
      TZ: Asia/Shanghai
      QDRANT__SERVICE__API_KEY: asktable
    volumes:
      - ./qdrant_storage:/qdrant/storage
      - ./qdrant_snapshots:/qdrant/snapshots
      

注意，BASE_URL和LLM_API_KEY这两个配置项必须按照实际情况修改。

其中，LLM_API_KEY是登录 https://cloud.asktable.com 后，点击上方「私有部署 AskTable」，在打开的页面中获取，如下图所示。

运行 AskTable

配置完成后，就可以通过 Docker Compose 来启动 AskTable 了：

构建并启动容器

在 docker-compose.yml 文件所在目录下，运行以下命令：

docker compose up -d
# 或者 docker-compose up -d

这条命令会在后台启动 AskTable 应用和 MySQL 数据库容器。

访问 AskTable

现在，AskTable 已经启动，您可以在浏览器中访问：

http://127.0.0.1:8000

在这里，您可以使用默认管理员（账号为 admin@asktable.com，密码为 admin）登录，并开始探索应用。

探索 AskTable

登录后，您可以开始使用 AskTable 进行各种任务，例如：

数据管理：创建、管理和查询数据源。
与 AskTable AI 互动：利用语言模型对您的数据进行查询和分析。
自定义业务知识：根据需要配置术语库、训练数据集和默认偏好，以适应您的业务场景。

高级配置（可选）

设置管理员账号：如果您希望设置管理员账号，您可以配置以下参数：
```
AUTH_EMAIL_INIT_ADMIN_EMAIL: admin@asktable.com
AUTH_EMAIL_INIT_ADMIN_PASSWORD: admin
```
使用本地 LLM 模型：如果您想使用本地的模型，假设已经部署了模型推理服务，则可以配置以下参数：

警告
使用非 AskTable 官方提供的模型可能无法保证效果，建议在 https://cloud.asktable.com 申请。
```
LLM_BASE_URL: http://10.10.0.3:11434/v1  # 本地LLM 服务地址
LLM_API_KEY: your_api_key_here  # 本地LLM 服务的 API Key（如果无密钥认证，则无需配置）
AT_FORCE_LLM_MODEL: Qwen2.5-72B-Instruct-128K  # 强制使用的模型名字
```
需注意，本地模型我们推荐满血版DeepSeek-V3-671B，其他模型则须同时满足以下条件：
- 至少 72B
- 至少 64K 上下文
- 支持 Function Call
- 支持 JSON（Instruct） Output
其他额外性能要求：
- 每次 AI 问数，大概有 2-4 次 LLM 大模型并发调用
- 每次 AI 问数，大概需要 5000 Input Tokens 和 500 Output Tokens。
本地 LLM 服务检测脚本
我们已为您准备了检测脚本，方便在服务器上快速验证本地 LLM 是否符合要求。请在服务器终端执行以下命令（记得将 YOUR_BASE_URL 和 YOUR_API_KEY 替换为您实际的模型服务地址和密钥）：
curl -O https://asktable-assets.oss-rg-china-mainland.aliyuncs.com/llm-env-test/asktable_llm_check.py && python3 asktable_llm_check.py --base-url YOUR_BASE_URL --api-key YOUR_API_KEY
若检测通过，即可无缝对接 AskTable。

更新版本

若需更新到最新版本，请在 docker-compose.yml 文件所在目录下，执行以下命令：

docker compose pull
docker compose down
docker compose up -d

常见问题

Docker 运行失败，提示网络错误，如何解决？

需要确保防火墙允许访问如下地址（端口 443）：
- registry.cn-shanghai.aliyuncs.com (下载镜像)
- dockerauth.cn-hangzhou.aliyuncs.com (下载镜像)
- aiproxy.asktable.com (访问 AI 模型服务)
- lf.asktable.com （访问 AI Tracing 服务）
AskTable 能打开，但登录的时候提示：连接失败

请检查 docker-compose.yaml 中的参数 BASE_URL，需要配置成浏览器访问的地址
如何验证容器与数据库网络的连通性（连接状况）

docker exec -ti asktable bash -c 'telnet DB_HOST DB_PORT'
- DB_HOST（数据库主机地址）
- DB_PORT（数据库端口号）
1. 连接成功会显示 Connected to localhost.
2. 连接被拒绝 / 网络不通 / 超时会显示 telnet: Unable to connect to remote host: Connection refused/host/timed out
如何卸载？

请在 docker-compose.yml 文件所在目录下，做如下操作：
1. 执行命令 docker compose down
2. 删除目录 asktable_data、mysql_data、qdrant_storage和qdrant_snapshots（若有）

注意事项

该部署模式适用于快速体验 AskTable，但不适用于生产环境，性能、准确性与稳定性无法保证。若有更高要求，请与我们联系。

再次感谢您的使用，祝您好运！🚀

前提条件​

硬件​

操作系统​

快速部署​

运行 AskTable​

探索 AskTable​

高级配置（可选）​

更新版本​

常见问题​

注意事项​