docker compose 部署配置 Awesome TTRSS 教程

前言

Tiny Tiny RSS 是一款基于 PHP 的免费开源 RSS 聚合阅读器。 Awesome TTRSS 旨在提供一个 「一站式容器化」 的 Tiny Tiny RSS 解决方案，通过提供简易的部署方式以及一些额外插件，以提升用户体验。

部署

• TTRSS

• PostgreSQL

• Mercury Parser API

• OpenCC API

配置 docker-compose.yml

• 建议在root目录下创建ttrss文件夹,以存放docker-compsoe.yml配置文件和postgres数据库目录.

• 下载 docker-compose.yml 至ttrss目录

• 更改 docker-compose.yml 中第7和23行两处的数据库密码

• 更改 docker-compose.yml 中第18行最终访问地址

• 修改 docker-compose.yml 中第9行的挂载目录,由~/postgres改为./postgres,以挂载至ttrss目录下.

version: "3"
services:
  database.postgres:
    image: sameersbn/postgresql:latest
#    container_name: postgres
    environment:
      - PG_PASSWORD=ttrss # please change the password
    volumes:
      - ~/postgres/data/:/var/lib/postgresql/data # persist postgres data to ~/postgres/data/ on the host
    restart: always

  service.rss:
    image: wangqiru/ttrss:latest
#    container_name: ttrss
    ports:
      - 181:80
    environment:
      - SELF_URL_PATH=http://localhost:181/ # please change to your own domain
      - DB_HOST=database.postgres
      - DB_PORT=5432
      - DB_NAME=ttrss
      - DB_USER=postgres
      - DB_PASS=ttrss # please change the password
      - ENABLE_PLUGINS=auth_internal,fever # auth_internal is required. Plugins enabled here will be enabled for all users as system plugins
    stdin_open: true
    tty: true
    restart: always
    command: sh -c 'sh /wait-for.sh $$DB_HOST:$$DB_PORT -- php /configure-db.php && exec s6-svscan /etc/s6/'

  service.mercury: # set Mercury Parser API endpoint to `service.mercury:3000` on TTRSS plugin setting page
    image: wangqiru/mercury-parser-api:latest
#    container_name: mercury
    expose:
      - 3000
    restart: always

  service.opencc: # set OpenCC API endpoint to `service.opencc:3000` on TTRSS plugin setting page
    image: wangqiru/opencc-api-server:latest
#    container_name: opencc
    environment:
      - NODE_ENV=production
    expose:
      - 3000
    restart: always

  # utility.watchtower:
  ##   container_name: watchtower
  #   image: containrrr/watchtower:latest
  #   volumes:
  #     - /var/run/docker.sock:/var/run/docker.sock
  #   environment:
  #     - WATCHTOWER_CLEANUP=true
  #     - WATCHTOWER_POLL_INTERVAL=86400
  #   restart: always

配置 HTTPS 协议

upstream ttrssdev {
    server 127.0.0.1:181;
}

server {
    listen 80;
    server_name  rss.ioiox.com;
    return 301 https://rss.ioiox.com$request_uri;
}

server {
    listen 443 ssl;
    gzip on;
    server_name  rss.ioiox.com;

    ssl_certificate /usr/local/nginx/conf/ssl/ioiox.com.crt;
    ssl_certificate_key /usr/local/nginx/conf/ssl/ioiox.com.key;

    # access_log /var/log/nginx/ttrssdev_access.log combined;
    # error_log  /var/log/nginx/ttrssdev_error.log;

    location / {
        proxy_redirect off;
        proxy_pass http://ttrssdev;

        proxy_set_header  Host                $http_host;
        proxy_set_header  X-Real-IP           $remote_addr;
        proxy_set_header  X-Forwarded-Ssl     on;
        proxy_set_header  X-Forwarded-For     $proxy_add_x_forwarded_for;
        proxy_set_header  X-Forwarded-Proto   $scheme;
        proxy_set_header  X-Frame-Options     SAMEORIGIN;

        client_max_body_size        100m;
        client_body_buffer_size     128k;

        proxy_buffer_size           4k;
        proxy_buffers               4 32k;
        proxy_busy_buffers_size     64k;
        proxy_temp_file_write_size  64k;
    }
}

启动 docker compose

docker-compose up -d

修改配置

docker-compose down
# 关闭 Docker 容器
# 修改 docker-compose.yml 配置文件
docker-compose up -d
# 再次启动 docker compose

更新

手动更新

docker-compose down
# 关闭 Docker 容器
docker pull wangqiru/ttrss:latest
docker pull wangqiru/mercury-parser-api:latest
docker pull wangqiru/opencc-api-server:latest
docker pull sameersbn/postgresql:latest
# 更新镜像
docker-compose up -d
# 重新启动 Docker 容器

自动更新

service.mercury:
  image: wangqiru/mercury-parser-api:latest
#  container_name: mercury
  expose:
    - 3000
  restart: always
    # ⬇️ 这将使 Watchtower 跳过对 mercury-parser-api 的更新检测
  labels:
      - com.centurylinklabs.watchtower.enable=false

迁移

备份数据库

docker exec postgres pg_dumpall -c -U postgres > export.sql

恢复数据库

cat export.sql | docker exec -i postgres psql -U postgres

定时备份

crontab -e
# 添加以下任务,每天凌晨1点备份数据库到 ttrss 目录.
0 1 * * * cd /root/ttrss && docker exec postgres pg_dumpall -c -U postgres > export.sql

插件

Mercury 全文获取

开启插件

填写 API 地址

service.mercury:3000

设置信息源全文获取

Fever API

• 添加账号类型为Fever

• 地址为 https://你的rss域名.com/plugins/fever

• 用户名为你的登陆ID

• 密码为Fever Emulation中创建的专用密码

结语