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.
Autor: Simon Vasconcelos Lee
Publicat la 18 noiembrie 2026Timp de citire: 14 minute
wallabag/wallabag, MariaDB, Redis și portul web publicat pe 127.0.0.1 în spatele unui proxy invers în HTTPS.SYMFONY__ENV__SECRET și adresa dumneavoastră publică în SYMFONY__ENV__DOMAIN_NAME; apoi schimbați parola contului wallabag, care este wallabag.X-Forwarded-Proto: https: așa află wallabag că vizitatorii săi sosesc prin HTTPS.compose.yaml, apoi actualizați schimbând eticheta imaginii și rulând migrările.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ă.
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.
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:
memory_limit la 256 MB începând cu versiunea sa 2.6.16, iar variabila PHP_MEMORY_LIMIT o modifică.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ă.
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:
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:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: exemplul din depozit publică portul 80 al containerului fără adresă, iar Docker îl deschide atunci pe toate adresele serverului. Publicat local, el este accesibil doar prin proxy-ul invers.MYSQL_ROOT_PASSWORD, imaginea creează baza de date și utilizatorul ei, apoi rulează wallabag:install, care creează tabelele și contul wallabag. Linia wallabag is ready! din jurnal marchează finalul.wallabag; serviciul db o păstrează.wallabag-db păstrează baza de date, wallabag-images imaginile articolelor. Și exemplul din documentația de instalare folosește volume cu nume.redis.2.6.17, 2.6, 2 și latest. O versiune completă vă lasă să alegeți momentul fiecărei actualizări.Pentru a verifica dacă aplicația răspunde, interogați ruta folosită de verificarea de sănătate a imaginii:
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.
/var/www/wallabag/data/db/wallabag.sqlite; montați în acest caz un volum pe /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, portul 5432, și POSTGRES_USER și POSTGRES_PASSWORD pentru ca imaginea să creeze baza de date. Versiunea 2.6.15 a imaginii corectează proprietarul bazei de date cu PostgreSQL 15 și versiunile ulterioare.POPULATE_DATABASE=False, apoi inițializați-o o singură dată cu docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. README-ul cere să rulați această comandă ca nobody, pentru ca niciun fișier să nu ajungă în proprietatea lui root.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:
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.
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.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag și wallabag.| Variabilă | Valoare implicită | Ce face |
|---|---|---|
SYMFONY__ENV__SECRET | Un șir public, același pentru toate instanțele | Adaugă entropie operațiunilor de securitate: documentația îl vrea unic pentru instanța dumneavoastră |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Adresa completă a instanței dumneavoastră, fără bară oblică la final |
SYMFONY__ENV__FOSUSER_REGISTRATION | false în imaginea Docker | Deschide sau închide înregistrarea publică |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Trimite un e-mail de confirmare pentru fiecare înregistrare |
SYMFONY__ENV__LOCALE | en | Limba implicită a instanței, de exemplu ro |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Numele 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.
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.
X-Forwarded-Proto: proxy-ul trebuie să îl trimită cu valoarea https.Host: numele dumneavoastră de domeniu, pentru ca redirecționările aplicației să trimită către el.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:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
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:
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
Verificați apoi că SYMFONY__ENV__DOMAIN_NAME conține adresa în https://, aceeași ca a proxy-ului dumneavoastră.
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.
| Instrument | Ce face | De ce are nevoie |
|---|---|---|
| Aplicația Android | Sincronizează listele de articole și le afișează pe telefon | Adresa instanței, numele dumneavoastră de utilizator și parola; aplicația își obține singură accesul la fluxuri |
| Aplicația iOS | Afișează articolele pe iPhone și iPad | Adresa, un ID și un secret de client API, numele dumneavoastră de utilizator și parola |
| Extensia wallabagger, pentru Firefox și Chrome | Salvează 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 marcaje | Nimic: îl trageți din pagina „Howto” |
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:
| Serviciu | Fișierul de furnizat |
|---|---|
| Pocket, export CSV | Arhiva ZIP de export Pocket, odată dezarhivată: un fișier CSV cu un nume precum part_000000.csv |
| Pocket, export HTML | Fișierul HTML al vechiului export Pocket, precum ril_export.html |
| Instapaper | Fișierul CSV din pagina de setări Instapaper |
| Omnivore | Fișierele metadata_x_to_y.json din exportul dezarhivat, pe rând |
| Pinboard, Delicious | Exportul lor JSON |
| Shaarli | Exportul său HTML |
| Firefox, Chrome | Backupul JSON al marcajelor Firefox sau fișierul Bookmarks din Chrome |
| Readability, elCurator | Exportul lor |
| wallabag 1.x sau 2.x | Exportul 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.
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.pocket_csv; el parcurge coada, apoi rămâne în ascultare până când îl opriți.docker compose run --rm wallabag import pocket_csv
Celelalte tipuri sunt pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox și chrome.
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:
- 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
@ devine %40. Dacă un caracter codificat împiedică pornirea, documentația sugerează dublarea semnului procent: %%40.FROM_EMAIL este expeditorul tuturor e-mailurilor wallabag, TWOFACTOR_SENDER cel al codurilor de autentificare în doi pași. Folosiți o adresă de pe domeniul dumneavoastră de pe care serverul SMTP acceptă să trimită.:465 la sfârșitul liniei.Recreați apoi containerul cu docker compose up -d și testați cu linkul „Forgot your password?” din pagina de conectare.
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:
| Element | Unde se află | Cum îl copiați |
|---|---|---|
| Setările | Fișierul dumneavoastră compose.yaml: imaginea generează din el parameters.yml la fiecare pornire | O copie a fișierului, păstrată în siguranță, deoarece conține secretele dumneavoastră |
| Baza de date | Volumul wallabag-db | Un export cu mariadb-dump |
| Imaginile | Volumul wallabag-images, montat pe web/assets/images | O arhivă a directorului |
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.
Pe o instalare nouă, porniți ansamblul cu același compose.yaml, apoi reîncărcați baza de date și imaginile:
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.
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:
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, iar notele sale de versiune cer golirea vechiului director web/uploads/import. În acest compose.yaml, acel director se află în interiorul containerului: cel creat din noua imagine pornește fără el.make update, care, pe instanțele cu 2.6.15 sau o versiune mai veche, alegea o versiune alfa publicată în acea dimineață. Pentru o instalare Git rămasă blocată, notele sale de versiune dau reparația: git checkout 2.6.17 --force, apoi make update.make update, care rulează și migrările și golește memoria cache.Citiți notele fiecărei versiuni înainte de actualizare: ele semnalează pașii proprii acelei versiuni, precum directorul de golit în 2.6.16.
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ă.
| Subiect | Echipele noastre | Dumneavoastră |
|---|---|---|
| Serverul | Actualizări de sistem și de securitate, intervenții pe server incluse | Momentul potrivit activității dumneavoastră |
| Monitorizarea | Server urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelul | Citirea jurnalelor instanței dumneavoastră |
| wallabag | Urmă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 articolele | Serverul care le poartă, supravegheat și salvat | Utilizatorii, î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 |
| Migrarea | Serverul dumneavoastră actual migrat, gratuit | Momentul 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.
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ă.
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ă.
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.
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.
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.
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.
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.
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.
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.
Simafri
Să discutăm despre site-ul dumneavoastră
Povestiți-ne despre proiectul dumneavoastră în câteva cuvinte: vă vom răspunde rapid.
Mulțumim! Cererea dumneavoastră a fost trimisă. Vă vom răspunde în curând.
Preferați e-mailul? Scrieți-ne la support@simafri.com.