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