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.
Autor: Simon Vasconcelos Lee
Avaldatud 18. novembril 2026Lugemisaeg: 14 minutit
wallabag/wallabag, MariaDB, Redis ja veebiport, mis on avaldatud aadressil 127.0.0.1 HTTPS-i pöördproksi taga.SYMFONY__ENV__SECRET ja oma avalik aadress muutujas SYMFONY__ENV__DOMAIN_NAME; seejärel muutke konto wallabag parooli, mis on wallabag.X-Forwarded-Proto: https: nii teab wallabag, et külastajad saabuvad HTTPS-i kaudu.compose.yaml ning uuendage, muutes tõmmise silti ja käivitades migratsioonid.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.
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.
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:
memory_limit vaikimisi väärtusele 256 MB alates oma versioonist 2.6.16 ja muutuja PHP_MEMORY_LIMIT muudab seda.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.
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:
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:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: hoidla näide avaldab konteineri pordi 80 ilma aadressita ja Docker avab selle siis serveri kõigil aadressidel. Kohalikult avaldatuna on see kättesaadav ainult pöördproksi kaudu.MYSQL_ROOT_PASSWORD loob tõmmis andmebaasi ja selle kasutaja ning käivitab seejärel wallabag:install, mis loob tabelid ja konto wallabag. Logis olev rida wallabag is ready! tähistab lõppu.wallabag; teenus db hoiab selle alles.wallabag-db hoiab andmebaasi, wallabag-images artiklipilte. Ka paigaldusdokumentatsiooni näide kasutab nimega köiteid.redis alt.2.6.17, 2.6, 2 ja latest. Täielik versioon laseb teil iga uuenduse aja ise valida.Et kontrollida, kas rakendus vastab, pärige teed, mida tõmmise tervisekontroll kasutab:
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.
/var/www/wallabag/data/db/wallabag.sqlite; sel juhul ühendage köide kausta /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, port 5432 ning POSTGRES_USER ja POSTGRES_PASSWORD, et tõmmis looks andmebaasi. Tõmmise versioon 2.6.15 parandab andmebaasi omandiõiguse PostgreSQL 15 ja uuematega.POPULATE_DATABASE=False ja lähtestage see seejärel üks kord käsuga docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. README palub käivitada selle käsu kasutajana nobody, et ükski fail ei jääks rooti omandisse.Dokumentatsiooni soovitatud tee eraldi serveris on Giti hoidla ja selle Makefile, koos Composeri, tööriista make ja nõuete lehel loetletud PHP laiendustega:
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.
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.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag ja wallabag.| Muutuja | Vaikeväärtus | Mida see teeb |
|---|---|---|
SYMFONY__ENV__SECRET | Avalik string, kõigil instantsidel sama | Lisab turvatoimingutele entroopiat: dokumentatsioon tahab, et see oleks teie instantsile ainulaadne |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Teie instantsi täielik aadress, ilma lõpukaldkriipsuta |
SYMFONY__ENV__FOSUSER_REGISTRATION | false Dockeri tõmmises | Avab või sulgeb avaliku registreerumise |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Saadab iga registreerumise kohta kinnitusmeili |
SYMFONY__ENV__LOCALE | en | Instantsi vaikekeel, näiteks et |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Instantsi 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.
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.
X-Forwarded-Proto: proksi peab selle saatma väärtusega https.Host: teie domeeninimi, et rakenduse ümbersuunamised viiksid sellele.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:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
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:
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
Seejärel kontrollige, et SYMFONY__ENV__DOMAIN_NAME sisaldaks aadressi kujul https://, sama mis teie proksil.
wallabag töötab brauseris ning projekt avaldab ka rakendusi ja laiendi, mis ühenduvad teie instantsiga selle aadressi kaudu, ilma lõpukaldkriipsuta.
| Tööriist | Mida see teeb | Mida see vajab |
|---|---|---|
| Androidi rakendus | Sünkroonib teie artiklite loendid ja näitab neid telefonis | Instantsi aadress, teie kasutajanimi ja parool; rakendus hangib oma voogude juurdepääsu ise |
| iOS-i rakendus | Näitab teie artikleid iPhone’is ja iPadis | Aadress, API kliendi ID ja saladus, teie kasutajanimi ja parool |
| Laiend wallabagger, Firefoxile ja Chrome’ile | Salvestab avatud lehe koos siltidega, lemmikuna või arhiveerituna | Aadress, API kliendi ID ja saladus, teie kasutajanimi ja parool |
| Järjehoidjaskript «bag it!» | Salvestab avatud lehe järjehoidjaribalt | Mitte midagi: lohistate selle lehelt «Howto» |
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:
| Teenus | Esitatav fail |
|---|---|
| Pocket, CSV-eksport | Pocketi ekspordi ZIP-fail lahtipakituna: CSV-fail, mille nimi on näiteks part_000000.csv |
| Pocket, HTML-eksport | Pocketi vanema ekspordi HTML-fail, näiteks ril_export.html |
| Instapaper | CSV-fail Instapaperi sätete lehelt |
| Omnivore | Lahtipakitud ekspordi failid metadata_x_to_y.json, ükshaaval |
| Pinboard, Delicious | Nende JSON-eksport |
| Shaarli | Selle HTML-eksport |
| Firefox, Chrome | Firefoxi järjehoidjate JSON-varukoopia või Chrome’i fail Bookmarks |
| Readability, elCurator | Nende eksport |
| wallabag 1.x või 2.x | Teise 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.
Et suur import lehte kinni ei hoiaks, annab wallabag selle Redisele, mis on ülaltoodud failis compose.yaml juba olemas:
1.pocket_csv; see töötleb järjekorra läbi ja jääb seejärel kuulama, kuni selle peatate.docker compose run --rm wallabag import pocket_csv
Ülejäänud tüübid on pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox ja chrome.
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:
- 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
@ muutub kujule %40. Kui kodeeritud märk takistab käivitamist, soovitab dokumentatsioon protsendimärgi kahekordistada: %%40.FROM_EMAIL on kõigi wallabagi e-kirjade saatja, TWOFACTOR_SENDER kaheastmelise autentimise koodide saatja. Kasutage oma domeeni aadressi, millelt teie SMTP-server lubab saata.:465.Seejärel looge konteiner uuesti käsuga docker compose up -d ja testige sisselogimislehe lingiga «Forgot your password?».
Dokumentatsiooni varunduslehel on nimetatud kolm osa: sätted, andmebaas ja pildid. Dockeri tõmmise puhul asub igaüks järgmiselt:
| Osa | Kus see asub | Kuidas seda kopeerida |
|---|---|---|
| Sätted | Teie compose.yaml: tõmmis koostab sellest iga käivitamisel faili parameters.yml | Faili koopia, hoitud turvalises kohas, sest see sisaldab teie saladusi |
| Andmebaas | Köide wallabag-db | Eksport tööriistaga mariadb-dump |
| Pildid | Köide wallabag-images, ühendatud kausta web/assets/images | Kausta arhiiv |
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.
Uues paigalduses käivitage komplekt sama failiga compose.yaml ning laadige seejärel andmebaas ja pildid tagasi:
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.
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:
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 ja selle versioonimärkmed paluvad tühjendada vana kausta web/uploads/import. Selles failis compose.yaml asub see kaust konteineri sees: uuest tõmmisest loodud konteiner alustab ilma selleta.make update, mis versiooni 2.6.15 või vanemat kasutavates instantsides valis samal hommikul avaldatud alfaversiooni. Kinni jäänud Giti paigalduse jaoks annavad selle versioonimärkmed paranduse: git checkout 2.6.17 --force, seejärel make update.make update, mis käivitab ka migratsioonid ja tühjendab vahemälu.Lugege enne uuendamist iga versiooni märkmeid: need toovad välja just selle versiooni sammud, näiteks versioonis 2.6.16 tühjendatava kausta.
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.
| Teema | Meie meeskonnad | Teie |
|---|---|---|
| Server | Süsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatud | Hetk, mis sobib teie tegevusele |
| Seire | Serverit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamata | Teie instantsi logide lugemine |
| wallabag | Proaktiivne jälgimine: vead, aeglus, andmebaas ja kettaruum avastatakse, parandus soovitatakse | Selle paigaldus, uuendused ja sätted, mille rakendate teie või teie tehisintellekti assistent |
| Kontod ja artiklid | Neid kandev server, jälgitud ja varundatud | Kasutajad, registreerumine, API kliendid ja impordid |
| Varukoopiad | Igal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldub | wallabagi enda ekspordid ja taastamistaotlus, kui seda vajate |
| Üleviimine | Teie 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.
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.
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.
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.
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.
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.
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.
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://.
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.
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.
Simafri
Räägime teie kavatsusest
Öelge meile paari sõnaga, mida vajate: vastame teile kiiresti.
Aitäh! Teie päring on saadetud. Võtame teiega peagi ühendust.
Eelistate e-posti? Kirjutage meile aadressil support@simafri.com.