Cititor RSS FreshRSS self-hosted rulat cu Docker pe un VPS
Self-hosting

FreshRSS Docker: cititor RSS self-hosted pe propriul VPS

Probabil urmaresti mai multe site-uri decat iti dai seama: cateva bloguri tehnice, un site de stiri local, changelog-ul unui tool de care depinzi, un prieten care scrie o data pe luna. Azi, cea mai mare parte din ele ajung la tine prin feed-uri sociale care decid ce vezi, in ce ordine, cu reclame strecurate printre postari. RSS e alternativa veche, plictisitoare si minunata: fiecare site publica o lista citibila de masini cu articolele noi, iar un cititor le aduna pentru tine, in ordine cronologica, fara nimic in plus. In tutorialul asta punem cititorul pe serverul tau, cu FreshRSS si Docker, ca feed-urile, istoricul de citire si telefonul sa ramana sincronizate fara nimeni la mijloc.

FreshRSS e un agregator de feed-uri gratuit si open source, sub licenta AGPL-3.0, dezvoltat de o comunitate de voluntari. Proiectul e pe freshrss.org , iar codul pe github.com/FreshRSS/FreshRSS . E destul de usor cat sa ruleze pe cel mai mic VPS, duce sute de feed-uri fara efort si vorbeste aceleasi protocoale de sincronizare ca marile cititoare comerciale, deci poti folosi in continuare o aplicatie de mobil bine facuta.

La final vei avea FreshRSS functional pe HTTPS, abonamentele tale importate dintr-un fisier OPML, o aplicatie de mobil care sincronizeaza articolele citite si cele marcate cu stea prin API, plus actualizare automata a feed-urilor dupa un program ales de tine.

Ce sunt, de fapt, RSS si FreshRSS

Un feed RSS (sau varul lui, feed-ul Atom) e un mic fisier XML pe care un site il actualizeaza de fiecare data cand publica ceva. Contine titluri, link-uri, date si deseori textul complet al articolului. Majoritatea blogurilor, site-urilor de stiri, podcast-urilor, canalelor YouTube, paginilor de release de pe GitHub si multe forumuri au unul, chiar daca nu il afiseaza la vedere.

Un cititor de feed-uri e programul care se aboneaza la aceste fisiere, le verifica periodic si iti arata ce e nou. Poti rula unul pe laptop, dar atunci telefonul habar n-are ce ai citit deja. Un cititor pe server rezolva problema: serverul aduce feed-urile non-stop, pastreaza totul intr-un singur loc, iar fiecare dispozitiv al tau il intreaba simplu “ce e necitit?”.

FreshRSS e exact un astfel de cititor pe server. E o aplicatie web PHP care stocheaza datele implicit in SQLite (suporta si PostgreSQL si MySQL/MariaDB) si vine cu:

  • o interfata web rapida, cu scurtaturi de tastatura, mai multe teme si moduri de citire;
  • suport multi-utilizator, ca o familie sau o echipa mica sa imparta aceeasi instanta, cu abonamente separate;
  • API compatibil Google Reader si API Fever, prin care se sincronizeaza aplicatiile de mobil si desktop;
  • suport WebSub, ca feed-urile care il ofera sa iti fie trimise aproape instant;
  • web scraping cu XPath, pentru site-uri care nu au deloc feed;
  • filtre, etichete, favorite, cautare in text si un sistem de extensii.

De ce sa-l gazduiesti singur in loc de un cititor in cloud

Cititoarele comerciale sunt ok, dar vin cu limite pe varianta gratuita, tracking si, din cand in cand, cate o inchidere (multi inca ne amintim de Google Reader). Cu instanta ta nu ai limita de feed-uri, nu ai reclame, nu ai algoritm de “engagement” si nimeni nu iti face profil dupa ce citesti. Si pentru ca totul se importa si se exporta ca OPML (un fisier standard care listeaza toate abonamentele), nu esti legat de nimic, nici macar de FreshRSS.

