使用 Docker 部署 FreshRSS 自建专属 RSS 服务

安装

本文提到的所有服务均为 Docker 安装，所以在开始 FreshRSS 的安装之前先需先配置好 Docker。所使用 VPS 的系统为 Ubuntu 20.04，理论上 Debian 系的所用命令通用，Red Hat 系的请自行替换部分安装命令。

参考 官方文档 安装 Docker：

代码语言：javascript复制

# 使用官方一键安装脚本
sudo curl -fsSL https://get.docker.com | sh

# 如果是非 Root 账户，将当前账户添加到 "docker" 组
sudo usermod -aG docker <your-user>

随后安装 Docker 三剑客之一——Docker Compose，有它可以方便处理存在依赖关系的服务。即便没有依赖，将长长的 bash 命令换成 yaml 文件的格式传入也舒服多了，不是吗？

代码语言：javascript复制

# 从 GitHub 下载到本地相应目录
sudo curl -L "https://github.com/docker/compose/releases/download/1.28.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 赋予 Docker Compose 目录相应权限
sudo chmod  x /usr/local/bin/docker-compose

第一条代码中的 1.28.2 可以更换为任何你希望获取的 版本。

FreshRSS 基础服务

除了 FreshRSS 本身，还需要一个数据库才能让它跑起来。官方示例中给出了 MySQL/MarriaDB/PostgreSQL 三种方案，这里只以 PostgreSQL 举例。

创建一个新目录如 ~/freshrss 并进入该位置，新建 docker-compose.yml，这就是 Docker Compose 的默认配置文件。

代码语言：javascript复制

# 创建 FreshRSS 目录并进入
mkdir ~/freshrss && cd ~/freshrss

# 新建 Docker Compose 配置文件
touch docker-compose.yml

# 编辑配置文件，反正我习惯用 Vim
vim docker-compose.yml

代码语言：javascript复制

# ~/freshrss/docker-compose.yml

version: "3"

services:
  freshrss-db:
    image: postgres:latest
    container_name: freshrss-db
    hostname: freshrss-db
    restart: unless-stopped
    volumes:
      - freshrss-db:/var/lib/postgresql/data
    environment:
      POSTGRES_USER: freshrss
      POSTGRES_PASSWORD: freshrss
      POSTGRES_DB: freshrss

  freshrss-app:
    image: freshrss/freshrss:latest
    container_name: freshrss-app
    hostname: freshrss-app
    restart: unless-stopped
    ports:
      - "8080:80"
    depends_on:
      - freshrss-db
    volumes:
      - ./data:/var/www/FreshRSS/data
      - ./extensions:/var/www/FreshRSS/extensions
    environment:
      CRON_MIN: '*/45'
      TZ: Asia/Shanghai

volumes:
  freshrss-db:

配置文件几乎和 模板 一致，只需要注意几点：

• 14~16 行是数据库配置，请自行修改、避免使用默认配置
• 24 行是宿主机端口映射到容器内端口，由于使用 http 通信请勿修改冒号后的 80 端口，冒号前的 8080 可以更改为任意空闲的端口
• 31 行是 RSS 刷新周期，单位为分钟，*/45 表示每 45 分钟刷新一次
• 32 行是时区

:wq 保存退出后，可先前台执行观察输出，若确实无误后便可置于后台持续运行。

代码语言：javascript复制

# 先前台执行观察输出
docker-compose up

# 确认无误后后台持续运行
docker-compose up -d

Caddy 反向代理

如果上一步没问题的话，已经可以通过 ip:port 的形式访问了。但服务器 IP 不仅不方便记忆，而且也无法使用 HTTPS 加密。所以打算借助 Caddy 接管 80/443 端口，将域名请求反代至特定端口。

至于为什么不用 Nginx/Apache 等更为常见的程式，Caddy 性能方面确实不及它们，但是自动获取 SSL 证书以及过分简单的配置文件，让使用 Caddy 不要太方便；再就是和从 Tiny Tiny RSS 切换至 FreshRSS 的理由一样，Caddy 更加轻量、占用小。这或许是对「最小化原则」的另类诠释？

参见 这篇问答，不能用 localhost、127.0.0.1 访问从 Docker 映射出来的端口，不然迎接你的可能是 Connection Refused（别问我怎么知道的）。如果你使用的是默认配置，则监听下名为 docker0 的 Docker Bridge。

代码语言：javascript复制

ip addr show docker0

不出意料会得到类似以下输出，进而得到 docker0 的内网地址，如这里的 172.17.0.1。

