DEEIX-Chat

环境要求

• 已安装 Docker 与 Docker Compose
• 所有 Docker 命令需在仓库根目录执行
• 默认安装方式需自备 PostgreSQL 与 Redis（地址要能从容器内访问）
• 分离部署时需 Node.js 与 pnpm 环境

安装与启动步骤

1. 1获取项目代码

   把仓库克隆到本地并进入项目根目录，后续所有 Docker 命令都在此根目录执行。

   git clone https://github.com/DEEIX-AI/DEEIX-Chat.git
   cd DEEIX-Chat

   复制

2. 2选择安装方案

   轻量=仅应用+SQLite；默认=外部 PostgreSQL+Redis；完整=应用+PostgreSQL+Redis 一体。三种方案默认都暴露 http://localhost:8080。

3. 3轻量安装(SQLite)

   依赖最少的方案，只启动 app 容器，数据和本地向量索引存 SQLite，使用进程内内存缓存，仅适合单机评估。

   cp config.sqlite.example.yaml config.yaml
   docker compose -f docker-compose.sqlite.yml up -d

   复制

4. 4默认安装(外部依赖)

   适用于 PostgreSQL 与 Redis 已在本 compose 之外管理的情况，启动前把库和缓存地址改成容器内可达，宿主机服务通常用 host.docker.internal。

   cp config.example.yaml config.yaml
   docker compose -f docker-compose.yml up -d

   复制

5. 5完整安装(一体栈)

   由 compose 同时启动 app、PostgreSQL、Redis；compose 里的 POSTGRES_DSN、REDIS_ADDR 等环境变量会覆盖 config.yaml 中的值。

   cp config.full.example.yaml config.yaml
   docker compose -f docker-compose.full.yml up -d

   复制

6. 6按需启动可选服务

   Tika、Tesseract、Docling 为可选服务，仅在管理台或 config.yaml 中启用时才启动；它们加入 deeix-chat-network，需先起一个根 compose 或手动建网络。

   docker network create deeix-chat-network
   docker compose -f docker/tika/docker-compose.yml up -d
   docker compose -f docker/tesseract/docker-compose.yml up -d --build
   docker compose -f docker/docling/docker-compose.yml up -d --build

   复制

7. 7使用本地自建镜像

   compose 文件只引用镜像不定义构建步骤，如需自定义可先本地构建，再用 DEEIX_CHAT_IMAGE 指定镜像。

   docker build -t deeix-chat:local .
   DEEIX_CHAT_IMAGE=deeix-chat:local docker compose up -d

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:8080 能正常进入应用界面，并用 docker compose ps 确认容器处于运行状态。

常见问题

注意事项

• 默认访问端口为 8080，三种根 compose 方案一致。
• 生产部署应保持 APP_ENV=prod 或 production，并替换为生产密钥。
• 默认应用镜像为 ghcr.io/deeix-ai/deeix-chat:latest。
• RapidOCR 目前只提供 Dockerfile 和入口，没有 compose 文件，需自行编写或手动运行。