De ce ai nevoie

  • Un VPS DreamServer cu Debian 13 sau Ubuntu 24.04. 1 vCPU, 1 GB RAM si 10 GB disc sunt mai mult decat suficiente pentru cativa utilizatori si sute de feed-uri.
  • Un utilizator cu sudo cu care te conectezi prin SSH, ideal cu cheie SSH.
  • Un domeniu sau subdomeniu pe care il controlezi, de exemplu rss.example.com, ca sa obtinem un certificat TLS gratuit.
  • Optional, un export OPML din cititorul actual (Feedly, Inoreader, NetNewsWire si aproape orice alt cititor pot genera unul).
  • Cam 30 de minute.

O nota despre tipul de virtualizare: pe un VPS KVM, tot ce urmeaza merge exact cum e scris. Intr-un container LXC neprivilegiat, Docker ruleaza doar daca nesting-ul (si de obicei keyctl) e activat pentru container, iar ufw s-ar putea sa nu-si poata incarca regulile de firewall. Daca esti pe LXC, cere echipei de suport sa activeze nesting-ul sau alege un plan KVM pentru aplicatii Docker.

Cum se leaga piesele intre ele

Inainte de comenzi, sa ne punem de acord asupra catorva termeni.

Un container e un proces izolat care vine cu tot ce ii trebuie (aici: Apache, PHP si FreshRSS), deci ruleaza la fel pe orice server. Porneste dintr-o imagine, un sablon read-only descarcat de pe Docker Hub. Containerele sunt de unica folosinta, asa ca tot ce vrem sa pastram sta intr-un volum, o zona de stocare gestionata de Docker care supravietuieste upgrade-urilor. Docker Compose ne lasa sa descriem mai multe containere intr-un singur fisier YAML si sa le pornim cu o singura comanda.

Un port e o usa numerotata a serverului: 22 pentru SSH, 80 pentru HTTP, 443 pentru HTTPS. Un reverse proxy e un server web care sta pe porturile 80 si 443, se ocupa de certificatele TLS si trimite fiecare cerere catre aplicatia potrivita din spatele lui. Folosim Caddy, pentru ca obtine si reinnoieste automat certificate Let’s Encrypt cu o configuratie de cateva randuri.

FreshRSS pe un VPS: drumul unei cereriAplicatie mobilBrowser webAplicatie desktopInternetufw22, 80, 443permiseDocker pe VPS-ul tauCaddyTLS pe 443FreshRSSApache + PHPcron: refresh feed-uriSite-uri cu feedRSS / Atomaduce feed-uricitire / scriereVolume Dockerdata + extensionsDoar Caddy publica porturi. FreshRSS ramane in reteaua privata Docker.
Figura 1: arhitectura FreshRSS Docker pe care o construim. Traficul trece de firewall, Caddy se ocupa de HTTPS, iar FreshRSS isi tine datele in volume Docker.

Decizia importanta de design: FreshRSS nu publica niciun port. Doar Caddy e accesibil din exterior si vorbeste cu FreshRSS printr-o retea Docker privata. Conteaza, pentru ca Docker isi scrie propriile reguli de firewall (iptables), iar un port publicat poate ocoli complet ufw.

Iata toata procedura dintr-o privire. Sectiunile numerotate de mai jos urmeaza exact aceiasi opt pasi, in aceeasi ordine.

Instalare FreshRSS cu Docker: 8 pasi1Pregatire VPSupdate + Docker2DNS + firewallrecord A, ufw3Fisier ComposeFreshRSS + Caddy4Pornire + instalareasistent web5Import OPMLfeed-urile tale6API + aplicatiisync articole citite7Refresh programatCRON_MIN, interval8Backup + updatevolume, pull
Figura 2: pasii 1-4 pun FreshRSS online, pasii 5-8 il fac util zi de zi. Fiecare numar corespunde unui titlu "Pasul" de mai jos.

Pasul 1: Pregateste VPS-ul si instaleaza Docker

