Hostovanie wallabag na Managed VPS: články na neskôr na vašom serveri

Hostovanie wallabag na Managed VPS znamená uchovávať články, ktoré si odkladáte na neskôr, na vlastnom stroji, ktorý naše tímy udržiavajú aktuálny a dohliadajú naň vo dne v noci. wallabag je slobodná aplikácia s otvoreným zdrojovým kódom na čítanie neskôr, pod licenciou MIT. Tento sprievodca postupuje podľa jeho oficiálnej dokumentácie a oficiálneho obrazu Docker vo verzii 2.6.17: inštalácia cez Docker Compose, prvý účet a tajné kľúče, HTTPS, aplikácie a rozšírenia prehliadača, import z Pocketu a ďalších služieb, e-maily, zálohy a aktualizácie.

Simon Vasconcelos Lee Autor: Publikované 18. novembra 2026Čas čítania: 15 minút

Všetci sprievodcovia

To najdôležitejšie

  1. Licencia MIT vám umožňuje wallabag voľne používať, upravovať a šíriť, v práci aj kdekoľvek inde, ak zachováte jeho upozornenie o autorských právach.
  2. Nainštalujte ho cez Docker Compose: oficiálny obraz wallabag/wallabag, MariaDB, Redis a webový port publikovaný na 127.0.0.1 za reverznou proxy s HTTPS.
  3. Pred prvým spustením nastavte SYMFONY__ENV__SECRET a svoju verejnú adresu v SYMFONY__ENV__DOMAIN_NAME; potom zmeňte heslo účtu wallabag, ktoré je wallabag.
  4. Reverzná proxy posiela X-Forwarded-Proto: https: podľa toho wallabag vie, že návštevníci prichádzajú cez HTTPS.
  5. Zálohujte databázu, zväzok s obrázkami a svoj compose.yaml, a aktualizujte zmenou tagu obrazu a spustením migrácií.

Čo wallabag robí

wallabag je webová aplikácia na čítanie neskôr: stránku uložíte jedným kliknutím a prečítate si ju, keď budete mať čas. Jeho README to zhŕňa takto: kliknite, uložte, prečítajte si to, kedy chcete. wallabag z článku vytiahne jeho obsah, takže vás nerušia vyskakovacie okná pôvodnej stránky.

Čo umožňuje licencia MIT

wallabag vychádza pod licenciou MIT, autorské práva patria Nicolasovi Lœuilletovi od roku 2013. Bezplatne udeľuje právo používať, kopírovať, upravovať, zlučovať, zverejňovať, šíriť, poskytovať sublicencie a predávať kópie softvéru. Môžete ho teda prevádzkovať pre seba, svoj tím alebo svojich klientov bez licencie, ktorú by ste museli kupovať.

Jedinou podmienkou je zachovať upozornenie o autorských právach a text licencie vo všetkých kópiách alebo podstatných častiach softvéru. Text poskytuje softvér „tak, ako je“, bez záruky.

Prostriedky, s ktorými treba počítať

Dokumentácia wallabag neuvádza žiadne číslo pre pamäť ani procesor. Vymenúva však, čo aplikácia potrebuje, a obraz Docker nastavuje niekoľko hodnôt, ktoré pomáhajú pri dimenzovaní:

Veľkosť servera teda závisí od počtu používateľov, množstva článkov a vašich importov. Na Managed VPS nám opíšte svoje používanie a odporučíme vám vhodnú veľkosť.

Inštalácia pomocou Docker Compose

Repozitár wallabag/docker publikuje oficiálny obraz wallabag/wallabag na Docker Hub a v GitHub Container Registry, spolu s ukážkovým súborom Compose: wallabag, databáza MariaDB a Redis. Na serveri s nainštalovaným Dockerom vytvorte priečinok a vložte doň tento compose.yaml, vychádzajúci z tejto ukážky:

