FreshRSS op engem Managed VPS hosten: Är RSS-Feeds op Ärem Server

Wat FreshRSS mécht

FreshRSS ass en Aggregator fir RSS-Feeds, deen een selwer host, a PHP geschriwwen. Säi README beschreift en als liicht, einfach ze handhaben, staark an upassbar, an iwwer zwanzeg Sprooche iwwersat. Et ass eng Applikatioun fir méi Benotzer, mat engem anonyme Liesmodus a perséinlechen Etiketten.

• D’Liesen: Är Abonnementer an Kategorien opgedeelt, Etiketten, Favoritten a gespäichert Sichen.
• WebSub: FreshRSS kritt nei Artikelen direkt vu kompatibele Quellen, déi se schécken, amplaz op déi nächst Aktualiséierung ze waarden.
• Web Scraping: fir e Site ouni RSS- oder Atom-Feed liest FreshRSS d’Säit selwer mat XPath-Reegelen, an hie ka och JSON-Dokumenter liesen.
• D’Deelen: eng Auswiel vun Artikele kann als HTML, RSS oder OPML nei publizéiert ginn.
• D’Appen: eng API fir d’Mobil- an d’Desktop-Appen, eng Kommandozeil an Extensiounen.

FreshRSS gëtt vu senger Communautéit op GitHub entwéckelt, a säin offiziellen Internetsite gëtt vun der FreshRSS-Communautéit publizéiert. D’Extensioune leien an engem separaten Depot, an d’Dokumentatioun riicht sech u Benotzer, Administrateuren an Entwéckler.

Wat d’AGPL-3.0-Lizenz erlaabt

FreshRSS gëtt ënner der GNU Affero General Public License, Versioun 3 publizéiert: säi Manifest composer.json deklaréiert en als AGPL-3.0, a säi README verlinkt den Text vun der Lizenz. Dësen Text erkläert eng onbegrenzt Erlaabnes, de net geännerte Programm lafen ze loossen. Dir kënnt also d’Image notzen, déi de Projet publizéiert, fir Är Entreprise an Äert Team, ouni eng Lizenz ze kafen.

Den Artikel 13 setzt eng Bedingung derbäi, déi dem AGPL eegen ass: wann Dir de Programm ännert, muss Är Versioun all deenen, déi se iwwer d’Netz um Distanz notzen, d’Méiglechkeet ginn, säi Quellcode gratis ze kréien. Eng Extensioun vun Drëtten, déi Dir am Volume extensions derbäisetzt, follegt hirer eegener Lizenz.

D’Installatioun mat Docker Compose

De Projet publizéiert seng offiziell Imagen op Docker Hub, als freshrss/freshrss, zesumme mat engem Beispill-Fichier fir Compose. Op engem Server, wou Docker installéiert ass, erstellt Dir en Dossier mam Numm freshrss a leet dës compose.yaml dran of, aus dësem Fichier an dem Docker-README geholl:

volumes:
  data:
  extensions:

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
    ports:
      - 127.0.0.1:8080:80
    environment:
      TZ: UTC
      CRON_MIN: '3,33'
      TRUSTED_PROXY: 172.16.0.1/12 192.168.0.1/16
    healthcheck:
      test: ["CMD", "cli/health.php"]
      timeout: 10s
      start_period: 60s
      start_interval: 11s
      interval: 75s
      retries: 3

docker compose up -d

• E Port, deen op 127.0.0.1 publizéiert ass: FreshRSS ass nëmmen iwwer de Reverse Proxy z’erreechen, deen um selwechte Server steet. De Beispill-Fichier vum Projet publizéiert de Port 8080 fir e lokale Gebrauch; d’Adress 127.0.0.1 reservéiert en hei fir de Proxy.
• De Volume data hält d’Konfiguratioun, d’Konten an, mat SQLite, d’Datebank vun all Benotzer. De README weist drop hin, datt en all perséinlech Donnéeën enthält. Docker Compose benennt en nom Dossier: freshrss_data.
• De Volume extensions hält d’Extensioune vun Drëtten, wann Dir där derbäisetzt.
• TZ hëlt d’Zäitzon vum Server, am PHP-Format; standardméisseg ass et UTC.
• TRUSTED_PROXY behält de Wäert aus dem Beispill-Fichier: déi privat Beräicher, aus deenen d’Ufroe vum Proxy kommen. Domat gëtt entscheet, wéi eng Adress an d’Logbicher kënnt, déi vum Besucher oder déi vum Proxy.
• D’Gesondheetskontroll leeft cli/health.php a regelméissegen Ofstänn, sou datt Docker weess, ob d’Instanz äntwert.

