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.
Autor: Simon Vasconcelos Lee
Publikované 18. novembra 2026Čas čítania: 15 minút
wallabag/wallabag, MariaDB, Redis a webový port publikovaný na 127.0.0.1 za reverznou proxy s HTTPS.SYMFONY__ENV__SECRET a svoju verejnú adresu v SYMFONY__ENV__DOMAIN_NAME; potom zmeňte heslo účtu wallabag, ktoré je wallabag.X-Forwarded-Proto: https: podľa toho wallabag vie, že návštevníci prichádzajú cez HTTPS.compose.yaml, a aktualizujte zmenou tagu obrazu a spustením migrácií.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.
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.
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í:
memory_limit na 256 MB a premenná PHP_MEMORY_LIMIT ju mení.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ť.
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:
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:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: ukážka z repozitára publikuje port 80 kontajnera bez adresy a Docker ho potom otvorí na všetkých adresách servera. Publikovaný lokálne je dostupný len cez reverznú proxy.MYSQL_ROOT_PASSWORD obraz vytvorí databázu a jej používateľa a potom spustí wallabag:install, ktorý vytvorí tabuľky a účet wallabag. Riadok wallabag is ready! v zázname označuje koniec.wallabag; služba db si ju ponechá.wallabag-db uchováva databázu, wallabag-images obrázky článkov. Ukážka v dokumentácii k inštalácii tiež používa pomenované zväzky.redis.2.6.17, 2.6, 2 a latest. Úplná verzia vám umožní zvoliť okamih každej aktualizácie.Ak chcete overiť, že aplikácia odpovedá, dopytujte sa na cestu, ktorú používa kontrola stavu obrazu:
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.
/var/www/wallabag/data/db/wallabag.sqlite; v takom prípade pripojte zväzok na /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, port 5432 a POSTGRES_USER a POSTGRES_PASSWORD, aby obraz databázu vytvoril. Verzia 2.6.15 obrazu opravuje vlastníctvo databázy pri PostgreSQL 15 a novšom.POPULATE_DATABASE=False a potom ju raz inicializujte príkazom docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. README žiada spúšťať tento príkaz ako nobody, aby žiadne súbory nepatrili rootovi.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:
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ú.
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.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag a wallabag.| Premenná | Predvolená hodnota | Na čo slúži |
|---|---|---|
SYMFONY__ENV__SECRET | Verejný reťazec, rovnaký pre všetky inštancie | Dodáva entropiu bezpečnostným operáciám: dokumentácia chce, aby bol pre vašu inštanciu jedinečný |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Úplná adresa vašej inštancie, bez koncovej lomky |
SYMFONY__ENV__FOSUSER_REGISTRATION | false v obraze Docker | Otvára alebo zatvára verejnú registráciu |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Posiela potvrdzovací e-mail ku každej registrácii |
SYMFONY__ENV__LOCALE | en | Predvolený jazyk inštancie, napríklad fr |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Ná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í.
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.
X-Forwarded-Proto: proxy ju musí posielať s hodnotou https.Host: vaše doménové meno, aby presmerovania aplikácie smerovali naň.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:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
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:
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;
}
}
sudo nginx -t
sudo certbot --nginx
Potom skontrolujte, že SYMFONY__ENV__DOMAIN_NAME obsahuje adresu https://, rovnakú ako pri vašej proxy.
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ástroj | Na čo slúži | Čo potrebuje |
|---|---|---|
| Aplikácia pre Android | Synchronizuje vaše zoznamy článkov a zobrazuje ich v telefóne | Adresu 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 iOS | Zobrazuje vaše články na iPhone a iPade | Adresu, ID a tajný kľúč klienta API, vaše používateľské meno a heslo |
| Rozšírenie wallabagger, pre Firefox a Chrome | Uloží 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žiek | Nič: pretiahnete ho zo stránky „Howto“ |
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žba | Súbor, ktorý dodáte |
|---|---|
| Pocket, export CSV | Archív ZIP z exportu Pocketu, po rozbalení: súbor CSV s názvom ako part_000000.csv |
| Pocket, export HTML | Súbor HTML zo staršieho exportu Pocketu, ako ril_export.html |
| Instapaper | Súbor CSV zo stránky nastavení Instapaperu |
| Omnivore | Súbory metadata_x_to_y.json z rozbaleného exportu, jeden po druhom |
| Pinboard, Delicious | Ich export JSON |
| Shaarli | Jeho export HTML |
| Firefox, Chrome | Záloha záložiek Firefoxu vo formáte JSON alebo súbor Bookmarks z Chromu |
| Readability, elCurator | Ich export |
| wallabag 1.x alebo 2.x | Export 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.
Aby veľký import nezdržiaval stránku, odovzdá ho wallabag Redisu, ktorý compose.yaml vyššie už obsahuje:
1.pocket_csv; spracuje front a potom ďalej počúva, kým ho nezastavíte.docker compose run --rm wallabag import pocket_csv
Ďalšie typy sú pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox a chrome.
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:
- 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
@ sa stane %40. Ak zakódovaný znak zastaví spustenie, dokumentácia navrhuje zdvojiť znak percenta: %%40.FROM_EMAIL je odosielateľ všetkých e-mailov wallabagu, TWOFACTOR_SENDER odosielateľ dvojfaktorových kódov. Použite adresu vo svojej doméne, z ktorej váš server SMTP umožňuje odosielať.:465 na konci riadku.Potom kontajner znova vytvorte príkazom docker compose up -d a vyskúšajte to odkazom „Forgot your password?“ na prihlasovacej stránke.
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žka | Kde sa nachádza | Ako ju skopírovať |
|---|---|---|
| Nastavenia | Váš compose.yaml: obraz z neho pri každom spustení zostaví parameters.yml | Kópia súboru, uložená v bezpečí, pretože obsahuje vaše tajné kľúče |
| Databáza | Zväzok wallabag-db | Export pomocou mariadb-dump |
| Obrázky | Zväzok wallabag-images, pripojený na web/assets/images | Archív priečinka |
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.
Na novej inštalácii spustite stack s rovnakým compose.yaml a potom doň znova nahrajte databázu a obrázky:
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.
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:
docker compose pull
docker compose up -d
docker compose exec --user nobody wallabag php bin/console doctrine:migrations:migrate --env=prod --no-interaction
var/import a poznámky k vydaniu žiadajú vyprázdniť starý priečinok web/uploads/import. V tomto compose.yaml sa tento priečinok nachádza vnútri kontajnera: kontajner vytvorený z nového obrazu štartuje bez neho.make update, ktorý na inštanciách vo verzii 2.6.15 alebo staršej vyberal alfa vydanie zverejnené v to ráno. Pre zaseknutú inštaláciu z Gitu uvádzajú poznámky k vydaniu opravu: git checkout 2.6.17 --force a potom make update.make update, ktorý tiež spustí migrácie a vyprázdni vyrovnávaciu pamäť.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.
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éma | Naše tímy | Vy |
|---|---|---|
| Server | Aktualizácie systému a zabezpečenia, vrátane zásahov na serveri | Čas, ktorý vyhovuje vašej činnosti |
| Dohľad | Server 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 |
| wallabag | Proaktívne sledovanie: chyby, spomalenia, databáza a miesto na disku, s odporúčanou opravou | Jeho inštalácia, aktualizácie a nastavenia, ktoré zapracujete vy alebo váš AI asistent |
| Účty a články | Server, ktorý ich nesie, sledovaný a zálohovaný | Používatelia, registrácie, klienti API a importy |
| Zálohy | Každú noc, šifrované a uchovávané mimo stroja; obnova je v cene | Exporty špecifické pre wallabag a žiadosť o obnovu, keď ju potrebujete |
| Migrácia | Váš 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.
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.
Á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ží.
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.
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.
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.
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.
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://.
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.
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.
Simafri
Porozprávajme sa o vašom zámere
Povedzte nám v pár slovách, čo potrebujete: rýchlo sa vám ozveme.
Ďakujeme! Vaša žiadosť bola odoslaná. Čoskoro sa vám ozveme.
Máte radšej e-mail? Napíšte nám na support@simafri.com.