compose.yaml
services:
  wallabag:
    image: wallabag/wallabag:2.6.17
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=root-password
      - SYMFONY__ENV__DATABASE_DRIVER=pdo_mysql
      - SYMFONY__ENV__DATABASE_HOST=db
      - SYMFONY__ENV__DATABASE_PORT=3306
      - SYMFONY__ENV__DATABASE_NAME=wallabag
      - SYMFONY__ENV__DATABASE_USER=wallabag
      - SYMFONY__ENV__DATABASE_PASSWORD=database-password
      - SYMFONY__ENV__DATABASE_CHARSET=utf8mb4
      - SYMFONY__ENV__SECRET=random-secret-string
      - SYMFONY__ENV__DOMAIN_NAME=https://read.example.com
      - SYMFONY__ENV__MAILER_DSN=smtp://user:password@smtp.example.com:587
      - SYMFONY__ENV__FROM_EMAIL=read@example.com
      - SYMFONY__ENV__TWOFACTOR_SENDER=read@example.com
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - wallabag-images:/var/www/wallabag/web/assets/images
    depends_on:
      - db
      - redis
  db:
    image: mariadb
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=root-password
    volumes:
      - wallabag-db:/var/lib/mysql
    healthcheck:
      test: ["CMD", "/usr/local/bin/healthcheck.sh", "--innodb_initialized"]
      interval: 20s
      timeout: 3s
  redis:
    image: redis:alpine
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 20s
      timeout: 3s

volumes:
  wallabag-images:
  wallabag-db:

Pred prvým spustením nahraďte tri tajné hodnoty. Šestnástkové reťazce fungujú všade, aj v príkazoch SQL, ktoré obraz zapisuje pri vytváraní databázy:

Terminál
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag

Ak chcete overiť, že aplikácia odpovedá, dopytujte sa na cestu, ktorú používa kontrola stavu obrazu:

Terminál
curl http://127.0.0.1:8080/api/info

Obraz pri každom spustení kontajnera znova načíta premenné SYMFONY__ENV__* a vyprázdni vyrovnávaciu pamäť. Po zmene súboru compose.yaml príkaz docker compose up -d kontajner znova vytvorí a použije nové nastavenia.

So SQLite alebo PostgreSQL

Bez Dockeru

Cesta, ktorú dokumentácia odporúča na vyhradenom serveri, je repozitár Git a jeho Makefile, s Composerom, nástrojom make a rozšíreniami PHP zo stránky s požiadavkami:

Terminál
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install

Webový server potom obsluhuje priečinok web, s app.php ako vstupným bodom: stránka o virtuálnych hostiteľoch uvádza konfigurácie pre Nginx, Apache, Caddy a lighttpd. Jej ukážky obsluhujú wallabag v koreni domény alebo subdomény, čo je usporiadanie, ktoré správcovia projektu podporujú.

Prvý účet, tajné kľúče a registrácie

Inštalácia vytvorí účet správcu, ktorého používateľské meno aj heslo je wallabag, s adresou wallabag@wallabag.io. Zmeňte ich skôr, než inštanciu otvoríte verejnosti. Tunel SSH prenesie port 8080 servera na váš počítač, na http://localhost:8080; pridajte -p a port SSH uvedený vo vašej zákazníckej zóne.

Terminál, na vašom počítači
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Prihláste sa pomocou wallabag a wallabag.
  2. V časti „Config“, na karte „Password“, zvoľte nové heslo s dĺžkou aspoň 8 znakov.
  3. Na karte „User information“ nahraďte e-mailovú adresu svojou: na ňu prichádzajú odkazy na obnovenie hesla.
  4. Na tej istej karte zapnite dvojfaktorové overenie. Dokumentácia odporúča aplikáciu s jednorazovými kódmi, ako je FreeOTP, pred kódom zasielaným e-mailom; wallabag ponúka aj záložné kódy.
PremennáPredvolená hodnotaNa čo slúži
SYMFONY__ENV__SECRETVerejný reťazec, rovnaký pre všetky inštancieDodáva entropiu bezpečnostným operáciám: dokumentácia chce, aby bol pre vašu inštanciu jedinečný
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgÚplná adresa vašej inštancie, bez koncovej lomky
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse v obraze DockerOtvára alebo zatvára verejnú registráciu
SYMFONY__ENV__FOSUSER_CONFIRMATIONtruePosiela potvrdzovací e-mail ku každej registrácii
SYMFONY__ENV__LOCALEenPredvolený jazyk inštancie, napríklad fr
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceNázov inštancie zobrazený vo vašej aplikácii na dvojfaktorové overenie

Verejná registrácia je teda v obraze Docker zatvorená. Ak chcete inštanciu otvoriť svojmu tímu, vytvorte účty sami v časti „Users management“, alebo otvorte registráciu na čas, keď sa ľudia prihlasujú, s potvrdením e-mailom.

