跳转到内容

环境要求

系统要求

硬件要求

最低配置（精简部署）：

CPU: 2 核
内存: 2GB RAM
存储: 10GB 可用空间

推荐配置（完整部署，含 Milvus）：

CPU: 4 核或以上
内存: 8GB RAM 或以上
存储: 40GB 可用空间

软件要求

操作系统: Linux / macOS / Windows（支持 Docker）
Docker Engine: 24.0+ 和 Docker Compose V2
域名（推荐）: 用于 HTTPS 配置

支持的架构

预构建的 Docker 镜像支持以下架构：

linux/amd64
linux/arm64

部署模式

完整部署

包含所有服务，支持智能推荐和偏好学习功能：

服务	容器名称	说明
PostgreSQL	glean-postgres	主数据库
Redis	glean-redis	任务队列
Backend	glean-backend	FastAPI API 服务器
Worker	glean-worker	后台任务处理
Web	glean-web	前端界面
Admin	glean-admin	管理后台
Milvus	glean-milvus	向量数据库
Milvus etcd	glean-milvus-etcd	Milvus 协调服务
Milvus MinIO	glean-milvus-minio	Milvus 对象存储

精简部署

不包含 Milvus 相关服务，共 6 个服务：

服务	容器名称	说明
PostgreSQL	glean-postgres	主数据库
Redis	glean-redis	任务队列
Backend	glean-backend	FastAPI API 服务器
Worker	glean-worker	后台任务处理
Web	glean-web	前端界面
Admin	glean-admin	管理后台

网络要求

出站连接

RSS/Atom 订阅源地址
AI API 端点（如使用 OpenAI 等）

入站端口

端口	服务	默认值	可配置
Web 应用	glean-web	80	WEB_PORT
管理后台	glean-admin	3001	ADMIN_PORT
Milvus	glean-milvus	19530	MILVUS_PORT

数据持久化

以下 Docker Volume 用于数据持久化：

Volume	说明
postgres_data	PostgreSQL 数据库文件
redis_data	Redis 持久化数据
glean_logs	应用日志
milvus_etcd_data	Milvus etcd 数据（完整版）
milvus_minio_data	Milvus 对象存储（完整版）
milvus_data	Milvus 向量数据（完整版）

Docker 镜像

预构建镜像托管在 GitHub Container Registry：

ghcr.io/leslieleung/glean-backend:latest
ghcr.io/leslieleung/glean-web:latest
ghcr.io/leslieleung/glean-admin:latest

使用特定版本

# 设置版本号
export IMAGE_TAG=v1.0.0

# 或者在 .env 文件中设置
echo "IMAGE_TAG=v1.0.0" >> .env

# 启动服务
docker compose up -d

测试预发布版本

# 使用 alpha/beta/rc 版本
IMAGE_TAG=v1.1.0-alpha.1 docker compose up -d

下一步

配置说明 - 自定义环境变量
HTTPS 配置 - 配置 SSL 证书
备份与恢复 - 数据备份策略