Den Tag latest, de Standard, follegt der leschter versionéierter Verëffentlechung; edge follegt der Rolling Release; en Tag wéi 1.30.4 fixéiert eng Versioun, an de Suffix -alpine gëtt dat selwecht op enger Alpine-Basis amplaz vun Debian. D’Sektioun iwwer d’Aktualiséierunge kënnt op dës Wiel zeréck.

D’Installatioun ofschléissen

Soubal de Reverse Proxy op der Plaz ass, mécht Är HTTPS-Adress op: den Installatiounsassistent freet no der Sprooch, kontrolléiert de Server, proposéiert d’Wiel vun der Datebank an erstellt dann den Administrateurskont, mat sengem Passwuert an der Umeldemethod. SQLite funktionéiert, ouni datt eppes virbereet muss ginn. D’Installatioun geet och iwwer d’Kommandozeil, mat cli/do-install.php an cli/create-user.php, iwwer docker exec --user www-data freshrss gestart.

Wat d’Ressourcen ugeet, freet de README e liichte Server, ënner Linux oder Windows, a seet, datt FreshRSS souguer op engem Raspberry Pi 1 leeft, mat Äntwertzäiten ënner enger Sekonn, mat 150 Feeds an 22.000 Artikelen. D’Gréisst hänkt vun der Zuel vun de Benotzer, de Feeds an den opgehuelenen Artikelen of. Op engem Managed VPS beschreift Dir eis Äre Gebrauch, a mir recommandéieren Iech déi passend Gréisst.

HTTPS: de Reverse Proxy

Fir d’Produktioun rot den Docker-README zu engem Reverse Proxy um Host-Server, deen HTTPS liwwert. Wielt als éischt en Domainnumm oder eng Subdomain, wéi rss.example.com, déi mat A- an AAAA-Enregistrementer op de Server weist. De Projet recommandéiert Traefik a publizéiert dofir e komplette Compose-Fichier, mat Zertifikater vu Let’s Encrypt an der Ëmleedung vun HTTP op HTTPS; e gëtt och Beispiller fir Apache, Nginx a Caddy.

Mat Caddy

Caddy kritt d’Zertifikat a schalt HTTPS vu sech aus an. Dëse Block follegt dem Beispill vun der Dokumentatioun fir eng Subdomain, hei op de lokal publizéierte Port geriicht:

rss.example.com {
  reverse_proxy 127.0.0.1:8080
}

Mat Nginx a Certbot

Dëse Block follegt dem Nginx-Beispill aus dem Docker-README fir d’Wuerzel vun engem Domain, op de Port 80 reduzéiert, fir Certbot HTTPS ariichten ze loossen. Déi lescht zwou Zeilen ginn den Header Authorization weider, deen d’Google-Reader-API brauch:

upstream freshrss {
  server 127.0.0.1:8080;
  keepalive 64;
}

server {
  listen 80;
  listen [::]:80;
  server_name rss.example.com;

  location / {
    proxy_pass http://freshrss/;
    proxy_redirect off;
    proxy_buffering off;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-Port $server_port;
    proxy_read_timeout 90;

    proxy_set_header Authorization $http_authorization;
    proxy_pass_header Authorization;
  }
}

Certbot setzt duerno d’Zertifikat a këmmert sech drëms, et ze erneieren:

sudo certbot --nginx

Déi ëffentlech Adress: base_url

FreshRSS hält seng ëffentlech Adress an base_url, am Fichier data/config.php. D’API a WebSub baséieren drop: kontrolléiert, datt do Är https-Adress steet. Den Docker-README weist, wou dëse Fichier am Volume ze fanne ass:

docker volume inspect freshrss_data
sudo nano /var/lib/docker/volumes/freshrss_data/_data/config.php
docker compose restart freshrss

'base_url' => 'https://rss.example.com/',

D’Feeds aktualiséieren: CRON_MIN

