wallabagi majutamine Managed VPS-is: teie lugemisnimekiri teie enda serveris

wallabagi majutamine Managed VPS-is tähendab, et hilisemaks lugemiseks kõrvale pandud artiklid jäävad masinasse, mis on teie enda ning mida meie meeskonnad hoiavad ajakohasena ja jälgivad päeval ja öösel. wallabag on MIT-litsentsiga vaba hilisema lugemise rakendus. See juhend järgib selle ametlikku dokumentatsiooni ja Dockeri tõmmist versioonis 2.6.17: paigaldus Docker Compose’iga, esimene konto ja saladused, HTTPS, rakendused ja brauserilaiendid, import Pocketist ja muudest teenustest, e-post, varukoopiad ja uuendused.

Simon Vasconcelos Lee Autor: Avaldatud 18. novembril 2026Lugemisaeg: 14 minutit

Kõik juhendid

Lühidalt

  1. MIT-litsents lubab wallabagi vabalt kasutada, muuta ja edasi levitada, ettevõttes ja mujal, tingimusel et säilitate selle autoriõiguse teate.
  2. Paigaldage see Docker Compose’iga: ametlik tõmmis wallabag/wallabag, MariaDB, Redis ja veebiport, mis on avaldatud aadressil 127.0.0.1 HTTPS-i pöördproksi taga.
  3. Enne esimest käivitamist määrake SYMFONY__ENV__SECRET ja oma avalik aadress muutujas SYMFONY__ENV__DOMAIN_NAME; seejärel muutke konto wallabag parooli, mis on wallabag.
  4. Pöördproksi saadab päise X-Forwarded-Proto: https: nii teab wallabag, et külastajad saabuvad HTTPS-i kaudu.
  5. Varundage andmebaas, piltide köide ja oma compose.yaml ning uuendage, muutes tõmmise silti ja käivitades migratsioonid.

Mida wallabag teeb

wallabag on hilisema lugemise veebirakendus: salvestate lehe ühe klõpsuga ja loete selle siis, kui teil on aega. Selle README võtab selle kokku nii: klõpsake, salvestage, lugege siis, kui soovite. wallabag eraldab artikli sisu, nii et algse lehe hüpikaknad teid ei sega.

Mida MIT-litsents lubab

wallabag avaldatakse MIT-litsentsi all, autoriõigus Nicolas Lœuillet alates 2013. aastast. See annab tasuta õiguse tarkvara koopiaid kasutada, kopeerida, muuta, ühendada, avaldada, levitada, all-litsentsida ja müüa. Seega võite seda käitada enda, oma meeskonna või oma klientide jaoks, ilma et peaksite litsentsi ostma.

Ainus tingimus on säilitada autoriõiguse teade ja litsentsi tekst tarkvara kõigis koopiates või olulistes osades. Tekst pakub tarkvara «nagu on», ilma garantiita.

Arvestatavad ressursid

wallabagi dokumentatsioon ei anna mälu ega protsessori kohta arve. Küll aga loetleb see, mida rakendus vajab, ja Dockeri tõmmis määrab mõned väärtused, mis aitavad serverit mõõtmestada:

Serveri suurus sõltub seega kasutajate arvust, artiklite mahust ja teie importidest. Managed VPS-i puhul kirjeldage meile oma kasutust ja me soovitame teile sobiva suuruse.

Paigaldus Docker Compose’iga

Hoidla wallabag/docker avaldab ametliku tõmmise wallabag/wallabag Docker Hubis ja GitHub Container Registry’s koos näidis-Compose-failiga: wallabag, MariaDB andmebaas ja Redis. Serveris, kuhu Docker on paigaldatud, looge kaust ja pange sinna see compose.yaml, mis põhineb sellel näitel:

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:

Asendage kolm salajast väärtust enne esimest käivitamist. Kuueteistkümnendsüsteemi stringid toimivad kõikjal, ka SQL-käskudes, mille tõmmis andmebaasi loomiseks kirjutab:

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

Et kontrollida, kas rakendus vastab, pärige teed, mida tõmmise tervisekontroll kasutab:

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

Tõmmis loeb muutujad SYMFONY__ENV__* uuesti iga konteineri käivitamisel ja tühjendab vahemälu. Pärast faili compose.yaml muutmist loob docker compose up -d konteineri uuesti ja rakendab uued sätted.

SQLite’i või PostgreSQL-iga

Ilma Dockerita

Dokumentatsiooni soovitatud tee eraldi serveris on Giti hoidla ja selle Makefile, koos Composeri, tööriista make ja nõuete lehel loetletud PHP laiendustega:

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