Citlivejšie nastavenia nájdete v časti „Internal Settings“, vyhradenej správcovi inštancie: verejné zdieľanie článkov, formáty exportu, prihlasovanie na weby s plateným obsahom, lokálne sťahovanie obrázkov a importy na pozadí.

HTTPS: reverzná proxy

Kontajner obsluhuje wallabag cez HTTP, na svojom porte 80, prostredníctvom interného Nginx. HTTPS zabezpečuje reverzná proxy pred ním. Tento interný Nginx číta hlavičku X-Forwarded-Proto: keď má hodnotu https, oznámi PHP, že je požiadavka šifrovaná, a wallabag podľa toho zostaví svoje odkazy a cookies.

S Caddy

Caddy si certifikát Let’s Encrypt sám získa a obnovuje. Jeho direktíva reverse_proxy predvolene zachová hlavičku Host a pridá X-Forwarded-For, X-Forwarded-Proto a X-Forwarded-Host:

Caddyfile
read.example.com {
  reverse_proxy 127.0.0.1:8080
}

S Nginx

Tento blok používa hlavičky z ukážky Nginx v README obrazu Docker, pridáva hlavičku Host a limit nahrávania obrazu a počúva na porte 80, aby Certbot mohol nastaviť HTTPS:

Blok Nginx
server {
    listen 80;
    listen [::]:80;
    server_name read.example.com;
    client_max_body_size 100M;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $server_name;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-For $remote_addr;
    }
}
Terminál
sudo nginx -t
sudo certbot --nginx

Potom skontrolujte, že SYMFONY__ENV__DOMAIN_NAME obsahuje adresu https://, rovnakú ako pri vašej proxy.

Aplikácie, rozšírenia prehliadača a kanály RSS

wallabag funguje v prehliadači a projekt publikuje aj aplikácie a rozšírenie, ktoré sa k vašej inštancii pripájajú cez jej adresu, bez koncovej lomky.

NástrojNa čo slúžiČo potrebuje
Aplikácia pre AndroidSynchronizuje vaše zoznamy článkov a zobrazuje ich v telefóneAdresu inštancie, vaše používateľské meno a heslo; prístupové údaje ku kanálom si aplikácia načíta sama
Aplikácia pre iOSZobrazuje vaše články na iPhone a iPadeAdresu, ID a tajný kľúč klienta API, vaše používateľské meno a heslo
Rozšírenie wallabagger, pre Firefox a ChromeUloží otvorenú stránku, so štítkami, s hviezdičkou alebo archivovanúAdresu, ID a tajný kľúč klienta API, vaše používateľské meno a heslo
Bookmarklet „bag it!“Uloží otvorenú stránku z lišty záložiekNič: pretiahnete ho zo stránky „Howto“

Import článkov z Pocketu a odinakiaľ

Ponuka „Import“ prenesie vaše články z inej služby. wallabag znova stiahne obsah každého článku, čo pri veľkom exporte chvíľu trvá. Importéry vo verzii 2.6.17:

SlužbaSúbor, ktorý dodáte
Pocket, export CSVArchív ZIP z exportu Pocketu, po rozbalení: súbor CSV s názvom ako part_000000.csv
Pocket, export HTMLSúbor HTML zo staršieho exportu Pocketu, ako ril_export.html
InstapaperSúbor CSV zo stránky nastavení Instapaperu
OmnivoreSúbory metadata_x_to_y.json z rozbaleného exportu, jeden po druhom
Pinboard, DeliciousIch export JSON
ShaarliJeho export HTML
Firefox, ChromeZáloha záložiek Firefoxu vo formáte JSON alebo súbor Bookmarks z Chromu
Readability, elCuratorIch export
wallabag 1.x alebo 2.xExport JSON z inej inštancie

Verzia 2.6.17 prináša aj opravu importu CSV z Pocketu. Existuje aj import cez API Pocketu, s vývojárskym kľúčom, ktorý správca nastaví v konfigurácii.

Veľké importy na pozadí

Aby veľký import nezdržiaval stránku, odovzdá ho wallabag Redisu, ktorý compose.yaml vyššie už obsahuje:

  1. V časti „Internal Settings“, sekcia „Import“, zapnite Redis hodnotou 1.
  2. Spustite import z ponuky „Import“: wallabag zaradí články do frontu.
  3. Spustite worker pre zvolený typ importu, napríklad pocket_csv; spracuje front a potom ďalej počúva, kým ho nezastavíte.