FreshRSS hëlt déi nei Artikele mat sengem Skript app/actualize_script.php. D’Docker-Image bréngt eng geplangten Aufgab mat, déi en an de Minutte leeft, déi an CRON_MIN stinn. Ouni dës Variabel, oder mat engem eidele Wäert, bleift d’Aufgab aus, an d’Feeds aktualiséiere sech net méi vu selwer.

• De Rhythmus: de Projet recommandéiert ongeféier zwee Duerchleef an der Stonn, zum Beispill 13,43; */20 geet och.
• D’Limit: de Skript aktualiséiert dee selwechte Feed net méi dacks wéi all zwanzeg Minutten, sou datt e méi enke Plang näischt bréngt.
• Echtzäit: WebSub iwwerhëlt fir déi kompatibel Quellen. Et brauch eng ëffentlech Adress, déi aus base_url gelies gëtt, an den Installatiounsassistent schalt et an, wann de Server eng huet.

Eng aner dokumentéiert Method: eng geplangten Aufgab um Host-Server, déi de Skript am Container opruff. An deem Fall huelt Dir CRON_MIN aus der compose.yaml eraus, fir nëmmen eng Method ze behalen:

7,37 * * * * root docker exec --user www-data freshrss php ./app/actualize_script.php > /tmp/FreshRSS.log 2>&1

Zënter der Versioun 1.30.0 refuséiert FreshRSS standardméisseg Adressen aus dem lokalen Netz wéi 127.0.0.1, fir sech géint Server-Side Request Forgery ze schützen. En Nopeschservice, deen Feeds produzéiert, wéi RSS-Bridge, gëtt iwwer d’Variabel INTERNAL_HOST_ALLOWLIST erlaabt, an der Form rss-bridge:80, oder an der Systemkonfiguratioun. De Wäert * hëlt all Kontroll ewech, an d’Dokumentatioun bezeechent en als onsécher.

D’Konten an d’Umeldung

Bei der Installatioun proposéiert FreshRSS d’Umeldung iwwer e Formulaire, déi JavaScript verlaangt. Et ass d’Standardmethod, a si passt fir déi meescht Instanzen. D’Dokumentatioun beschreift aner Methoden:

D’Dokumentatioun warnt, datt FreshRSS all Adress vertraut, déi an TRUSTED_PROXY steet: e schlecht geschützte Proxy géif engem Ugräifer erlaben, den Header ze setzen an Administrateursrechter ze kréien. Hei lauschtert de Port nëmmen op 127.0.0.1, wat en dem eegene Proxy vum Server reservéiert. D’Dokumentatioun rit och vun all Instanz ouni Authentifiséierung of, soubal de Server vu baussent Ärem Netz z’erreechen ass.

Registréierungen a Benotzer

• Standardméisseg zou: d’Konfiguratioun setzt d’Zuel vun de Konten op 1, dee vum Administrateur. De Registréierungsformulaire erschéngt eréischt, wann Dir dës Zuel eropsetzt, ënner Administratioun, Systemkonfiguratioun; 0 hëlt all Limit ewech.
• Konten, déi den Administrateur erstellt: Administratioun, Benotzer verwalten, mat der Sprooch, dem Benotzernumm, dem Passwuert an der Wiel, ob de Kont en Administrateur ass.
• Eng nei Authentifiséierung gëtt virun heikle Manipulatioune verlaangt, wéi e Benotzer ze befërderen oder eng Aktualiséierung anzespillen, standardméisseg no 20 Minutten.
• D’Validatioun vun der E-Mail-Adress ass fakultativ. Si brauch e SMTP-Server, mat mailer an smtp an data/config.php agestallt: d’Dokumentatioun seet, datt de Versand iwwer d’PHP-Funktioun mail an den offiziellen Docker-Imagen nach net ënnerstëtzt gëtt.

Fir eng Instanz, déi méi Leit deelen, rot d’Dokumentatioun, d’Konte fir Leit opzemaachen, deenen Dir vertraut, an d’Instanz hannert engem Proxy oder enger Firewall ze halen, déi den Zougang zu den interne Beräicher vun Adressen spären.

D’Mobil-Appen: d’Google-Reader- an d’Fever-API

FreshRSS funktionéiert am Browser, op grousse wéi op klenge Schiermer, an an Appe fir Android, iOS, Linux, Windows a macOS. Dës Appe notzen eng vu sengen zwou API: Google Reader, déi de README als déi bescht ukuckt, a Fever, mat méi limitéierte Funktiounen, manner effizient a manner sécher.