Veebiserver serveerib siis kausta web, sisenemispunktiks app.php: virtuaalhostide leht annab seadistused Nginxi, Apache’i, Caddy ja lighttpd jaoks. Selle näited serveerivad wallabagi domeeni või alamdomeeni juurest, mis on hooldajate toetatud seadistus.

Esimene konto, saladused ja registreerumine

Paigaldus loob administraatorikonto, mille kasutajanimi ja parool on mõlemad wallabag, aadressiga wallabag@wallabag.io. Muutke need enne instantsi avamist avalikkusele. SSH-tunnel toob serveri pordi 8080 teie arvutisse aadressile http://localhost:8080; lisage -p ja teie kliendialas näidatud SSH-port.

Terminal, teie arvutis
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Logige sisse andmetega wallabag ja wallabag.
  2. Valige jaotise «Config» vahekaardil «Password» uus vähemalt 8-märgiline parool.
  3. Asendage vahekaardil «User information» e-posti aadress enda omaga: see saab parooli lähtestamise lingid.
  4. Lülitage samal vahekaardil sisse kaheastmeline autentimine. Dokumentatsioon soovitab e-postiga saadetava koodi asemel ühekordsete koodide rakendust, näiteks FreeOTP-d; wallabag pakub ka varukoode.
MuutujaVaikeväärtusMida see teeb
SYMFONY__ENV__SECRETAvalik string, kõigil instantsidel samaLisab turvatoimingutele entroopiat: dokumentatsioon tahab, et see oleks teie instantsile ainulaadne
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgTeie instantsi täielik aadress, ilma lõpukaldkriipsuta
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse Dockeri tõmmisesAvab või sulgeb avaliku registreerumise
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueSaadab iga registreerumise kohta kinnitusmeili
SYMFONY__ENV__LOCALEenInstantsi vaikekeel, näiteks et
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceInstantsi nimi, mida näitab teie kaheastmelise autentimise rakendus

Dockeri tõmmisega on avalik registreerumine seega suletud. Et avada instants oma meeskonnale, looge kontod ise jaotises «Users management» või avage registreerumine selleks ajaks, kui inimesed liituvad, koos e-posti kinnitusega.

Tundlikumad sätted asuvad jaotises «Internal Settings», mis on reserveeritud instantsi administraatorile: artiklite avalik jagamine, ekspordivormingud, sisselogimine tasulistele saitidele, piltide kohalik allalaadimine ja taustaimpordid.

HTTPS: pöördproksi

Konteiner serveerib wallabagi HTTP kaudu oma pordil 80, sisemise Nginxi abil. HTTPS-i eest hoolitseb selle ees olev pöördproksi. See sisemine Nginx loeb päist X-Forwarded-Proto: kui selle väärtus on https, teatab see PHP-le, et päring on krüpteeritud, ja wallabag koostab oma lingid ja küpsised vastavalt.

Caddy-ga

Caddy hangib Let’s Encrypti sertifikaadi ise ja uuendab seda. Selle direktiiv reverse_proxy säilitab päise Host ja lisab vaikimisi X-Forwarded-For, X-Forwarded-Proto ja X-Forwarded-Host:

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

Nginxiga

See plokk kasutab Dockeri tõmmise README Nginxi näite päiseid, lisab päise Host ja tõmmise üleslaadimise piirangu ning kuulab pordil 80, et Certbot saaks HTTPS-i paigaldada:

Nginxi plokk
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

Seejärel kontrollige, et SYMFONY__ENV__DOMAIN_NAME sisaldaks aadressi kujul https://, sama mis teie proksil.

Rakendused, brauserilaiendid ja RSS-vood

wallabag töötab brauseris ning projekt avaldab ka rakendusi ja laiendi, mis ühenduvad teie instantsiga selle aadressi kaudu, ilma lõpukaldkriipsuta.

TööriistMida see teebMida see vajab
Androidi rakendusSünkroonib teie artiklite loendid ja näitab neid telefonisInstantsi aadress, teie kasutajanimi ja parool; rakendus hangib oma voogude juurdepääsu ise
iOS-i rakendusNäitab teie artikleid iPhone’is ja iPadisAadress, API kliendi ID ja saladus, teie kasutajanimi ja parool
Laiend wallabagger, Firefoxile ja Chrome’ileSalvestab avatud lehe koos siltidega, lemmikuna või arhiveeritunaAadress, API kliendi ID ja saladus, teie kasutajanimi ja parool
Järjehoidjaskript «bag it!»Salvestab avatud lehe järjehoidjaribaltMitte midagi: lohistate selle lehelt «Howto»

Artiklite import Pocketist ja mujalt

