Hosting wallabag na Managed VPS: artykuły na później na Państwa serwerze

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.

Simon Vasconcelos Lee Autor: Opublikowano 18 listopada 2026Czas czytania: 15 minut

Wszystkie poradniki

W skrócie

  1. Licencja MIT pozwala swobodnie używać, modyfikować i rozpowszechniać wallabag, w pracy czy gdziekolwiek indziej, pod warunkiem zachowania informacji o prawach autorskich.
  2. Proszę zainstalować go przez Docker Compose: oficjalny obraz wallabag/wallabag, MariaDB, Redis i port webowy opublikowany na 127.0.0.1 za odwrotnym proxy z HTTPS.
  3. Przed pierwszym uruchomieniem proszę ustawić 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.
  4. Odwrotne proxy wysyła X-Forwarded-Proto: https: w ten sposób wallabag wie, że odwiedzający łączą się przez HTTPS.
  5. Proszę kopiować bazę danych, wolumen z obrazami i swój compose.yaml, a aktualizować przez zmianę tagu obrazu i uruchomienie migracji.

Co robi wallabag

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.

Na co pozwala licencja MIT

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.

Zasoby do zaplanowania

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:

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.

Instalacja przez Docker Compose

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:

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:

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:

Terminal
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag

Aby sprawdzić, czy aplikacja odpowiada, proszę odpytać ścieżkę, z której korzysta kontrola stanu obrazu:

Terminal
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.

Z SQLite lub PostgreSQL

Bez Dockera

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:

Terminal
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.

Pierwsze konto, sekrety i rejestracja

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.

Terminal, na Państwa komputerze
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Proszę zalogować się danymi wallabag i wallabag.
  2. W „Config”, zakładka „Password”, proszę wybrać nowe hasło o długości co najmniej 8 znaków.
  3. W zakładce „User information” proszę zastąpić adres e-mail swoim: to on otrzymuje linki do resetowania hasła.
  4. W tej samej zakładce proszę włączyć uwierzytelnianie dwuskładnikowe. Dokumentacja zaleca aplikację z kodami jednorazowymi, taką jak FreeOTP, zamiast kodu wysyłanego e-mailem; wallabag oferuje też kody zapasowe.
ZmiennaWartość domyślnaDo czego służy
SYMFONY__ENV__SECRETPubliczny ciąg, taki sam dla każdej instancjiDodaje entropii operacjom bezpieczeństwa: dokumentacja wymaga, by był unikalny dla Państwa instancji
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgPełny adres Państwa instancji, bez końcowego ukośnika
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse w obrazie DockerOtwiera lub zamyka publiczną rejestrację
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueWysyła e-mail z potwierdzeniem przy każdej rejestracji
SYMFONY__ENV__LOCALEenDomyślny język instancji, na przykład fr
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceNazwa 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.

HTTPS: odwrotne proxy

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.

Z Caddy

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:

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

Z Nginx

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:

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;
    }
}
Terminal
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.

Aplikacje, rozszerzenia przeglądarki i kanały RSS

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ędzieDo czego służyCzego potrzebuje
Aplikacja na AndroidaSynchronizuje Państwa listy artykułów i wyświetla je na telefonieAdres instancji, nazwę użytkownika i hasło; aplikacja sama pobiera swoje dane dostępowe do kanałów
Aplikacja na iOSWyświetla Państwa artykuły na iPhonie i iPadzieAdres, identyfikator i sekret klienta API, nazwę użytkownika i hasło
Rozszerzenie wallabagger, dla Firefoksa i ChromeZapisuje 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ładekNic: przeciąga się go ze strony „Howto”

Import artykułów z Pocket i innych serwisów

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:

SerwisPlik do przekazania
Pocket, eksport CSVArchiwum ZIP z eksportu Pocket, po rozpakowaniu: plik CSV o nazwie w rodzaju part_000000.csv
Pocket, eksport HTMLPlik HTML ze starszego eksportu Pocket, w rodzaju ril_export.html
InstapaperPlik CSV ze strony ustawień Instapaper
OmnivorePliki metadata_x_to_y.json z rozpakowanego eksportu, po jednym naraz
Pinboard, DeliciousIch eksport JSON
ShaarliJego eksport HTML
Firefox, ChromeKopia zakładek Firefoksa w formacie JSON albo plik Bookmarks Chrome
Readability, elCuratorIch eksport
wallabag 1.x lub 2.xEksport 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.

Duże importy w tle