1. Als Administrateur schalt Dir an der Sektioun Authentifiséierung d’Optioun an, déi den Zougang zur API erlaabt.
2. All Benotzer leet a sengem Profil en API-Passwuert fest. Et ass vum Haaptpasswuert getrennt, gëtt Zougang zu manner Saachen an ass fir manner sécher Situatioune geduecht.
3. An der App gitt Dir d’Adress https://rss.example.com/api/greader.php an, oder https://rss.example.com/api/fever.php fir Fever, mam Benotzernumm an dësem API-Passwuert.

Fir ze kontrolléieren, mécht de Link niewent dem API-Passwuert, am Profil, eng Testsäit op: PASS bei der kompletter Kontroll bestätegt, datt alles funktionéiert. D’Docker-Image stellt Apache scho sou an, datt e kodéiert Schréistricher akzeptéiert, déi e puer Appe brauchen; mat Nginx dovir behaalt Dir d’Weiderginn vum Header Authorization.

De README féiert eng Tabell vun de kompatibelen Appen, mat hirer Plattform, hirer API an hire Funktiounen: Capy Reader a Readrops op Android, FeedFlow um Handy an um Computer, RSS Guard an NewsFlash um Computer, ReadKit a Reeder Classic op iOS a macOS, ënner anerem.

SQLite, PostgreSQL, MySQL oder MariaDB

FreshRSS huet SQLite integréiert, wat den Docker-README als déi einfachst Optioun beschreift, mat enger gudder Performance. D’Säit mat de Viraussetzunge recommandéiert PostgreSQL 10 oder méi nei, an akzeptéiert och MariaDB 10.6 a MySQL 8.0 oder méi nei. D’Wiel maacht Dir am Installatiounsassistent.

Fir PostgreSQL setzt Dir dëse Service an d’compose.yaml, aus dem Fichier docker-compose-db.yml vum Projet geholl, an de Volume db an d’Lëscht vun de Volumen. D’Passwuert kënnt an e Fichier .env, niewent der compose.yaml:

  freshrss-db:
    image: postgres:18
    container_name: freshrss-db
    hostname: freshrss-db
    restart: unless-stopped
    logging:
      options:
        max-size: 10m
    volumes:
      - db:/var/lib/postgresql
    environment:
      POSTGRES_DB: freshrss
      POSTGRES_USER: freshrss
      POSTGRES_PASSWORD: ${DB_PASSWORD}

DB_PASSWORD='a-long-unique-password'

Am Assistent wielt Dir PostgreSQL a gitt freshrss-db als Host an, mam Benotzer, dem Passwuert an der Datebank freshrss.

Dir kënnt dës Wiel méi spéit nach eng Kéier iwwerdenken. D’Dokumentatioun beschreift de Wiessel vun enger Datebank op eng aner, vu MySQL op PostgreSQL zum Beispill, oder op eng méi nei Haaptversioun vu PostgreSQL: cli/db-backup.php kopéiert d’Datebank vun all Benotzer an e SQLite-Fichier, an cli/db-restore.php luet se dann an déi nei Datebank.

D’Backups

De README seet, datt FreshRSS ouni iergendeng Garantie geliwwert gëtt: Är Backups behalen Är Abonnementer, Är Artikelen an Är Astellungen. Hei ass, wat d’Dokumentatioun Iech freet ze séchere:

D’Volumen, bei gestoppte Service

D’Dokumentatioun hält et fir méi sécher, de Service wärend den Ënnerhaltsaarbechten ze stoppen. D’Docker-Volume ginn mat engem temporäre Container kopéiert, d’Method, déi d’Docker-Dokumentatioun beschreift:

docker compose stop freshrss
docker run --rm --volumes-from freshrss -v "$PWD":/backup ubuntu tar -czf /backup/freshrss-$(date +%F).tgz --exclude=data/cache -C /var/www/FreshRSS data extensions
docker compose start freshrss

D’Datebanken, wärend de Service leeft

Zënter der Versioun 1.29.1 kann FreshRSS d’Datebank vun all Benotzer selwer an e SQLite-Fichier exportéieren, egal wéi eng Datebank Dir notzt, an nëmmen déi rezentst behalen. Schalt dësen Export an data/config.php an:

