Gostovanje wallabag na Managed VPS: članki za pozneje na vašem strežniku

Gostovanje wallabag na Managed VPS pomeni, da članki, ki jih shranite za pozneje, ostanejo na lastnem stroju, ki ga naše ekipe posodabljajo in podnevi in ponoči spremljajo. wallabag je prosta, odprtokodna aplikacija za branje pozneje pod licenco MIT. Ta vodnik sledi njegovi uradni dokumentaciji in uradni sliki Docker v različici 2.6.17: namestitev z Docker Compose, prvi račun in skrivnosti, HTTPS, aplikacije in razširitve brskalnika, uvoz iz Pocketa in drugih storitev, e-pošta, varnostne kopije in posodobitve.

Simon Vasconcelos Lee Avtor: Objavljeno 18. novembra 2026Čas branja: 15 minut

Vsi vodniki

Na kratko

  1. Licenca MIT vam dovoljuje, da wallabag prosto uporabljate, spreminjate in razširjate, v službi ali kjer koli drugje, če ohranite njegovo obvestilo o avtorskih pravicah.
  2. Namestite ga z Docker Compose: uradna slika wallabag/wallabag, MariaDB, Redis in spletna vrata, objavljena na 127.0.0.1 za obratnim posredniškim strežnikom s HTTPS.
  3. Pred prvim zagonom nastavite SYMFONY__ENV__SECRET in svoj javni naslov v SYMFONY__ENV__DOMAIN_NAME; nato spremenite geslo računa wallabag, ki je wallabag.
  4. Obratni posredniški strežnik pošilja X-Forwarded-Proto: https: tako wallabag ve, da obiskovalci prihajajo prek HTTPS.
  5. Varnostno kopirajte zbirko podatkov, nosilec s slikami in svoj compose.yaml, posodabljajte pa tako, da spremenite oznako slike in zaženete migracije.

Kaj počne wallabag

wallabag je spletna aplikacija za branje pozneje: stran shranite z enim klikom in jo preberete, ko imate čas. Njegov README to povzame tako: kliknite, shranite, preberite, ko želite. wallabag iz članka izlušči vsebino, zato vas pojavna okna izvirne strani ne motijo.

Kaj dovoljuje licenca MIT

wallabag je objavljen pod licenco MIT, avtorske pravice od leta 2013 pripadajo Nicolasu Lœuilletu. Ta brezplačno podeljuje pravico do uporabe, kopiranja, spreminjanja, združevanja, objave, razširjanja, podlicenciranja in prodaje kopij programske opreme. Poganjate ga torej lahko zase, za svojo ekipo ali za svoje stranke, ne da bi morali kupiti licenco.

Edini pogoj je, da obvestilo o avtorskih pravicah in besedilo licence ohranite v vseh kopijah ali bistvenih delih programske opreme. Besedilo programsko opremo ponuja „takšno, kot je“, brez garancije.

Viri, ki jih je treba predvideti

Dokumentacija wallabag ne navaja številk za pomnilnik ali procesor. Navaja pa, kaj aplikacija potrebuje, slika Docker pa določa nekaj vrednosti, ki pomagajo pri dimenzioniranju:

Velikost strežnika je torej odvisna od števila uporabnikov, količine člankov in vaših uvozov. Na Managed VPS nam opišite svojo uporabo in priporočimo vam ustrezno velikost.

Namestitev z Docker Compose

Repozitorij wallabag/docker objavlja uradno sliko wallabag/wallabag na Docker Hub in v GitHub Container Registry, skupaj s primerom datoteke Compose: wallabag, zbirka podatkov MariaDB in Redis. Na strežniku z nameščenim Dockerjem ustvarite mapo in vanjo postavite ta compose.yaml, ki izhaja iz tega primera:

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:

Pred prvim zagonom zamenjajte tri skrivne vrednosti. Šestnajstiški nizi delujejo povsod, tudi v ukazih SQL, ki jih slika zapiše za ustvarjanje zbirke podatkov:

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

Da preverite, ali se aplikacija odziva, pokličite pot, ki jo uporablja preverjanje stanja slike:

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

Slika ob vsakem zagonu vsebnika znova prebere spremenljivke SYMFONY__ENV__* in izprazni predpomnilnik. Ko spremenite compose.yaml, ukaz docker compose up -d vsebnik znova ustvari in uveljavi nove nastavitve.

S SQLite ali PostgreSQL

Brez Dockerja

Pot, ki jo dokumentacija priporoča na namenskem strežniku, je repozitorij Git in njegov Makefile, s Composerjem, orodjem make in razširitvami PHP s strani z zahtevami:

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

