安装指南

本指南将帮助您安装和配置雷驼智能引擎。雷驼智能引擎是一款面向企业的智能服务平台，提供大模型聚合能力，为智能对话、知识库、智能体等场景提供基础支撑。

环境要求

系统要求

操作系统：Linux (推荐 Ubuntu 20.04+), macOS, Windows
内存：最低 2GB，推荐 4GB+
存储：最低 10GB 可用空间
网络：稳定的互联网连接

软件依赖

Docker：20.10 或更高版本
Docker Compose：2.0 或更高版本
PostgreSQL：16.0 或更高版本（通过 Docker 提供）+ pgvector

通过 Docker 安装

目前雷驼智能引擎仅支持通过 Docker 部署，推荐使用 docker-compose 进行管理。

1. 安装 Docker

请确保您的服务器或本地环境已安装 Docker 与 docker-compose。

Ubuntu/Debian

# 更新包索引
sudo apt update

# 安装必要的包
sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release

# 添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 设置稳定版仓库
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装 Docker Engine
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 启动 Docker 服务
sudo systemctl start docker
sudo systemctl enable docker

# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER

macOS

下载并安装 Docker Desktop for Mac

Windows

下载并安装 Docker Desktop for Windows

2. 创建 docker-compose.yml 文件

touch docker-compose.yml

3. 配置 docker-compose.yml

使用任意编辑器打开 docker-compose.yml 文件，并添加以下内容：

services:
    # PostgreSQL 数据库服务
    postgres:
        image: pgvector/pgvector:pg16
        container_name: postgres
        ports:
            - "5432:5432"
        environment:
            - POSTGRES_USER=postgres
            - POSTGRES_PASSWORD=dathor123456
            - POSTGRES_DB=dathor
        volumes:
            - postgres_data:/var/lib/postgresql/data
        healthcheck:
            test: ["CMD-SHELL", "pg_isready -U postgres"]
            interval: 5s
            timeout: 5s
            retries: 5
        networks:
            - dathor-network

    # 初始化数据库服务
    db-init:
        image: postgres:16
        depends_on:
            postgres:
                condition: service_healthy
        environment:
            - POSTGRES_USER=postgres
            - POSTGRES_PASSWORD=dathor123456
            - POSTGRES_DB=dathor
        command: >
            bash -c "
            PGPASSWORD=$$POSTGRES_PASSWORD psql -h postgres -U $$POSTGRES_USER -d postgres -c 'CREATE DATABASE \"$$POSTGRES_DB\";' || true;
            PGPASSWORD=$$POSTGRES_PASSWORD psql -h postgres -U $$POSTGRES_USER -d $$POSTGRES_DB -c 'CREATE EXTENSION IF NOT EXISTS vector;'
            "
        networks:
            - dathor-network
        restart: "no"

    # 雷驼智能引擎服务
    app:
        image: qihangnet/dathor:v1.0.38
        container_name: dathor
        ports:
            - "8000:8000"
        environment:
            - LANG=zh_CN.UTF-8
            - LANGUAGE=zh_CN:zh
            - DB_HOST=postgres
            - DB_PORT=5432
            - DB_USER=postgres
            - DB_PASSWORD=dathor123456
            - DB_NAME=dathor
        depends_on:
            postgres:
                condition: service_healthy
            db-init:
                condition: service_completed_successfully
        networks:
            - dathor-network
        restart: unless-stopped

volumes:
    postgres_data:

networks:
    dathor-network:
        driver: bridge

或者直接下载示例文件：

# 下载示例配置文件
# 请从官方文档获取 docker-compose.yml 配置文件

**注意：**如使用自建数据库，请删除 postgres 与 db-init 服务，并在 app 服务中配置数据库连接信息。

4. 检查与调整配置

确认版本

如需使用其他版本，请将 v1.0.38 替换为目标版本号：

app:
    image: qihangnet/dathor:v1.0.38 # 使用 v1.0.38 版本
    container_name: dathor

配置服务端口

如需更改宿主机端口，请调整端口映射（格式为宿主机:容器）：

app:
    ports:
        - "8000:8000" # 宿主机 8000 → 容器 8000

配置数据库

如使用自建数据库，需在 app 服务中设置数据库连接环境变量：

app:
    environment:
        - DB_HOST=postgres      # 数据库主机地址
        - DB_PORT=5432          # 数据库端口
        - DB_USER=postgres      # 数据库用户名
        - DB_PASSWORD=dathor123456 # 数据库密码
        - DB_NAME=dathor      # 数据库名称

环境变量说明：

变量名	描述	默认值	必需
DB_HOST	数据库主机地址	localhost	✓
DB_PORT	数据库端口	5432
DB_USER	数据库用户名	postgres
DB_PASSWORD	数据库密码	(空)	✓
DB_NAME	数据库名称	dathor

5. 安装并启动服务

首次安装需要拉取镜像，耗时取决于网络状况。执行以下命令启动：

# 拉取最新镜像
docker-compose pull

# 在后台运行
docker-compose up -d

# 查看 app 进程的情况
docker-compose logs app

注：如使用 Docker Compose v2，请将命令中的 docker-compose 替换为 docker compose。

6. 访问并初始化

服务启动后，使用浏览器访问 http://localhost:8000

首次访问需创建管理员账号，按照提示填写账号与密码即可完成初始化。

升级雷驼智能引擎

1. 停止现有服务

# 停止现有服务
docker-compose down

# 如需删除旧容器和数据（危险操作！）
docker-compose down -v

2. 更新 docker-compose.yml 文件

将 app 服务的 image 版本号替换为新版本号：

app:
    image: qihangnet/dathor:v1.0.38 # 替换为新版本号

3. 拉取最新镜像并启动

docker-compose pull
docker-compose up -d
docker-compose logs app

常见问题

Q: 数据库连接失败

A: 检查以下项目：

PostgreSQL 服务是否运行
数据库连接参数是否正确
防火墙设置是否允许连接

Q: 端口被占用

A: 修改端口映射或停止占用端口的服务：

# 查看端口占用
lsof -i :8000

# 停止占用端口的进程
kill -9 <PID>

Q: 容器启动失败

A: 检查以下项目：

Docker 服务是否运行
镜像是否正确拉取
环境变量配置是否正确

# 查看容器日志
docker-compose logs app

# 查看容器状态
docker-compose ps

Q: 数据库初始化失败

A: 检查数据库服务状态：

# 查看数据库容器状态
docker-compose logs postgres

# 检查数据库连接
docker-compose exec postgres psql -U postgres -d dathor -c "SELECT 1;"

下一步

配置说明 - 详细的配置选项
接口文档 - 完整的接口文档
部署指南 - 生产环境部署

环境要求​

系统要求​

软件依赖​

通过 Docker 安装​

1. 安装 Docker​

Ubuntu/Debian​

macOS​

Windows​

2. 创建 docker-compose.yml 文件​

3. 配置 docker-compose.yml​

4. 检查与调整配置​

确认版本​

配置服务端口​

配置数据库​

5. 安装并启动服务​

6. 访问并初始化​

升级雷驼智能引擎​

1. 停止现有服务​

2. 更新 docker-compose.yml 文件​

3. 拉取最新镜像并启动​

常见问题​

Q: 数据库连接失败​

Q: 端口被占用​

Q: 容器启动失败​

Q: 数据库初始化失败​

下一步​