Terminál, v priečinku so súborom compose.yaml
docker compose run --rm wallabag import pocket_csv

Ďalšie typy sú pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox a chrome.

E-maily: konfigurácia SMTP

wallabag posiela e-maily na potvrdenie registrácie, obnovenie hesla a dvojfaktorové kódy zasielané e-mailom. Odosiela ich cez server opísaný v SYMFONY__ENV__MAILER_DSN, ktorého predvolená hodnota je smtp://127.0.0.1.

Na VPS Simafri nastavte overovaný server SMTP, na porte 587 alebo 465: poštovú službu vašej domény alebo službu na odosielanie e-mailov. Dokumentácia uvádza formát na jednom riadku, s používateľom, heslom, serverom a portom:

compose.yaml, služba wallabag
      - SYMFONY__ENV__MAILER_DSN=smtp://read%40example.com:password@smtp.example.com:587
      - SYMFONY__ENV__FROM_EMAIL=read@example.com
      - SYMFONY__ENV__TWOFACTOR_SENDER=read@example.com

Potom kontajner znova vytvorte príkazom docker compose up -d a vyskúšajte to odkazom „Forgot your password?“ na prihlasovacej stránke.

Zálohy

Stránka dokumentácie o zálohách menuje tri položky: nastavenia, databázu a obrázky. S obrazom Docker sa každá z nich nachádza tu:

PoložkaKde sa nachádzaAko ju skopírovať
NastaveniaVáš compose.yaml: obraz z neho pri každom spustení zostaví parameters.ymlKópia súboru, uložená v bezpečí, pretože obsahuje vaše tajné kľúče
DatabázaZväzok wallabag-dbExport pomocou mariadb-dump
ObrázkyZväzok wallabag-images, pripojený na web/assets/imagesArchív priečinka
Terminál, v priečinku so súborom compose.yaml
docker compose exec -T db sh -c 'exec mariadb-dump -uroot -p"$MYSQL_ROOT_PASSWORD" wallabag' > wallabag-$(date +%F).sql
docker compose exec -T wallabag tar -czf - -C /var/www/wallabag/web/assets images > wallabag-images-$(date +%F).tar.gz
cp compose.yaml compose-$(date +%F).yaml

Tieto kópie naplánujte a posielajte ich mimo servera. Uložené na jeho disku sa tieto archívy dostanú aj do jeho nočných záloh. Pri SQLite dokumentácia žiada skopírovať priečinok data/db.

Obnova

Na novej inštalácii spustite stack s rovnakým compose.yaml a potom doň znova nahrajte databázu a obrázky:

Terminál
docker compose exec -T db sh -c 'exec mariadb -uroot -p"$MYSQL_ROOT_PASSWORD" wallabag' < wallabag-2026-11-18.sql
docker compose exec -T wallabag tar -xzf - -C /var/www/wallabag/web/assets < wallabag-images-2026-11-18.tar.gz

Každý používateľ môže tiež exportovať svoje články do JSON zo zoznamu „All entries“ a znova ich importovať do inej inštancie importérom wallabag 2.x. Pre správcov exportuje príkaz wallabag:export články používateľa do súboru.

Aktualizácie

S Dockerom zmeňte tag obrazu v compose.yaml, urobte zálohu, potom stiahnite nový obraz a kontajner znova vytvorte. README potom žiada spustiť migrácie databázy, ak ich vydanie prináša:

Terminál, v priečinku so súborom compose.yaml
docker compose pull
docker compose up -d
docker compose exec --user nobody wallabag php bin/console doctrine:migrations:migrate --env=prod --no-interaction

Pred aktualizáciou si prečítajte poznámky k vydaniu každej verzie: upozorňujú na kroky špecifické pre danú verziu, ako je priečinok na vyprázdnenie vo verzii 2.6.16.

Kto čo robí na Managed VPS

Hostovanie na vlastnom serveri vyžaduje popri aplikácii starať sa aj o server. Na Managed VPS preberajú server naše tímy a vašu inštanciu proaktívne sledujú; wallabag zostáva vaším softvérom, s jeho nastaveniami a vašimi článkami.

