Hostati FreshRSS na Managed VPS-u: vaši RSS feedovi na vašem poslužitelju

Što radi FreshRSS

FreshRSS je agregator RSS feedova za hostanje na vlastitom poslužitelju, napisan u PHP-u. README ga opisuje kao lagan, jednostavan za rad, moćan i prilagodljiv, preveden na više od dvadeset jezika. Riječ je o višekorisničkoj aplikaciji, s anonimnim načinom čitanja i prilagođenim oznakama.

• Čitanje: vaše pretplate razvrstane u kategorije, oznake, favorite i spremljena pretraživanja.
• WebSub: FreshRSS nove članke prima trenutačno od kompatibilnih izvora, koji ih šalju sami umjesto da čekaju sljedeće osvježavanje.
• Web scraping: za web-mjesto bez RSS ili Atom feeda FreshRSS sam čita stranicu pomoću pravila XPath, a zna čitati i JSON dokumente.
• Dijeljenje: odabir članaka može se ponovno objaviti kao HTML, RSS ili OPML.
• Aplikacije: API za mobilne i desktop aplikacije, sučelje naredbenog retka i proširenja.

FreshRSS razvija njegova zajednica na GitHubu, a službeno web-mjesto objavljuje zajednica FreshRSS. Proširenja se nalaze u zasebnom repozitoriju, a dokumentacija pokriva korisnike, administratore i razvojne programere.

Što dopušta licenca AGPL-3.0

FreshRSS je objavljen pod licencom GNU Affero General Public License, inačica 3: njegov manifest composer.json deklarira je kao AGPL-3.0, a README upućuje na tekst licence. Taj tekst potvrđuje neograničeno dopuštenje za pokretanje neizmijenjenog programa. Stoga možete koristiti sliku koju objavljuje projekt za svoju tvrtku i svoj tim, bez kupnje licence.

Članak 13. dodaje uvjet svojstven licenci AGPL: ako program izmijenite, vaša inačica mora svima koji je koriste na daljinu, preko mreže, omogućiti da besplatno dobiju njezin izvorni kod. Proširenje treće strane dodano u volumen extensions podliježe vlastitoj licenci.

Instalacija s Docker Composeom

Projekt svoje službene slike objavljuje na Docker Hubu, pod nazivom freshrss/freshrss, zajedno s primjerom datoteke Compose. Na poslužitelju s instaliranim Dockerom izradite mapu freshrss i u nju stavite ovaj compose.yaml, preuzet iz te datoteke i Docker README-a:

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

• Port objavljen na 127.0.0.1: FreshRSS je dostupan samo preko obrnutog proxyja, postavljenog na istom poslužitelju. Primjer datoteke projekta objavljuje port 8080 za lokalnu upotrebu; adresa 127.0.0.1 ovdje ga rezervira za proxy.
• Volumen data čuva konfiguraciju, račune i, uz SQLite, bazu svakog korisnika. README ističe da sadrži sve osobne podatke. Docker Compose naziva ga prema mapi: freshrss_data.
• Volumen extensions čuva proširenja trećih strana, ako ih dodate.
• TZ prima vremensku zonu poslužitelja, u formatu PHP-a; zadana je vrijednost UTC.
• TRUSTED_PROXY zadržava vrijednost iz primjera datoteke: privatne raspone iz kojih dolaze zahtjevi proxyja. O njoj ovisi koja adresa ulazi u zapisnike, posjetiteljeva ili proxyjeva.
• Provjera stanja u redovitim razmacima pokreće cli/health.php, kako bi Docker znao odgovara li instanca.

Oznaka latest, zadana, prati posljednje izdanje s brojem inačice; edge prati kontinuirano izdanje; oznaka poput 1.30.4 fiksira inačicu, a sufiks -alpine daje isto na osnovi Alpine umjesto Debiana. Odjeljak o ažuriranjima vraća se na taj izbor.

Dovršetak instalacije

Kada je obrnuti proxy postavljen, otvorite svoju HTTPS adresu: čarobnjak za postavljanje traži jezik, provjerava poslužitelj, nudi izbor baze, a zatim izrađuje administratorski račun, s njegovom lozinkom i načinom prijave. SQLite radi bez ikakve pripreme. Instalacija radi i iz naredbenog retka, s cli/do-install.php i cli/create-user.php, pokrenutima preko docker exec --user www-data freshrss.