Menüü «Import» toob teie artiklid teisest teenusest. wallabag laadib iga artikli sisu uuesti alla, mis suure ekspordi puhul võtab aega. Versiooni 2.6.17 importijad:

TeenusEsitatav fail
Pocket, CSV-eksportPocketi ekspordi ZIP-fail lahtipakituna: CSV-fail, mille nimi on näiteks part_000000.csv
Pocket, HTML-eksportPocketi vanema ekspordi HTML-fail, näiteks ril_export.html
InstapaperCSV-fail Instapaperi sätete lehelt
OmnivoreLahtipakitud ekspordi failid metadata_x_to_y.json, ükshaaval
Pinboard, DeliciousNende JSON-eksport
ShaarliSelle HTML-eksport
Firefox, ChromeFirefoxi järjehoidjate JSON-varukoopia või Chrome’i fail Bookmarks
Readability, elCuratorNende eksport
wallabag 1.x või 2.xTeise instantsi JSON-eksport

Versioon 2.6.17 toob lisaks paranduse Pocketi CSV-impordile. Olemas on ka import Pocketi API kaudu, arendajavõtmega, mille administraator määrab seadistuses.

Suured impordid taustal

Et suur import lehte kinni ei hoiaks, annab wallabag selle Redisele, mis on ülaltoodud failis compose.yaml juba olemas:

  1. Lülitage jaotise «Internal Settings» osas «Import» Redis sisse väärtusega 1.
  2. Alustage importi menüüst «Import»: wallabag paneb artiklid järjekorda.
  3. Käivitage valitud impordi tüübi töötaja, näiteks pocket_csv; see töötleb järjekorra läbi ja jääb seejärel kuulama, kuni selle peatate.
Terminal, compose.yaml-i kaustas
docker compose run --rm wallabag import pocket_csv

Ülejäänud tüübid on pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox ja chrome.

E-post: SMTP seadistus

wallabag saadab e-kirju registreerumise kinnitamiseks, paroolide lähtestamiseks ja e-postiga saadetavate kaheastmelise autentimise koodide jaoks. Ta saadab need serveri kaudu, mida kirjeldab SYMFONY__ENV__MAILER_DSN ja mille vaikeväärtus on smtp://127.0.0.1.

Simafri VPS-is seadistage autenditud SMTP-server pordil 587 või 465: teie domeeni e-posti teenus või saatmisteenus. Dokumentatsioon annab üherealise vormingu koos kasutaja, parooli, serveri ja pordiga:

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

Seejärel looge konteiner uuesti käsuga docker compose up -d ja testige sisselogimislehe lingiga «Forgot your password?».

Varukoopiad

Dokumentatsiooni varunduslehel on nimetatud kolm osa: sätted, andmebaas ja pildid. Dockeri tõmmise puhul asub igaüks järgmiselt:

OsaKus see asubKuidas seda kopeerida
SättedTeie compose.yaml: tõmmis koostab sellest iga käivitamisel faili parameters.ymlFaili koopia, hoitud turvalises kohas, sest see sisaldab teie saladusi
AndmebaasKöide wallabag-dbEksport tööriistaga mariadb-dump
PildidKöide wallabag-images, ühendatud kausta web/assets/imagesKausta arhiiv
Terminal, compose.yaml-i kaustas
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

Ajastage need koopiad ja saatke need serverist välja. Serveri kettale salvestatuna kuuluvad need arhiivid ka selle öistesse varukoopiatesse. SQLite’i puhul palub dokumentatsioon kopeerida kausta data/db.

Taastamine

Uues paigalduses käivitage komplekt sama failiga compose.yaml ning laadige seejärel andmebaas ja pildid tagasi:

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

Iga kasutaja saab ka oma artiklid JSON-vormingus eksportida loendist «All entries» ja importida need uuesti teise instantsi wallabag 2.x importijaga. Administraatoritele ekspordib käsk wallabag:export kasutaja artiklid faili.

Uuendused

Dockeriga muutke tõmmise silti failis compose.yaml, tehke varukoopia, seejärel tõmmake uus tõmmis ja looge konteiner uuesti. README palub seejärel käivitada andmebaasi migratsioonid, kui versioon neid toob:

Terminal, compose.yaml-i kaustas
docker compose pull
docker compose up -d
docker compose exec --user nobody wallabag php bin/console doctrine:migrations:migrate --env=prod --no-interaction

Lugege enne uuendamist iga versiooni märkmeid: need toovad välja just selle versiooni sammud, näiteks versioonis 2.6.16 tühjendatava kausta.

Kes mida teeb Managed VPS-is