TémaNaše tímyVy
ServerAktualizácie systému a zabezpečenia, vrátane zásahov na serveriČas, ktorý vyhovuje vašej činnosti
DohľadServer sledovaný 24 hodín denne, 7 dní v týždni, so zásahom bez čakania na vaše zavolanieČítanie záznamov vašej inštancie
wallabagProaktívne sledovanie: chyby, spomalenia, databáza a miesto na disku, s odporúčanou opravouJeho inštalácia, aktualizácie a nastavenia, ktoré zapracujete vy alebo váš AI asistent
Účty a článkyServer, ktorý ich nesie, sledovaný a zálohovanýPoužívatelia, registrácie, klienti API a importy
ZálohyKaždú noc, šifrované a uchovávané mimo stroja; obnova je v ceneExporty špecifické pre wallabag a žiadosť o obnovu, keď ju potrebujete
MigráciaVáš súčasný server prenesený zdarmaČas prepnutia

Ak by ste uprednostnili, aby naše tímy zasiahli priamo v aplikácii, táto služba sa fakturuje hodinovo alebo paušálne, s cenovou ponukou oznámenou pred zásahom.

wallabag na serveri, o ktorý sa staráme za vás

S Managed VPS od Simafri udržiavajú naše tímy server vašej inštancie wallabag aktuálny, sledujú ho vo dne v noci a zasahujú bez čakania na vaše zavolanie; vašu inštanciu navyše proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy alebo váš AI asistent. Zálohy sa každú noc šifrujú a uchovávajú mimo stroja, ich obnova je v cene a migrácia vášho súčasného servera je zdarma.

Objaviť Managed VPS

Časté otázky

Je wallabag zadarmo?

Áno. wallabag je pod licenciou MIT: môžete ho používať, upravovať a šíriť, v práci aj kdekoľvek inde, bez kupovania licencie, ak zachováte jeho upozornenie o autorských právach. Zostávajú náklady na server, na ktorom beží.

Ako nainštalovať wallabag pomocou Docker Compose?

Vyjdite z ukážkového compose.yaml obrazu wallabag/wallabag, s MariaDB a Redisom. Nastavte SYMFONY__ENV__SECRET, heslá a svoju adresu v SYMFONY__ENV__DOMAIN_NAME, publikujte port na 127.0.0.1, potom spustite docker compose up -d a predraďte reverznú proxy s HTTPS.

Aké sú predvolené prihlasovacie údaje wallabag?

Inštalácia vytvorí správcu, ktorého používateľské meno aj heslo je wallabag. Zmeňte heslo v Config, na karte Password, a e-mailovú adresu v User information, skôr než inštanciu otvoríte verejnosti.

Ako importovať články z Pocketu do wallabag?

Rozbaľte archív ZIP z exportu Pocketu: obsahuje súbor CSV, napríklad part_000000.csv. V ponuke Import zvoľte Pocket CSV a nahrajte tento súbor. wallabag potom stiahne obsah každého článku; pri veľkom exporte zapnite Redis v interných nastaveniach.

Ktoré aplikácie fungujú s wallabag?

Projekt publikuje aplikácie pre Android a iOS a rozšírenie wallabagger pre Firefox a Chrome, ktoré sa k vašej inštancii pripájajú cez jej adresu, bez koncovej lomky. iOS a wallabagger potrebujú klienta API, vytvoreného v API clients management.

Prečo odkazy wallabag za proxy zostávajú na http?

Obraz číta hlavičku X-Forwarded-Proto, aby vedel, že požiadavka prichádza cez HTTPS. Nechajte svoju proxy posielať ju s hodnotou https, spolu s hlavičkou Host vašej domény, a do SYMFONY__ENV__DOMAIN_NAME zapíšte adresu https://.

Ako zálohovať wallabag?

Kopírujte tri položky: databázu, pomocou mariadb-dump pri MariaDB, zväzok s obrázkami pripojený na web/assets/images a svoj compose.yaml, ktorý obsahuje nastavenia a tajné kľúče. Tieto kópie posielajte mimo servera.

Pokrýva Managed VPS aj wallabag?

Managed VPS pokrýva server: systém, zabezpečenie, dohľad a zálohy. Naše tímy navyše vašu inštanciu proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy. Zásah v aplikácii sa fakturuje hodinovo alebo paušálne.

Zdroje a oficiálna dokumentácia

Kontaktujte nás