Što se tiče resursa, README traži lagan poslužitelj, s Linuxom ili Windowsom, i napominje da FreshRSS radi čak i na Raspberry Pi 1, s vremenom odziva ispod sekunde, uz 150 feedova i 22 000 članaka. Veličina ovisi o broju korisnika, feedova i sačuvanih članaka. Na Managed VPS-u opišite nam svoju upotrebu, a mi vam preporučujemo odgovarajuću veličinu.

HTTPS: obrnuti proxy

Za produkciju Docker README savjetuje obrnuti proxy na poslužitelju domaćinu, koji osigurava HTTPS. Najprije odaberite naziv domene ili poddomenu, poput rss.example.com, koja pokazuje na poslužitelj putem A i AAAA zapisa. Projekt preporučuje Traefik i za njega objavljuje cijelu datoteku Compose, s certifikatima Let’s Encrypt i preusmjeravanjem s HTTP-a na HTTPS; daje i primjere za Apache, Nginx i Caddy.

S Caddyjem

Caddy sam pribavlja certifikat i uključuje HTTPS. Ovaj blok preuzima primjer iz dokumentacije za poddomenu, ovdje usmjeren na lokalno objavljeni port:

rss.example.com {
  reverse_proxy 127.0.0.1:8080
}

S Nginxom i Certbotom

Ovaj blok preuzima primjer za Nginx iz Docker README-a za korijen domene, sveden na port 80 kako bi Certbot postavio HTTPS. Posljednja dva retka prosljeđuju zaglavlje Authorization, koje treba API Google Reader:

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 zatim postavlja certifikat i brine se za njegovu obnovu:

sudo certbot --nginx

Javna adresa: base_url

FreshRSS svoju javnu adresu čuva u base_url, u datoteci data/config.php. Na nju se oslanjaju API i WebSub: provjerite sadrži li vašu adresu u https. Docker README pokazuje gdje se ta datoteka nalazi u volumenu:

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/',

Osvježavanje feedova: CRON_MIN

FreshRSS nove članke dohvaća svojom skriptom app/actualize_script.php. Docker slika isporučuje planirani zadatak koji je pokreće u minutama navedenima u CRON_MIN. Bez te varijable, ili s praznom vrijednošću, zadatak ostaje isključen i feedovi se više ne osvježavaju sami.

• Ritam: projekt preporučuje otprilike dva pokretanja na sat, primjerice 13,43; radi i */20.
• Ograničenje: skripta isti feed ne osvježava češće od jednom svakih dvadeset minuta, pa gušći raspored ništa ne donosi.
• Stvarno vrijeme: za kompatibilne izvore posao preuzima WebSub. Treba mu javna adresa, pročitana iz base_url, a čarobnjak za postavljanje uključuje ga kada je poslužitelj ima.

Druga dokumentirana metoda: planirani zadatak na poslužitelju domaćinu, koji poziva skriptu unutar kontejnera. U tom slučaju uklonite CRON_MIN iz compose.yaml, kako biste zadržali samo jednu metodu:

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

Od inačice 1.30.0 FreshRSS prema zadanim postavkama odbija adrese lokalne mreže poput 127.0.0.1, radi zaštite od krivotvorenja zahtjeva na strani poslužitelja. Susjedna usluga koja proizvodi feedove, poput RSS-Bridgea, dopušta se varijablom INTERNAL_HOST_ALLOWLIST, u obliku rss-bridge:80, ili u konfiguraciji sustava. Vrijednost * uklanja svaku provjeru, a dokumentacija je naziva nesigurnom.

Računi i prijava

Tijekom instalacije FreshRSS nudi prijavu putem obrasca, koja zahtijeva JavaScript. To je zadana metoda i odgovara većini instanci. Dokumentacija opisuje i druge:

