#rss #rss-reader #fever #rssreader

bin+lib 拉雷斯

简单的RSS阅读器服务(Fever API后端)

4个版本

0.2.2 2020年9月20日
0.2.0 2020年9月8日
0.1.1 2020年8月16日
0.1.0 2020年8月15日

#602HTTP服务器

MIT 协议

65KB
1.5K SLoC

拉雷斯:最小化Fever API实现

Build Status Crates.io Docker Status

拉雷斯 是用Rust编写的最小化 Fever API 实现。它旨在提供一个无需设置的RSS阅读器后端。它使用SQLite 3作为存储引擎。 它不提供用户界面。

建议使用Reeder作为客户端访问拉雷斯。

安装

Cargo

cargo install lares

Docker

docker run -it fanzeyi/lares

预构建的二进制文件

对于每个版本,GitHub Action将附加预构建的二进制文件,适用于Ubuntu、macOS和Windows。您可以在 版本页面 找到这些二进制文件。

用法

拉雷斯由两部分组成,CLI和服务器。通过命令行界面仅可管理订阅和组。

$ lares --help
lares 0.2.1
Minimal RSS service

USAGE:
    lares [FLAGS] [OPTIONS] <SUBCOMMAND>

FLAGS:
        --debug
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -d, --database <database>     [env: LARES_DATABASE=]  [default: lares.db]

SUBCOMMANDS:
    feed      Manages feeds
    group     Manages group
    help      Prints this message or the help of the given subcommand(s)
    server    Starts web server

或者,要启动一个服务器

$ lares server --help
lares-server 0.2.1
Starts web server

USAGE:
    lares server [OPTIONS]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -H, --host <host>            Specifies server host [env: LARES_HOST=]  [default: 127.0.0.1]
    -i, --interval <interval>    Specifies crawl interval (unit: minutes) [env: LARES_INTERVAL=]  [default: 30]
    -P, --password <password>    Specifies authentication password [env: LARES_PASSWORD=]
    -p, --port <port>            Specifies alternate port [env: LARES_PORT=]  [default: 4000]
    -u, --username <username>    Specifies authentication username [env: LARES_USERNAME=]

要启动一个监听 127.0.0.1:4000 的拉雷斯服务器,仅接受使用 laresapassword 进行认证,并将SQLite数据库放置在 /var/lares.db,请运行

$ lares --database /var/lares.db server --host 127.0.0.1 --port 4000 \
  --username lares --password apassword

Docker Compose

如果您想使用Docker Compose启动Lares主机,可以从以下配置开始

version: '3'
services:
  lares:
    image: fanzeyi/lares:latest
    ports:
      - "127.0.0.1:4000:4000"
    restart: always
    # Uncomment this to persist the storage on the host.
    # volumes:
    #  - ./run/lares:/var/lares
    environment:
      LARES_DATABASE: /var/lares/lares.db
      LARES_HOST: 0.0.0.0
      LARES_USERNAME: username
      LARES_PASSWORD: password

然后您可以使用 docker-compose exec lares lares 访问容器内的Lares命令行界面。例如,如果您想添加一个订阅,请使用

docker-compose exec lares lares feed add http://example.com/

许可证

MIT

依赖项

~44–60MB
~1M SLoC