RSS阅读器与知识管理利器Glean

最新推荐文章于 2025-12-19 17:13:02 发布

原创最新推荐文章于 2025-12-19 17:13:02 发布 · 1.6k 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#群晖 #docker #RSS #知识管理

在这里插入图片描述

简介

什么是 Glean ？

Glean（拾灵）是一款开源、可自托管的 RSS 阅读器和个人知识管理工具，旨在帮助重度信息消费者通过智能 RSS 聚合与管理功能，解决信息过载问题，帮助用户高效地进行阅读、筛选和知识沉淀。

主要特点

📰 RSS 订阅：轻松订阅和管理 RSS/Atom 源，支持 OPML 导入导出
📚 智能阅读：简洁、无干扰的阅读体验，支持内容过滤
🔖 稍后阅读：保存文章以便稍后阅读，并支持自动清理
📁 文件夹与标签：通过多层级文件夹和标签系统地组织内容
⭐ 收藏系统：收藏重要的订阅文章或外部链接
🔧 后台同步：每 15 分钟自动在后台更新订阅源，确保内容常新
🔒 自托管：通过 Docker 部署，数据完全由您掌控
🎨 现代界面：美观且响应式的用户界面，提供舒适的暖色深色主题
👨‍💼 管理后台：提供用户管理和系统监控功能

对于每天需要处理大量信息源的用户来说，Glean 提供了一个统一的平台来聚合、筛选和消费内容。无论您是研究人员、开发者、学生还是内容创作者，Glean 都能帮助您构建一个个性化的信息流，将分散的知识整理成有序的个人知识库。

安装

在群晖上以 Docker 方式安装。

官方提供了两种部署模式：

一种是精简版部署，仅包含核心的 Web 应用，不带管理后台，适合个人使用；
另一种是完整版部署，包含一个管理后台，提供用户管理和系统统计功能；

本文采用完整版部署 ，由多个服务组成，采用 docker-compose 进行安装，这也是在群晖上部署多容器应用最便捷的方式。

建目录

通过 SSH 客户端连接到您的群晖，然后执行以下命令，创建一个用于存放 Glean 数据的目录

# 新建文件夹 glean 和 子目录
mkdir -p /volume1/docker/glean/{postgres,redis}

# 进入 glean 目录
cd /volume1/docker/glean

env.txt

env.txt 是环境变量文件

# Glean Environment Configuration
# Copy this file to .env and customize for your environment

# ========================================
# Database Configuration
# ========================================
POSTGRES_DB=glean
POSTGRES_USER=glean
POSTGRES_PASSWORD=glean

# ========================================
# Backend Configuration
# ========================================
# JWT secret key - CHANGE THIS IN PRODUCTION!
# Generate with: openssl rand -hex 32
SECRET_KEY=a9696c4e5de0ad6635d651e21e8a6186deee3304c6530f78561615c23b5c02d9

# Enable debug mode (shows API docs at /api/docs)
DEBUG=false

# ========================================
# Port Configuration
# ========================================
# Web interface port
WEB_PORT=8530

# Admin dashboard port (only for full deployment)
ADMIN_PORT=8531
# =============================================================================
# ADMIN (Optional - Full Deployment Only)
# =============================================================================
# Set CREATE_ADMIN=true on first startup to auto-create admin account
# The password will be printed in the logs (save it immediately!)
CREATE_ADMIN=true
ADMIN_USERNAME=admin
ADMIN_PASSWORD=laosu123
ADMIN_ROLE=super_admin

# ========================================
# Development Configuration (optional)
# ========================================
# Full database URL (auto-generated from above if not set)
# DATABASE_URL=postgresql+asyncpg://glean:glean@localhost:5432/glean

# Redis URL
# REDIS_URL=redis://localhost:6379/0

# CORS origins (JSON array)
# CORS_ORIGINS=["http://localhost", "http://localhost:3000"]

下面是参数的简单说明，请根据需要进行修改

环境变量	参考值	说明
POSTGRES_DB	`glean`	`PostgreSQL` 数据库名称。
POSTGRES_USER	`glean`	`PostgreSQL` 数据库用户。
POSTGRES_PASSWORD	`glean`	`PostgreSQL` 数据库密码。
SECRET_KEY		`JWT` 签名密钥，建议在生产环境中更改。可使用 `openssl rand -hex 32` 生成新的密钥。
DEBUG	`false`	是否启用调试模式，开启后可以在 `/api/docs` 访问 `API` 文档。
WEB_PORT	`8530`	`Web` 界面使用的端口号。
ADMIN_PORT	`8531`	管理仪表板使用的端口号（仅在完整部署时使用）。
CREATE_ADMIN	`true`	首次启动时是否自动创建管理员账户，设置为 `true` 将创建默认管理员账户。
ADMIN_USERNAME	`admin`	默认管理员用户名。
ADMIN_PASSWORD	`laosu123`	默认管理员密码。
ADMIN_ROLE	`super_admin`	默认管理员角色。
DATABASE_URL		数据库的完整 URL，如果没有设置则自动生成。
REDIS_URL	`redis://localhost:6379/0`	`Redis` 服务的 `URL`。
CORS_ORIGINS	`["http://localhost", "http://localhost:3000"]`	允许的跨源请求（`CORS`）地址的 `JSON` 数组。

