Docker 安装 FreshRSS 教程

本文将指导如何在 Linux 下使用 Docker 和 Docker Compose 安装 FreshRSS 开源 RSS 聚合器服务。

PS:本文同时适用于任何可安装 Docker 的 Linux 发行版。

什么是 FreshRSS?

FreshRSS 是一款免费且开源的 RSS 聚合器,设计用于帮助用户集中管理和阅读来自不同网站的新闻源。它具有高效、轻量的特点,并且支持多用户使用。

安装 Docker 和 Docker Compose

Debian 和 Ubuntu 系统请参考本站教程

其他 Linux 系统可以使用 Docker 官方的脚本安装 Docker 和 Docker Compose:

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

安装 FreshRSS

这里我们使用 PostgreSQL 数据库,首先创建一个目录用于存放 FreshRSS 的配置文件和数据库文件:

mkdir -p /opt/freshrss
cd /opt/freshrss

然后创建一个 docker-compose.yml 文件:

services:

  freshrss:
    image: freshrss/freshrss:latest
    container_name: freshrss
    hostname: freshrss
    restart: unless-stopped
    logging:
      options:
        max-size: 10m
    volumes:
      - ./data:/var/www/FreshRSS/data
      - ./extensions:/var/www/FreshRSS/extensions
    environment:
      TZ: Etc/UTC
      CRON_MIN: '3,33'
      TRUSTED_PROXY: 172.16.0.1/12 192.168.0.1/16
      ADMIN_EMAIL: 你的邮箱
      BASE_URL: 你的 FreshRSS 访问地址
    ports:
      - 127.0.0.1:8080:80

  freshrss-db:
    image: postgres:16
    container_name: freshrss-db
    hostname: freshrss-db
    restart: unless-stopped
    logging:
      options:
        max-size: 10m
    volumes:
      - ./db:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: freshrss
      POSTGRES_USER: freshrss
      POSTGRES_PASSWORD: freshrss
    command:
      - -c
      - shared_buffers=1GB
      - -c
      - work_mem=32MB

请自行替换 ADMIN_EMAIL 和 BASE_URL 的值,BASE_URL 需要写全,比如 https://freshrss.example.com

然后拉取 Docker 镜像并运行:

cd /opt/shlink
docker compose pull
docker compose up -d

安装配置 Nginx 反向代理

我们的 Docker Compose 配置文件中,FreshRSS 服务监听在 127.0.0.1:8080 端口,所以我们需要配置 Nginx 反代来访问,假设你 FreshRSS 的地址是 https://freshrss.example.com

freshrss.example.com 段配置:

	location / {
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header Host $http_host;
		proxy_http_version 1.1;
		proxy_set_header Upgrade $http_upgrade;
		proxy_redirect off;
		proxy_set_header        X-Forwarded-Proto $scheme;
		proxy_connect_timeout       300;
		proxy_send_timeout          300;
		proxy_read_timeout          300;
		send_timeout                300;
		proxy_pass http://127.0.0.1:8080;
	}

最后记得参考本站 Nginx SSL 配置教程加上 SSL 证书后,即可访问 https://freshrss.example.com/

配置 FreshRSS

访问 https://freshrss.example.com/,在安装向导中填写数据库信息:

  • 数据库类型:PostgreSQL
  • 数据库主机(Host):freshrss-db
  • 数据库名称(Database):freshrss
  • 数据库用户(User):freshrss
  • 数据库密码(Password):freshrss

然后点击 Install FreshRSS 即可完成安装。

如果需要安装插件,可以把插件上传到 /opt/freshrss/extensions 目录,然后在 FreshRSS 后台安装。

推荐在官方插件仓库里下载插件:FreshRSS Extensions

推荐安装 CustomCSS 插件,就可以使用自定义 CSS 样式了,个人比较喜欢这个主题系列

如果需要第三方客户端,可以在这里查看支持的应用:APIs & native apps

迁移 FreshRSS

可以参考《使用 Docker 安装 Mailcow 自建域名邮箱》。

备份 FreshRSS

我们可以定期备份 FreshRSS 网站文件和数据库,压缩网站目录和导出数据库命令如下:

 
backup_folder_name=$(date +"%Y_%m_%d_%I_%M_%p")
# 备份 FreshRSS 网站文件
tar --exclude /opt/freshrss/data/cache -zcvf data-$backup_folder_name.tar.gz /opt/freshrss/data
tar -zcvf extensions-$backup_folder_name.tar.gz /opt/freshrss/extensions
# 备份 FreshRSS 数据库
docker exec -t freshrss-db pg_dumpall -c -U freshrss | gzip > database-$backup_folder_name.gz
© 版权声明
THE END
喜欢就支持一下吧
点赞6赞赏 分享
评论 抢沙发
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情代码图片

    暂无评论内容