Hostovat wallabag na Managed VPS: články na později na vašem serveru

Hostovat wallabag na Managed VPS znamená uchovávat články, které si odkládáte na později, na vlastním stroji, který naše týmy udržují aktuální a ve dne i v noci hlídají. wallabag je svobodná aplikace s otevřeným zdrojovým kódem pro čtení později, pod licencí MIT. Tento průvodce sleduje jeho oficiální dokumentaci a oficiální obraz Docker ve verzi 2.6.17: instalaci pomocí Docker Compose, první účet a tajné klíče, HTTPS, aplikace a rozšíření prohlížeče, import z Pocketu a dalších služeb, e-maily, zálohy a aktualizace.

Simon Vasconcelos Lee Autor: Publikováno 18. listopadu 2026Doba čtení: 15 minut

Všichni průvodci

To nejdůležitější

  1. Licence MIT vám dovoluje wallabag volně používat, upravovat a šířit, v práci i kdekoli jinde, pokud zachováte jeho upozornění o autorských právech.
  2. Nainstalujte ho pomocí Docker Compose: oficiální obraz wallabag/wallabag, MariaDB, Redis a webový port publikovaný na 127.0.0.1 za reverzní proxy s HTTPS.
  3. Před prvním spuštěním nastavte SYMFONY__ENV__SECRET a svou veřejnou adresu v SYMFONY__ENV__DOMAIN_NAME; potom změňte heslo účtu wallabag, které zní wallabag.
  4. Reverzní proxy posílá X-Forwarded-Proto: https: podle toho wallabag pozná, že návštěvníci přicházejí přes HTTPS.
  5. Zálohujte databázi, svazek s obrázky a svůj compose.yaml, a aktualizujte změnou tagu obrazu a spuštěním migrací.

Co wallabag umí

wallabag je webová aplikace pro čtení později: stránku uložíte jedním kliknutím a přečtete si ji, až budete mít čas. Jeho README to shrnuje takto: klikněte, uložte, přečtěte si to, kdy chcete. wallabag z článku vytáhne jeho obsah, takže vás neruší vyskakovací okna původní stránky.

Co dovoluje licence MIT

wallabag je vydáván pod licencí MIT, autorská práva náležejí Nicolasi Lœuilletovi od roku 2013. Ta bezplatně uděluje právo software používat, kopírovat, upravovat, slučovat, zveřejňovat, šířit, sublicencovat a prodávat jeho kopie. Můžete ho tedy provozovat pro sebe, svůj tým nebo své klienty, aniž byste kupovali licenci.

Jedinou podmínkou je zachovat upozornění o autorských právech a text licence ve všech kopiích nebo podstatných částech softwaru. Text poskytuje software „tak, jak je“, bez záruky.

Prostředky, se kterými počítat

Dokumentace wallabag neuvádí žádné číslo pro paměť ani CPU. Vyjmenovává ale, co aplikace potřebuje, a obraz Docker nastavuje několik hodnot, které s dimenzováním pomohou:

Velikost serveru tedy závisí na počtu uživatelů, množství článků a vašich importech. Na Managed VPS nám popište své použití a doporučíme vám vhodnou velikost.

Instalace pomocí Docker Compose

Repozitář wallabag/docker publikuje oficiální obraz wallabag/wallabag na Docker Hub a v GitHub Container Registry, spolu s ukázkovým souborem Compose: wallabag, databáze MariaDB a Redis. Na serveru s nainstalovaným Dockerem vytvořte složku a vložte do ní tento compose.yaml, vycházející z této ukázky:

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:

Před prvním spuštěním nahraďte tři tajné hodnoty. Šestnáctkové řetězce fungují všude, i v příkazech SQL, které obraz zapisuje při vytváření databáze:

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

Abyste ověřili, že aplikace odpovídá, dotažte se na cestu, kterou používá kontrola stavu obrazu:

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

Obraz při každém spuštění kontejneru znovu načte proměnné SYMFONY__ENV__* a vyprázdní mezipaměť. Po změně souboru compose.yaml příkaz docker compose up -d kontejner znovu vytvoří a použije nová nastavení.

Se SQLite nebo PostgreSQL

Bez Dockeru

Cesta, kterou dokumentace doporučuje na vyhrazeném serveru, je repozitář Git a jeho Makefile, s Composerem, nástrojem make a rozšířeními PHP ze stránky s požadavky:

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