Conecteaza-te prin SSH si adu sistemul la zi:

sudo apt update && sudo apt full-upgrade -y

Comanda reimprospateaza lista de pachete si instaleaza toate actualizarile in asteptare. Daca s-a instalat un kernel nou, fa restart inainte sa continui. Pe Ubuntu, un fisier-semnal iti spune cand e nevoie:

[ -f /var/run/reboot-required ] && echo "Reboot necesar" || echo "Fara semnal de reboot"

Pe Debian, /var/run/reboot-required nu e creat implicit, asa ca verificarea de mai sus afiseaza mereu “Fara semnal de reboot”. Pe Debian, da pur si simplu restart daca ai vazut un pachet linux-image in output-ul upgrade-ului:

sudo reboot

Acum instalam Docker Engine si plugin-ul Compose v2 din repository-ul oficial Docker. Exista si pachetele din distributie, dar raman in urma si au nume diferite pe Debian si Ubuntu. Blocul de mai jos citeste /etc/os-release, deci aceleasi comenzi aleg repository-ul corect pe ambele sisteme: $ID devine debian sau ubuntu, iar $VERSION_CODENAME devine trixie sau noble.

sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
. /etc/os-release
sudo curl -fsSL "https://download.docker.com/linux/${ID}/gpg" -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/${ID} ${VERSION_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Primele randuri descarca cheia de semnare Docker, ca apt sa poata verifica pachetele, apoi adaugam repository-ul si instalam engine-ul plus plugin-ul compose. Verifica daca ambele raspund:

docker --version
docker compose version

Ar trebui sa vezi ceva de genul Docker version 28.x.x si Docker Compose version v2.x.x. Numerele exacte vor diferi; important e ca docker compose, cu spatiu, sa functioneze. Vechiul docker-compose cu cratima nu mai e necesar.

Ca sa rulezi Docker fara sudo de fiecare data, adauga-ti utilizatorul in grupul docker, apoi deconecteaza-te si conecteaza-te din nou:

sudo usermod -aG docker $USER
exit

Dupa reconectare, docker run --rm hello-world ar trebui sa afiseze “Hello from Docker!”. Tine minte ca apartenenta la grupul docker inseamna practic acces de root, deci adauga doar utilizatori in care ai incredere.

Pasul 2: Indreapta domeniul spre VPS si deschide firewall-ul

La furnizorul tau de DNS, creeaza un record A pentru rss.example.com care sa indice adresa IPv4 publica a VPS-ului, plus un record AAAA daca folosesti IPv6. Apoi verifica de pe VPS ca numele se rezolva:

getent hosts rss.example.com

Output-ul trebuie sa arate IP-ul serverului tau. Daca e gol sau apare alta adresa, asteapta cateva minute sa se propage DNS-ul. Caddy nu poate obtine certificatul pana nu e corect.

Urmeaza firewall-ul, portarul care decide ce porturi accepta conexiuni. Ubuntu vine cu ufw instalat, dar inactiv; Debian 13 nu il instaleaza deloc, asa ca il instalam intai (comanda nu strica nimic pe Ubuntu):

sudo apt install -y ufw
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp
sudo ufw enable
sudo ufw status verbose

Permitem SSH primul, ca activarea firewall-ului sa nu ne blocheze afara. Daca serverul SSH asculta pe alt port, foloseste sudo ufw allow 2222/tcp cu portul tau. Portul 80 e necesar pentru validarea certificatului si redirectul HTTP catre HTTPS, 443/tcp pentru HTTPS si 443/udp pentru HTTP/3. Statusul trebuie sa listeze aceste reguli cu ALLOW IN si sa arate Status: active.

Pasul 3: Scrie fisierul Docker Compose pentru FreshRSS

Creeaza un director pentru proiect. Numele lui devine numele proiectului Compose, care va fi prefixul volumelor mai tarziu:

mkdir -p ~/freshrss && cd ~/freshrss
nano compose.yaml

Lipeste urmatorul continut:

services:
  freshrss:
    image: freshrss/freshrss:1
    container_name: 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/Bucharest"
      CRON_MIN: "3,23,43"
      TRUSTED_PROXY: "172.16.0.0/12 192.168.0.0/16"
    networks:
      - web

  caddy:
    image: caddy:2
    container_name: caddy
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config
    networks:
      - web
    depends_on:
      - freshrss

volumes:
  freshrss_data:
  freshrss_extensions:
  caddy_data:
  caddy_config:

networks:
  web:

Ce face fiecare parte:

  • image: freshrss/freshrss:1 foloseste imaginea oficiala si urmareste cel mai nou release 1.x, deci primesti fix-uri si functii noi, dar niciodata o versiune majora surpriza. :latest merge si el, dar fixarea versiunii majore e mai sigura. Pentru control total, fixeaza un release exact, de exemplu freshrss/freshrss:1.27.1 (verifica lista de tag-uri pe Docker Hub pentru cel curent), si schimba-l manual dupa ce citesti release notes.
  • Cele doua volume tin tot ce conteaza: data contine configuratia, utilizatorii si bazele SQLite, iar extensions tine extensiile optionale.
  • TZ seteaza fusul orar pentru date si pentru programatorul intern.
  • CRON_MIN porneste programatorul din container si actualizeaza feed-urile la aceste minute din fiecare ora: :03, :23 si :43, adica la fiecare 20 de minute, evitand inceputul de ora, cand toata lumea face cereri. Il detaliem la pasul 7.
  • TRUSTED_PROXY ii spune lui FreshRSS sa aiba incredere in header-ele trimise din retelele private Docker, ca sa stie ca vizitatorii au venit pe HTTPS si sa logheze IP-ul lor real.
  • Intentionat nu exista sectiune ports: la freshrss. Doar Caddy publica porturi.
  • logging limiteaza dimensiunea log-urilor, ca un container vorbaret sa nu-ti umple discul.

Salveaza cu Ctrl+O, Enter, iesi cu Ctrl+X. Acum configuratia Caddy:

nano Caddyfile
{
    email tu@example.com
}

rss.example.com {
    encode zstd gzip
    reverse_proxy freshrss:80
}

Inlocuieste rss.example.com cu domeniul tau si adresa de email cu a ta; Let’s Encrypt o foloseste pentru avertismente de expirare. reverse_proxy freshrss:80 functioneaza pentru ca, in aceeasi retea Compose, containerele se gasesc dupa numele serviciului, iar encode comprima raspunsurile, ca paginile sa se incarce mai repede pe date mobile.

Pasul 4: Porneste stack-ul si finalizeaza instalarea din browser

Din directorul ~/freshrss, porneste totul:

docker compose up -d

Docker descarca ambele imagini si porneste containerele in fundal (-d vine de la detached). Ultimele randuri ar trebui sa fie Container freshrss Started si Container caddy Started. Verifica daca ruleaza:

docker compose ps

Ambele servicii trebuie sa aiba statusul Up. Apoi urmareste cum Caddy obtine certificatul:

docker compose logs -f caddy

Cauta un rand cu certificate obtained successfully pentru domeniul tau, apoi apasa Ctrl+C ca sa nu mai urmaresti log-ul; containerul continua sa ruleze.

Acum deschide https://rss.example.com in browser. Fa-o imediat: pana nu termini instalarea, oricine gaseste adresa poate rula asistentul si isi poate crea contul de admin. Asistentul are cateva ecrane scurte (folosim denumirile din interfata in engleza):

  1. Language: alegi limba interfetei.
  2. Checks: toate randurile trebuie sa fie verzi, imaginea oficiala vine cu toate extensiile PHP necesare.
  3. General configuration: base URL ar trebui sa fie deja https://rss.example.com. Daca apare http:// sau o adresa interna, vezi sectiunea de depanare.
  4. Database: alege SQLite. Fara container in plus si fara parola de baza de date de gestionat, perfect pentru o instanta personala sau de familie.
  5. User: alegi un nume de utilizator (in exemple folosim alice), o parola puternica, si pastrezi metoda de autentificare “Web form”.

Apasa Complete installation si autentifica-te. Ai acum un cititor gol, dar functional.

Pasul 5: Importa feed-urile prin OPML

OPML (Outline Processor Markup Language) e un format XML mic care listeaza feed-urile si categoriile lor. Exporta-l din cititorul vechi; in majoritatea aplicatiilor il gasesti la setari, “Import/Export” sau “Backup”.

In FreshRSS, deschide Subscription management (iconita de rotita langa lista de feed-uri), mergi la Import / export, alege fisierul .opml in sectiunea de import si apasa Import. Categoriile se pastreaza, iar feed-urile apar in bara laterala. Apasa butonul de refresh din partea de sus ca sa aduci articolele imediat, fara sa astepti programatorul.

Pentru fisiere foarte mari, sau daca preferi terminalul, FreshRSS are un importator din linia de comanda. Copiaza fisierul in container, apoi ruleaza importatorul ca www-data, utilizatorul care detine fisierele FreshRSS:

docker compose cp feeds.opml freshrss:/tmp/feeds.opml
docker compose exec --user www-data freshrss \
  php /var/www/FreshRSS/cli/import-for-user.php --user alice --filename /tmp/feeds.opml

Inlocuieste alice cu numele tau de utilizator. Rularea ca www-data conteaza: uneltele CLI pornite ca root pot lasa in volum fisiere detinute de root, pe care serverul web nu le mai poate scrie.

N-ai fisier OPML? Lipeste adresa unui site in Subscription management > Add a feed. Pentru majoritatea site-urilor, FreshRSS descopera singur link-ul de feed, deci nu trebuie sa cauti URL-ul exact de tip /feed.

Pasul 6: Activeaza API-ul si conecteaza aplicatiile de mobil

Interfata web merge bine si pe telefon, dar o aplicatie nativa iti da citire offline, gesturi de swipe si notificari. Aplicatiile vorbesc cu FreshRSS printr-un API (Application Programming Interface), un set de URL-uri gandite pentru programe, nu pentru oameni. Trebuie activate doua lucruri.

Intai, permite accesul API pentru instanta. Ca admin, mergi la Administration > Authentication, bifeaza Allow API access (required for mobile apps) si salveaza.

Apoi, seteaza o parola API pentru utilizatorul tau. Deschide Settings > Profile, gaseste sectiunea API management, introdu o parola API si salveaza. E separata de parola de login: aplicatiile o memoreaza, deci daca pierzi telefonul schimbi doar parola API, iar login-ul web ramane in siguranta.

Verifica totul deschizand https://rss.example.com/api/ in browser. FreshRSS afiseaza o mica pagina de test cu adresele endpoint-urilor, iar verificarile Google Reader si Fever trebuie sa arate PASS.

In aplicatie, alege “FreshRSS” sau “Google Reader API” ca tip de cont si completeaza:

SetareValoare
URL server (Google Reader API)https://rss.example.com/api/greader.php
URL server (Fever API)https://rss.example.com/api/fever.php
Utilizatornumele tau de utilizator FreshRSS
Parolaparola API, nu parola de login

Cand o aplicatie suporta ambele, alege Google Reader API: sincronizeaza categoriile, articolele citite si cele cu stea in ambele directii. Unele aplicatii cer doar https://rss.example.com si adauga singure restul caii. Aplicatii care merg cu FreshRSS: Readrops, Read You si FeedMe pe Android, NetNewsWire si Reeder pe iPhone si Mac, Fluent Reader pe desktop. Marcheaza un articol ca citit pe telefon, reincarca browserul si dispare din lista de necitite: asta e sincronizarea la lucru.

Pasul 7: Programeaza actualizarea feed-urilor

Un cititor e util doar daca verifica feed-urile fara sa apesi tu pe ceva. Cron e programatorul clasic din Unix care ruleaza comenzi la ore fixe, iar imaginea oficiala il include: cand CRON_MIN e setat, containerul porneste cron si apeleaza actualize_script.php din FreshRSS la minutele respective.

Valoarea noastra "3,23,43" inseamna de trei ori pe ora. Merge orice expresie valida de minut cron, de exemplu "*/15" pentru la fiecare 15 minute sau "7" pentru o data pe ora. Dupa ce modifici compose.yaml, aplica schimbarea:

docker compose up -d

Compose observa ca s-au schimbat variabilele de mediu si recreeaza doar containerul FreshRSS; datele din volum raman neatinse.

Mai e o setare pe care multi o rateaza: FreshRSS nu actualizeaza niciodata un feed mai des decat intervalul lui minim, care implicit e de o ora. Chiar daca cron ruleaza la 15 minute, fiecare feed e adus cel mult o data pe ora pana schimbi asta. Ajusteaza valoarea globala din Settings > Archiving (“Do not automatically refresh more often than”) sau pe fiecare feed in parte, in setarile lui avansate. Foloseste intervale scurte pentru site-urile de stiri rapide si lungi, de exemplu o zi, pentru blogurile care posteaza lunar: economisesti trafic si esti mai bland cu site-urile mici.

Ca sa declansezi manual o actualizare, de exemplu cand testezi:

docker compose exec --user www-data freshrss php /var/www/FreshRSS/app/actualize_script.php

Comanda afiseaza informatii despre feed-urile procesate. Feed-urile care suporta WebSub pot trimite articolele noi catre FreshRSS chiar in momentul publicarii, lucru care merge pentru ca instanta ta are o adresa HTTPS publica.

Preferi cron-ul de pe host? Sterge CRON_MIN, ruleaza din nou docker compose up -d si adauga randul de mai jos cu crontab -e pe VPS (inlocuieste utilizator):

*/20 * * * * cd /home/utilizator/freshrss && docker compose exec -T --user www-data freshrss php /var/www/FreshRSS/app/actualize_script.php > /dev/null 2>&1

Optiunea -T dezactiveaza pseudo-terminalul, pe care cron nu il ofera.

Pasul 8: Backup si update pentru FreshRSS

Tot ce e important sta in volumul freshrss_data. Docker pune numele proiectului ca prefix la volume, asa ca listeaza-le intai:

docker volume ls

Ar trebui sa vezi freshrss_freshrss_data, freshrss_freshrss_extensions, freshrss_caddy_data si freshrss_caddy_config. Pentru un backup consistent, opreste FreshRSS cateva secunde, arhiveaza volumul cu un container Alpine temporar si porneste-l la loc:

docker compose stop freshrss
docker run --rm -v freshrss_freshrss_data:/data:ro -v "$PWD":/backup alpine:3 \
  tar czf /backup/freshrss-data-$(date +%F).tar.gz -C /data .
docker compose start freshrss

Se creeaza freshrss-data-AAAA-LL-ZZ.tar.gz in directorul curent. Copiaza-l in afara serverului cu scp sau cu unealta ta de backup: un backup pe acelasi disc nu te apara daca pierzi discul. Ca o copie suplimentara usoara, exporta abonamentele ca OPML:

docker compose exec -T --user www-data freshrss \
  php /var/www/FreshRSS/cli/export-opml-for-user.php --user alice > feeds-backup.opml

Update-ul inseamna trei comenzi. Pentru ca am fixat :1, ajungi la cel mai nou release 1.x:

docker compose pull
docker compose up -d
docker image prune -f

pull descarca imaginile noi, up -d recreeaza doar containerele a caror imagine s-a schimbat, iar prune sterge straturile vechi nefolosite. FreshRSS isi migreaza singur baza de date la pornire. Inainte de salturi mai mari, fa un backup si arunca o privire pe release notes pe GitHub.

Cat de usor e FreshRSS fata de alte cititoare?

FreshRSS isi merita locul pe serverele mici. Din experienta noastra, o instanta cu un singur utilizator si in jur de 100 de feed-uri sta in repaus la aproximativ 50-70 MB de RAM, iar Caddy mai adauga cam 20 MB. Graficul compara memoria tipica in repaus pentru cateva stack-uri populare de cititoare self-hosted. Valorile sunt aproximative si depind de setari, numarul de feed-uri si configurarea worker-ilor PHP.

RAM aproximativ in repaus, cititoare RSS self-hostedFreshRSS + SQLite~60 MBMiniflux + PostgreSQL~110 MBTiny Tiny RSS + PostgreSQL~180 MBNextcloud + News~450 MB0100200300400500RAM in repaus, MB (aproximativ)Stack cititor
Figura 3: memorie aproximativa in repaus pentru un utilizator cu circa 100 de feed-uri, fara reverse proxy. Valorile reale variaza cu configuratia.

Miniflux e cealalta optiune excelenta si usoara, dar are nevoie de PostgreSQL. Tiny Tiny RSS e puternic, dar mai greu, si se instaleaza de obicei cu PostgreSQL si procese separate de actualizare. Nextcloud News are sens mai ales daca rulezi deja Nextcloud. Pentru “un container, un fisier SQLite”, FreshRSS e greu de batut.

Depanare si greseli frecvente

Caddy nu obtine certificatul. Ruleaza docker compose logs caddy. Cauzele obisnuite sunt DNS-ul care inca nu indica VPS-ul, portul 80 blocat sau o greseala de scriere a domeniului in Caddyfile. Dupa multe incercari esuate, Let’s Encrypt aplica limite, asa ca rezolva cauza si asteapta putin, nu reporni in bucla.

502 Bad Gateway. Caddy ruleaza, dar nu ajunge la FreshRSS. Verifica docker compose ps si docker compose logs freshrss si asigura-te ca numele din reverse_proxy freshrss:80 e acelasi cu numele serviciului din compose.yaml.

Link-urile, redirecturile sau pagina de login folosesc http:// sau o adresa ciudata. Fie lipseste TRUSTED_PROXY, fie base URL-ul salvat la instalare e gresit. Verifica-l si, daca e cazul, corecteaza-l:

docker compose exec freshrss grep base_url /var/www/FreshRSS/data/config.php
docker compose exec --user www-data freshrss sed -i "s#'base_url' => '.*'#'base_url' => 'https://rss.example.com'#" /var/www/FreshRSS/data/config.php

Aplicatia de mobil spune ca autentificarea a esuat. Verifica daca accesul API e activat din Administration, daca ai folosit parola API si nu parola de login, si daca URL-ul se termina in /api/greader.php (sau /api/fever.php). Pagina de test de la /api/ iti arata repede ce nu merge.

Feed-urile nu se actualizeaza. Verifica daca CRON_MIN e setat si daca ai recreat containerul dupa aceea, apoi ruleaza comanda de actualizare manuala de la pasul 7 si citeste ce afiseaza. Nu uita de intervalul minim de actualizare (o ora implicit) inainte sa decizi ca programatorul e stricat.

Unele feed-uri dau erori, de exemplu 403 sau timeout. Unele site-uri blocheaza cererile care vin din data center-e sau nu se inteleg bine cu boti. Configurarea ta e in regula; incearca un URL alternativ de feed al site-ului sau o frecventa mai mica.

permission denied cand vorbesti cu socket-ul Docker. Te-ai adaugat in grupul docker, dar nu te-ai deconectat si reconectat. Reconecteaza-te prin SSH.

Fisiere detinute de root in volumul de date, de obicei dupa ce ai rulat o unealta CLI fara --user www-data. Repara proprietarul:

docker compose exec freshrss chown -R www-data:www-data /var/www/FreshRSS/data

Docker nu porneste intr-un container LXC neprivilegiat. Trebuie activat nesting-ul pentru container. Pe un VPS KVM problema nu exista.

Note de securitate

  • Nu publica portul FreshRSS. Docker isi insereaza propriile reguli iptables, deci un rand ca "8080:80" face aplicatia accesibila din tot internetul, chiar daca ufw spune altceva. Daca ai nevoie de acces direct pentru depanare, leaga portul de localhost ("127.0.0.1:8080:80") si foloseste un tunel SSH.
  • Termina instalarea imediat dupa prima pornire, inainte s-o faca altcineva.
  • Tine inregistrarile inchise. In Administration > System configuration, numarul maxim de conturi controleaza daca straini isi pot face cont; lasa o valoare care nu permite conturi publice noi si creeaza tu utilizatorii.
  • Foloseste parole puternice si unice, tine parola API separata si dezactiveaza accesul API daca nu folosesti aplicatii. Citirea anonima trebuie sa ramana dezactivata, cu exceptia cazului in care vrei intentionat un cititor public.
  • Tine totul la zi: update-uri apt pentru sistem (ia in calcul unattended-upgrades) si docker compose pull pentru imagini.
  • Securizeaza SSH-ul cu autentificare pe baza de chei si cu autentificarea prin parola dezactivata.
  • Pastreaza backup-urile in afara serverului si testeaza o restaurare macar o data, ca sa stii ca merge inainte sa ai nevoie.

Deci, merita un cititor RSS self-hosted?

Daca citesti web-ul zilnic, da. Pentru costul celui mai mic VPS primesti un flux calm si cronologic din site-urile pe care chiar le-ai ales, fara reclame, fara algoritm, cu articolele citite sincronizate pe toate dispozitivele si cu toata lista de abonamente portabila intr-un singur fisier OPML. FreshRSS cu Docker face din instalare o treaba de jumatate de ora, iar update-urile devin o rutina de doua comenzi.

Poti porni acest stack pe un VPS DreamServer in cateva minute, din data center-ul nostru din Romania. Daca preferi sa sari complet peste terminal, echipa noastra de administrare servere poate instala, securiza, face backup si intretine FreshRSS (sau orice alta aplicatie self-hosted) in locul tau.

Intrebari frecvente

Pot folosi mai multe persoane aceeasi instanta FreshRSS?

Da. FreshRSS e multi-utilizator: fiecare cont are abonamentele, categoriile, statusul de citire si parola API proprii. Creeaza utilizatorii din Administration > Users in loc sa deschizi inregistrarea publica.

Folosesc SQLite sau PostgreSQL?

SQLite e alegerea potrivita pentru o persoana sau o familie, chiar si cu cateva sute de feed-uri. Ia in calcul PostgreSQL sau MariaDB cand gazduiesti multi utilizatori sau zeci de mii de articole si vrei un server de baze de date separat, reglabil.

Pot urmari site-uri care nu au feed RSS?

De multe ori, da. Cand adaugi un feed, FreshRSS iti permite tipul “HTML + XPath”, care extrage continutul unei pagini web pe baza unor reguli XPath si construieste un feed din el. Cere putina joaca, dar merge bine pe paginile simple de tip lista.

Merge FreshRSS intr-un container LXC neprivilegiat?

FreshRSS in sine merge, dar Docker intr-un LXC neprivilegiat are nevoie de nesting activat, iar ufw s-ar putea sa nu functioneze acolo. Pe un VPS KVM nu exista astfel de limitari.

Cate feed-uri duce un VPS mic?

Destule. Un VPS cu 1 vCPU si 1 GB RAM duce linistit cateva sute de feed-uri actualizate la 20 de minute. Spatiul pe disc creste odata cu articolele pastrate, asa ca seteaza limite de pastrare rezonabile din Settings > Archiving.

Avem Incredere & Suntem Membri

Suntem membri ai principalelor organizatii de infrastructura internet.

RIPE NCC MANRS PeeringDB RoTLD DSIX SBIX 4IXP LOCIX Euro-IX RIPE NCC MANRS PeeringDB RoTLD DSIX SBIX 4IXP LOCIX Euro-IX