FreshRSS: co to je a jak jej nainstalovat na VPS

6. 9. 20266 min čtení

Tropic

FreshRSS: co to je a jak jej nainstalovat na VPS

Language: cs

FreshRSS: vlastní zpravodajský kanál bez algoritmů

Sociální sítě rozhodují, které příspěvky zobrazí jako první. Důležitá aktualizace projektu tak může snadno zapadnout mezi desítky doporučení. FreshRSS funguje jinak: zdroje si vybíráte sami a nový obsah se zobrazuje v jediném chronologickém kanálu.

FreshRSS lze nainstalovat na vlastní server a používat jako jednotnou schránku pro blogy, zpravodajské weby, aktualizace softwaru, fóra, podcasty a další zdroje poskytující kanály RSS nebo Atom. Tato příručka popisuje funkce aplikace, požadavky na server a instalaci na VPS s Dockerem a HTTPS.

FreshRSS v pěti krocích

Vytvořte Linux VPS a nasměrujte na něj subdoménu, například rss.example.com.
Nainstalujte Docker a Docker Compose.
Spusťte FreshRSS společně s Caddy pro automatické HTTPS.
Otevřete subdoménu, zvolte SQLite a vytvořte účet.
Importujte odběry z OPML nebo weby přidejte ručně.

Poté bude VPS kontrolovat zdroje podle plánu, i když je počítač uživatele vypnutý.

Co je FreshRSS?

FreshRSS je bezplatný RSS a Atom agregátor s vlastním hostingem. Vlastní hosting znamená, že aplikace a databáze běží na serveru, který ovládáte, a ne na infrastruktuře cloudové služby.

RSS kanál je speciální soubor, který web aktualizuje pokaždé, když publikuje nový obsah. FreshRSS tyto soubory pravidelně načítá z vybraných zdrojů a spojuje jejich položky do jediného rozhraní. Nepřečtené články, oblíbené položky a historie čtení se synchronizují mezi zařízeními.

Základní myšlenka je jednoduchá: uživatelé sami rozhodují, koho budou sledovat a v jakém pořadí si publikace zobrazí. FreshRSS neřadí položky podle interakcí a mezi odběry nevkládá doporučený obsah.

Funkce FreshRSS

Funkce	K čemu slouží
Kategorie, stavy a oblíbené položky	Rozdělení pracovních, technických a osobních zdrojů
Vyhledávání, filtry a uložené dotazy	Zobrazení pouze publikací na zvolené téma
Import a export OPML	Rychlý přenos seznamu odběrů
Google Reader API a Fever API	Připojení kompatibilních mobilních a desktopových aplikací
WebSub	Okamžité získání položek po publikování z podporovaných zdrojů
Více uživatelů	Vytvoření samostatných účtů pro rodinu nebo tým
Motivy a rozšíření	Změna rozhraní a přidání funkcí
XPath a JSON Feed	Odběr některých zdrojů bez standardního kanálu RSS nebo Atom

Uložený dotaz se může stát samostatným tematickým kanálem, například kanálem obsahujícím pouze bezpečnostní publikace nebo aktualizace konkrétního produktu. Výsledek lze otevřít ve FreshRSS nebo publikovat jako HTML či RSS; pro seznamy kanálů je k dispozici také OPML.

WebSub umožňuje kompatibilnímu webu upozornit FreshRSS na novou položku, místo aby se čekalo na další plánovanou kontrolu. Aby to fungovalo, musí být instance FreshRSS dostupná z internetu prostřednictvím platné veřejné adresy.

FreshRSS je zvlášť užitečný pro vývojáře a správce systémů: blogy projektů, vydání, hlášení incidentů a bezpečnostní publikace lze shromáždit v jednom kanálu. Při každodenním čtení nahrazuje desítky otevřených karet a zachovává přesný stav přečtení na všech zařízeních.

Systémové požadavky FreshRSS

FreshRSS potřebuje jen málo prostředků. Podporuje SQLite, PostgreSQL, MariaDB a MySQL, zatímco ruční instalace vyžaduje webový server a PHP 8.1 nebo novější. Oficiální popis dokonce uvádí test na Raspberry Pi 1 se 150 kanály a 22 000 články.

