Găzduirea wallabag pe un Managed VPS: lecturile amânate, pe propriul server

Găzduirea wallabag pe un Managed VPS înseamnă să păstrați articolele puse deoparte pentru mai târziu pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. wallabag este o aplicație liberă de citire ulterioară, sub licență MIT. Acest ghid urmează documentația sa oficială și imaginea sa Docker, la versiunea 2.6.17: instalarea cu Docker Compose, primul cont și secretele, HTTPS, aplicațiile și extensiile, importul din Pocket și din alte servicii, e-mailurile, backupurile și actualizările.

Simon Vasconcelos Lee Autor: Publicat la 18 noiembrie 2026Timp de citire: 14 minute

Toate ghidurile

Esențialul

  1. Licența MIT permite folosirea, modificarea și redistribuirea liberă a wallabag, în firmă ca oriunde altundeva, cu condiția să păstrați mențiunea sa de copyright.
  2. Instalați-l cu Docker Compose: imaginea oficială wallabag/wallabag, MariaDB, Redis și portul web publicat pe 127.0.0.1 în spatele unui proxy invers în HTTPS.
  3. Înainte de prima pornire, setați SYMFONY__ENV__SECRET și adresa dumneavoastră publică în SYMFONY__ENV__DOMAIN_NAME; apoi schimbați parola contului wallabag, care este wallabag.
  4. Proxy-ul invers trimite X-Forwarded-Proto: https: așa află wallabag că vizitatorii săi sosesc prin HTTPS.
  5. Salvați baza de date, volumul de imagini și fișierul compose.yaml, apoi actualizați schimbând eticheta imaginii și rulând migrările.

Ce face wallabag

wallabag este o aplicație web de citire ulterioară: salvați o pagină cu un clic și o citiți când aveți timp. README-ul său o rezumă astfel: un clic, o salvare, o citiți când doriți. wallabag extrage conținutul articolului, astfel încât ferestrele pop-up ale paginii originale să nu vă distragă.

Ce permite licența MIT

wallabag este publicat sub licența MIT, copyright Nicolas Lœuillet din 2013. Ea acordă, gratuit, dreptul de a folosi, copia, modifica, îmbina, publica, distribui, sublicenția și vinde copii ale software-ului. Îl puteți deci rula pentru dumneavoastră, pentru echipa dumneavoastră sau pentru clienții dumneavoastră, fără nicio licență de cumpărat.

Singura condiție este să păstrați mențiunea de copyright și textul licenței în toate copiile sau părțile substanțiale ale software-ului. Textul furnizează software-ul „ca atare” („as is”), fără garanție.

Resursele de prevăzut

Documentația wallabag nu dă cifre pentru memorie sau procesor. Ea enumeră însă de ce are nevoie aplicația, iar imaginea Docker fixează câteva valori care ajută la dimensionare:

Dimensiunea serverului depinde deci de numărul de utilizatori, de volumul de articole și de importurile dumneavoastră. Pe un Managed VPS, descrieți-ne utilizarea dumneavoastră și vă vom recomanda dimensiunea potrivită.

Instalarea cu Docker Compose

Depozitul wallabag/docker publică imaginea oficială wallabag/wallabag pe Docker Hub și pe GitHub Container Registry, cu un fișier Compose de exemplu: wallabag, o bază de date MariaDB și Redis. Pe un server unde Docker este instalat, creați un director și puneți în el acest compose.yaml, pornind de la acel exemplu:

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:

Înlocuiți cele trei valori secrete înainte de prima pornire. Șirurile hexazecimale funcționează peste tot, inclusiv în comenzile SQL pe care imaginea le scrie pentru a crea baza de date:

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

Pentru a verifica dacă aplicația răspunde, interogați ruta folosită de verificarea de sănătate a imaginii:

Terminal
curl http://127.0.0.1:8080/api/info

Imaginea recitește variabilele SYMFONY__ENV__* la fiecare pornire a containerului și golește memoria cache. După ce modificați compose.yaml, un docker compose up -d recreează containerul și aplică noile setări.

Cu SQLite sau PostgreSQL

Fără Docker

Calea pe care documentația o recomandă pe un server dedicat este depozitul Git și fișierul său Makefile, cu Composer, instrumentul make și extensiile PHP de pe pagina de cerințe:

Terminal
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install

Serverul web servește atunci directorul web, cu app.php ca punct de intrare: pagina despre gazdele virtuale oferă configurații pentru Nginx, Apache, Caddy și lighttpd. Exemplele sale servesc wallabag la rădăcina unui domeniu sau subdomeniu, configurația susținută de cei care întrețin proiectul.

Primul cont, secretele și înregistrările

