Docker 部署

使用 Docker Compose 一键部署 OpenVort

Docker 部署

Docker 部署视频

https://cloud.video.taobao.com/vod/6UmzaEqgXntaNmR5DRGe4hv1dvhb78xk2yA6pW7AJqE.mp4

前置条件

  • Docker 20.10+
  • Docker Compose 2.0+
  • 至少 2GB 内存

没有 Docker？macOS / Windows / Linux: curl -fsSL https://get.docker.com | sudo sh

快速部署

curl -fsSL https://raw.githubusercontent.com/openvort/openvort/master/docker-compose.yml -o docker-compose.yml
docker compose up -d

访问 http://localhost:10899，使用 admin / admin 登录。

无需 clone 仓库、无需安装 Python，Docker 镜像已包含所有运行依赖。

服务组件

Docker Compose 包含：

  • openvort — 主服务（FastAPI + Agent Runtime + 前端），预构建镜像 openvort/openvort:latest
  • postgres — PostgreSQL 17 + pgvector（向量搜索，知识库功能）

配置

所有配置均为可选。不创建 .env 文件也能正常启动（数据库自动创建，AI 功能通过 Web 面板配置）。

如需自定义，在 docker-compose.yml 同目录创建 .env 文件：

# LLM 配置（推荐通过 Web 面板的"AI 配置"页面管理）
OPENVORT_LLM_API_KEY=sk-ant-...
OPENVORT_LLM_MODEL=claude-sonnet-4-20250514

# 日志级别
OPENVORT_LOG_LEVEL=INFO

完整环境变量参考：环境变量

数据持久化

数据库数据和应用数据通过 Docker Named Volume 持久化：

  • pgdata — PostgreSQL 数据
  • openvort_data — 应用数据（~/.openvort）

升级时数据不会丢失。

升级

docker compose pull
docker compose up -d

从源码构建镜像

如需自行构建 Docker 镜像（而非使用预构建镜像），可直接在项目根目录执行：

git clone https://github.com/openvort/openvort.git
cd openvort
docker build -t openvort .

国内网络环境可使用 MIRROR=cn 参数，自动切换 apt / Node.js / pip 为国内镜像源，大幅加速构建：

docker build --build-arg MIRROR=cn -t openvort .

查看日志

docker compose logs -f          # 所有服务
docker compose logs -f openvort # 仅应用
docker compose logs -f postgres # 仅数据库