Praktické výchozí konfigurace:

Scénář	CPU	RAM	Úložiště	Databáze
Osobní kanál	1 vCPU	1 GB	10–20 GB SSD	SQLite
Rodina nebo malý tým	1–2 vCPU	2 GB	20–40 GB SSD	SQLite nebo externí databáze
Mnoho uživatelů a velký archiv	Od 2 vCPU	Od 4 GB	Od 40 GB SSD	PostgreSQL nebo MariaDB

Jde o orientační hodnoty, nikoli o pevná minima. Spotřeba úložiště závisí na počtu zdrojů, četnosti publikování a délce uchovávání historie. VPS je praktičtější než domácí počítač, pokud potřebujete aktualizace nepřetržitě, přístup zvenčí, synchronizaci s mobilem a správné fungování WebSub.

Jak nainstalovat FreshRSS na VPS s Dockerem

V níže uvedené konfiguraci běží FreshRSS za Caddy. Caddy přijímá externí požadavky a automaticky získává certifikát TLS.

Budete potřebovat Linux VPS, nainstalovaný Docker s příkazem docker compose, subdoménu se záznamem A směřujícím na IP adresu serveru a otevřené porty 80 a 443.

Krok 1. Vytvoření adresáře

sudo mkdir -p /opt/freshrss
sudo chown "$USER":"$USER" /opt/freshrss
cd /opt/freshrss

Krok 2. Vytvoření `compose.yaml`

services:
  freshrss:
    image: freshrss/freshrss:latest
    container_name: freshrss
    restart: unless-stopped
    logging:
      options:
        max-size: 10m
    environment:
      TZ: Etc/UTC
      CRON_MIN: '3,33'
      FRESHRSS_ENV: production
      TRUSTED_PROXY: 172.16.0.0/12
    volumes:
      - freshrss_data:/var/www/FreshRSS/data
      - freshrss_extensions:/var/www/FreshRSS/extensions

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

volumes:
  freshrss_data:
  freshrss_extensions:
  caddy_data:
  caddy_config:

CRON_MIN: '3,33' spouští kontrolu kanálů ve 3. a 33. minutě každé hodiny. FreshRSS neaktualizuje jednotlivý kanál častěji než přibližně jednou za 20 minut, takže častější spouštění úlohy obvykle není nutné.

Krok 3. Vytvoření `Caddyfile`

rss.example.com {
    reverse_proxy freshrss:80
}

Nahraďte doménu vlastní doménou. Jakmile se záznam DNS rozšíří a porty budou dostupné, Caddy certifikát automaticky získá a bude jej obnovovat.

Krok 4. Spuštění FreshRSS

docker compose up -d
docker compose ps

Prohlédnout protokoly můžete tímto příkazem:

docker compose logs -f --tail=100

Otevřete https://rss.example.com. Průvodce instalací zkontroluje prostředí, požádá vás o výběr databáze a vytvoří prvního uživatele. SQLite je pro osobní server nejjednodušší volbou, protože nevyžaduje samostatný databázový kontejner.

Počáteční konfigurace

FreshRSS často dokáže najít kanál RSS nebo Atom z běžné adresy webu. Pokud automatické nalezení nefunguje, zadejte přímou URL kanálu. Odběry z Feedly, Inoreaderu a dalších čteček lze pohodlně přenést pomocí OPML.

Hned na začátku uspořádejte zdroje do kategorií, jako jsou „nutno přečíst“, „práce“, „bezpečnost“, „delší čtení“ a „čtení na později“. Weby s vysokým objemem zpráv by neměly vytlačovat skutečně důležité aktualizace z hlavního kanálu.

Chcete-li připojit aplikaci, povolte API v nastavení ověřování a v profilu nastavte samostatné heslo API. Adresa Google Reader API vypadá takto:

https://rss.example.com/api/greader.php

Je lepší nepoužívat stejné heslo pro hlavní účet a API.