Instalarea creează un cont de administrator al cărui nume de utilizator și a cărui parolă sunt amândouă wallabag, cu adresa wallabag@wallabag.io. Schimbați-le înainte de a deschide instanța publicului. Un tunel SSH aduce portul 8080 al serverului pe computerul dumneavoastră, la http://localhost:8080; adăugați -p și portul SSH indicat în spațiul dumneavoastră de client.

Terminal, pe computerul dumneavoastră
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Conectați-vă cu wallabag și wallabag.
  2. În „Config”, fila „Password”, alegeți o parolă nouă de cel puțin 8 caractere.
  3. În fila „User information”, înlocuiți adresa de e-mail cu a dumneavoastră: ea primește linkurile de resetare a parolei.
  4. În aceeași filă, activați autentificarea în doi pași. Documentația recomandă o aplicație de coduri de unică folosință, precum FreeOTP, în locul codului trimis prin e-mail; wallabag oferă și coduri de rezervă.
VariabilăValoare implicităCe face
SYMFONY__ENV__SECRETUn șir public, același pentru toate instanțeleAdaugă entropie operațiunilor de securitate: documentația îl vrea unic pentru instanța dumneavoastră
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgAdresa completă a instanței dumneavoastră, fără bară oblică la final
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse în imaginea DockerDeschide sau închide înregistrarea publică
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueTrimite un e-mail de confirmare pentru fiecare înregistrare
SYMFONY__ENV__LOCALEenLimba implicită a instanței, de exemplu ro
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceNumele instanței afișat în aplicația dumneavoastră de autentificare în doi pași

Cu imaginea Docker, înregistrarea publică este deci închisă. Pentru a deschide instanța echipei dumneavoastră, creați chiar dumneavoastră conturile din „Users management” sau deschideți înregistrarea cât timp se înscriu persoanele, cu confirmare prin e-mail.

Setările mai sensibile se află în „Internal Settings”, rezervate administratorului instanței: partajarea publică a articolelor, formatele de export, conectarea la site-urile cu plată, descărcarea locală a imaginilor și importurile în fundal.

HTTPS: proxy-ul invers

Containerul servește wallabag în HTTP, pe portul său 80, printr-un Nginx intern. HTTPS revine proxy-ului invers plasat în față. Acest Nginx intern citește antetul X-Forwarded-Proto: când valoarea lui este https, îi comunică lui PHP că cererea este criptată, iar wallabag își construiește în consecință linkurile și cookie-urile.

Cu Caddy

Caddy obține singur certificatul Let’s Encrypt și îl reînnoiește. Directiva sa reverse_proxy păstrează antetul Host și adaugă implicit X-Forwarded-For, X-Forwarded-Proto și X-Forwarded-Host:

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

Cu Nginx

Acest bloc preia antetele din exemplul Nginx al README-ului imaginii Docker, adaugă antetul Host și limita de încărcare a imaginii și ascultă pe portul 80, pentru a lăsa Certbot să instaleze HTTPS:

Bloc 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

Verificați apoi că SYMFONY__ENV__DOMAIN_NAME conține adresa în https://, aceeași ca a proxy-ului dumneavoastră.

Aplicațiile, extensiile și fluxurile RSS

wallabag funcționează în browser, iar proiectul publică și aplicații și o extensie, care se conectează la instanța dumneavoastră prin adresa ei, fără bară oblică la final.

InstrumentCe faceDe ce are nevoie
Aplicația AndroidSincronizează listele de articole și le afișează pe telefonAdresa instanței, numele dumneavoastră de utilizator și parola; aplicația își obține singură accesul la fluxuri
Aplicația iOSAfișează articolele pe iPhone și iPadAdresa, un ID și un secret de client API, numele dumneavoastră de utilizator și parola
Extensia wallabagger, pentru Firefox și ChromeSalvează pagina deschisă, cu etichetele ei, ca favorită sau arhivatăAdresa, un ID și un secret de client API, numele dumneavoastră de utilizator și parola
Bookmarkletul „bag it!”Salvează pagina deschisă din bara de marcajeNimic: îl trageți din pagina „Howto”

Importul articolelor din Pocket și din alte servicii

Meniul „Import” aduce articolele dumneavoastră dintr-un alt serviciu. wallabag descarcă din nou conținutul fiecărui articol, ceea ce durează în cazul unui export voluminos. Importatoarele din versiunea 2.6.17:

ServiciuFișierul de furnizat
Pocket, export CSVArhiva ZIP de export Pocket, odată dezarhivată: un fișier CSV cu un nume precum part_000000.csv
Pocket, export HTMLFișierul HTML al vechiului export Pocket, precum ril_export.html
InstapaperFișierul CSV din pagina de setări Instapaper
OmnivoreFișierele metadata_x_to_y.json din exportul dezarhivat, pe rând
Pinboard, DeliciousExportul lor JSON
ShaarliExportul său HTML
Firefox, ChromeBackupul JSON al marcajelor Firefox sau fișierul Bookmarks din Chrome
Readability, elCuratorExportul lor
wallabag 1.x sau 2.xExportul JSON al unei alte instanțe

