FreshRSS部署以及安装扩展

在Docker中部署FreshRSS及安装扩展指南

本指南将引导你通过Docker在你的服务器上部署FreshRSS，以及如何安装和启用扩展，以增强你的RSS阅读体验。作为示例，我们将安装YouTube/PeerTube Video Feed扩展。

我开始学习了网上使用docker-compose的做法，用起来也比较顺手，后来重装发现用docker更快，详情见官网。
下面是我的代码，根据官网更改了时区和端口：

docker run -d --restart unless-stopped --log-opt max-size=10m \
  -p 8001:80 \
  -e TZ=Asia/Shanghai \
  -e 'CRON_MIN=1,31' \
  -v freshrss_data:/var/www/FreshRSS/data \
  -v freshrss_extensions:/var/www/FreshRSS/extensions \
  --name freshrss \
  freshrss/freshrss

准备工作

1. 创建工作目录：首先，创建一个文件夹用于存放所有相关的Docker配置文件。例如freshrss-docker。

   mkdir freshrss-docker
   cd freshrss-docker

2. 下载Docker Compose文件：接下来，将Docker Compose配置文件保存到你的工作目录中。

   nano docker-compose.yml

   • docker-compose.yml

   version: "2.4"
   
   volumes:
     data:
     extensions:
   
   services:
   
     freshrss:
       image: freshrss/freshrss:latest
       container_name: freshrss
       restart: unless-stopped
       logging:
         options:
           max-size: 10m
       volumes:
         - data:/var/www/FreshRSS/data
         - extensions:/var/www/FreshRSS/extensions
       ports:
         - "port:80"  #前面的port改为你自己的端口
       environment:
         TZ: Asia/Shanghai  #时区，见http://php.net/timezones
         CRON_MIN: '3,33' #Cron job to refresh feeds at specified minutes
         FRESHRSS_ENV: development

   nano docker-compose-db.yml

   • docker-compose-db.yml

   version: "2.4"
   
   volumes:
     db:
   
   services:
   
     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: ${DB_BASE:-freshrss}
         POSTGRES_USER: ${DB_USER:-freshrss}
         POSTGRES_PASSWORD: ${DB_PASSWORD:-freshrss}
       command:
         # Examples of PostgreSQL tuning.
         # https://wiki.postgresql.org/wiki/Tuning_Your_PostgreSQL_Server
         # When in doubt, skip and stick to default PostgreSQL settings.
         - -c
         - shared_buffers=1GB
         - -c
         - work_mem=32MB

   nano docker-compose-local.yml

   • docker-compose-local.yml

   version: "2.4"
   
   services:
   
     freshrss:
       ports:
         - "${PUBLISHED_PORT:-port}:${LISTEN:-80}"  #前面的port改为你自己的端口

修改端口设置

• 在docker-compose.yml中，将ports节中的port替换为你希望FreshRSS使用的端口号。

  ports:
    - "自定义端口:80"  # 将"自定义端口"更改为你的端口号

• 在docker-compose-local.yml中，同样替换ports节中的port。

  ports:
    - "${PUBLISHED_PORT:-自定义端口}:${LISTEN:-80}"  # 将"自定义端口"更改为你的端口号

部署FreshRSS

使用以下命令来部署和管理FreshRSS：

• 更新Docker镜像

  docker-compose -f docker-compose.yml -f docker-compose-db.yml pull

• 启动FreshRSS

  docker-compose -f docker-compose.yml -f docker-compose-db.yml -f docker-compose-local.yml up -d --remove-orphans

• 查看日志

  docker-compose -f docker-compose.yml -f docker-compose-db.yml logs -f --timestamps

访问FreshRSS

部署完成后，通过浏览器访问http://你的IP:自定义端口/。如果一切顺利，你将看到FreshRSS的初次引导界面。

如果开启https，并且在登录后出现403 CSRF验证失败的错误，则需要设置环境变量CSRF_TRUSTED_ORIGINS ,值为域名或IP地址:https://*.example.com

安装扩展

以YouTube/PeerTube Video Feed扩展为例

1. 下载并解压扩展

   wget https://github.com/kevinpapst/freshrss-youtube/archive/master.zip
   unzip master.zip

2. 复制扩展到容器

   使用docker cp命令将扩展复制到容器中。请替换path/to/freshrss-youtube-master/xExtension-YouTube为实际路径。

   docker cp path/to/freshrss-youtube-master/xExtension-YouTube 容器ID:/var/www/FreshRSS/extensions/

3. 确认扩展安装成功

   docker exec 容器ID ls /var/www/FreshRSS/extensions/

4. 重启FreshRSS容器

   docker restart 容器ID

启用扩展

登录到FreshRSS的管理界面，在扩展部分找到并启用新安装的扩展。