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日 |
#602 在 HTTP服务器
65KB
1.5K SLoC
拉雷斯:最小化Fever API实现
拉雷斯 是用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
的拉雷斯服务器,仅接受使用 lares
和 apassword
进行认证,并将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