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.
Autor: Simon Vasconcelos Lee
Publikováno 18. listopadu 2026Doba čtení: 15 minut
wallabag/wallabag, MariaDB, Redis a webový port publikovaný na 127.0.0.1 za reverzní proxy s HTTPS.SYMFONY__ENV__SECRET a svou veřejnou adresu v SYMFONY__ENV__DOMAIN_NAME; potom změňte heslo účtu wallabag, které zní wallabag.X-Forwarded-Proto: https: podle toho wallabag pozná, že návštěvníci přicházejí přes HTTPS.compose.yaml, a aktualizujte změnou tagu obrazu a spuštěním migrací.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.
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.
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:
memory_limit výchozí hodnotou na 256 MB a proměnná PHP_MEMORY_LIMIT ji mění.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.
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:
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:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: ukázka z repozitáře publikuje port 80 kontejneru bez adresy a Docker ho pak otevře na všech adresách serveru. Publikovaný lokálně je dostupný jen přes reverzní proxy.MYSQL_ROOT_PASSWORD obraz vytvoří databázi a jejího uživatele a potom spustí wallabag:install, který vytvoří tabulky a účet wallabag. Řádek wallabag is ready! v protokolu označuje konec.wallabag; služba db si ji ponechá.wallabag-db uchovává databázi, wallabag-images obrázky článků. Ukázka v dokumentaci k instalaci také používá pojmenované svazky.redis.2.6.17, 2.6, 2 a latest. Plná verze vám dovolí zvolit okamžik každé aktualizace.Abyste ověřili, že aplikace odpovídá, dotažte se na cestu, kterou používá kontrola stavu obrazu:
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í.
/var/www/wallabag/data/db/wallabag.sqlite; v takovém případě připojte svazek na /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, port 5432 a POSTGRES_USER a POSTGRES_PASSWORD, aby obraz databázi vytvořil. Verze 2.6.15 obrazu opravuje vlastnictví databáze u PostgreSQL 15 a novějšího.POPULATE_DATABASE=False a potom ji jednou inicializujte příkazem docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. README žádá spouštět tento příkaz jako nobody, aby žádné soubory nepatřily rootovi.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:
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í.
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.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag a wallabag.| Proměnná | Výchozí hodnota | K čemu slouží |
|---|---|---|
SYMFONY__ENV__SECRET | Veřejný řetězec, stejný pro všechny instance | Dodává entropii bezpečnostním operacím: dokumentace chce, aby byl pro vaši instanci jedinečný |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Úplná adresa vaší instance, bez koncového lomítka |
SYMFONY__ENV__FOSUSER_REGISTRATION | false v obrazu Docker | Otevírá nebo zavírá veřejnou registraci |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Posílá potvrzovací e-mail ke každé registraci |
SYMFONY__ENV__LOCALE | en | Výchozí jazyk instance, například fr |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Ná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í.
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.
X-Forwarded-Proto: proxy ji musí posílat s hodnotou https.Host: vaše doménové jméno, aby přesměrování aplikace mířila na ně.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:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
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:
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 zkontrolujte, že SYMFONY__ENV__DOMAIN_NAME obsahuje adresu https://, stejnou jako u vaší proxy.
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ástroj | K čemu slouží | Co potřebuje |
|---|---|---|
| Aplikace pro Android | Synchronizuje vaše seznamy článků a zobrazuje je v telefonu | Adresu instance, vaše uživatelské jméno a heslo; přístupové údaje ke kanálům si aplikace načte sama |
| Aplikace pro iOS | Zobrazuje vaše články na iPhonu a iPadu | Adresu, ID a tajný klíč klienta API, vaše uživatelské jméno a heslo |
| Rozšíření wallabagger, pro Firefox a Chrome | Uloží otevřenou stránku, se štítky, s hvězdičkou nebo archivovanou | Adresu, 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žek | Nic: přetáhnete ho ze stránky „Howto“ |
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žba | Soubor, který dodáte |
|---|---|
| Pocket, export CSV | Archiv ZIP z exportu Pocketu, po rozbalení: soubor CSV s názvem jako part_000000.csv |
| Pocket, export HTML | Soubor HTML ze staršího exportu Pocketu, jako ril_export.html |
| Instapaper | Soubor CSV ze stránky nastavení Instapaperu |
| Omnivore | Soubory metadata_x_to_y.json z rozbaleného exportu, jeden po druhém |
| Pinboard, Delicious | Jejich export JSON |
| Shaarli | Jeho export HTML |
| Firefox, Chrome | Záloha záložek Firefoxu ve formátu JSON nebo soubor Bookmarks z Chromu |
| Readability, elCurator | Jejich export |
| wallabag 1.x nebo 2.x | Export 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.
Aby velký import nezdržoval stránku, předá ho wallabag Redisu, kterého compose.yaml výše už obsahuje:
1.pocket_csv; zpracuje frontu a potom dál naslouchá, dokud ho nezastavíte.docker compose run --rm wallabag import pocket_csv
Další typy jsou pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox a chrome.
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:
- 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
@ se stane %40. Pokud zakódovaný znak zastaví spuštění, dokumentace navrhuje zdvojit znak procenta: %%40.FROM_EMAIL je odesílatel všech e-mailů wallabagu, TWOFACTOR_SENDER odesílatel dvoufázových kódů. Použijte adresu ve své doméně, ze které váš server SMTP dovoluje odesílat.:465 na konci řádku.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.
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žka | Kde 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.yml | Kopie souboru, uložená v bezpečí, protože obsahuje vaše tajné klíče |
| Databáze | Svazek wallabag-db | Export pomocí mariadb-dump |
| Obrázky | Svazek wallabag-images, připojený na web/assets/images | Archiv složky |
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.
Na nové instalaci spusťte stack se stejným compose.yaml a potom do něj znovu nahrajte databázi 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ý 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.
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áší:
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 vydání žádají vyprázdnit starou složku web/uploads/import. V tomto compose.yaml se tato složka nachází uvnitř kontejneru: kontejner vytvořený z nového obrazu startuje bez ní.make update, který na instancích ve verzi 2.6.15 nebo starší vybíral alfa vydání zveřejněné toho rána. Pro zaseknutou instalaci z Gitu uvádějí poznámky k vydání opravu: git checkout 2.6.17 --force a potom make update.make update, který také spustí migrace a vyprázdní mezipaměť.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.
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éma | Naše týmy | Vy |
|---|---|---|
| Server | Aktualizace systému a zabezpečení, včetně zásahů na serveru | Okamžik, který vyhovuje vašemu provozu |
| Dohled | Server sledovaný 24 hodin denně, 7 dní v týdnu, se zásahem bez čekání na vaše volání | Čtení protokolů vaší instance |
| wallabag | Proaktivní sledování: chyby, zpomalení, databáze a místo na disku zachycené, doporučená oprava | Jeho instalace, aktualizace a nastavení, které zapracujete vy nebo váš AI asistent |
| Účty a články | Server, který je nese, hlídaný a zálohovaný | Uživatelé, registrace, klienti API a importy |
| Zálohy | Každou noc, šifrované a uchovávané mimo stroj; obnova v ceně | Exporty vlastní wallabagu a žádost o obnovu, když ji potřebujete |
| Migrace | Váš stávající server přenesen zdarma | Okamž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.
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.
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ěží.
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.
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.
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.
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.
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://.
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.
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.
Simafri
Promluvme si o vašem záměru
Řekněte nám v pár slovech, co potřebujete: rychle se vám ozveme.
Děkujeme! Vaše zpráva byla odeslána. Brzy se vám ozveme.
Máte raději e-mail? Napište nám na support@simafri.com.