Spletni strežnik nato streže mapo web, z app.php kot vstopno točko: stran o navideznih gostiteljih navaja nastavitve za Nginx, Apache, Caddy in lighttpd. Njeni primeri strežejo wallabag v korenu domene ali poddomene, kar je postavitev, ki jo vzdrževalci podpirajo.

Prvi račun, skrivnosti in registracije

Namestitev ustvari skrbniški račun, katerega uporabniško ime in geslo sta oba wallabag, z naslovom wallabag@wallabag.io. Spremenite ju, preden instanco odprete javnosti. Tunel SSH prenese vrata 8080 strežnika na vaš računalnik, na http://localhost:8080; dodajte -p in vrata SSH, prikazana v vašem uporabniškem območju.

Terminal, na vašem računalniku
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Prijavite se z wallabag in wallabag.
  2. V „Config“, zavihek „Password“, izberite novo geslo z vsaj 8 znaki.
  3. V zavihku „User information“ e-poštni naslov zamenjajte s svojim: nanj prihajajo povezave za ponastavitev gesla.
  4. V istem zavihku vklopite dvostopenjsko preverjanje pristnosti. Dokumentacija pred kodo, poslano po e-pošti, priporoča aplikacijo z enkratnimi kodami, kot je FreeOTP; wallabag ponuja tudi rezervne kode.
SpremenljivkaPrivzeta vrednostČemu služi
SYMFONY__ENV__SECRETJavni niz, enak za vse instanceVarnostnim operacijam doda entropijo: dokumentacija želi, da je edinstven za vašo instanco
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgPolni naslov vaše instance, brez končne poševnice
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse v sliki DockerOdpre ali zapre javno registracijo
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueOb vsaki registraciji pošlje potrditveno e-pošto
SYMFONY__ENV__LOCALEenPrivzeti jezik instance, na primer fr
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceIme instance, prikazano v vaši aplikaciji za dvostopenjsko preverjanje

Javna registracija je torej v sliki Docker zaprta. Da instanco odprete svoji ekipi, račune ustvarite sami v „Users management“ ali pa registracijo odprete za čas prijav, s potrditvijo po e-pošti.

Občutljivejše nastavitve so v „Internal Settings“, pridržanih skrbniku instance: javno deljenje člankov, oblike izvoza, prijava v spletišča s plačljivo vsebino, lokalni prenos slik in uvozi v ozadju.

HTTPS: obratni posredniški strežnik

Vsebnik wallabag streže prek HTTP, na svojih vratih 80, z notranjim Nginxom. Za HTTPS poskrbi obratni posredniški strežnik pred njim. Ta notranji Nginx bere glavo X-Forwarded-Proto: ko ima vrednost https, PHP sporoči, da je zahteva šifrirana, wallabag pa temu primerno sestavi svoje povezave in piškotke.

S Caddyjem

Caddy sam pridobi potrdilo Let’s Encrypt in ga podaljšuje. Njegova direktiva reverse_proxy privzeto ohrani glavo Host in doda X-Forwarded-For, X-Forwarded-Proto in X-Forwarded-Host:

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

Z Nginxom

Ta blok uporablja glave iz primera za Nginx v README slike Docker, doda glavo Host in omejitev nalaganja iz slike ter posluša na vratih 80, da lahko Certbot nastavi 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

Nato preverite, da SYMFONY__ENV__DOMAIN_NAME vsebuje naslov https://, enak kot pri vašem posredniškem strežniku.

Aplikacije, razširitve brskalnika in viri RSS

wallabag deluje v brskalniku, projekt pa objavlja tudi aplikacije in razširitev, ki se z vašo instanco povežejo prek njenega naslova, brez končne poševnice.

OrodjeČemu služiKaj potrebuje
Aplikacija za AndroidSinhronizira vaše sezname člankov in jih prikaže na telefonuNaslov instance, vaše uporabniško ime in geslo; poverilnice za vire si aplikacija pridobi sama
Aplikacija za iOSPrikaže vaše članke na iPhonu in iPaduNaslov, ID in skrivnost odjemalca API, vaše uporabniško ime in geslo
Razširitev wallabagger, za Firefox in ChromeShrani odprto stran, z oznakami, z zvezdico ali arhiviranoNaslov, ID in skrivnost odjemalca API, vaše uporabniško ime in geslo
Zaznamek „bag it!“Shrani odprto stran iz vrstice z zaznamkiNič: povlečete ga s strani „Howto“

Uvoz člankov iz Pocketa in drugod

Meni „Import“ prinese vaše članke iz druge storitve. wallabag znova prenese vsebino vsakega članka, kar pri velikem izvozu traja nekaj časa. Uvozniki v različici 2.6.17:

