athou/commafeed

CommaFeed

CommaFeed的官方Docker镜像，用于部署自托管的个人RSS阅读器，灵感源自Google Reader，支持多种数据库配置，适合个人或小型实例使用。

快速开始

使用H2嵌入式数据库启动CommaFeed，然后通过http://localhost:8082/使用`admin/admin`登录。

docker

bash
docker run --name commafeed --detach --publish 8082:8082 --restart unless-stopped --volume /path/to/commafeed/db:/commafeed/data --memory 256M athou/commafeed:latest-h2

docker-compose

yaml
services:
  commafeed:
    image: athou/commafeed:latest-h2
    restart: unless-stopped
    volumes:
      - /path/to/commafeed/db:/commafeed/data  # 映射数据库数据目录
    deploy:
      resources:
        limits:
          memory: 256M  # 内存限制
    ports:
      - 8082:8082  # 端口映射

高级配置

H2嵌入式数据库适用于小型实例，若需更多数据库控制，可使用其他数据库（注意镜像标签需从latest-h2改为对应数据库标签，如latest-postgresql）：

PostgreSQL示例

yaml
services:
  commafeed:
    image: athou/commafeed:latest-postgresql
    restart: unless-stopped
    environment:
      - QUARKUS_DATASOURCE_JDBC_URL=jdbc:postgresql://postgresql:5432/commafeed  # PostgreSQL连接URL
      - QUARKUS_DATASOURCE_USERNAME=commafeed  # 数据库用户名
      - QUARKUS_DATASOURCE_PASSWORD=commafeed  # 数据库密码
    deploy:
      resources:
        limits:
          memory: 256M
    ports:
      - 8082:8082

  postgresql:
    image: postgres:latest
    restart: unless-stopped
    environment:
      POSTGRES_USER: commafeed
      POSTGRES_PASSWORD: commafeed
      POSTGRES_DB: commafeed
    volumes:
      - /path/to/commafeed/db:/var/lib/postgresql/data  # PostgreSQL数据目录

其他支持的数据库

• MySQL: QUARKUS_DATASOURCE_JDBC_URL=jdbc:mysql://localhost/commafeed?autoReconnect=true&failOverReadOnly=false&maxReconnects=20&rewriteBatchedStatements=true&timezone=UTC

• MariaDB: QUARKUS_DATASOURCE_JDBC_URL=jdbc:mariadb://localhost/commafeed?autoReconnect=true&failOverReadOnly=false&maxReconnects=20&rewriteBatchedStatements=true&timezone=UTC

配置说明

所有https://athou.github.io/commafeed/documentation%E5%9D%87%E4%B8%BA%E5%8F%AF%E9%80%89%EF%BC%8C%E4%B8%94%E5%85%B7%E6%9C%89%E5%90%88%E7%90%86%E9%BB%98%E8%AE%A4%E5%80%BC%E3%80%82

环境变量覆盖配置

设置可通过环境变量覆盖，例如：commafeed.feed-refresh.interval-empirical可通过COMMAFEED_FEED_REFRESH_INTERVAL_EMPIRICAL环境变量设置。

会话加密密钥

登录凭证存储在加密Cookie中，加密密钥默认随机生成，导致应用重启后需重新登录。建议设置固定密钥（至少16字符）： QUARKUS_HTTP_AUTH_SESSION_ENCRYPTION_KEY=<固定密钥>

其他Quarkus设置详见官方文档。

更新通知

部署后可订阅https://github.com/Athou/commafeed/releases.atom%E8%8E%B7%E5%8F%96%E6%96%B0%E7%89%88%E6%9C%AC%E9%80%9A%E7%9F%A5%E3%80%82

Docker标签说明

标签格式：<version>-<database>[-jvm]

• <version>:

  • 具体版本（如5.0.0）
  • latest（最新稳定版）
  • master（最新Git提交）

• <database>: 数据库类型，可选h2、postgresql、mysql或mariadb

• -jvm（可选）: 表示应用运行于JVM而非原生编译版本