有了该地址与端口，就可以着手于 Caddy 的配置了。由于 Caddy 会直接接管宿主机 80/443 端口，如果有新域名请求需要处理还是修改同一份 Caddy 配置文件Caddyfile。为方便管理还是建议单独给 Caddy 开一份 Docker Compose 文件，不要共用 FreshRSS 的。

代码语言：javascript复制

# 创建 Caddy 目录并进入
mkdir ~/caddy && cd ~/caddy

# 新建 Docker Compose 配置文件
touch docker-compose.yml

# 新建 Caddy 配置文件
touch Caddyfile

先编辑 Caddy 配置文件 Caddyfile。

代码语言：javascript复制

vim Caddyfile

代码语言：javascript复制

// ~/caddy/Caddyfile

freshrss.example.net {
  tls your_email@example.net
  reverse_proxy 172.17.0.1:8080
}

完了！是不是简单得过分？相比于其他动辄半百行配置文件的而言。Caddy 还能自动申请 Let’s Encypt 颁发的免费 SSL 证书，只需在第 2 行填写你的邮箱即可。当然你也可以上传自己的 SSL 证书，只需将 tls 行替换为类似以下内容，并把证书放在 ~/caddy/ssl/ 下，之后再在 Docker Compose 配置文件将 ~/caddy/ssl 对应容器内的相应位置即可。

代码语言：javascript复制

tls /etc/ssl/certs/path/to/cert.pem /etc/ssl/certs/path/to/key.pem

:wq 保存退出后继续编辑 Docker Compose 配置文件：

代码语言：javascript复制

vim docker-compsoe.yml

代码语言：javascript复制

# ~/caddy/docker-compose.yml

version: "3"

services:
  caddy:
    image: caddy:latest
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - ./site:/srv
      - ./ssl:/etc/ssl/certs
      - caddy_data:/data
      - caddy_config:/config

volumes:
  caddy_data:
  caddy_config:

之后同样，先前台运行，如果使用域名已经能够访问网站，就切换到后台持续运行。

代码语言：javascript复制

# 先前台执行观察输出
docker-compose up

# 确认无误后后台持续运行
docker-compose up -d

配置

完成之前的安装，在浏览器中输入设置的域名或服务器 IP 端口的形式访问 FreshRSS。第一次访问就会进入初始化页面。

初始化

语言选择有简体中文选项，环境检查由于 Docker 严格控制变量基本不会出问题，大概需要注意的只有数据库连接，其余初始化配置就不赘述了。

用户名、密码、数据库分别对应之前 Docker Compose 配置文件中的 POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB；表前缀任意填；主机名要稍微注意一下，既非 127.0.0.1/localhost 也不是刚刚 Caddy 反代的 172.17.0.1，而要用容器的 IP，用下述命令可以得到。

代码语言：javascript复制

# 获取 Container ID
docker ps

# 查看指定容器信息
docker inspect <container id>

所以示例中填写的就是 172.19.0.2，也只有这样才能连接上 PostgreSQL。

除此以外，如果你只运行一个 PostgreSQL 数据库，可以直接将宿主机 5432 端口映射到 PostgreSQL 容器的 5432 端口，然后使用 172.17.0.1:5432 访问。这样在连接数据库这一步就可以填 172.17.0.1。但是不建议这么做。

应用配置

默认配置大多没有问题，自己浏览一遍根据习惯来即可，但最好关闭「阅读 => 合适将文章标记为已读」的「在滚动浏览后」，否则即便不点击打开文章、只要你划过去就算已读了。

导入信息源

FreshRSS 支持一键导入信息源，这让迁移省心了不少。我尝试过的 Tiny Tiny RSS 和 Inoreader 的导出文件均可成功导入 FreshRSS，相信大多时候都不会在这里遇到问题。通过「订阅管理 => 导入/导出 => 选择文件」选择要导入信息源的文件即可。

插件

FreshRSS 虽有官方的插件仓库，但无法直接在插件配置中直接添加插件，说实话这我不是很理解，但在之前部署 FreshRSS 的 Docker Compose 配置文件中已经将 ~/freshrss/extensions/ 对应了 FreshRSS 在容器内的插件位置，所以只需要将插件拖至 ~/freshrss/extensions/ 即可。

Fever API

若希望在第三方应用中阅读，目前最方便的方法还是借助 Fever API。尽管它已经不怎么更新，但无所谓，毕竟 RSS 协议已经很稳定了。默认 Fever API 路径为 /api/fever.php。

sql 数据库 容器镜像服务 postgresql 容器

0 人点赞