蚁阅 ( RSSAnt )

让 RSS 更好用，轻松订阅你喜欢的博客和资讯

主要特点

• 非社交，无广告，无推荐，专注阅读
• 为移动端优化，适合随时随地阅读
• 按订阅更新频率区分消息，好文章慢慢看，读资讯一目十行
• 输入博客地址，智能查找订阅，支持批量导入导出
• 智能图片代理，解决图片无法加载问题
• 开源，可以自己部署，也可以直接用在线版

部署文档

蚁阅基于Docker部署，服务器环境要求:

• Linux, 1G 内存
• Docker + 镜像加速器

第一步，准备配置文件

配置文件保存为 ~/rssant/rssant.env 。

# 关闭DEBUG请置0
RSSANT_DEBUG=1

# 请随机生成一个字符串
RSSANT_SECRET_KEY=SECRET

# 应用的访问地址
RSSANT_ROOT_URL=http://localhost:6789

# 检查订阅的时间间隔，默认30分钟
RSSANT_CHECK_FEED_MINUTES=30

# 请前往GITHUB设置页面申请，不需要Github登录可留空
# GitHub OAuth callback:
# http://<你的域名>/api/v1/accounts/github/login/callback/
RSSANT_GITHUB_CLIENT_ID=
RSSANT_GITHUB_SECRET=

# SMTP邮件功能，不需要注册功能可留空
RSSANT_ADMIN_EMAIL=
RSSANT_SMTP_ENABLE=false
RSSANT_SMTP_HOST=smtp.qq.com
RSSANT_SMTP_PORT=465
RSSANT_SMTP_USE_SSL=true
RSSANT_SMTP_USERNAME=
RSSANT_SMTP_PASSWORD=

# 以下配置保持不动
RSSANT_SCHEDULER_NETWORK=rssant
RSSANT_PG_DB=rssant
RSSANT_PG_HOST=localhost
RSSANT_PG_USER=rssant
RSSANT_PG_PASSWORD=rssant

第二步，启动服务

将以下脚本保存为 ~/rssant/start.sh，其中端口 6789 可改为自定义端口。

#!/bin/bash

docker volume create rssant-data
docker volume create rssant-postgres-data
docker volume create rssant-postgres-logs

docker rm -f rssant
docker run -ti --name rssant -d 
-p 6789:80 
--env-file ~/rssant/rssant.env 
-v rssant-data:/app/data 
-v rssant-postgres-data:/var/lib/postgresql/11/main 
-v rssant-postgres-logs:/var/log/postgresql 
--log-driver json-file --log-opt max-size=50m --log-opt max-file=10 
--restart unless-stopped 
guyskk/rssant:latest

docker logs --tail 1000 -f rssant

启动服务 bash ~/rssant/start.sh, 当看到下面的日志时，服务就启动好了。

# 初始化数据库的日志
I 2019-12-22 11:01:36 scripts.django_db_init:26   extension hstore created
I 2019-12-22 11:01:36 scripts.django_db_init:33   create admin user
I 2019-12-22 11:01:36 scripts.django_db_init:41   update site info
I 2019-12-22 11:01:36 scripts.django_db_init:53   create github social app
# 程序正常运行中的日志
I 2019-12-22 13:16:08 rssant_harbor.actors.rss:418  delete 0 old feed creations
I 2019-12-22 13:16:08 rssant_harbor.actors.rss:423  retry 0 status=UPDATING feed creations
I 2019-12-22 13:16:08 rssant_harbor.actors.rss:429  retry 0 status=PENDING feed creations

执行 docker exec -ti rssant supervisorctl status, 以下进程状态说明一切正常：

api                              RUNNING   pid 9, uptime 0:10:03
async-api                        RUNNING   pid 10, uptime 0:10:03
harbor                           RUNNING   pid 11, uptime 0:10:03
initdb                           EXITED    Dec 22 01:15 PM
nginx                            RUNNING   pid 15, uptime 0:10:03
postgres                         RUNNING   pid 17, uptime 0:10:03
scheduler                        RUNNING   pid 19, uptime 0:10:03
worker                           RUNNING   pid 21, uptime 0:10:03

访问 http://localhost:6789/admin/ 用户名: admin 密码: admin

点击页面右上角 “CHANGE PASSWORD” 修改密码。

大功告成，返回首页即可开始使用了！

如需停止服务，执行: docker rm -f rssant
如需备份数据，备份 rssant-postgres-data 这个卷即可，其他卷可忽略。

反馈与协作

蚁阅主仓库托管在 码云 上，GitHub 主要作为镜像仓库。

码云和 GitHub 均可提交 Issue:

• https://gitee.com/anyant/rssant/issues
• https://github.com/anyant/rssant/issues

码云和 GitHub 也均可提交 Pull Request:

• https://gitee.com/anyant/rssant/pulls
• https://github.com/anyant/rssant/pulls

如果你有码云账号，建议到码云提交 Pull Request。
非常感谢你的支持！

开发环境

系统级依赖

• Linux 或 Mac OSX
• Docker + 镜像加速器
• Python + pyenv
• Node.js + nvm

后端

安装依赖

git clone [email protected]:anyant/rssant.git
cd rssant
pyenv virtualenv -p python3.7 3.7.4 rssant
pyenv local rssant
pip install -r requirements.txt

启动数据库

./scripts/postgres_start.sh

初始化数据库

python manage.py migrate
python manage.py runscript django_db_init

开多个终端，分别启动以下服务

python manage.py runserver 6788

python -m rssant_async.main

python -m rssant_scheduler.main --concurrency 10

python -m rssant_harbor.main --concurrency 10

python -m rssant_worker.main --concurrency 10

访问 http://127.0.0.1:6788/doc/v1/ 账号: admin 密码: admin

访问 http://127.0.0.1:6788/docs/v1/#api-v1-feed-import-create

点击 Interact，输入任意博客地址，例如: https://www.ruanyifeng.com/blog/ , 然后提交。

请求应当正常返回，后台任务控制台会输出查找订阅的日志信息。

测试

pytest

打包

docker build -t rssant/api:latest .

前端

git clone [email protected]:anyant/rssant-web.git
cd rssant-web
npm install
npm run serve

访问 http://127.0.0.1:6789/ 即可看到前端页面。

打包

docker build -t rssant/web:latest .

rssant/box

将前端代码放到 box/web 目录下

cd rssant
git clone [email protected]:anyant/rssant-web.git box/web

打包

./box/build.sh

运行

./box/run.sh