Webový server pak obsluhuje složku web, s app.php jako vstupním bodem: stránka o virtuálních hostitelích uvádí konfigurace pro Nginx, Apache, Caddy a lighttpd. Její ukázky obsluhují wallabag v kořeni domény nebo subdomény, což je uspořádání, které správci projektu podporují.

První účet, tajné klíče a registrace

Instalace vytvoří účet správce, jehož uživatelské jméno i heslo je wallabag, s adresou wallabag@wallabag.io. Změňte je dřív, než instanci otevřete veřejnosti. Tunel SSH přenese port 8080 serveru na váš počítač, na http://localhost:8080; přidejte -p a port SSH uvedený ve vašem zákaznickém prostoru.

Terminál, na vašem počítači
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Přihlaste se pomocí wallabag a wallabag.
  2. V části „Config“, na kartě „Password“, zvolte nové heslo o délce alespoň 8 znaků.
  3. Na kartě „User information“ nahraďte e-mailovou adresu svou: na ni chodí odkazy pro obnovení hesla.
  4. Na téže kartě zapněte dvoufázové ověření. Dokumentace doporučuje aplikaci s jednorázovými kódy, jako je FreeOTP, před kódem zasílaným e-mailem; wallabag nabízí i záložní kódy.
ProměnnáVýchozí hodnotaK čemu slouží
SYMFONY__ENV__SECRETVeřejný řetězec, stejný pro všechny instanceDodává entropii bezpečnostním operacím: dokumentace chce, aby byl pro vaši instanci jedinečný
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgÚplná adresa vaší instance, bez koncového lomítka
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse v obrazu DockerOtevírá nebo zavírá veřejnou registraci
SYMFONY__ENV__FOSUSER_CONFIRMATIONtruePosílá potvrzovací e-mail ke každé registraci
SYMFONY__ENV__LOCALEenVýchozí jazyk instance, například fr
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceNázev instance zobrazený ve vaší aplikaci pro dvoufázové ověření

Veřejná registrace je tedy v obrazu Docker zavřená. Chcete-li instanci otevřít svému týmu, vytvořte účty sami v části „Users management“, nebo otevřete registraci na dobu, kdy se lidé přihlašují, s potvrzením e-mailem.

Citlivější nastavení najdete v části „Internal Settings“, vyhrazené správci instance: veřejné sdílení článků, formáty exportu, přihlašování k webům s placeným obsahem, místní stahování obrázků a importy na pozadí.

HTTPS: reverzní proxy

Kontejner obsluhuje wallabag přes HTTP, na svém portu 80, prostřednictvím interního Nginx. HTTPS zajišťuje reverzní proxy před ním. Tento interní Nginx čte hlavičku X-Forwarded-Proto: když má hodnotu https, sdělí PHP, že je požadavek šifrovaný, a wallabag podle toho sestaví své odkazy a cookies.

S Caddy

Caddy si certifikát Let’s Encrypt sám získá a obnovuje. Jeho direktiva reverse_proxy ve výchozím stavu zachová hlavičku Host a přidá 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žívá hlavičky z ukázky Nginx v README obrazu Docker, přidává hlavičku Host a limit nahrávání obrazu a naslouchá na portu 80, aby Certbot mohl nastavit 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 zkontrolujte, že SYMFONY__ENV__DOMAIN_NAME obsahuje adresu https://, stejnou jako u vaší proxy.

Aplikace, rozšíření prohlížeče a kanály RSS

wallabag funguje v prohlížeči a projekt publikuje také aplikace a rozšíření, které se k vaší instanci připojují přes její adresu, bez koncového lomítka.

NástrojK čemu sloužíCo potřebuje
Aplikace pro AndroidSynchronizuje vaše seznamy článků a zobrazuje je v telefonuAdresu instance, vaše uživatelské jméno a heslo; přístupové údaje ke kanálům si aplikace načte sama
Aplikace pro iOSZobrazuje vaše články na iPhonu a iPaduAdresu, ID a tajný klíč klienta API, vaše uživatelské jméno a heslo
Rozšíření wallabagger, pro Firefox a ChromeUloží otevřenou stránku, se štítky, s hvězdičkou nebo archivovanouAdresu, ID a tajný klíč klienta API, vaše uživatelské jméno a heslo
Bookmarklet „bag it!“Uloží otevřenou stránku z lišty záložekNic: přetáhnete ho ze stránky „Howto“