Dokumentacija upozorava da FreshRSS vjeruje svakoj adresi navedenoj u TRUSTED_PROXY: loše zaštićen proxy omogućio bi napadaču da postavi zaglavlje i dobije administratorski pristup. Ovdje port sluša samo na 127.0.0.1, čime je rezerviran za proxy samog poslužitelja. Dokumentacija odvraća i od svake instance bez autentifikacije čim je poslužitelj dostupan izvan vaše mreže.

Registracije i korisnici

• Zatvorene prema zadanim postavkama: konfiguracija broj računa postavlja na 1, administratorov. Obrazac za registraciju pojavljuje se tek ako povećate taj broj, u izborniku Administracija, Konfiguracija sustava; 0 uklanja svako ograničenje.
• Računi koje izrađuje administrator: Administracija, Upravljanje korisnicima, s jezikom, korisničkim imenom, lozinkom i oznakom je li račun administratorski.
• Ponovna autentifikacija traži se prije osjetljivih radnji, poput promaknuća korisnika ili primjene ažuriranja, prema zadanim postavkama nakon 20 minuta.
• Provjera adrese e-pošte nije obavezna. Treba joj SMTP poslužitelj, postavljen s mailer i smtp u data/config.php: dokumentacija navodi da slanje preko PHP funkcije mail unutar službenih Docker slika još nije podržano.

Za instancu koju dijeli više osoba dokumentacija savjetuje da račune otvarate osobama kojima vjerujete i da instancu držite iza proxyja ili vatrozida koji blokira pristup internim rasponima adresa.

Mobilne aplikacije: API-ji Google Reader i Fever

FreshRSS radi u pregledniku, na velikim i malim zaslonima, te u aplikacijama za Android, iOS, Linux, Windows i macOS. Te aplikacije koriste jedan od njegova dva API-ja: Google Reader, koji README ocjenjuje najboljim, i Fever, s ograničenijim funkcijama, manje učinkovit i manje siguran.

1. Kao administrator, u odjeljku Autentifikacija, uključite opciju koja dopušta pristup API-ju.
2. Svaki korisnik u svojem profilu postavlja API lozinku. Ona je odvojena od glavne lozinke, daje pristup manjem broju stvari i namijenjena je manje sigurnim situacijama.
3. U aplikaciji unesite adresu https://rss.example.com/api/greader.php, ili https://rss.example.com/api/fever.php za Fever, s korisničkim imenom i tom API lozinkom.

Za provjeru, poveznica prikazana pokraj API lozinke, u profilu, otvara probnu stranicu: PASS na cjelovitoj provjeri potvrđuje da sve radi. Docker slika već postavlja Apache tako da prihvaća kodirane kose crte, koje trebaju neke aplikacije; s Nginxom ispred zadržite prosljeđivanje zaglavlja Authorization.

README vodi tablicu kompatibilnih aplikacija, s njihovom platformom, API-jem i funkcijama: među ostalima Capy Reader i Readrops na Androidu, FeedFlow na mobitelu i računalu, RSS Guard i NewsFlash na računalu, ReadKit i Reeder Classic na iOS-u i macOS-u.

SQLite, PostgreSQL, MySQL ili MariaDB

FreshRSS ima ugrađen SQLite, koji Docker README opisuje kao najjednostavniju mogućnost, s dobrim performansama. Stranica sa zahtjevima preporučuje PostgreSQL 10 ili noviji, a prihvaća i MariaDB 10.6 te MySQL 8.0 ili noviji. Izbor radite u čarobnjaku za postavljanje.

Za PostgreSQL u compose.yaml dodajte ovu uslugu, preuzetu iz datoteke projekta docker-compose-db.yml, a volumen db na popis volumena. Lozinka ide u datoteku .env, uz 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'

U čarobnjaku odaberite PostgreSQL i kao host unesite freshrss-db, s korisnikom, lozinkom i bazom freshrss.

Ovaj izbor možete kasnije promijeniti. Dokumentacija opisuje prelazak s jedne baze na drugu, primjerice s MySQL-a na PostgreSQL, ili na noviju glavnu inačicu PostgreSQL-a: cli/db-backup.php kopira bazu svakog korisnika u datoteku SQLite, a zatim je cli/db-restore.php učitava u novu bazu.

Sigurnosne kopije

