wallabag talpinimas Managed VPS serveryje reiškia, kad straipsniai, kuriuos išsaugote vėlesniam skaitymui, lieka jūsų pačių mašinoje, kurią mūsų komandos prižiūri atnaujintą ir stebi dieną bei naktį. wallabag yra laisva atvirojo kodo programa straipsniams skaityti vėliau, platinama pagal MIT licenciją. Šis gidas seka oficialią jos dokumentaciją ir Docker atvaizdą, 2.6.17 versiją: diegimą su Docker Compose, pirmąją paskyrą ir slaptas reikšmes, HTTPS, programėles ir naršyklės plėtinius, importą iš Pocket ir kitų paslaugų, el. paštą, atsargines kopijas ir atnaujinimus.
Autorius: Simon Vasconcelos Lee
Paskelbta 2026 m. lapkričio 18 d.Skaitymo trukmė: 14 min.
wallabag/wallabag, MariaDB, Redis ir žiniatinklio prievadas, paskelbtas adresu 127.0.0.1 už HTTPS atvirkštinio tarpinio serverio.SYMFONY__ENV__SECRET ir savo viešąjį adresą kintamajame SYMFONY__ENV__DOMAIN_NAME; tada pakeiskite paskyros wallabag slaptažodį, kuris yra wallabag.X-Forwarded-Proto: https: taip wallabag žino, kad lankytojai ateina per HTTPS.compose.yaml atsargines kopijas, o atnaujinkite pakeisdami atvaizdo žymą ir paleisdami migracijas.wallabag yra žiniatinklio programa straipsniams skaityti vėliau: vienu spustelėjimu išsaugote puslapį ir jį perskaitote, kai turite laiko. Jos README tai apibendrina taip: spustelėkite, išsaugokite, skaitykite, kada norite. wallabag ištraukia straipsnio turinį, todėl jūsų neblaško originalaus puslapio iššokantys langai.
wallabag platinama pagal MIT licenciją, autorių teisės priklauso Nicolas Lœuillet nuo 2013 m. Ji nemokamai suteikia teisę naudoti, kopijuoti, keisti, sujungti, skelbti, platinti, suteikti sublicencijas ir parduoti programinės įrangos kopijas. Todėl ją galite paleisti sau, savo komandai ar klientams, nepirkdami jokios licencijos.
Vienintelė sąlyga yra išlaikyti autorių teisių pranešimą ir licencijos tekstą visose programinės įrangos kopijose ar esminėse jos dalyse. Tekstas programinę įrangą teikia „tokią, kokia yra“, be garantijų.
wallabag dokumentacija nenurodo jokio atminties ar procesoriaus skaičiaus. Vis dėlto ji išvardija, ko programai reikia, o Docker atvaizdas nustato kelias reikšmes, kurios padeda parinkti dydį:
memory_limit į 256 MB, o kintamasis PHP_MEMORY_LIMIT šią reikšmę keičia.Todėl serverio dydis priklauso nuo naudotojų skaičiaus, straipsnių kiekio ir jūsų importų. Naudojant Managed VPS, papasakokite mums, kaip ją naudojate, ir mes rekomenduosime tinkamą dydį.
Saugykla wallabag/docker skelbia oficialų atvaizdą wallabag/wallabag Docker Hub ir GitHub Container Registry, kartu su Compose failo pavyzdžiu: wallabag, MariaDB duomenų bazė ir Redis. Serveryje su įdiegtu Docker sukurkite katalogą ir įdėkite į jį šį compose.yaml, parengtą pagal tą pavyzdį:
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:
Prieš pirmąjį paleidimą pakeiskite tris slaptas reikšmes. Šešioliktainės eilutės tinka visur, taip pat SQL komandose, kurias atvaizdas rašo duomenų bazei sukurti:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: saugyklos pavyzdys konteinerio 80 prievadą skelbia be adreso, ir tada Docker jį atveria visais serverio adresais. Paskelbtas lokaliai, jis pasiekiamas tik per atvirkštinį tarpinį serverį.MYSQL_ROOT_PASSWORD atvaizdas sukuria duomenų bazę ir jos naudotoją, tada paleidžia wallabag:install, kuri sukuria lenteles ir paskyrą wallabag. Pabaigą žymi žurnalo eilutė wallabag is ready!.wallabag; paslauga db jį pasilieka.wallabag-db saugo duomenų bazę, wallabag-images straipsnių paveikslėlius. Diegimo dokumentacijos pavyzdyje taip pat naudojami pavadinti tomai.redis.2.6.17, 2.6, 2 ir latest. Visa versija leidžia pasirinkti, kada vyks kiekvienas atnaujinimas.Norėdami patikrinti, ar programa atsako, kreipkitės į maršrutą, kurį naudoja atvaizdo būsenos patikra:
curl http://127.0.0.1:8080/api/info
Atvaizdas kintamuosius SYMFONY__ENV__* nuskaito iš naujo kiekvieną kartą paleidžiant konteinerį ir išvalo podėlį. Pakeitus compose.yaml, komanda docker compose up -d iš naujo sukuria konteinerį ir pritaiko naujus nustatymus.
/var/www/wallabag/data/db/wallabag.sqlite; tokiu atveju prijunkite tomą prie /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, 5432 prievadas, taip pat POSTGRES_USER ir POSTGRES_PASSWORD, kad atvaizdas sukurtų duomenų bazę. Atvaizdo 2.6.15 versija ištaiso duomenų bazės nuosavybę su PostgreSQL 15 ir naujesnėmis.POPULATE_DATABASE=False, tada vieną kartą ją inicijuokite komanda docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. README prašo šią komandą vykdyti kaip nobody, kad jokie failai netaptų root nuosavybe.Dokumentacijos rekomenduojamas būdas atskirame serveryje yra Git saugykla ir jos Makefile, su Composer, įrankiu make ir PHP plėtiniais iš reikalavimų puslapio:
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install
Tada žiniatinklio serveris teikia katalogą web, o įėjimo taškas yra app.php: virtualiųjų serverių puslapyje pateikiamos Nginx, Apache, Caddy ir lighttpd konfigūracijos. Jo pavyzdžiai teikia wallabag domeno ar subdomeno šaknyje; tokią sąranką palaiko projekto prižiūrėtojai.
Diegimas sukuria administratoriaus paskyrą, kurios naudotojo vardas ir slaptažodis abu yra wallabag, su adresu wallabag@wallabag.io. Pakeiskite juos prieš atverdami egzempliorių visuomenei. SSH tunelis serverio 8080 prievadą atveda į jūsų kompiuterį, adresu http://localhost:8080; pridėkite -p ir SSH prievadą, nurodytą jūsų kliento zonoje.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag ir wallabag.| Kintamasis | Numatytoji reikšmė | Ką jis daro |
|---|---|---|
SYMFONY__ENV__SECRET | Vieša eilutė, vienoda visiems egzemplioriams | Prideda entropijos saugumo operacijoms: dokumentacija reikalauja, kad ji būtų unikali jūsų egzemplioriui |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Visas jūsų egzemplioriaus adresas, be pasvirojo brūkšnio gale |
SYMFONY__ENV__FOSUSER_REGISTRATION | false Docker atvaizde | Atveria arba uždaro viešą registraciją |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Kiekvienai registracijai siunčia patvirtinimo laišką |
SYMFONY__ENV__LOCALE | en | Numatytoji egzemplioriaus kalba, pavyzdžiui, fr |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Egzemplioriaus pavadinimas, rodomas jūsų dviejų veiksnių programėlėje |
Taigi su Docker atvaizdu vieša registracija uždaryta. Norėdami atverti egzempliorių savo komandai, paskyras sukurkite patys skiltyje „Users management“ arba atverkite registraciją tol, kol žmonės registruojasi, su patvirtinimu el. paštu.
Jautresni nustatymai yra skiltyje „Internal Settings“, skirtoje egzemplioriaus administratoriui: viešas dalijimasis straipsniais, eksporto formatai, prisijungimas prie mokamos prieigos svetainių, vietinis paveikslėlių atsisiuntimas ir foniniai importai.
Konteineris wallabag teikia per HTTP, savo 80 prievadu, per vidinį Nginx. HTTPS rūpinasi priešais jį stovintis atvirkštinis tarpinis serveris. Šis vidinis Nginx skaito antraštę X-Forwarded-Proto: kai ji yra https, jis praneša PHP, kad užklausa šifruota, ir wallabag pagal tai kuria savo nuorodas ir slapukus.
X-Forwarded-Proto: tarpinis serveris turi ją siųsti su reikšme https.Host: jūsų domeno vardas, kad programos peradresavimai vestų į jį.Caddy pats gauna Let’s Encrypt sertifikatą ir jį atnaujina. Jo direktyva reverse_proxy išlaiko antraštę Host ir pagal numatymą prideda X-Forwarded-For, X-Forwarded-Proto ir X-Forwarded-Host:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
Šis blokas naudoja antraštes iš Nginx pavyzdžio Docker atvaizdo README, prideda antraštę Host ir atvaizdo įkėlimo ribą bei klauso 80 prievado, kad Certbot galėtų įdiegti 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
Tada patikrinkite, ar kintamajame SYMFONY__ENV__DOMAIN_NAME nurodytas adresas su https://, toks pat kaip jūsų tarpinio serverio.
wallabag veikia naršyklėje, o projektas taip pat skelbia programėles ir plėtinį, kurie prie jūsų egzemplioriaus jungiasi jo adresu, be pasvirojo brūkšnio gale.
| Įrankis | Ką jis daro | Ko jam reikia |
|---|---|---|
| Android programėlė | Sinchronizuoja jūsų straipsnių sąrašus ir rodo juos telefone | Egzemplioriaus adreso, jūsų naudotojo vardo ir slaptažodžio; srautų prisijungimo duomenis programėlė gauna pati |
| iOS programėlė | Rodo jūsų straipsnius iPhone ir iPad | Adreso, API kliento ID ir slaptos reikšmės, jūsų naudotojo vardo ir slaptažodžio |
| wallabagger plėtinys, skirtas Firefox ir Chrome | Išsaugo atidarytą puslapį su jo žymomis, pažymėtą žvaigždute ar archyvuotą | Adreso, API kliento ID ir slaptos reikšmės, jūsų naudotojo vardo ir slaptažodžio |
| Žymelė „bag it!“ | Išsaugo atidarytą puslapį iš žymių juostos | Nieko: ją nutempiate iš puslapio „Howto“ |
Meniu „Import“ perkelia jūsų straipsnius iš kitos paslaugos. wallabag iš naujo atsisiunčia kiekvieno straipsnio turinį, todėl dideliam eksportui reikia laiko. Importo įrankiai 2.6.17 versijoje:
| Paslauga | Pateiktinas failas |
|---|---|
| Pocket, CSV eksportas | Išskleistas Pocket eksporto ZIP: CSV failas, pavadintas panašiai kaip part_000000.csv |
| Pocket, HTML eksportas | Senesnio Pocket eksporto HTML failas, pavyzdžiui, ril_export.html |
| Instapaper | CSV failas iš Instapaper nustatymų puslapio |
| Omnivore | Išskleisto eksporto failai metadata_x_to_y.json, po vieną |
| Pinboard, Delicious | Jų JSON eksportas |
| Shaarli | Jo HTML eksportas |
| Firefox, Chrome | Firefox žymių JSON atsarginė kopija arba Chrome failas Bookmarks |
| Readability, elCurator | Jų eksportas |
| wallabag 1.x arba 2.x | Kito egzemplioriaus JSON eksportas |
2.6.17 versija taip pat ištaiso Pocket CSV importą. Yra ir importas per Pocket API, su kūrėjo raktu, kurį administratorius nurodo konfigūracijoje.
Kad didelis importas nestabdytų puslapio, wallabag jį perduoda Redis, kurį aukščiau pateiktas compose.yaml jau numato:
1.pocket_csv; jis apdoroja eilę, o paskui toliau klausosi, kol jį sustabdysite.docker compose run --rm wallabag import pocket_csv
Kiti tipai yra pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox ir chrome.
wallabag siunčia laiškus registracijai patvirtinti, slaptažodžiui atkurti ir dviejų veiksnių kodams el. paštu. Juos siunčia per serverį, aprašytą kintamajame SYMFONY__ENV__MAILER_DSN, kurio numatytoji reikšmė yra smtp://127.0.0.1.
Simafri VPS serveryje sukonfigūruokite SMTP serverį su autentifikavimu, 587 arba 465 prievadu: jūsų domeno pašto paslaugą arba siuntimo paslaugą. Dokumentacija pateikia vienos eilutės formatą su naudotoju, slaptažodžiu, serveriu ir prievadu:
- 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
@ tampa %40. Jei užkoduotas simbolis sustabdo paleidimą, dokumentacija siūlo procento ženklą padvigubinti: %%40.FROM_EMAIL yra visų wallabag laiškų siuntėjas, TWOFACTOR_SENDER yra dviejų veiksnių kodų siuntėjas. Naudokite savo domeno adresą, iš kurio jūsų SMTP serveris leidžia siųsti.:465 eilutės gale.Tada iš naujo sukurkite konteinerį komanda docker compose up -d ir išbandykite su nuoroda „Forgot your password?“ prisijungimo puslapyje.
Dokumentacijos atsarginių kopijų puslapyje įvardijami trys elementai: nustatymai, duomenų bazė ir paveikslėliai. Su Docker atvaizdu kiekvienas iš jų yra štai kur:
| Elementas | Kur jis yra | Kaip jį nukopijuoti |
|---|---|---|
| Nustatymai | Jūsų compose.yaml: atvaizdas iš jo kiekvieno paleidimo metu sukuria parameters.yml | Failo kopija, laikoma saugioje vietoje, nes joje yra jūsų slaptos reikšmės |
| Duomenų bazė | Tomas wallabag-db | Eksportas su mariadb-dump |
| Paveikslėliai | Tomas wallabag-images, prijungtas prie web/assets/images | Katalogo archyvas |
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
Suplanuokite šias kopijas ir siųskite jas už serverio ribų. Laikomi jo diske, šie archyvai taip pat patenka į naktines jo atsargines kopijas. Naudojant SQLite, dokumentacija prašo kopijuoti katalogą data/db.
Naujame diegime paleiskite rinkinį su tuo pačiu compose.yaml, tada įkelkite atgal duomenų bazę ir paveikslėlius:
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
Kiekvienas naudotojas taip pat gali eksportuoti savo straipsnius JSON formatu iš sąrašo „All entries“ ir vėl juos importuoti į kitą egzempliorių su wallabag 2.x importo įrankiu. Administratoriams komanda wallabag:export eksportuoja naudotojo straipsnius į failą.
Naudodami Docker, pakeiskite atvaizdo žymą faile compose.yaml, padarykite atsarginę kopiją, tada atsisiųskite naują atvaizdą ir iš naujo sukurkite konteinerį. Po to README prašo paleisti duomenų bazės migracijas, kai versija jų turi:
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, o versijos pastabos prašo ištuštinti seną katalogą web/uploads/import. Šiame compose.yaml tas katalogas yra konteinerio viduje: iš naujojo atvaizdo sukurtas konteineris pradeda be jo.make update, kuri egzemplioriuose su 2.6.15 ar senesne versija pasirinkdavo tą rytą paskelbtą alfa versiją. Užstrigusiam Git diegimui versijos pastabos pateikia sprendimą: git checkout 2.6.17 --force, tada make update.make update, kuri taip pat paleidžia migracijas ir išvalo podėlį.Prieš atnaujindami perskaitykite kiekvienos versijos pastabas: jose nurodomi tai versijai būdingi žingsniai, pavyzdžiui, 2.6.16 versijoje ištuštintinas katalogas.
Talpinant savo serveryje, be programos reikia prižiūrėti ir patį serverį. Naudojant Managed VPS, mūsų komandos perima serverį ir proaktyviai stebi jūsų egzempliorių; wallabag lieka jūsų programa su savo nustatymais ir jūsų straipsniais.
| Tema | Mūsų komandos | Jūs |
|---|---|---|
| Serveris | Sistemos ir saugumo atnaujinimai, įskaitant įsikišimą serveryje | Jūsų veiklai tinkamas momentas |
| Stebėsena | Serveris stebimas 24 val. per parą, 7 dienas per savaitę, įsikišant nelaukiant jūsų skambučio | Jūsų egzemplioriaus žurnalų skaitymas |
| wallabag | Proaktyvi stebėsena: klaidos, sulėtėjimai, duomenų bazė ir disko vieta pastebimi, rekomenduojamas pataisymas | Jos diegimas, atnaujinimai ir nustatymai, kuriuos pritaikote jūs arba jūsų DI asistentas |
| Paskyros ir straipsniai | Juos nešantis serveris, stebimas ir saugomas atsarginėmis kopijomis | Naudotojai, registracija, API klientai ir importai |
| Atsarginės kopijos | Kiekvieną naktį, šifruotos ir saugomos už mašinos ribų; atkūrimas įskaičiuotas | Pačios wallabag eksportai ir atkūrimo prašymas, kai jo prireikia |
| Perkėlimas | Jūsų dabartinis serveris perkeliamas nemokamai | Perjungimo momentas |
Jei norite, kad mūsų komandos įsikištų į pačią programą, ši paslauga apmokestinama valandomis arba fiksuota kaina, o skaičiavimas pateikiamas prieš įsikišimą.
Su Simafri Managed VPS mūsų komandos palaiko jūsų wallabag egzemplioriaus serverį atnaujintą, stebi jį dieną ir naktį ir įsikiša nelaukdamos jūsų skambučio; jos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs arba jūsų DI asistentas. Atsarginės kopijos kiekvieną naktį šifruojamos ir saugomos už mašinos ribų, jų atkūrimas įskaičiuotas, o jūsų dabartinio serverio perkėlimas nemokamas.
Taip. wallabag platinama pagal MIT licenciją: ją galite naudoti, keisti ir platinti, tiek įmonėje, tiek kitur, nieko nepirkdami dėl licencijos, jei išlaikote jos autorių teisių pranešimą. Lieka tik ją vykdančio serverio kaina.
Pradėkite nuo atvaizdo wallabag/wallabag compose.yaml pavyzdžio su MariaDB ir Redis. Nustatykite SYMFONY__ENV__SECRET, slaptažodžius ir savo adresą kintamajame SYMFONY__ENV__DOMAIN_NAME, paskelbkite prievadą adresu 127.0.0.1, tada paleiskite docker compose up -d ir priešais pastatykite HTTPS atvirkštinį tarpinį serverį.
Diegimas sukuria administratorių, kurio naudotojo vardas ir slaptažodis abu yra wallabag. Prieš atverdami egzempliorių visuomenei, pakeiskite slaptažodį skiltyje Config, kortelėje Password, o el. pašto adresą kortelėje User information.
Išskleiskite Pocket eksporto ZIP: jame yra CSV failas, pavyzdžiui, part_000000.csv. Meniu Import pasirinkite Pocket CSV ir įkelkite šį failą. Tada wallabag atsisiunčia kiekvieno straipsnio turinį; dideliam eksportui vidiniuose nustatymuose įjunkite Redis.
Projektas skelbia Android ir iOS programėles bei wallabagger plėtinį, skirtą Firefox ir Chrome, kurie prie jūsų egzemplioriaus jungiasi jo adresu, be pasvirojo brūkšnio gale. iOS ir wallabagger reikia API kliento, sukurto skiltyje API clients management.
Atvaizdas skaito antraštę X-Forwarded-Proto, kad žinotų, jog užklausa ateina per HTTPS. Nustatykite tarpinį serverį siųsti ją su reikšme https, kartu su jūsų domeno antrašte Host, ir į SYMFONY__ENV__DOMAIN_NAME įrašykite adresą su https://.
Nukopijuokite tris elementus: duomenų bazę, MariaDB atveju su mariadb-dump, paveikslėlių tomą, prijungtą prie web/assets/images, ir savo compose.yaml, kuriame yra nustatymai ir slaptos reikšmės. Siųskite šias kopijas už serverio ribų.
Managed VPS apima serverį: sistemą, saugumą, stebėseną ir atsargines kopijas. Mūsų komandos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs. Įsikišimas į pačią programą apmokestinamas valandomis arba fiksuota kaina.
Simafri
Pakalbėkime apie jūsų sumanymą
Pasakykite mums keliais žodžiais, ko jums reikia: greitai jums atsakome.
Ačiū! Jūsų užklausa išsiųsta. Netrukus su jumis susisieksime.
Labiau mėgstate el. paštą? Rašykite mums adresu support@simafri.com.