Import článků z Pocketu a odjinud

Nabídka „Import“ přenese vaše články z jiné služby. wallabag znovu stáhne obsah každého článku, což u velkého exportu chvíli trvá. Importéry ve verzi 2.6.17:

SlužbaSoubor, který dodáte
Pocket, export CSVArchiv ZIP z exportu Pocketu, po rozbalení: soubor CSV s názvem jako part_000000.csv
Pocket, export HTMLSoubor HTML ze staršího exportu Pocketu, jako ril_export.html
InstapaperSoubor CSV ze stránky nastavení Instapaperu
OmnivoreSoubory metadata_x_to_y.json z rozbaleného exportu, jeden po druhém
Pinboard, DeliciousJejich export JSON
ShaarliJeho export HTML
Firefox, ChromeZáloha záložek Firefoxu ve formátu JSON nebo soubor Bookmarks z Chromu
Readability, elCuratorJejich export
wallabag 1.x nebo 2.xExport JSON z jiné instance

Verze 2.6.17 přináší také opravu importu CSV z Pocketu. Existuje i import přes API Pocketu, s vývojářským klíčem, který správce nastaví v konfiguraci.

Velké importy na pozadí

Aby velký import nezdržoval stránku, předá ho wallabag Redisu, kterého compose.yaml výše už obsahuje:

  1. V části „Internal Settings“, oddíl „Import“, zapněte Redis hodnotou 1.
  2. Spusťte import z nabídky „Import“: wallabag zařadí články do fronty.
  3. Spusťte worker pro zvolený typ importu, například pocket_csv; zpracuje frontu a potom dál naslouchá, dokud ho nezastavíte.
Terminál, ve složce se souborem compose.yaml
docker compose run --rm wallabag import pocket_csv

Další typy jsou pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox a chrome.

E-maily: konfigurace SMTP

wallabag posílá e-maily pro potvrzení registrace, obnovení hesla a dvoufázové kódy zasílané e-mailem. Odesílá je přes server popsaný v SYMFONY__ENV__MAILER_DSN, jehož výchozí hodnota je smtp://127.0.0.1.

Na VPS Simafri nastavte ověřovaný server SMTP, na portu 587 nebo 465: poštovní službu vaší domény nebo službu pro odesílání e-mailů. Dokumentace uvádí formát na jednom řádku, s uživatelem, heslem, serverem a portem:

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 kontejner znovu vytvořte příkazem docker compose up -d a vyzkoušejte to odkazem „Forgot your password?“ na přihlašovací stránce.

Zálohy

Stránka dokumentace o zálohách jmenuje tři položky: nastavení, databázi a obrázky. S obrazem Docker se každá z nich nachází zde:

PoložkaKde se nacházíJak ji zkopírovat
NastaveníVáš compose.yaml: obraz z něj při každém spuštění sestaví parameters.ymlKopie souboru, uložená v bezpečí, protože obsahuje vaše tajné klíče
DatabázeSvazek wallabag-dbExport pomocí mariadb-dump
ObrázkySvazek wallabag-images, připojený na web/assets/imagesArchiv složky
Terminál, ve složce se souborem 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

Naplánujte tyto kopie a posílejte je mimo server. Uložené na jeho disku se tyto archivy dostanou i do jeho nočních záloh. U SQLite dokumentace žádá zkopírovat složku data/db.

Obnova

Na nové instalaci spusťte stack se stejným compose.yaml a potom do něj znovu nahrajte databázi 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ý uživatel může také exportovat své články do JSON ze seznamu „All entries“ a znovu je importovat do jiné instance importérem wallabag 2.x. Pro správce exportuje příkaz wallabag:export články uživatele do souboru.

Aktualizace

S Dockerem změňte tag obrazu v compose.yaml, proveďte zálohu, potom stáhněte nový obraz a kontejner znovu vytvořte. README pak žádá spustit migrace databáze, pokud je vydání přináší:

Terminál, ve složce se souborem 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

Před aktualizací si přečtěte poznámky k vydání každé verze: upozorňují na kroky vlastní dané verzi, jako je složka k vyprázdnění ve verzi 2.6.16.

Kdo co dělá na Managed VPS

Vlastní hosting vyžaduje, abyste kromě aplikace udržovali i server. Na Managed VPS se serveru ujímají naše týmy a vaši instanci proaktivně sledují; wallabag zůstává vaším softwarem, s jeho nastavením a vašimi články.