Jak se neutopit v nepřečtených článcích

FreshRSS je nejpřínosnější po krátkém nastavení:

v hlavním kanálu ponechte jen důležité zdroje;
pomocí filtrů automaticky označujte nepotřebné sekce jako přečtené;
ukládejte vyhledávací dotazy pro produkty, autory a témata;
pravidelně kontrolujte statistiky a odstraňujte zdroje, které vytvářejí pouze šum.

Rozšíření mohou přidat odhady doby čtení, zvýraznění slov, proxy pro obrázky, vkládání YouTube, oznámení přes webhook a klasifikaci článků prostřednictvím kompatibilního API LLM. Doplňky třetích stran instalujte pouze z důvěryhodných zdrojů.

Aktualizace, zabezpečení a zálohy

Pro aktualizaci kontejnerů spusťte:

cd /opt/freshrss
docker compose pull
docker compose up -d

Před velkou aktualizací vytvořte zálohu. Svazek freshrss_data obsahuje uživatelská nastavení a při použití SQLite také databázi článků. Pokud používáte doplňky, zachovejte i freshrss_extensions. PostgreSQL, MariaDB a MySQL vyžadují samostatný výpis databáze.

Minimální bezpečnostní opatření:

používejte HTTPS;
po vytvoření potřebných účtů zakažte otevřenou registraci;
nepovolujte anonymní přístup, pokud není nutný;
používejte samostatné heslo API;
pravidelně aktualizujte FreshRSS a jeho rozšíření;
uchovávejte zálohu mimo VPS.

Export OPML nenahrazuje úplnou zálohu, ale umožňuje rychle obnovit seznam odběrů v libovolné kompatibilní RSS čtečce.

FreshRSS na VPS od tropic.host

FreshRSS je dobrá první služba s vlastním hostingem: potřebuje málo prostředků, běží v Dockeru a po importu odběrů je okamžitě užitečná. Veřejné VPS zajišťuje aktualizace kanálů 24/7, přístup z telefonu a správné fungování WebSub.

Pro osobní instalaci obvykle stačí malá konfigurace Linuxu. Na tropic.host můžete FreshRSS přidělit vlastní subdoménu, začít se základním VPS a udržet službu nezávislou na domácím počítači. Při výběru tarifu záleží na stabilitě, prostoru pro archiv a zálohách více než na velké rezervě výpočetního výkonu.

Závěr

FreshRSS mění desítky webů na přehledný osobní kanál bez algoritmického řazení. Podporuje mobilní klienty, filtry, uložené dotazy, více uživatelů, WebSub a rozšíření, přitom zůstává dostatečně nenáročný pro malé VPS.

Na začátku potřebujete Docker, doménu a SQLite. Po instalaci nastavte kategorie, automatické aktualizace, HTTPS a zálohy. FreshRSS pak bude zobrazovat pouze zdroje, které jste vybrali, a kontrolu nad čtením ponechá ve vašich rukou.

FAQ

Je FreshRSS zdarma?

Ano. FreshRSS je distribuován pod licencí AGPL-3.0. Platit musíte pouze za infrastrukturu, pokud aplikace běží na pronajatém VPS.

Lze FreshRSS používat bez domény?

Ano, vystavením portu kontejneru. Pro trvalé používání je lepší nastavit doménu a HTTPS, protože to zjednoduší bezpečný přístup, synchronizaci s mobilem a WebSub.

Kolik RAM FreshRSS potřebuje?

Pro osobní kanál je rozumné začít s 1 GB RAM a SQLite. Velký archiv, více uživatelů nebo další služby budou vyžadovat více paměti.

Mohu přidat web bez RSS?

Někdy ano. FreshRSS podporuje scrapování webu pomocí XPath, ale pravidla je nutné nastavit ručně. Pokud se rozvržení webu změní, může být potřeba zdroj opravit.

Co je nutné zálohovat?

Především zálohujte svazek freshrss_data: při použití SQLite obsahuje databázi článků. Zachovejte také freshrss_extensions a vytvořte výpisy všech externích databází.

Zpět na Blog