StoritevDatoteka, ki jo naložite
Pocket, izvoz CSVArhiv ZIP izvoza iz Pocketa, ko ga razširite: datoteka CSV z imenom, kot je part_000000.csv
Pocket, izvoz HTMLDatoteka HTML starejšega izvoza iz Pocketa, kot je ril_export.html
InstapaperDatoteka CSV s strani nastavitev storitve Instapaper
OmnivoreDatoteke metadata_x_to_y.json iz razširjenega izvoza, ena za drugo
Pinboard, DeliciousNjun izvoz JSON
ShaarliNjegov izvoz HTML
Firefox, ChromeVarnostna kopija zaznamkov Firefoxa v obliki JSON ali datoteka Bookmarks iz Chroma
Readability, elCuratorNjun izvoz
wallabag 1.x ali 2.xIzvoz JSON druge instance

Različica 2.6.17 prinaša tudi popravek uvoza CSV iz Pocketa. Obstaja tudi uvoz prek API Pocketa, z razvijalskim ključem, ki ga skrbnik nastavi v konfiguraciji.

Veliki uvozi v ozadju

Da velik uvoz ne zadržuje strani, ga wallabag preda Redisu, ki ga zgornji compose.yaml že vsebuje:

  1. V „Internal Settings“, razdelek „Import“, vklopite Redis z vrednostjo 1.
  2. Zaženite uvoz iz menija „Import“: wallabag članke postavi v čakalno vrsto.
  3. Zaženite delavca za izbrano vrsto uvoza, na primer pocket_csv; obdela čakalno vrsto in nato posluša naprej, dokler ga ne ustavite.
Terminal, v mapi datoteke compose.yaml
docker compose run --rm wallabag import pocket_csv

Druge vrste so pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox in chrome.

E-pošta: nastavitev SMTP

wallabag pošilja e-pošto za potrditev registracije, ponastavitev gesla in dvostopenjske kode po e-pošti. Pošilja jo prek strežnika, opisanega v SYMFONY__ENV__MAILER_DSN, ki je privzeto smtp://127.0.0.1.

Na VPS Simafri nastavite strežnik SMTP s preverjanjem pristnosti, na vratih 587 ali 465: poštno storitev vaše domene ali storitev za pošiljanje. Dokumentacija navaja obliko v eni vrstici, z uporabnikom, geslom, strežnikom in vrati:

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

Nato vsebnik znova ustvarite z docker compose up -d in preizkusite pošiljanje s povezavo „Forgot your password?“ na strani za prijavo.

Varnostne kopije

Stran dokumentacije o varnostnih kopijah navaja tri elemente: nastavitve, zbirko podatkov in slike. S sliko Docker je vsak od njih tukaj:

ElementKje jeKako ga kopirati
NastavitveVaš compose.yaml: slika iz njega ob vsakem zagonu sestavi parameters.ymlKopija datoteke, shranjena na varnem, saj vsebuje vaše skrivnosti
Zbirka podatkovNosilec wallabag-dbIzvoz z mariadb-dump
SlikeNosilec wallabag-images, priklopljen na web/assets/imagesArhiv mape
Terminal, v mapi datoteke 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

Te kopije načrtujte in jih pošiljajte zunaj strežnika. Postavljeni na njegov disk ti arhivi vstopijo tudi v njegove nočne varnostne kopije. Pri SQLite dokumentacija prosi, da kopirate mapo data/db.

Obnova

Na novi namestitvi zaženite sklad z istim compose.yaml, nato znova naložite zbirko podatkov in slike:

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

Vsak uporabnik lahko svoje članke tudi izvozi v JSON s seznama „All entries“ in jih z uvoznikom wallabag 2.x znova uvozi v drugo instanco. Za skrbnike ukaz wallabag:export izvozi članke uporabnika v datoteko.

Posodobitve

Z Dockerjem spremenite oznako slike v compose.yaml, naredite varnostno kopijo, nato prenesite novo sliko in vsebnik znova ustvarite. README nato prosi, da zaženete migracije zbirke podatkov, kadar jih izdaja prinaša:

Terminal, v mapi datoteke 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

Pred posodobitvijo preberite opombe ob izdaji vsake različice: opozarjajo na korake, značilne za to različico, kot je mapa, ki jo je treba izprazniti v 2.6.16.

Kdo kaj dela na Managed VPS

Samostojno gostovanje poleg aplikacije zahteva tudi vzdrževanje strežnika. Na Managed VPS naše ekipe prevzamejo strežnik in proaktivno spremljajo vašo instanco; wallabag ostaja vaša programska oprema, z njegovimi nastavitvami in vašimi članki.

