Glean部署教程：Docker Compose一键启动，轻松管理服务依赖

【免费下载链接】gleanA self-hosted RSS reader and personal knowledge management tool.项目地址: https://gitcode.com/gh_mirrors/glean8/glean

Glean是一款自托管的RSS阅读器和个人知识管理工具，通过Docker Compose可以轻松部署，自动管理所有服务依赖。本教程将详细介绍如何使用Docker Compose快速搭建Glean服务，让你无需复杂配置即可拥有属于自己的知识管理系统。

准备工作：环境要求与前期准备

在开始部署前，请确保你的系统满足以下条件：

• Docker Engine 20.10.0+
• Docker Compose 2.0+
• 至少2GB内存（推荐4GB以上，以支持Milvus向量数据库功能）
• 稳定的网络连接（用于拉取Docker镜像）

首先克隆Glean仓库到本地：

git clone https://gitcode.com/gh_mirrors/glean8/glean cd glean

核心配置：了解Docker Compose文件结构

Glean项目提供了多个Docker Compose配置文件，满足不同场景需求：

• docker-compose.yml：完整部署配置，包含所有服务组件
• docker-compose.lite.yml：轻量版配置，不含Milvus向量数据库
• docker-compose.dev.yml：开发环境配置
• docker-compose.test.yml：测试环境配置

默认配置文件包含以下核心服务组件：

• PostgreSQL：数据存储
• Redis：缓存和消息队列
• Backend：API服务
• Worker：后台任务处理
• Web：用户界面
• Admin：管理面板
• Milvus：向量数据库（用于智能推荐功能）

快速部署：两种启动方式任选

方式1：完整部署（推荐生产环境）

完整部署包含所有功能组件，特别是Milvus向量数据库，支持智能推荐和偏好学习功能：

docker compose up -d

方式2：轻量部署（适合资源有限环境）

如果你的服务器资源有限，可以选择轻量部署，不包含Milvus组件：

docker compose -f docker-compose.lite.yml up -d

首次启动时，系统会自动拉取所需的Docker镜像并创建数据库表结构。根据网络情况，这个过程可能需要5-10分钟。

环境变量配置：自定义你的Glean服务

Glean支持通过环境变量自定义配置，创建.env文件可以修改以下关键参数：

# 基础设置 IMAGE_TAG=latest # Docker镜像版本 WEB_PORT=80 # Web界面端口 ADMIN_PORT=3001 # 管理面板端口 # 数据库配置 POSTGRES_DB=glean # 数据库名称 POSTGRES_USER=glean # 数据库用户名 POSTGRES_PASSWORD=your_secure_password # 数据库密码 # 安全设置 SECRET_KEY=your_long_random_string # JWT签名密钥，生产环境务必修改 # 管理员账户 ADMIN_USERNAME=admin # 管理员用户名 ADMIN_PASSWORD=your_secure_password # 管理员密码

修改配置后，使用以下命令应用变更：

docker compose up -d --force-recreate

访问Glean：登录与初始设置

服务启动后，可以通过以下地址访问Glean：

• Web界面：http://服务器IP:WEB_PORT（默认80端口）
• 管理面板：http://服务器IP:ADMIN_PORT（默认3001端口）

Glean RSS阅读器界面

使用默认管理员账户登录（或你在.env文件中设置的账户）：

• 用户名：admin
• 密码：Admin123!（首次登录后请立即修改）

服务管理：日常运维命令

查看服务状态

docker compose ps

查看日志

# 查看所有服务日志 docker compose logs -f # 查看特定服务日志（如backend） docker compose logs -f backend

停止服务

docker compose down

备份数据

# 备份PostgreSQL数据库 docker exec glean-postgres pg_dump -U glean glean > backup_$(date +%Y%m%d).sql

常见问题解决

服务启动失败怎么办？

1. 检查Docker和Docker Compose版本是否满足要求
2. 查看日志定位问题：docker compose logs -f
3. 确保端口未被占用，或修改.env文件中的端口配置

如何更新Glean到最新版本？

# 拉取最新代码 git pull # 拉取最新镜像并重启服务 docker compose pull docker compose up -d

忘记管理员密码怎么办？

可以通过执行脚本重置管理员密码：

docker exec -it glean-backend uv run --no-sync /app/scripts/create-admin.py

总结：轻松拥有自托管知识管理系统

通过Docker Compose部署Glean，你只需几个简单命令就能搭建起功能完善的自托管RSS阅读器和知识管理系统。无论是个人使用还是小团队协作，Glean都能帮助你高效管理信息、构建个人知识库。

现在就开始你的Glean之旅，体验自托管服务带来的自由与掌控吧！

【免费下载链接】gleanA self-hosted RSS reader and personal knowledge management tool.项目地址: https://gitcode.com/gh_mirrors/glean8/glean