Versiunea 2.6.17 aduce în plus o corectură a importului CSV din Pocket. Există și importul prin API-ul Pocket, cu o cheie de dezvoltator pe care administratorul o introduce în configurație.

Importurile mari în fundal

Pentru ca un import mare să nu blocheze pagina, wallabag îl încredințează lui Redis, pe care compose.yaml de mai sus îl prevede deja:

  1. În „Internal Settings”, secțiunea „Import”, activați Redis cu valoarea 1.
  2. Porniți importul din meniul „Import”: wallabag pune articolele într-o coadă.
  3. Porniți procesul de lucru pentru tipul de import ales, de exemplu pocket_csv; el parcurge coada, apoi rămâne în ascultare până când îl opriți.
Terminal, în directorul fișierului compose.yaml
docker compose run --rm wallabag import pocket_csv

Celelalte tipuri sunt pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox și chrome.

E-mailurile: configurația SMTP

wallabag trimite e-mailuri pentru confirmarea înregistrărilor, resetarea parolelor și codurile de autentificare în doi pași prin e-mail. Le trimite prin serverul descris de SYMFONY__ENV__MAILER_DSN, care implicit este smtp://127.0.0.1.

Pe un VPS Simafri, configurați un server SMTP autentificat, pe portul 587 sau 465: serviciul de e-mail al domeniului dumneavoastră sau un serviciu de trimitere. Documentația dă formatul pe o singură linie, cu utilizator, parolă, server și port:

compose.yaml, serviciul 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

Recreați apoi containerul cu docker compose up -d și testați cu linkul „Forgot your password?” din pagina de conectare.

Backupurile

Pagina despre backupuri din documentație numește trei elemente: setările, baza de date și imaginile. Cu imaginea Docker, iată unde se află fiecare:

ElementUnde se aflăCum îl copiați
SetărileFișierul dumneavoastră compose.yaml: imaginea generează din el parameters.yml la fiecare pornireO copie a fișierului, păstrată în siguranță, deoarece conține secretele dumneavoastră
Baza de dateVolumul wallabag-dbUn export cu mariadb-dump
ImaginileVolumul wallabag-images, montat pe web/assets/imagesO arhivă a directorului
Terminal, în directorul fișierului 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

Programați aceste copii și trimiteți-le în afara serverului. Păstrate pe discul său, aceste arhive intră și în backupurile sale de noapte. Cu SQLite, documentația cere să copiați directorul data/db.

Restaurarea

Pe o instalare nouă, porniți ansamblul cu același compose.yaml, apoi reîncărcați baza de date și imaginile:

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

Fiecare utilizator își poate exporta și el articolele în JSON, din lista „All entries”, și le poate importa din nou într-o altă instanță cu importatorul wallabag 2.x. Pentru administratori, comanda wallabag:export exportă într-un fișier articolele unui utilizator.

Actualizările

Cu Docker, schimbați eticheta imaginii în compose.yaml, faceți un backup, apoi descărcați noua imagine și recreați containerul. README-ul cere apoi să rulați migrările bazei de date atunci când o versiune aduce astfel de migrări:

Terminal, în directorul fișierului 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

Citiți notele fiecărei versiuni înainte de actualizare: ele semnalează pașii proprii acelei versiuni, precum directorul de golit în 2.6.16.

Cine ce face pe un Managed VPS

Găzduirea pe propriul server cere să țineți serverul pe lângă aplicație. Pe un Managed VPS, echipele noastre preiau serverul și vă urmăresc proactiv instanța; wallabag rămâne software-ul dumneavoastră, cu setările sale și articolele dumneavoastră.

SubiectEchipele noastreDumneavoastră
ServerulActualizări de sistem și de securitate, intervenții pe server incluseMomentul potrivit activității dumneavoastră
MonitorizareaServer urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelulCitirea jurnalelor instanței dumneavoastră
wallabagUrmărire proactivă: erori, încetiniri, baza de date și spațiu pe disc depistate, corectură recomandatăInstalarea, actualizările și setările sale, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI
Conturile și articoleleServerul care le poartă, supravegheat și salvatUtilizatorii, înregistrările, clienții API și importurile
BackupurileÎn fiecare noapte, criptate și păstrate în afara mașinii; restaurare inclusăExporturile proprii wallabag și cererea de restaurare, când aveți nevoie de ea
MigrareaServerul dumneavoastră actual migrat, gratuitMomentul trecerii

