如何快速部署Glean？5分钟搭建属于你的自托管RSS阅读器

如何快速部署Glean？5分钟搭建属于你的自托管RSS阅读器

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

Glean是一款功能强大的自托管RSS阅读器和个人知识管理工具，让你轻松掌控信息获取与管理。本文将展示如何在5分钟内完成Glean的部署，打造专属的信息聚合平台。

🌟 为什么选择Glean自托管RSS阅读器？

在信息爆炸的时代，一个高效的RSS阅读器能帮你过滤噪音、聚焦重要内容。Glean作为自托管解决方案，不仅保护你的数据隐私，还提供了高度定制化的阅读体验。它支持多源订阅、智能分类和标签管理，让信息整理变得前所未有的简单。

🚀 部署前的准备工作

开始部署前，请确保你的系统满足以下要求：

• Docker Engine 24.0+ 和 Docker Compose V2
• 至少2GB内存和10GB磁盘空间
• 稳定的网络连接

如果你还没有安装Docker，可以通过以下命令快速安装（适用于Ubuntu系统）：

# 更新软件包索引 sudo apt update # 安装Docker依赖 sudo apt install -y apt-transport-https ca-certificates curl software-properties-common # 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - # 添加Docker仓库 sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" # 安装Docker sudo apt update sudo apt install -y docker-ce docker-compose-plugin # 将当前用户添加到docker组（避免每次使用sudo） sudo usermod -aG docker $USER

⚠️ 注意：添加用户到docker组后需要注销并重新登录才能生效

🔌 两种部署方案：完整版 vs 精简版

Glean提供两种部署方案，你可以根据需求选择：

方案一：完整部署（推荐）

包含Milvus向量数据库，支持智能推荐和偏好学习等高级功能：

# 克隆仓库 git clone https://gitcode.com/gh_mirrors/glean8/glean cd glean # 创建.env文件配置管理员凭据 cat > .env << EOF CREATE_ADMIN=true ADMIN_USERNAME=admin ADMIN_PASSWORD=$(openssl rand -base64 24) SECRET_KEY=$(openssl rand -base64 32) EOF # 保存生成的密码 cat .env # 启动所有服务 docker compose up -d

方案二：精简部署（不含Milvus）

如果不需要智能推荐功能，可以选择精简版，占用资源更少：

# 克隆仓库 git clone https://gitcode.com/gh_mirrors/glean8/glean cd glean # 使用精简版配置文件启动 docker compose -f docker-compose.lite.yml up -d

💡 提示：两种方案都会自动创建默认管理员账号，用户名是admin，密码会在启动时显示。请务必保存好这个密码！

🔍 验证部署是否成功

服务启动后，可以通过以下命令验证所有组件是否正常运行：

# 查看服务状态 docker compose ps # 检查后端健康状态 curl http://localhost/api/health

如果一切正常，你将看到类似以下的服务状态输出：

NAME IMAGE STATUS glean-admin ghcr.io/leslieleung/glean-admin:latest Up (healthy) glean-backend ghcr.io/leslieleung/glean-backend:latest Up (healthy) glean-postgres postgres:16-alpine Up (healthy) glean-redis redis:8-alpine Up (healthy) glean-web ghcr.io/leslieleung/glean-web:latest Up glean-worker ghcr.io/leslieleung/glean-backend:latest Up

🌐 访问Glean服务

部署成功后，你可以通过以下地址访问Glean的各项服务：

• Web应用：http://localhost （或你的服务器IP地址）
• 管理后台：http://localhost:3001
• API文档：http://localhost/api/docs （仅当DEBUG=true时可用）

使用之前保存的管理员账号和密码登录系统，开始你的RSS阅读之旅吧！

⚙️ 基本配置与自定义

修改默认端口

如果你需要修改默认端口，可以编辑.env文件：

# 编辑环境变量文件 nano .env # 修改端口配置 WEB_PORT=8080 # Web界面端口 ADMIN_PORT=3002 # 管理后台端口

修改后需要重启服务使配置生效：

docker compose up -d

配置HTTPS（生产环境必备）

对于生产环境部署，强烈建议配置HTTPS以确保数据传输安全。你可以使用Caddy或Nginx作为反向代理来实现HTTPS。

使用Caddy的简单配置：

# 创建Caddyfile cat > Caddyfile << EOF yourdomain.com { reverse_proxy localhost:80 } admin.yourdomain.com { reverse_proxy localhost:3001 } EOF # 启动Caddy caddy run --config Caddyfile

Caddy会自动为你的域名获取和续期Let's Encrypt证书，无需额外配置。

📝 常用操作命令

查看日志

# 查看所有服务日志 docker compose logs -f # 查看特定服务日志（如后端） docker compose logs -f backend # 查看最后100行日志 docker compose logs --tail=100 backend

更新Glean到最新版本

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

备份数据

# 创建备份脚本 cat > backup-glean.sh << 'EOF' #!/bin/bash BACKUP_DIR="$HOME/glean-backups" DATE=$(date +%Y%m%d_%H%M%S) mkdir -p "$BACKUP_DIR" # 备份PostgreSQL数据库 docker exec glean-postgres pg_dump -U glean glean | gzip > "$BACKUP_DIR/glean_db_$DATE.sql.gz" echo "备份完成: $BACKUP_DIR/glean_db_$DATE.sql.gz" EOF # 使脚本可执行 chmod +x backup-glean.sh # 执行备份 ./backup-glean.sh

❓ 常见问题解决

服务无法启动

如果服务无法启动，首先查看日志找出问题原因：

docker compose logs backend

常见问题及解决方案：

1. 端口冲突：修改.env文件中的WEB_PORT或ADMIN_PORT
2. 数据库连接失败：确保PostgreSQL服务正常运行
3. SECRET_KEY未设置：检查.env文件中是否设置了SECRET_KEY

忘记管理员密码

如果忘记了管理员密码，可以通过以下命令重置：

# 进入后端容器 docker exec -it glean-backend bash # 运行密码重置脚本 uv run python scripts/create-admin.py --username admin --password NewPassword123! --force

🎉 开始使用Glean

恭喜你成功部署了Glean自托管RSS阅读器！现在你可以：

1. 添加你喜爱的RSS订阅源
2. 创建文件夹和标签来组织内容
3. 使用搜索功能快速找到感兴趣的文章
4. 自定义阅读界面和偏好设置

Glean的强大之处在于它的可扩展性和个性化，随着使用时间的增长，它会越来越符合你的阅读习惯。

📚 更多资源

• 官方部署文档：DEPLOY.zh-CN.md
• 项目配置文件：docker-compose.yml
• 环境变量设置：.env.example

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