Hosting wallabag na Managed VPS oznacza, że artykuły odkładane do przeczytania później pozostają na maszynie, która należy do Państwa, a nasze zespoły dbają o jej aktualność i nadzorują ją dniem i nocą. wallabag to wolna, otwartoźródłowa aplikacja typu „przeczytaj później” na licencji MIT. Ten poradnik podąża za oficjalną dokumentacją i oficjalnym obrazem Docker wallabag, w wersji 2.6.17: instalacja przez Docker Compose, pierwsze konto i sekrety, HTTPS, aplikacje i rozszerzenia przeglądarki, import z Pocket i innych serwisów, e-mail, kopie zapasowe i aktualizacje.
Autor: Simon Vasconcelos Lee
Opublikowano 18 listopada 2026Czas czytania: 15 minut
wallabag/wallabag, MariaDB, Redis i port webowy opublikowany na 127.0.0.1 za odwrotnym proxy z HTTPS.SYMFONY__ENV__SECRET i swój publiczny adres w SYMFONY__ENV__DOMAIN_NAME, a następnie zmienić hasło konta wallabag, które brzmi wallabag.X-Forwarded-Proto: https: w ten sposób wallabag wie, że odwiedzający łączą się przez HTTPS.compose.yaml, a aktualizować przez zmianę tagu obrazu i uruchomienie migracji.wallabag to aplikacja webowa typu „przeczytaj później”: zapisują Państwo stronę jednym kliknięciem i czytają ją, gdy znajdą czas. Jego README streszcza to tak: kliknij, zapisz, przeczytaj, kiedy chcesz. wallabag wyodrębnia treść artykułu, dzięki czemu nie rozpraszają Państwa wyskakujące okna oryginalnej strony.
wallabag jest udostępniany na licencji MIT, prawa autorskie należą do Nicolasa Lœuilleta od 2013 roku. Przyznaje ona bezpłatnie prawo do używania, kopiowania, modyfikowania, łączenia, publikowania, rozpowszechniania, sublicencjonowania i sprzedawania kopii oprogramowania. Mogą więc Państwo uruchomić go dla siebie, swojego zespołu lub klientów, bez zakupu licencji.
Jedynym warunkiem jest zachowanie informacji o prawach autorskich i tekstu licencji we wszystkich kopiach lub istotnych częściach oprogramowania. Tekst dostarcza oprogramowanie „w stanie, w jakim jest”, bez gwarancji.
Dokumentacja wallabag nie podaje liczb dotyczących pamięci ani procesora. Wymienia natomiast, czego aplikacja potrzebuje, a obraz Docker ustala kilka wartości, które pomagają w doborze serwera:
memory_limit na 256 MB, a zmienna PHP_MEMORY_LIMIT pozwala to zmienić.Rozmiar serwera zależy więc od liczby użytkowników, liczby artykułów i Państwa importów. Na Managed VPS wystarczy opisać nam swoje zastosowanie, a polecimy odpowiedni rozmiar.
Repozytorium wallabag/docker publikuje oficjalny obraz wallabag/wallabag na Docker Hub i w GitHub Container Registry, wraz z przykładowym plikiem Compose: wallabag, baza MariaDB i Redis. Na serwerze z zainstalowanym Dockerem proszę utworzyć katalog i umieścić w nim ten compose.yaml, oparty na tym przykładzie:
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:
Przed pierwszym uruchomieniem proszę zastąpić trzy tajne wartości. Ciągi szesnastkowe działają wszędzie, także w poleceniach SQL, które obraz zapisuje, aby utworzyć bazę danych:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: przykład z repozytorium publikuje port 80 kontenera bez adresu, a Docker otwiera go wtedy na wszystkich adresach serwera. Opublikowany lokalnie, jest osiągalny wyłącznie przez odwrotne proxy.MYSQL_ROOT_PASSWORD obraz tworzy bazę danych i jej użytkownika, a następnie uruchamia wallabag:install, które tworzy tabele i konto wallabag. Wiersz wallabag is ready! w dzienniku oznacza koniec.wallabag; usługa db ją zachowuje.wallabag-db przechowuje bazę danych, wallabag-images obrazy artykułów. Przykład z dokumentacji instalacji również korzysta z wolumenów nazwanych.redis.2.6.17, 2.6, 2 i latest. Pełna wersja pozwala Państwu wybrać moment każdej aktualizacji.Aby sprawdzić, czy aplikacja odpowiada, proszę odpytać ścieżkę, z której korzysta kontrola stanu obrazu:
curl http://127.0.0.1:8080/api/info
Obraz odczytuje zmienne SYMFONY__ENV__* przy każdym starcie kontenera i czyści pamięć podręczną. Po zmianie compose.yaml polecenie docker compose up -d odtwarza kontener i stosuje nowe ustawienia.
/var/www/wallabag/data/db/wallabag.sqlite; w takim przypadku proszę zamontować wolumen w /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, port 5432 oraz POSTGRES_USER i POSTGRES_PASSWORD, aby obraz utworzył bazę danych. Wersja 2.6.15 obrazu poprawia własność bazy danych przy PostgreSQL 15 i nowszych.POPULATE_DATABASE=False, a następnie zainicjować ją jeden raz poleceniem docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. README prosi o uruchamianie tego polecenia jako nobody, aby żadne pliki nie należały do roota.Sposób zalecany przez dokumentację na serwerze dedykowanym to repozytorium Git i jego Makefile, z Composerem, narzędziem make i rozszerzeniami PHP ze strony z wymaganiami:
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install
Serwer WWW udostępnia wtedy katalog web, z app.php jako punktem wejścia: strona o hostach wirtualnych podaje konfiguracje dla Nginx, Apache, Caddy i lighttpd. Jej przykłady udostępniają wallabag w katalogu głównym domeny lub subdomeny, czyli w konfiguracji wspieranej przez opiekunów projektu.
Instalacja tworzy konto administratora, którego nazwa użytkownika i hasło to wallabag, z adresem wallabag@wallabag.io. Proszę je zmienić przed otwarciem instancji dla publiczności. Tunel SSH przenosi port 8080 serwera na Państwa komputer, pod adres http://localhost:8080; proszę dodać -p i port SSH podany w Państwa strefie klienta.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag i wallabag.| Zmienna | Wartość domyślna | Do czego służy |
|---|---|---|
SYMFONY__ENV__SECRET | Publiczny ciąg, taki sam dla każdej instancji | Dodaje entropii operacjom bezpieczeństwa: dokumentacja wymaga, by był unikalny dla Państwa instancji |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Pełny adres Państwa instancji, bez końcowego ukośnika |
SYMFONY__ENV__FOSUSER_REGISTRATION | false w obrazie Docker | Otwiera lub zamyka publiczną rejestrację |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Wysyła e-mail z potwierdzeniem przy każdej rejestracji |
SYMFONY__ENV__LOCALE | en | Domyślny język instancji, na przykład fr |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Nazwa instancji wyświetlana w Państwa aplikacji dwuskładnikowej |
Publiczna rejestracja jest więc w obrazie Docker zamknięta. Aby otworzyć instancję dla swojego zespołu, mogą Państwo sami utworzyć konta w „Users management” albo otworzyć rejestrację na czas zapisów, z potwierdzeniem e-mailem.
Bardziej wrażliwe ustawienia znajdują się w „Internal Settings”, zastrzeżonych dla administratora instancji: publiczne udostępnianie artykułów, formaty eksportu, logowanie do serwisów z płatnym dostępem, lokalne pobieranie obrazów i importy w tle.
Kontener udostępnia wallabag przez HTTP, na swoim porcie 80, za pośrednictwem wewnętrznego Nginx. HTTPS obsługuje odwrotne proxy umieszczone przed nim. Wewnętrzny Nginx odczytuje nagłówek X-Forwarded-Proto: gdy ma on wartość https, informuje PHP, że żądanie jest szyfrowane, a wallabag odpowiednio buduje swoje linki i ciasteczka.
X-Forwarded-Proto: proxy musi go wysyłać z wartością https.Host: Państwa nazwa domeny, aby przekierowania aplikacji na nią wskazywały.Caddy sam uzyskuje certyfikat Let’s Encrypt i go odnawia. Jego dyrektywa reverse_proxy domyślnie zachowuje nagłówek Host i dodaje X-Forwarded-For, X-Forwarded-Proto i X-Forwarded-Host:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
Ten blok korzysta z nagłówków z przykładu Nginx w README obrazu Docker, dodaje nagłówek Host i limit przesyłania obrazu oraz nasłuchuje na porcie 80, aby Certbot mógł zainstalować 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
Następnie proszę sprawdzić, czy SYMFONY__ENV__DOMAIN_NAME zawiera adres https://, ten sam co w Państwa proxy.
wallabag działa w przeglądarce, a projekt publikuje też aplikacje i rozszerzenie, które łączą się z Państwa instancją przez jej adres, bez końcowego ukośnika.
| Narzędzie | Do czego służy | Czego potrzebuje |
|---|---|---|
| Aplikacja na Androida | Synchronizuje Państwa listy artykułów i wyświetla je na telefonie | Adres instancji, nazwę użytkownika i hasło; aplikacja sama pobiera swoje dane dostępowe do kanałów |
| Aplikacja na iOS | Wyświetla Państwa artykuły na iPhonie i iPadzie | Adres, identyfikator i sekret klienta API, nazwę użytkownika i hasło |
| Rozszerzenie wallabagger, dla Firefoksa i Chrome | Zapisuje otwartą stronę, z tagami, oznaczoną gwiazdką lub zarchiwizowaną | Adres, identyfikator i sekret klienta API, nazwę użytkownika i hasło |
| Bookmarklet „bag it!” | Zapisuje otwartą stronę z paska zakładek | Nic: przeciąga się go ze strony „Howto” |
Menu „Import” przenosi Państwa artykuły z innego serwisu. wallabag ponownie pobiera treść każdego artykułu, co przy dużym eksporcie zajmuje czas. Importery w wersji 2.6.17:
| Serwis | Plik do przekazania |
|---|---|
| Pocket, eksport CSV | Archiwum ZIP z eksportu Pocket, po rozpakowaniu: plik CSV o nazwie w rodzaju part_000000.csv |
| Pocket, eksport HTML | Plik HTML ze starszego eksportu Pocket, w rodzaju ril_export.html |
| Instapaper | Plik CSV ze strony ustawień Instapaper |
| Omnivore | Pliki metadata_x_to_y.json z rozpakowanego eksportu, po jednym naraz |
| Pinboard, Delicious | Ich eksport JSON |
| Shaarli | Jego eksport HTML |
| Firefox, Chrome | Kopia zakładek Firefoksa w formacie JSON albo plik Bookmarks Chrome |
| Readability, elCurator | Ich eksport |
| wallabag 1.x lub 2.x | Eksport JSON z innej instancji |
Wersja 2.6.17 przynosi też poprawkę importu CSV z Pocket. Istnieje również import przez API Pocket, z kluczem deweloperskim, który administrator ustawia w konfiguracji.
Aby duży import nie blokował strony, wallabag przekazuje go do Redis, którego compose.yaml powyżej już dostarcza:
1.pocket_csv; przetwarza on kolejkę, a potem dalej nasłuchuje, dopóki go Państwo nie zatrzymają.docker compose run --rm wallabag import pocket_csv
Pozostałe typy to pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox i chrome.
wallabag wysyła e-maile z potwierdzeniem rejestracji, z resetowaniem hasła oraz z kodami dwuskładnikowymi przesyłanymi e-mailem. Wysyła je przez serwer opisany w SYMFONY__ENV__MAILER_DSN, domyślnie smtp://127.0.0.1.
Na VPS Simafri proszę skonfigurować uwierzytelniany serwer SMTP, na porcie 587 lub 465: usługę poczty Państwa domeny albo usługę wysyłkową. Dokumentacja podaje format w jednym wierszu, z użytkownikiem, hasłem, serwerem i 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
@ staje się %40. Jeśli zakodowany znak blokuje uruchomienie, dokumentacja sugeruje podwojenie znaku procentu: %%40.FROM_EMAIL to nadawca wszystkich e-maili wallabag, TWOFACTOR_SENDER nadawca kodów dwuskładnikowych. Proszę użyć adresu w swojej domenie, z którego Państwa serwer SMTP pozwala wysyłać.:465 na końcu wiersza.Następnie proszę odtworzyć kontener poleceniem docker compose up -d i przetestować wysyłkę linkiem „Forgot your password?” na stronie logowania.
Strona dokumentacji o kopiach zapasowych wymienia trzy elementy: ustawienia, bazę danych i obrazy. Przy obrazie Docker każdy z nich znajduje się tutaj:
| Element | Gdzie się znajduje | Jak go skopiować |
|---|---|---|
| Ustawienia | Państwa compose.yaml: obraz buduje z niego parameters.yml przy każdym starcie | Kopia pliku, przechowywana w bezpiecznym miejscu, ponieważ zawiera Państwa sekrety |
| Baza danych | Wolumen wallabag-db | Eksport przez mariadb-dump |
| Obrazy | Wolumen wallabag-images, zamontowany w web/assets/images | Archiwum katalogu |
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
Proszę zaplanować te kopie i wysyłać je poza serwer. Umieszczone na jego dysku, archiwa te trafiają także do jego nocnych kopii zapasowych. Przy SQLite dokumentacja prosi o skopiowanie katalogu data/db.
Na nowej instalacji proszę uruchomić stos z tym samym compose.yaml, a następnie wczytać z powrotem bazę danych i obrazy:
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żdy użytkownik może też wyeksportować swoje artykuły do JSON z listy „All entries” i zaimportować je ponownie do innej instancji importerem wallabag 2.x. Dla administratorów polecenie wallabag:export eksportuje artykuły użytkownika do pliku.
Przy Dockerze proszę zmienić tag obrazu w compose.yaml, wykonać kopię zapasową, a następnie pobrać nowy obraz i odtworzyć kontener. README prosi potem o uruchomienie migracji bazy danych, gdy wydanie je przynosi:
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 informacje o wydaniu proszą o opróżnienie starego katalogu web/uploads/import. W tym compose.yaml katalog ten znajduje się wewnątrz kontenera: kontener utworzony z nowego obrazu startuje bez niego.make update, które na instancjach w wersji 2.6.15 lub starszej wybierało wydanie alfa opublikowane tego ranka. Dla zablokowanej instalacji z Git informacje o wydaniu podają naprawę: git checkout 2.6.17 --force, a następnie make update.make update, które uruchamia też migracje i czyści pamięć podręczną.Przed aktualizacją proszę przeczytać informacje o każdym wydaniu: wskazują one kroki właściwe dla danej wersji, takie jak katalog do opróżnienia w 2.6.16.
Samodzielny hosting wymaga prowadzenia serwera, oprócz samej aplikacji. Na Managed VPS nasze zespoły przejmują serwer i proaktywnie czuwają nad Państwa instancją; wallabag pozostaje Państwa oprogramowaniem, z jego ustawieniami i Państwa artykułami.
| Temat | Nasze zespoły | Państwo |
|---|---|---|
| Serwer | Aktualizacje systemu i zabezpieczeń, w tym interwencje na serwerze | Moment dogodny dla Państwa działalności |
| Nadzór | Serwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefon | Czytanie dzienników Państwa instancji |
| wallabag | Proaktywna opieka: wychwytujemy błędy, spowolnienia, stan bazy danych i brak miejsca na dysku oraz polecamy poprawkę | Instalacja, aktualizacje i ustawienia, które wdrażają Państwo sami albo Państwa asystent AI |
| Konta i artykuły | Serwer, który je utrzymuje, nadzorowany i objęty kopiami zapasowymi | Użytkownicy, rejestracja, klienty API i importy |
| Kopie zapasowe | Co noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenie | Eksporty właściwe dla wallabag oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne |
| Migracja | Migracja Państwa obecnego serwera, bezpłatna | Moment przełączenia |
Jeśli wolą Państwo, aby nasze zespoły interweniowały w samej aplikacji, usługa ta jest rozliczana godzinowo lub ryczałtowo, z wyceną przekazaną przed interwencją.
Z Managed VPS od Simafri nasze zespoły utrzymują serwer Państwa instancji wallabag w aktualności, nadzorują go dniem i nocą i interweniują bez czekania na Państwa telefon; proaktywnie czuwają także nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami albo Państwa asystent AI. Kopie zapasowe są szyfrowane co noc i przechowywane poza maszyną, ich przywracanie jest w cenie, a migracja obecnego serwera jest bezpłatna.
Tak. wallabag jest udostępniany na licencji MIT: mogą Państwo używać go, modyfikować i rozpowszechniać, w pracy czy gdziekolwiek indziej, bez zakupu licencji, pod warunkiem zachowania informacji o prawach autorskich. Pozostaje koszt serwera, na którym działa.
Proszę wyjść od przykładowego compose.yaml obrazu wallabag/wallabag, z MariaDB i Redis. Proszę ustawić SYMFONY__ENV__SECRET, hasła i swój adres w SYMFONY__ENV__DOMAIN_NAME, opublikować port na 127.0.0.1, a następnie uruchomić docker compose up -d i postawić przed nim odwrotne proxy z HTTPS.
Instalacja tworzy administratora, którego nazwa użytkownika i hasło to wallabag. Proszę zmienić hasło w Config, zakładka Password, a adres e-mail w User information, przed otwarciem instancji dla publiczności.
Proszę rozpakować archiwum ZIP z eksportu Pocket: zawiera ono plik CSV, na przykład part_000000.csv. W menu Import proszę wybrać Pocket CSV i przesłać ten plik. wallabag pobiera wtedy treść każdego artykułu; przy dużym eksporcie proszę włączyć Redis w ustawieniach wewnętrznych.
Projekt publikuje aplikacje na Androida i iOS oraz rozszerzenie wallabagger dla Firefoksa i Chrome, które łączą się z Państwa instancją przez jej adres, bez końcowego ukośnika. iOS i wallabagger potrzebują klienta API, tworzonego w API clients management.
Obraz odczytuje nagłówek X-Forwarded-Proto, aby wiedzieć, że żądanie przychodzi przez HTTPS. Proszę sprawić, by proxy wysyłało go z wartością https, razem z nagłówkiem Host Państwa domeny, i wpisać adres https:// w SYMFONY__ENV__DOMAIN_NAME.
Proszę kopiować trzy elementy: bazę danych, przez mariadb-dump dla MariaDB, wolumen z obrazami zamontowany w web/assets/images oraz swój compose.yaml, który zawiera ustawienia i sekrety. Proszę wysyłać te kopie poza serwer.
Managed VPS obejmuje serwer: system, bezpieczeństwo, nadzór i kopie zapasowe. Nasze zespoły proaktywnie czuwają też nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami. Interwencja w aplikacji jest rozliczana godzinowo lub ryczałtowo.
Simafri
Porozmawiajmy o Państwa projekcie
Proszę powiedzieć nam w kilku słowach, czego Państwo potrzebują: odpowiemy szybko.
Dziękujemy! Państwa zapytanie zostało wysłane. Wkrótce się odezwiemy.
Wolą Państwo e-mail? Proszę napisać do nas na support@simafri.com.