Dacă preferați ca echipele noastre să intervină în aplicația însăși, această prestație se facturează la oră sau la preț fix, cu o ofertă comunicată înainte de intervenție.

wallabag, pe un server întreținut pentru dumneavoastră

Cu un Managed VPS Simafri, echipele noastre țin la zi serverul instanței dumneavoastră wallabag, îl monitorizează zi și noapte și intervin fără a vă aștepta apelul; ele vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI. Backupurile sunt criptate în fiecare noapte și păstrate în afara mașinii, restaurarea lor este inclusă, iar migrarea serverului actual este gratuită.

Descoperiți gama Managed VPS

Întrebări frecvente

Este wallabag gratuit?

Da. wallabag este sub licență MIT: îl puteți folosi, modifica și redistribui, în firmă ca oriunde altundeva, fără nicio licență de cumpărat, cu condiția să păstrați mențiunea sa de copyright. Rămâne costul serverului pe care rulează.

Cum se instalează wallabag cu Docker Compose?

Porniți de la compose.yaml de exemplu al imaginii wallabag/wallabag, cu MariaDB și Redis. Setați SYMFONY__ENV__SECRET, parolele și adresa dumneavoastră în SYMFONY__ENV__DOMAIN_NAME, publicați portul pe 127.0.0.1, apoi rulați docker compose up -d și puneți în față un proxy invers în HTTPS.

Care sunt datele de acces implicite ale wallabag?

Instalarea creează un administrator al cărui nume de utilizator și a cărui parolă sunt amândouă wallabag. Schimbați parola în Config, fila Password, și adresa de e-mail în User information, înainte de a deschide instanța publicului.

Cum îmi import articolele din Pocket în wallabag?

Dezarhivați arhiva ZIP de export Pocket: ea conține un fișier CSV precum part_000000.csv. În meniul Import, alegeți Pocket CSV și încărcați acel fișier. wallabag descarcă apoi conținutul fiecărui articol; pentru un export voluminos, activați Redis în setările interne.

Ce aplicații funcționează cu wallabag?

Proiectul publică aplicații pentru Android și iOS și extensia wallabagger pentru Firefox și Chrome, care se conectează la instanța dumneavoastră prin adresa ei, fără bară oblică la final. iOS și wallabagger au nevoie de un client API, creat în API clients management.

De ce rămân linkurile wallabag în http în spatele unui proxy?

Imaginea citește antetul X-Forwarded-Proto pentru a ști că cererea vine prin HTTPS. Faceți ca proxy-ul să îl trimită cu valoarea https, împreună cu antetul Host al domeniului dumneavoastră, și puneți adresa în https:// în SYMFONY__ENV__DOMAIN_NAME.

Cum se face backupul pentru wallabag?

Copiați trei elemente: baza de date, cu mariadb-dump pentru MariaDB, volumul de imagini montat pe web/assets/images și fișierul compose.yaml, care conține setările și secretele. Trimiteți aceste copii în afara serverului.

Acoperă un Managed VPS și wallabag?

Un Managed VPS acoperă serverul: sistem, securitate, monitorizare și backupuri. Echipele noastre vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră. O intervenție în aplicație se facturează la oră sau la preț fix.

Surse și documentație oficială

Ghiduri conexe

Găzduirea FreshRSS pe un Managed VPS: fluxurile RSS pe propriul serverGăzduirea FreshRSS pe un Managed VPS înseamnă că dumneavoastră și echipa dumneavoastră citiți fluxurile RSS de pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. FreshRSS este un software liber sub licență AGPL-3.0. Acest ghid urmează documentația sa oficială: instalarea cu Docker Compose, HTTPS, actualizarea fluxurilor, conturile și conectarea, API-ul pentru aplicațiile mobile, baza de date, backupurile și actualizările.Backupurile unui VPS: ce trebuie să verificați înainte de a semnaO ofertă de VPS anunță aproape mereu „backupuri incluse”. În spatele acestor două cuvinte se poate afla o copie făcută în fiecare noapte, păstrată în afara mașinii și restaurată de experți, sau un snapshot pus pe același disc ca serverul. Acest ghid prezintă întrebările care fac diferența, ce înseamnă fiecare răspuns și modul de a verifica faptul că un backup se poate restaura.Diferența dintre VPS administrat și neadministrat: cine ce faceDiferența dintre un VPS administrat și unul neadministrat ține de o singură întrebare: cine se ocupă de server după ce acesta funcționează. Totuși, „administrat” (managed) nu are o definiție oficială: de la un furnizor la altul, cuvântul acoperă orice, de la simpla instalare a sistemului până la exploatarea completă a serverului. Acest ghid arată cine ce face, rând cu rând, inclusiv la nivelul intermediar al asistenței, și oferă întrebările care înlătură ambiguitatea înainte de semnare.
Contactați-ne