'auto_sqlite_export' => [
    'enabled' => true,
    'retention' => 7,
],

Plangt dann de Befehl um Server, hei all Nuecht. All Duerchlaf schreift data/users/<user>/sqlite-backups/<date>.sqlite a läscht d’Fichieren iwwer déi lescht siwen eraus:

20 2 * * * root docker exec --user www-data freshrss cli/export-sqlite-auto.php --quiet

Mat PostgreSQL setzt Dir en Dump mam eegene Werkzeug vun der Datebank derbäi, wéi am Docker-README. D’Optioun -T verzicht op den Terminal, mat deem eng geplangten Aufgab näischt ufänke kann:

docker compose exec -T freshrss-db pg_dump -U freshrss freshrss | gzip -9 > freshrss-postgres-$(date +%F).sql.gz

Den OPML-Export, aus der Interface, séchert d’Lëscht vun Äre Feeds, ouni e puer Astellungen, déi FreshRSS eegen sinn, wéi d’Zougangsdonnéeën oder d’Reegele fir d’Scraping vu Säiten. Fir eng komplett Kopie behaalt d’SQLite-Exporter: um Disk vum Server geluecht, kommen si och a seng Backups vun der Nuecht.

Restauréieren

1. Stoppt FreshRSS mat docker compose stop freshrss.
2. Luet d’Archiv zeréck an d’Volumen: docker run --rm --volumes-from freshrss -v "$PWD":/backup ubuntu tar -xzf /backup/freshrss-YYYY-MM-DD.tgz -C /var/www/FreshRSS.
3. Mat enger externer Datebank restauréiert Dir se aus hirem Dump, oder aus de SQLite-Fichiere mat cli/db-restore.php --delete-backup --force-overwrite.
4. Start en nei mat docker compose start freshrss, a kontrolléiert dann, datt Är Feeds an Är Artikelen do sinn.

Widderhuelt dësen Exercice vun Zäit zu Zäit, op enger Kopie: esou kontrolléiert Dir, datt eng Backup funktionéiert.

D’Aktualiséierungen

Den Docker-README gëtt zwee Befeeler, aus dem Dossier vun der compose.yaml. D’Volume bleiwen op hirer Plaz:

docker compose pull
docker compose up -d

FreshRSS publizéiert op zwee Kanäl. Déi versionéiert Verëffentlechungen, Tag latest, kommen e puer Mol am Joer eraus, ouni fixen Zäitplang, an hir Korrekture ginn net op méi al Versiounen zeréckportéiert. D’Rolling Release, Tag edge, kritt nei Funktiounen a Korrekturen, soubal se do sinn: zënter der Versioun 1.30.0 recommandéiert de Projet se fir méi séier Sécherheetskorrekturen.

• Fir d’éischt eng Backup: d’Dokumentatioun freet eng Backup vun data/, den Extensiounen an der Datebank virun all Aktualiséierung.
• Versioun fir Versioun: wann Dir e puer Versiounen hannendrun sidd, gitt duerch all eenzel, zum Beispill vun 1.26.0 op 1.27.1 virun 1.28.1, a kontrolléiert bei all Schrëtt. Mat Docker maachen Tags wéi 1.29.1 dëse Wee méiglech.
• Déi rezent Verëffentlechungen: d’1.30.4 vum 21. Oktober 2026 ass déi véiert Sécherheetsversioun vun der Serie 1.30. Si korrigéiert PHP-Schwachstellen an den Alpine-Imagen, no der 1.30.3, déi d’Standard-Debian-Image op Debian 13 bruecht huet.

Fir déi nei Verëffentlechungen ze verfollegen, publizéiert de Projet en Atom-Feed vu senge Versiounen: abonnéiert Är eege FreshRSS-Instanz drop.

Wien mécht wat op engem Managed VPS

Selwer hosten heescht, de Server zousätzlech zur Applikatioun ze halen. Op engem Managed VPS huelen eis Equippen de Server an d’Hand a verfollegen Är Instanz proaktiv; FreshRSS bleift Är Software, mat senge Astellungen an Donnéeën.

Wann Dir léiwer wëllt, datt eis Equippen an der Applikatioun selwer intervenéieren, gëtt dës Prestatioun op Stonnebasis oder pauschal verrechent, mat engem Käschtevirschlag, deen Iech virun der Interventioun matgedeelt gëtt.