20251113 FreshRSS 备份与升级

相关资源:FreshRSS 用户手册FreshRSS 官方文档插件汇总

备份与还原

  1. 确定 FreshRSS 的数据路径,本人用的是 Docker 默认路径为 /var/www/FreshRSS/data,该路径映射的外部路径为:/var/lib/docker/volumes/freshrss_data/_data
  2. 选择需要备份的内容,完整备份可考虑压缩保存整个 data 文件夹;FreshRSS 的全局配置文件是 data/config.php;假设用户名称为 qwq,则用户配置文件是 data/users/qwq/config.php,用户数据库文件是 data/users/xxx/db.sqlite;根据个人需求进行合理备份
  3. 从备份中还原配置文件,只需要重命名并替换即可;但对于数据库文件的还原,则需要执行脚本:
cd /usr/share/FreshRSS/
./cli/db-restore.php --delete-backup --force-overwrite
# 从 `data/users/*/backup.sqlite` 中恢复所有用户的各自数据库

补充说明:数据库的迁移过程,与备份还原过程是一样的

启动方式变更

改为 docker-compose 的方式启动

volumes:
  freshrss_data:
    external: true
  freshrss_extensions:
    external: true

services:
  freshrss:
    image: freshrss/freshrss:latest
    # # Optional build section if you want to build the image locally:
    # build:
    #   # Pick #latest (slow releases) or #edge (rolling release) or a specific release like #1.27.1
    #   context: https://github.com/FreshRSS/FreshRSS.git#latest
    #   dockerfile: Docker/Dockerfile-Alpine
    container_name: freshrss
    hostname: freshrss
    restart: unless-stopped
    logging:
      options:
        max-size: 10m
    volumes:
      - freshrss_data:/var/www/FreshRSS/data
      - freshrss_extensions:/var/www/FreshRSS/extensions
    environment:
      TZ: Europe/Paris
      CRON_MIN: '3,33'
      TRUSTED_PROXY: 172.16.0.1/12 192.168.0.1/16
    ports:
    - target: 80
      published: 8081

相关启动命令:

# Update
docker compose pull
# Run
docker compose -f docker-compose.yml up -d --remove-orphans
# Logs
docker compose logs -f --timestamps
# Stop
docker compose down --remove-orphans

FreshRSS 升级

本人目前的 FreshRSS 版本为 1.23.1,当前最新版为 (251113)

升级原因:(1)常规 bug 修复与体验升级(2)部分订阅源存在订阅失败的问题

网络在线更新

  • 确保授予 www-data 用户组的文件读取/写入权限
chown -R :www-data /var/www/FreshRSS
chmod -R 775 /var/www/FreshRSS
  • 访问 http://<your_server>/i/?c=update 并进行在线更新

更多升级方式可参阅官方文档的 FreshRSS 升级说明

插件推荐

插件安装方式:

  1. 下载插件压缩包,并上传至服务器或容器内
  2. 在 FreshRSS 安装目录下的 ./extensions 中解压

个人目前安装的插件:

往年同期文章