Aby duży import nie blokował strony, wallabag przekazuje go do Redis, którego compose.yaml powyżej już dostarcza:

  1. W „Internal Settings”, sekcja „Import”, proszę włączyć Redis wartością 1.
  2. Proszę uruchomić import z menu „Import”: wallabag umieszcza artykuły w kolejce.
  3. Proszę uruchomić proces roboczy dla wybranego typu importu, na przykład pocket_csv; przetwarza on kolejkę, a potem dalej nasłuchuje, dopóki go Państwo nie zatrzymają.
Terminal, w katalogu z compose.yaml
docker compose run --rm wallabag import pocket_csv

Pozostałe typy to pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox i chrome.

E-mail: konfiguracja SMTP

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:

compose.yaml, usługa 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

Następnie proszę odtworzyć kontener poleceniem docker compose up -d i przetestować wysyłkę linkiem „Forgot your password?” na stronie logowania.

Kopie zapasowe

Strona dokumentacji o kopiach zapasowych wymienia trzy elementy: ustawienia, bazę danych i obrazy. Przy obrazie Docker każdy z nich znajduje się tutaj:

ElementGdzie się znajdujeJak go skopiować
UstawieniaPaństwa compose.yaml: obraz buduje z niego parameters.yml przy każdym starcieKopia pliku, przechowywana w bezpiecznym miejscu, ponieważ zawiera Państwa sekrety
Baza danychWolumen wallabag-dbEksport przez mariadb-dump
ObrazyWolumen wallabag-images, zamontowany w web/assets/imagesArchiwum katalogu
Terminal, w katalogu z 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

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.

Przywracanie

Na nowej instalacji proszę uruchomić stos z tym samym compose.yaml, a następnie wczytać z powrotem bazę danych i obrazy:

Terminal
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.

Aktualizacje

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:

Terminal, w katalogu z 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

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.

Kto za co odpowiada na Managed VPS

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.

TematNasze zespołyPaństwo
SerwerAktualizacje systemu i zabezpieczeń, w tym interwencje na serwerzeMoment dogodny dla Państwa działalności
NadzórSerwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefonCzytanie dzienników Państwa instancji
wallabagProaktywna 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łySerwer, który je utrzymuje, nadzorowany i objęty kopiami zapasowymiUżytkownicy, rejestracja, klienty API i importy
Kopie zapasoweCo noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenieEksporty właściwe dla wallabag oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne
MigracjaMigracja Państwa obecnego serwera, bezpłatnaMoment 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ą.

wallabag na serwerze prowadzonym za Państwa

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.

Poznaj Managed VPS

Częste pytania

Czy wallabag jest bezpłatny?

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.

Jak zainstalować wallabag przez Docker Compose?

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.

Jakie są domyślne dane logowania wallabag?

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.

Jak zaimportować artykuły z Pocket do wallabag?

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.

Jakie aplikacje działają z wallabag?

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.

Dlaczego linki wallabag pozostają na http za proxy?

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.

Jak wykonać kopię zapasową wallabag?

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.

Czy Managed VPS obejmuje wallabag?

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.

Źródła i oficjalna dokumentacja

Powiązane poradniki

Hosting FreshRSS na Managed VPS: Państwa kanały RSS na Państwa serwerzeHosting FreshRSS na Managed VPS oznacza, że Państwo i Państwa zespół czytają swoje kanały RSS z maszyny, która należy do Państwa, a nasze zespoły dbają o jej aktualność i nadzorują ją dniem i nocą. FreshRSS to wolne oprogramowanie na licencji AGPL-3.0. Ten poradnik podąża za jego oficjalną dokumentacją: instalacja przez Docker Compose, HTTPS, odświeżanie kanałów, konta i logowanie, API dla aplikacji mobilnych, baza danych, kopie zapasowe i aktualizacje.Kopie zapasowe VPS: co sprawdzić przed podpisaniem umowyOferta VPS prawie zawsze zapowiada „kopie zapasowe w cenie”. Za tymi słowami może kryć się kopia wykonywana co noc, przechowywana poza maszyną i przywracana przez ekspertów, albo migawka zapisana na tym samym dysku co serwer. Ten poradnik podaje pytania, które robią różnicę, wyjaśnia, co oznacza każda odpowiedź, i pokazuje, jak sprawdzić, czy kopię da się przywrócić.Różnica między VPS zarządzanym a niezarządzanym: kto co robiRóżnica między VPS zarządzanym a niezarządzanym sprowadza się do jednego pytania: kto zajmuje się serwerem, gdy już działa. Samo słowo „zarządzany” nie ma przy tym oficjalnej definicji: u różnych firm hostingowych oznacza wszystko, od samej instalacji systemu po pełne prowadzenie serwera. Ten poradnik pokazuje, kto co robi, punkt po punkcie, łącznie z pośrednim poziomem, jakim jest wsparcie, i podaje pytania, które rozwiewają wątpliwości przed podpisaniem umowy.
Skontaktuj się z nami