docker-compose.yml

将下面的内容保存为 docker-compose.yml 文件

# Glean Full Deployment - Docker Compose (with Admin Dashboard)
# Usage: docker compose -f docker-compose.full.yml up -d
#
# This deployment includes the admin dashboard.
# Set CREATE_ADMIN=true to auto-create admin account on first startup.

services:
  postgres:
    image: postgres:16-alpine
    container_name: glean-postgres
    environment:
      POSTGRES_DB: ${POSTGRES_DB:-glean}
      POSTGRES_USER: ${POSTGRES_USER:-glean}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-glean}
    volumes:
      - ./postgres:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-glean}"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: unless-stopped

  redis:
    image: redis:7-alpine
    container_name: glean-redis
    command: redis-server --appendonly yes
    volumes:
      - ./redis:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: unless-stopped

  backend:
    image: ghcr.io/leslieleung/glean-backend:latest
    container_name: glean-backend
    environment:
      DATABASE_URL: postgresql+asyncpg://${POSTGRES_USER:-glean}:${POSTGRES_PASSWORD:-glean}@postgres:5432/${POSTGRES_DB:-glean}
      REDIS_URL: redis://redis:6379/0
      SECRET_KEY: ${SECRET_KEY:-change-me-in-production-use-a-long-random-string}
      CORS_ORIGINS: '["http://localhost", "http://localhost:3000", "http://localhost:3001"]'
      DEBUG: ${DEBUG:-false}
      # Only backend runs migrations to avoid race conditions
      RUN_MIGRATIONS: "true"
      # Admin auto-creation (set to true for first startup)
      CREATE_ADMIN: ${CREATE_ADMIN:-false}
      ADMIN_USERNAME: ${ADMIN_USERNAME:-admin}
      ADMIN_PASSWORD: ${ADMIN_PASSWORD:-}
      ADMIN_ROLE: ${ADMIN_ROLE:-super_admin}
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000/api/health"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    restart: unless-stopped
    command: ["uv", "run", "--no-sync", "uvicorn", "glean_api.main:app", "--host", "0.0.0.0", "--port", "8000"]

  worker:
    image: ghcr.io/leslieleung/glean-backend:latest
    container_name: glean-worker
    environment:
      DATABASE_URL: postgresql+asyncpg://${POSTGRES_USER:-glean}:${POSTGRES_PASSWORD:-glean}@postgres:5432/${POSTGRES_DB:-glean}
      REDIS_URL: redis://redis:6379/0
      SECRET_KEY: ${SECRET_KEY:-change-me-in-production-use-a-long-random-string}
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
      backend:
        condition: service_healthy
    restart: unless-stopped
    command: ["uv", "run", "--no-sync", "arq", "glean_worker.main.WorkerSettings"]

  web:
    image: ghcr.io/leslieleung/glean-web:latest
    container_name: glean-web
    ports:
      - "${WEB_PORT:-80}:80"
    depends_on:
      - backend
    restart: unless-stopped

  admin:
    image: ghcr.io/leslieleung/glean-admin:latest
    container_name: glean-admin
    ports:
      - "${ADMIN_PORT:-3001}:80"
    depends_on:
      - backend
    restart: unless-stopped

启动

将 docker-compose.yml 和 env.txt 放入项目根目录，然后执行下面的命令

# 一键启动
docker-compose --env-file env.txt up -d

运行

Web

在浏览器中输入 http://群晖IP:8530 就能看到 Web 端的登录界面

第一次需要点 Create an account→ 创建账号

登录成功后的主界面

Manage Feeds --> Add Feed，添加 RSS

还是以老苏的博客为例，https://laosu.tech/atom.xml

添加成功之后

刷新一下，应该就可以看到订阅的内容了

管理端

在浏览器中输入 http://群晖IP:8531 就能看到管理端的登录界面

登录成功后的主界面

网页端订阅了之后，数据会发生变化

管理用户

能看到订阅的 Feeds

也可以在 Entries 中看到文章

参考文档

LeslieLeung/glean: A self-hosted RSS reader and personal knowledge management tool.
地址：https://github.com/LeslieLeung/glean