TémaNaše týmyVy
ServerAktualizace systému a zabezpečení, včetně zásahů na serveruOkamžik, který vyhovuje vašemu provozu
DohledServer sledovaný 24 hodin denně, 7 dní v týdnu, se zásahem bez čekání na vaše voláníČtení protokolů vaší instance
wallabagProaktivní sledování: chyby, zpomalení, databáze a místo na disku zachycené, doporučená opravaJeho instalace, aktualizace a nastavení, které zapracujete vy nebo váš AI asistent
Účty a článkyServer, který je nese, hlídaný a zálohovanýUživatelé, registrace, klienti API a importy
ZálohyKaždou noc, šifrované a uchovávané mimo stroj; obnova v ceněExporty vlastní wallabagu a žádost o obnovu, když ji potřebujete
MigraceVáš stávající server přenesen zdarmaOkamžik přepnutí

Pokud dáváte přednost tomu, aby naše týmy zasáhly přímo v aplikaci, tato služba se účtuje po hodinách nebo paušálem, s cenovou nabídkou sdělenou před zásahem.

wallabag na serveru, o který se staráme za vás

S Managed VPS od Simafri udržují naše týmy server vaší instance wallabag aktuální, hlídají ho ve dne i v noci a zasahují bez čekání na vaše volání; vaši instanci také proaktivně sledují a doporučí vám užitečné opravy, které zapracujete vy nebo váš AI asistent. Zálohy se každou noc šifrují a uchovávají mimo stroj, jejich obnova je v ceně a migrace vašeho stávajícího serveru je zdarma.

Objevit Managed VPS

Časté otázky

Je wallabag zdarma?

Ano. wallabag je pod licencí MIT: můžete ho používat, upravovat a šířit, v práci i kdekoli jinde, aniž byste kupovali licenci, pokud zachováte jeho upozornění o autorských právech. Zbývají náklady na server, na kterém běží.

Jak nainstalovat wallabag pomocí Docker Compose?

Vyjděte z ukázkového compose.yaml obrazu wallabag/wallabag, s MariaDB a Redisem. Nastavte SYMFONY__ENV__SECRET, hesla a svou adresu v SYMFONY__ENV__DOMAIN_NAME, publikujte port na 127.0.0.1, potom spusťte docker compose up -d a předřaďte reverzní proxy s HTTPS.

Jaké jsou výchozí přihlašovací údaje wallabag?

Instalace vytvoří správce, jehož uživatelské jméno i heslo je wallabag. Změňte heslo v Config, na kartě Password, a e-mailovou adresu v User information, dřív než instanci otevřete veřejnosti.

Jak importovat články z Pocketu do wallabag?

Rozbalte archiv ZIP z exportu Pocketu: obsahuje soubor CSV, například part_000000.csv. V nabídce Import zvolte Pocket CSV a nahrajte tento soubor. wallabag pak stáhne obsah každého článku; u velkého exportu zapněte Redis v interních nastaveních.

Které aplikace fungují s wallabag?

Projekt publikuje aplikace pro Android a iOS a rozšíření wallabagger pro Firefox a Chrome, které se k vaší instanci připojují přes její adresu, bez koncového lomítka. iOS a wallabagger potřebují klienta API, vytvořeného v API clients management.

Proč odkazy wallabag za proxy zůstávají na http?

Obraz čte hlavičku X-Forwarded-Proto, aby věděl, že požadavek přichází přes HTTPS. Nechte svou proxy posílat ji s hodnotou https, spolu s hlavičkou Host vaší domény, a do SYMFONY__ENV__DOMAIN_NAME zapište adresu https://.

Jak zálohovat wallabag?

Kopírujte tři položky: databázi, pomocí mariadb-dump u MariaDB, svazek s obrázky připojený na web/assets/images a svůj compose.yaml, který obsahuje nastavení a tajné klíče. Tyto kopie posílejte mimo server.

Pokrývá Managed VPS i wallabag?

Managed VPS pokrývá server: systém, zabezpečení, dohled a zálohy. Naše týmy navíc vaši instanci proaktivně sledují a doporučí vám užitečné opravy, které zapracujete vy. Zásah v aplikaci se účtuje po hodinách nebo paušálem.

Zdroje a oficiální dokumentace

Kontaktujte nás