部署单机版

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

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

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

前提条件

硬件

最低配置要求：2核CPU、4G内存、10G硬盘。支持 x86。

操作系统

Linux 系统 需要安装以下软件：
1. Docker：Docker 安装文档。
2. Docker Compose：用来打包部署 AskTable 和 PostgreSQL 数据库。Docker Compose 安装文档。

快速部署

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

services:
  asktable:
    # AskTable
    image: registry.cn-shanghai.aliyuncs.com/datamini/asktable-all-in-one:latest  # 中国大陆地区
    container_name: asktable
    depends_on:
      - asktable_pg
    ports:
      - "8000:80"
    privileged: true
    environment:
      TZ: Asia/Shanghai
      BASE_URL: http://127.0.0.1:8000        # 【务必修改】容器对外暴露的地址（即从外部比如浏览器访问的地址）
      LLM_API_KEY: asktable-xxxxxx=xxxxxxxx      # 【务必修改】AI 模型令牌，是以"asktable-"开头的字符串。登录 AskTable(https://cloud.asktable.com) 后，顶部点击"私有部署 AskTable"获取。
      DATABASE_HOST: asktable_pg               # PostgreSQL 数据库地址（该数据库是 AskTable 系统数据库，并非利用 AskTable 去查询的数据库，后者需要在 AskTable 界面上添加）
      DATABASE_PORT: 5432                      # PostgreSQL 数据库端口
      DATABASE_USER: asktable                  # PostgreSQL 数据库用户名
      DATABASE_PASSWORD: asktable              # 【建议修改】PostgreSQL 数据库密码
      DATABASE_DB: asktable                    # PostgreSQL 数据库名称
      VDB_ADDRESS: http://asktable_vdb:6333    # 向量数据库地址
      VDB_API_KEY: asktable                    # 【建议修改】向量数据库 API KEY
    volumes:
      - ./asktable_data:/asktable

  asktable_pg:
    image: registry.cn-shanghai.aliyuncs.com/dminfra/postgres:17.6
    container_name: asktable_pg
    restart: unless-stopped
    ports:
      - "5432"
    environment:
      TZ: Asia/Shanghai
      POSTGRES_USER: asktable              # 【建议修改】
      POSTGRES_PASSWORD: asktable          # 【建议修改】
      POSTGRES_DB: asktable
    volumes:
      - ./postgres_data:/var/lib/postgresql/data

  asktable_vdb:
    image: registry.cn-shanghai.aliyuncs.com/dminfra/qdrant:v1.11.5
    container_name: asktable_vdb
    ports:
      - "6333"
      - "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 这两个配置项必须按照实际情况修改。

运行 AskTable

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

构建并启动容器

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

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

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

访问 AskTable

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

http://127.0.0.1:8000

在这里，您可以直接注册账号，第一个注册的用户将自动获得超级管理员权限，之后即可探索和使用应用。

探索 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: Qwen3-80B-Instruct  # 强制使用的模型名字
```
需注意，本地模型我们推荐满血版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。
子路径部署：支持将 AskTable 部署到 URL 子路径，如 https://example.com/asktable。

外部反向代理（Caddy/Nginx/Traefik）需剥离子路径前缀后转发到容器：
```
浏览器 /asktable/xxx → 外部代理 (strip_prefix /asktable) → 容器收到 /xxx
```
配置示例：
```
BASE_URL: https://example.com/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、postgres_data、qdrant_storage和qdrant_snapshots（若有）
麒麟V10等国产系统如何正常运行？

部分国产操作系统（如麒麟V10SP1）会因安全策略等原因限制容器部分操作，可能导致启动后异常。此时需在 docker-compose.yml 文件的每个服务下添加 privileged: true 以获取最高权限。例如：

注意事项

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

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

前提条件​

硬件​

操作系统​

快速部署​

运行 AskTable​

探索 AskTable​

高级配置（可选）​

更新版本​

常见问题​

注意事项​