Ise majutamine nõuab lisaks rakendusele ka serveri hoidmist. Managed VPS-is võtavad meie meeskonnad serveri enda hoole alla ja jälgivad teie instantsi proaktiivselt; wallabag jääb teie tarkvaraks oma sätete ja teie artiklitega.

TeemaMeie meeskonnadTeie
ServerSüsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatudHetk, mis sobib teie tegevusele
SeireServerit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamataTeie instantsi logide lugemine
wallabagProaktiivne jälgimine: vead, aeglus, andmebaas ja kettaruum avastatakse, parandus soovitatakseSelle paigaldus, uuendused ja sätted, mille rakendate teie või teie tehisintellekti assistent
Kontod ja artiklidNeid kandev server, jälgitud ja varundatudKasutajad, registreerumine, API kliendid ja impordid
VarukoopiadIgal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldubwallabagi enda ekspordid ja taastamistaotlus, kui seda vajate
ÜleviimineTeie praeguse serveri üleviimine, tasutaÜmberlülitamise hetk

Kui eelistate, et meie meeskonnad sekkuksid rakendusse endasse, arveldatakse see teenus tunni- või kindlahinnaga, hinnapakkumine edastatakse enne sekkumist.

wallabag teie eest hoitud serveris

Simafri Managed VPS-iga hoiavad meie meeskonnad teie wallabagi instantsi serveri ajakohasena, jälgivad seda päeval ja öösel ning sekkuvad ilma teie kõnet ootamata; nad jälgivad ka teie instantsi proaktiivselt ja soovitavad teile kasulikud parandused, mille rakendate ise või oma tehisintellekti assistendiga. Varukoopiad krüpteeritakse igal ööl ja hoitakse väljaspool masinat, nende taastamine sisaldub hinnas ning teie praeguse serveri üleviimine on tasuta.

Vaadake Managed VPS

Korduma kippuvad küsimused

Kas wallabag on tasuta?

Jah. wallabag on MIT-litsentsiga: võite seda kasutada, muuta ja edasi levitada, ettevõttes ja mujal, ilma et peaksite litsentsi ostma, tingimusel et säilitate selle autoriõiguse teate. Jääb ainult seda käitava serveri hind.

Kuidas paigaldada wallabag Docker Compose’iga?

Alustage tõmmise wallabag/wallabag näidisfailist compose.yaml koos MariaDB ja Redisega. Määrake SYMFONY__ENV__SECRET, paroolid ja oma aadress muutujas SYMFONY__ENV__DOMAIN_NAME, avaldage port aadressil 127.0.0.1, seejärel käivitage docker compose up -d ja pange ette HTTPS-i pöördproksi.

Millised on wallabagi vaikimisi sisselogimisandmed?

Paigaldus loob administraatori, kelle kasutajanimi ja parool on mõlemad wallabag. Muutke parool jaotise Config vahekaardil Password ja e-posti aadress vahekaardil User information enne instantsi avamist avalikkusele.

Kuidas importida oma Pocketi artiklid wallabagi?

Pakkige Pocketi ekspordi ZIP-fail lahti: selles on CSV-fail, näiteks part_000000.csv. Valige menüüs Import Pocket CSV ja laadige see fail üles. Seejärel laadib wallabag iga artikli sisu alla; suure ekspordi puhul lülitage Redis sisse sisemistes sätetes.

Millised rakendused töötavad wallabagiga?

Projekt avaldab Androidi ja iOS-i rakendused ning Firefoxi ja Chrome’i laiendi wallabagger, mis ühenduvad teie instantsiga selle aadressi kaudu, ilma lõpukaldkriipsuta. iOS ja wallabagger vajavad API klienti, mis luuakse jaotises API clients management.

Miks jäävad wallabagi lingid proksi taga http-le?

Tõmmis loeb päist X-Forwarded-Proto, et teada, kas päring tuleb HTTPS-i kaudu. Laske oma proksil saata see väärtusega https koos teie domeeni päisega Host ja pange muutujasse SYMFONY__ENV__DOMAIN_NAME aadress kujul https://.

Kuidas wallabagi varundada?

Kopeerige kolm osa: andmebaas, MariaDB puhul tööriistaga mariadb-dump, kausta web/assets/images ühendatud piltide köide ja teie compose.yaml, mis sisaldab sätteid ja saladusi. Saatke need koopiad serverist välja.

Kas Managed VPS katab wallabagi?

Managed VPS katab serveri: süsteemi, turvalisuse, seire ja varukoopiad. Meie meeskonnad jälgivad ka teie instantsi proaktiivselt ja soovitavad kasulikke parandusi, mille rakendate teie. Sekkumine rakendusse arveldatakse tunni- või kindlahinnaga.

Allikad ja ametlik dokumentatsioon

Võtke meiega ühendust