十分钟搭建属于自己的信息流—FreshRSS
原文地址:https://blog.laoda.de/archives/docker-compose-install-freshrss
1. 前言
为什么要用 RSS?
因为它们提供了一种可定制的、无算法的方式来聚合和访问来自多个来源的内容,使我们能够高效管理信息过载,并在不受社交媒体干扰的情况下保持对自己感兴趣内容的更新。
2. 介绍
这一期我们来介绍另一个和 TinytinyRSS 类似的 RSS 管理服务——FreshRSS。
相较于 Tiny Tiny RSS,它有着更低的资源使用、更现代和用户友好的界面,以及更好的文档,使得对于技术能力较弱的用户来说,设置和维护更加容易。
3. 相关地址
官方 GitHub 地址:https://github.com/FreshRSS/FreshRSS (目前 9.2k 个 star,欢迎大家去给项目点星星!)
4. 搭建环境
- 服务器:建议服务器内存 1G 以上
- 系统:Debian 11
- 安装好 Docker、Docker-compose
- 【必需】域名一枚,并做好解析到服务器上
- 【非必需】提前安装好宝塔面板海外版本 aapanel,并安装好 Nginx
5. 搭建方式
5.1 安装 Docker
5.2 创建安装目录
创建一下安装的目录:
sudo -i
mkdir -p /root/data/docker_data/freshrss
cd /root/data/docker_data/freshrss
接着我们来编辑下docker-compose.yml
vim docker-compose.yml
services:
freshrss:
image: freshrss/freshrss:latest
container_name: freshrss
environment:
- CRON_MIN=*/20 #每20分钟刷新一次
- TZ=Asia/Shanghai
volumes:
- ./data:/var/www/FreshRSS/data
- ./extensions:/var/www/FreshRSS/extensions
ports:
- 8080:80 #左边的8080可以改成服务器上没有用过的端口
depends_on:
- postgres
restart: always
postgres:
image: postgres:alpine
container_name: freshrss-postgres
environment:
- POSTGRES_USER=freshrss
- POSTGRES_PASSWORD=freshrss #密码可以自己修改
- POSTGRES_DB=freshrss
volumes:
- ./freshrss-postgres-data:/var/lib/postgresql/data
restart: always
同样,修改完成之后,可以在英文输入法下,按 i
修改,完成之后,按一下 esc
,然后 :wq
保存退出。
5.3 打开服务器防火墙(非必需)并访问网页
打开防火墙的端口 8080
如果你在 docker-compose 文件里换了 9009
,这边就需要填 9009
,以此类推
查看端口是否被占用(以 8080
为例),输入:
lsof -i:8080 #查看 8080 端口是否被占用,如果被占用,重新自定义一个端口
如果啥也没出现,表示端口未被占用,我们可以继续下面的操作了~
如果出现:
-bash: lsof: command not found
运行:
apt install lsof #安装 lsof
如果端口没有被占用(被占用了就修改一下端口,比如改成 8381
,注意 docker 命令行里和防火墙都要改)
5.4 启动 freshrss
cd /root/data/docker_data/freshrss
docker compose up -d # 注意,老版本用户用 docker-compose up -d
等待拉取好镜像,出现 done
的字样之后,
理论上我们就可以输入 http://ip:8080
访问了。
但是这边我们推荐先搞一下反向代理!
做反向代理前,你需要一个域名!
6. 利用宝塔面板反向代理
发现还是有不少小伙伴习惯用宝塔面板,这边也贴一个宝塔面板的反代配置:
直接新建一个站点,不要数据库,不要 php,纯静态即可
然后打开下面的配置,修改 Nginx 的配置。
代码如下:
location / {
proxy_pass http://127.0.0.1:8080/; # 注意改成你实际使用的端口
rewrite ^/(.*)$ /$1 break;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Upgrade-Insecure-Requests 1;
proxy_set_header X-Forwarded-Proto https;
}
7. 使用教程
建议参考官方配置文档:https://github.com/freshrssapp/freshrss/blob/main/docs/configuration.md
7.1 安装与配置
数据库信息
主机记得填postgres
,其他的按docker-compose.yaml
里面的填
设置账号密码:
安装成功!
登录
默认订阅了 Fresh RSS 的官方 GitHub 仓库的 releases
这边我们不管,先来订阅一下咕咕的博客,最近视频更新进度缓慢,但是博客还是会经常更新的,订阅了博客的 RSS 之后,只要我一更新博客,你就能第一时间看到啦!
以咕咕的博客为例子,添加博客的 RSS:https://blog.laoda.de/rss.xml
“订阅管理”——“添加订阅源或分类”
可以先给分类起个名字,比如 “个人博客”
然后再次点击 “添加订阅源”
输入咕咕博客的 RSS:https://blog.laoda.de/rss.xml
点击左上角 FreshRSS 的图片,就能回到首页了,
可以看到已经订阅成功!
7.2 扩展下载
FreshRSS 还有很多扩展可以下载,
你可以选择合适的扩展进行下载。
有一个吐槽的点是,这个下载是要手动的...
扩展的 GitHub 仓库:https://github.com/FreshRSS/Extensions
扩展的下载地址:https://github.com/FreshRSS/Extensions/archive/master.zip
基本上就是这个包,我们上传到服务器里。(当然你可以直接用服务器来下载,这样就省得上传这个步骤了)
7.2.1 直接命令行操作(二选一)
cd /root/data/docker_data/freshrss/extensions/
wget https://github.com/FreshRSS/Extensions/archive/master.zip
unzip master.zip
cd Extensions-master
mv /root/data/docker_data/freshrss/extensions/Extensions-master/* /root/data/docker_data/freshrss/extensions/
然后记得重启一下容器:
cd /root/data/docker_data/freshrss
docker compose down
docker compose up -d
7.2.2 如果你用的是 finalshell 的话(二选一)
上传插件
使用 unzip 命令来解压缩,
移动到我们制定的文件夹里
mv /root/data/docker_data/freshrss/extensions/Extensions-master/* /root/data/docker_data/freshrss/extensions/
刷新
7.3 配置 API
允许手机访问,
设置一个 API 密码,
手机端,IOS 推荐用 Reeder,安卓推荐 Read You
注意手机 app 登录的时候,末尾还要加上greader.php
比如:https://xxxxx.com/api/greader.php
7.4 更新 freshrss
cd /root/data/docker_data/freshrss
docker-compose pull
docker-compose up -d # 请不要使用 docker-compose stop 来停止容器,因为这么做需要额外的时间等待容器停止;docker-compose up -d 直接升级容器时会自动停止并立刻重建新的容器,完全没有必要浪费那些时间。
docker image prune # prune 命令用来删除不再使用的 docker 对象。删除所有未被 tag 标记和未被容器使用的镜像
提示:
WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N]
输入 y
利用 Docker 搭建的应用,更新非常容易~
7.5 卸载 freshrss
同样进入安装页面,先停止所有容器。
cd /root/data/docker_data/freshrss
docker-compose down
cd ..
rm -rf /root/data/docker_data/freshrss # 完全删除
可以卸载得很干净。
参考资料
官方 GitHub:https://github.com/FreshRSS/FreshRSS
评论