README navodi da FreshRSS dolazi bez ikakvog jamstva: vaše sigurnosne kopije čuvaju vaše pretplate, vaše članke i vaše postavke. Evo što dokumentacija traži da sigurnosno kopirate:

Volumeni, uz zaustavljenu uslugu

Dokumentacija smatra sigurnijim zaustaviti uslugu tijekom radova na održavanju. Docker volumeni kopiraju se privremenim kontejnerom, metodom opisanom u dokumentaciji Dockera:

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

Baze, dok usluga radi

Od inačice 1.29.1 FreshRSS sam zna izvesti bazu svakog korisnika u datoteku SQLite, bez obzira na to koju bazu koristite, i zadržati samo najnovije izvoze. Uključite taj izvoz u data/config.php:

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

Zatim naredbu planirajte na poslužitelju, ovdje svake noći. Svako pokretanje upisuje data/users/<user>/sqlite-backups/<date>.sqlite i briše datoteke starije od posljednjih sedam:

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

Uz PostgreSQL dodajte izvoz vlastitim alatom baze, kao u Docker README-u. Opcija -T izostavlja terminal, koji planiranom zadatku ne treba:

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

Izvoz OPML, iz sučelja, sigurnosno kopira popis vaših feedova, bez nekih postavki svojstvenih FreshRSS-u, poput pristupnih podataka ili pravila za čitanje stranica. Za potpunu kopiju zadržite izvoze SQLite: postavljeni na disk poslužitelja, ulaze i u njegove noćne sigurnosne kopije.

Vraćanje

1. Zaustavite FreshRSS s docker compose stop freshrss.
2. Ponovno učitajte arhivu u volumene: docker run --rm --volumes-from freshrss -v "$PWD":/backup ubuntu tar -xzf /backup/freshrss-YYYY-MM-DD.tgz -C /var/www/FreshRSS.
3. Uz vanjsku bazu vratite je iz njezina izvoza ili iz datoteka SQLite s cli/db-restore.php --delete-backup --force-overwrite.
4. Ponovno ga pokrenite s docker compose start freshrss, a zatim provjerite jesu li vaši feedovi i članci na mjestu.

Tu vježbu povremeno ponovite, na kopiji: tako provjeravate da sigurnosna kopija radi.

Ažuriranja

Docker README daje dvije naredbe, iz mape s datotekom compose.yaml. Volumeni ostaju na mjestu:

docker compose pull
docker compose up -d

FreshRSS objavljuje na dva kanala. Izdanja s brojem inačice, oznaka latest, izlaze nekoliko puta godišnje, bez utvrđenog kalendara, a njihovi se ispravci ne prenose na starije inačice. Kontinuirano izdanje, oznaka edge, dobiva nove funkcije i ispravke čim stignu: od inačice 1.30.0 projekt ga preporučuje radi bržih sigurnosnih zakrpa.

• Najprije sigurnosna kopija: dokumentacija prije svakog ažuriranja traži sigurnosnu kopiju mape data/, proširenja i baze.
• Inačicu po inačicu: ako kasnite nekoliko inačica, prođite kroz svaku, primjerice od 1.26.0 do 1.27.1 prije 1.28.1, uz provjeru na svakom koraku. Uz Docker oznake poput 1.29.1 omogućuju taj put.
• Nedavna izdanja: 1.30.4 od 21. listopada 2026. četvrto je sigurnosno izdanje serije 1.30. Ispravlja ranjivosti PHP-a u slikama Alpine, nakon inačice 1.30.3, koja je zadanu Debian sliku prebacila na Debian 13.

Da biste pratili nova izdanja, projekt objavljuje Atom feed svojih inačica: pretplatite na njega svoju instancu FreshRSS-a.

Tko što radi na Managed VPS-u

Hostanje na vlastitom poslužitelju traži da uz aplikaciju održavate i poslužitelj. Na Managed VPS-u naši timovi preuzimaju poslužitelj i proaktivno prate vašu instancu; FreshRSS ostaje vaš softver, sa svojim postavkama i podacima.

Ako želite da naši timovi interveniraju u samoj aplikaciji, ta se usluga naplaćuje po satu ili paušalno, uz procjenu koja vam se priopćuje prije intervencije.