TemaNaše ekipeVi
StrežnikPosodobitve sistema in varnosti, vključno s posegi na strežnikuTrenutek, ki ustreza vaši dejavnosti
NadzorStrežnik pod nadzorom 24 ur na dan, 7 dni v tednu, s posegom brez čakanja na vaš klicBranje dnevnikov vaše instance
wallabagProaktivno spremljanje: napake, upočasnitve, zbirka podatkov in prostor na disku, s priporočenim popravkomNamestitev, posodobitve in nastavitve, ki jih uvedete vi ali vaš AI pomočnik
Računi in člankiStrežnik, ki jih nosi, pod nadzorom in varnostno kopiranUporabniki, registracije, odjemalci API in uvozi
Varnostne kopijeVsako noč, šifrirane in shranjene zunaj stroja; obnova je vključenaIzvozi, značilni za wallabag, in zahteva za obnovo, ko jo potrebujete
SelitevSelitev vašega sedanjega strežnika, brezplačnoTrenutek preklopa

Če želite, da naše ekipe posežejo v samo aplikacijo, se ta storitev zaračuna po urah ali pavšalno, z oceno stroškov, sporočeno pred posegom.

wallabag na strežniku, ki ga vzdržujemo za vas

Z Managed VPS Simafri naše ekipe strežnik vaše instance wallabag sproti posodabljajo, ga podnevi in ponoči nadzirajo ter posežejo brez čakanja na vaš klic; vašo instanco tudi proaktivno spremljajo in vam priporočajo koristne popravke, ki jih uvedete vi ali vaš AI pomočnik. Varnostne kopije so vsako noč šifrirane in shranjene zunaj stroja, njihova obnova je vključena, selitev vašega sedanjega strežnika pa je brezplačna.

Odkrijte Managed VPS

Pogosta vprašanja

Ali je wallabag brezplačen?

Da. wallabag je pod licenco MIT: lahko ga uporabljate, spreminjate in razširjate, v službi ali kjer koli drugje, ne da bi kupili licenco, če ohranite njegovo obvestilo o avtorskih pravicah. Ostane strošek strežnika, na katerem teče.

Kako namestim wallabag z Docker Compose?

Izhajajte iz primera compose.yaml slike wallabag/wallabag, z MariaDB in Redisom. Nastavite SYMFONY__ENV__SECRET, gesla in svoj naslov v SYMFONY__ENV__DOMAIN_NAME, vrata objavite na 127.0.0.1, nato zaženite docker compose up -d in predenj postavite obratni posredniški strežnik s HTTPS.

Katere so privzete poverilnice za wallabag?

Namestitev ustvari skrbnika, katerega uporabniško ime in geslo sta oba wallabag. Geslo spremenite v Config, zavihek Password, e-poštni naslov pa v User information, preden instanco odprete javnosti.

Kako uvozim svoje članke iz Pocketa v wallabag?

Razširite arhiv ZIP izvoza iz Pocketa: vsebuje datoteko CSV, kot je part_000000.csv. V meniju Import izberite Pocket CSV in naložite to datoteko. wallabag nato prenese vsebino vsakega članka; pri velikem izvozu vklopite Redis v notranjih nastavitvah.

Katere aplikacije delujejo z wallabag?

Projekt objavlja aplikaciji za Android in iOS ter razširitev wallabagger za Firefox in Chrome, ki se z vašo instanco povežejo prek njenega naslova, brez končne poševnice. iOS in wallabagger potrebujeta odjemalca API, ustvarjenega v API clients management.

Zakaj povezave wallabag za posredniškim strežnikom ostanejo na http?

Slika bere glavo X-Forwarded-Proto, da ve, da zahteva prihaja prek HTTPS. Poskrbite, da jo vaš posredniški strežnik pošilja z vrednostjo https, skupaj z glavo Host vaše domene, in v SYMFONY__ENV__DOMAIN_NAME vpišite naslov https://.

Kako varnostno kopiram wallabag?

Kopirajte tri elemente: zbirko podatkov, z mariadb-dump pri MariaDB, nosilec s slikami, priklopljen na web/assets/images, in svoj compose.yaml, ki vsebuje nastavitve in skrivnosti. Te kopije pošiljajte zunaj strežnika.

Ali Managed VPS pokriva wallabag?

Managed VPS pokriva strežnik: sistem, varnost, nadzor in varnostne kopije. Naše ekipe tudi proaktivno spremljajo vašo instanco in vam priporočajo koristne popravke, ki jih uvedete vi. Poseg v aplikacijo se zaračuna po urah ali pavšalno.

Viri in uradna dokumentacija

Stopite v stik z nami