Mitināt wallabag Managed VPS serverī nozīmē, ka raksti, ko saglabājat lasīšanai vēlāk, paliek uz jūsu pašu mašīnas, ko mūsu komandas uztur atjauninātu un uzrauga dienu un nakti. wallabag ir brīva atvērtā koda lietotne rakstu lasīšanai vēlāk ar MIT licenci. Šis ceļvedis seko tās oficiālajai dokumentācijai un Docker attēlam, versijā 2.6.17: uzstādīšana ar Docker Compose, pirmais konts un slepenās vērtības, HTTPS, lietotnes un pārlūka paplašinājumi, imports no Pocket un citiem pakalpojumiem, e-pasts, rezerves kopijas un atjauninājumi.
Autors: Simon Vasconcelos Lee
Publicēts 2026. gada 18. novembrīLasīšanas laiks: 14 minūtes
wallabag/wallabag, MariaDB, Redis un tīmekļa ports, publicēts uz 127.0.0.1 aiz HTTPS reversā starpniekservera.SYMFONY__ENV__SECRET un savu publisko adresi mainīgajā SYMFONY__ENV__DOMAIN_NAME; pēc tam nomainiet konta wallabag paroli, kas ir wallabag.X-Forwarded-Proto: https: tā wallabag zina, ka apmeklētāji ierodas pa HTTPS.compose.yaml, bet atjauniniet, nomainot attēla birku un palaižot migrācijas.wallabag ir tīmekļa lietotne rakstu lasīšanai vēlāk: ar vienu klikšķi saglabājat lapu un izlasāt to, kad jums ir laiks. Tās README to apkopo šādi: noklikšķiniet, saglabājiet, lasiet, kad vēlaties. wallabag izgūst raksta saturu, tāpēc jūs nenovērš sākotnējās lapas uznirstošie logi.
wallabag tiek publicēts ar MIT licenci, autortiesības kopš 2013. gada pieder Nicolas Lœuillet. Tā bez maksas piešķir tiesības izmantot, kopēt, mainīt, apvienot, publicēt, izplatīt, piešķirt apakšlicences un pārdot programmatūras kopijas. Tāpēc varat to darbināt sev, savai komandai vai saviem klientiem, nepērkot nekādu licenci.
Vienīgais nosacījums ir saglabāt autortiesību paziņojumu un licences tekstu visās programmatūras kopijās vai būtiskās tās daļās. Teksts programmatūru nodrošina «tādu, kāda tā ir», bez garantijas.
wallabag dokumentācija nenorāda skaitli atmiņai vai procesoram. Tā tomēr uzskaita, kas lietotnei vajadzīgs, un Docker attēls iestata dažas vērtības, kas palīdz noteikt izmēru:
memory_limit uz 256 MB, un mainīgais PHP_MEMORY_LIMIT šo vērtību maina.Tāpēc servera izmērs ir atkarīgs no lietotāju skaita, rakstu apjoma un jūsu importiem. Ar Managed VPS pastāstiet mums, kā to izmantojat, un mēs ieteiksim piemērotu izmēru.
Repozitorijs wallabag/docker publicē oficiālo attēlu wallabag/wallabag vietnēs Docker Hub un GitHub Container Registry, kopā ar Compose faila piemēru: wallabag, MariaDB datubāze un Redis. Serverī ar uzstādītu Docker izveidojiet mapi un ievietojiet tajā šo compose.yaml, kas balstīts uz minēto piemēru:
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:
Pirms pirmās palaišanas nomainiet trīs slepenās vērtības. Heksadecimālas virknes der visur, arī SQL komandās, ko attēls raksta, lai izveidotu datubāzi:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: repozitorija piemērs publicē konteinera portu 80 bez adreses, un tad Docker to atver visās servera adresēs. Publicēts lokāli, tas ir sasniedzams tikai caur reverso starpniekserveri.MYSQL_ROOT_PASSWORD attēls izveido datubāzi un tās lietotāju, pēc tam palaiž wallabag:install, kas izveido tabulas un kontu wallabag. Beigas iezīmē žurnāla rinda wallabag is ready!.wallabag; pakalpojums db to patur.wallabag-db glabā datubāzi, wallabag-images rakstu attēlus. Arī uzstādīšanas dokumentācijas piemērā izmantoti nosaukti sējumi.redis.2.6.17, 2.6, 2 un latest. Pilna versija ļauj izvēlēties, kad notiek katrs atjauninājums.Lai pārbaudītu, vai lietotne atbild, vaicājiet maršrutu, ko izmanto attēla veselības pārbaude:
curl http://127.0.0.1:8080/api/info
Attēls mainīgos SYMFONY__ENV__* nolasa no jauna katrā konteinera palaišanā un iztīra kešatmiņu. Pēc compose.yaml izmaiņām komanda docker compose up -d no jauna izveido konteineru un piemēro jaunos iestatījumus.
/var/www/wallabag/data/db/wallabag.sqlite; šādā gadījumā piemontējiet sējumu uz /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, ports 5432, kā arī POSTGRES_USER un POSTGRES_PASSWORD, lai attēls izveidotu datubāzi. Attēla versija 2.6.15 izlabo datubāzes īpašumtiesības ar PostgreSQL 15 un jaunākām versijām.POPULATE_DATABASE=False, pēc tam vienreiz to inicializējiet ar docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. README lūdz šo komandu izpildīt kā nobody, lai neviens fails nenonāktu root īpašumā.Dokumentācijas ieteiktais ceļš atsevišķā serverī ir Git repozitorijs un tā Makefile, ar Composer, rīku make un PHP paplašinājumiem no prasību lapas:
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install
Pēc tam tīmekļa serveris pasniedz mapi web, ar app.php kā ieejas punktu: virtuālo resursdatoru lapā sniegtas Nginx, Apache, Caddy un lighttpd konfigurācijas. Tās piemēri pasniedz wallabag domēna vai apakšdomēna saknē, un šo iestatījumu atbalsta projekta uzturētāji.
Uzstādīšana izveido administratora kontu, kura lietotājvārds un parole abi ir wallabag, ar adresi wallabag@wallabag.io. Nomainiet tos, pirms atverat instanci publikai. SSH tunelis atved servera portu 8080 uz jūsu datoru, adresē http://localhost:8080; pievienojiet -p un SSH portu, kas norādīts jūsu klienta zonā.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag un wallabag.| Mainīgais | Noklusējuma vērtība | Ko tas dara |
|---|---|---|
SYMFONY__ENV__SECRET | Publiska virkne, vienāda visām instancēm | Pievieno entropiju drošības darbībām: dokumentācija vēlas, lai tā būtu unikāla jūsu instancei |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Pilna jūsu instances adrese, bez slīpsvītras beigās |
SYMFONY__ENV__FOSUSER_REGISTRATION | false Docker attēlā | Atver vai aizver publisko reģistrāciju |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Katrai reģistrācijai sūta apstiprinājuma e-pastu |
SYMFONY__ENV__LOCALE | en | Instances noklusējuma valoda, piemēram, fr |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Instances nosaukums, kas redzams jūsu divu faktoru lietotnē |
Tātad ar Docker attēlu publiskā reģistrācija ir aizvērta. Lai atvērtu instanci savai komandai, izveidojiet kontus paši sadaļā «Users management» vai atveriet reģistrāciju uz laiku, kamēr cilvēki reģistrējas, ar apstiprinājumu pa e-pastu.
Jutīgākie iestatījumi atrodas sadaļā «Internal Settings», kas paredzēta instances administratoram: rakstu publiska kopīgošana, eksporta formāti, pieteikšanās maksas piekļuves vietnēs, attēlu lejupielāde serverī un fona importi.
Konteiners pasniedz wallabag pa HTTP, savā portā 80, ar iekšēja Nginx starpniecību. Par HTTPS rūpējas reversais starpniekserveris, kas atrodas tā priekšā. Šis iekšējais Nginx nolasa galveni X-Forwarded-Proto: kad tā ir https, tas paziņo PHP, ka pieprasījums ir šifrēts, un wallabag atbilstoši veido savas saites un sīkfailus.
X-Forwarded-Proto: starpniekserverim tā jāsūta ar vērtību https.Host: jūsu domēna vārds, lai lietotnes pāradresācijas vestu uz to.Caddy pats iegūst Let’s Encrypt sertifikātu un to atjauno. Tā direktīva reverse_proxy saglabā galveni Host un pēc noklusējuma pievieno X-Forwarded-For, X-Forwarded-Proto un X-Forwarded-Host:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
Šis bloks izmanto galvenes no Nginx piemēra Docker attēla README, pievieno galveni Host un attēla augšupielādes ierobežojumu un klausās portā 80, lai Certbot varētu iestatīt 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
Pēc tam pārbaudiet, vai mainīgajā SYMFONY__ENV__DOMAIN_NAME ir adrese ar https://, tāda pati kā jūsu starpniekserverim.
wallabag darbojas pārlūkā, un projekts publicē arī lietotnes un paplašinājumu, kas savienojas ar jūsu instanci pēc tās adreses, bez slīpsvītras beigās.
| Rīks | Ko tas dara | Kas tam vajadzīgs |
|---|---|---|
| Android lietotne | Sinhronizē jūsu rakstu sarakstus un rāda tos tālrunī | Instances adrese, jūsu lietotājvārds un parole; plūsmu piekļuves datus lietotne iegūst pati |
| iOS lietotne | Rāda jūsu rakstus iPhone un iPad ierīcēs | Adrese, API klienta ID un slepenā vērtība, jūsu lietotājvārds un parole |
| Paplašinājums wallabagger, pārlūkiem Firefox un Chrome | Saglabā atvērto lapu ar tās birkām, atzīmētu ar zvaigznīti vai arhivētu | Adrese, API klienta ID un slepenā vērtība, jūsu lietotājvārds un parole |
| Grāmatzīmes skripts «bag it!» | Saglabā atvērto lapu no grāmatzīmju joslas | Neko: to ievelk no lapas «Howto» |
Izvēlne «Import» ienes jūsu rakstus no cita pakalpojuma. wallabag no jauna ielādē katra raksta saturu, tāpēc lielam eksportam vajadzīgs laiks. Importētāji versijā 2.6.17:
| Pakalpojums | Iesniedzamais fails |
|---|---|
| Pocket, CSV eksports | Atarhivēts Pocket eksporta ZIP: CSV fails ar nosaukumu, līdzīgu part_000000.csv |
| Pocket, HTML eksports | Pocket vecākā eksporta HTML fails, piemēram, ril_export.html |
| Instapaper | CSV fails no Instapaper iestatījumu lapas |
| Omnivore | Atarhivētā eksporta faili metadata_x_to_y.json, pa vienam |
| Pinboard, Delicious | To JSON eksports |
| Shaarli | Tā HTML eksports |
| Firefox, Chrome | Firefox grāmatzīmju JSON rezerves kopija vai Chrome fails Bookmarks |
| Readability, elCurator | To eksports |
| wallabag 1.x vai 2.x | Citas instances JSON eksports |
Versija 2.6.17 ienes arī labojumu Pocket CSV importam. Pastāv arī imports caur Pocket API, ar izstrādātāja atslēgu, ko administrators norāda konfigurācijā.
Lai liels imports neaizturētu lapu, wallabag to nodod Redis, ko iepriekš dotais compose.yaml jau nodrošina:
1.pocket_csv; tas apstrādā rindu un pēc tam turpina klausīties, līdz to apturat.docker compose run --rm wallabag import pocket_csv
Pārējie veidi ir pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox un chrome.
wallabag sūta e-pastus reģistrācijas apstiprināšanai, paroles atiestatīšanai un divu faktoru kodiem pa e-pastu. Tos sūta caur serveri, kas aprakstīts mainīgajā SYMFONY__ENV__MAILER_DSN, un tā noklusējuma vērtība ir smtp://127.0.0.1.
Simafri VPS serverī konfigurējiet SMTP serveri ar autentifikāciju, portā 587 vai 465: jūsu domēna pasta pakalpojumu vai sūtīšanas pakalpojumu. Dokumentācija sniedz vienas rindas formātu ar lietotāju, paroli, serveri un portu:
- 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
@ kļūst par %40. Ja kodēta rakstzīme aptur palaišanu, dokumentācija iesaka procentu zīmi dubultot: %%40.FROM_EMAIL ir visu wallabag e-pastu sūtītājs, TWOFACTOR_SENDER ir divu faktoru kodu sūtītājs. Izmantojiet sava domēna adresi, no kuras jūsu SMTP serveris pieņem sūtīšanu.:465 rindas beigās.Pēc tam no jauna izveidojiet konteineru ar docker compose up -d un pārbaudiet ar saiti «Forgot your password?» pieteikšanās lapā.
Dokumentācijas rezerves kopiju lapā nosaukti trīs elementi: iestatījumi, datubāze un attēli. Ar Docker attēlu katrs no tiem atrodas šeit:
| Elements | Kur tas atrodas | Kā to nokopēt |
|---|---|---|
| Iestatījumi | Jūsu compose.yaml: attēls no tā katrā palaišanā izveido parameters.yml | Faila kopija, glabāta drošā vietā, jo tajā ir jūsu slepenās vērtības |
| Datubāze | Sējums wallabag-db | Eksports ar mariadb-dump |
| Attēli | Sējums wallabag-images, piemontēts uz web/assets/images | Mapes arhīvs |
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
Ieplānojiet šīs kopijas un sūtiet tās ārpus servera. Glabāti tā diskā, šie arhīvi tiek iekļauti arī tā nakts rezerves kopijās. Ar SQLite dokumentācija lūdz kopēt mapi data/db.
Jaunā uzstādījumā palaidiet steku ar to pašu compose.yaml, pēc tam ielādējiet atpakaļ datubāzi un attēlus:
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
Katrs lietotājs var arī eksportēt savus rakstus JSON formātā no saraksta «All entries» un importēt tos atkal citā instancē ar wallabag 2.x importētāju. Administratoriem komanda wallabag:export eksportē lietotāja rakstus failā.
Ar Docker nomainiet attēla birku failā compose.yaml, izveidojiet rezerves kopiju, pēc tam lejupielādējiet jauno attēlu un no jauna izveidojiet konteineru. Pēc tam README lūdz palaist datubāzes migrācijas, ja versija tās ienes:
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, un versijas piezīmes lūdz iztukšot veco mapi web/uploads/import. Šajā compose.yaml šī mape atrodas konteinera iekšienē: konteiners, kas izveidots no jaunā attēla, sāk bez tās.make update, kas instancēs ar 2.6.15 vai vecāku versiju izvēlējās tajā rītā publicētu alfa versiju. Iestrēgušai Git instalācijai versijas piezīmes sniedz labojumu: git checkout 2.6.17 --force, pēc tam make update.make update, kas arī palaiž migrācijas un iztīra kešatmiņu.Pirms atjaunināšanas izlasiet katras versijas piezīmes: tajās norādīti konkrētajai versijai raksturīgie soļi, piemēram, versijā 2.6.16 iztukšojamā mape.
Mitināšana savā serverī prasa uzturēt serveri papildus lietojumprogrammai. Ar Managed VPS mūsu komandas uzņemas serveri un proaktīvi seko jūsu instancei; wallabag paliek jūsu programmatūra ar saviem iestatījumiem un jūsu rakstiem.
| Temats | Mūsu komandas | Jūs |
|---|---|---|
| Serveris | Sistēmas un drošības atjauninājumi, ieskaitot iejaukšanos serverī | Brīdis, kas der jūsu darbam |
| Uzraudzība | Serveris tiek uzraudzīts 24/7, iejaucoties, negaidot jūsu zvanu | Jūsu instances žurnālu lasīšana |
| wallabag | Proaktīva sekošana: kļūdas, palēninājumi, datubāze un diska vieta tiek pamanīti, labojums tiek ieteikts | Tā uzstādīšana, atjauninājumi un iestatījumi, ko ieviešat jūs vai jūsu MI asistents |
| Konti un raksti | Serveris, kas tos nes, uzraudzīts un ar rezerves kopijām | Lietotāji, reģistrācija, API klienti un importi |
| Rezerves kopijas | Katru nakti, šifrētas un glabātas ārpus mašīnas; atjaunošana iekļauta | Paša wallabag eksporti un atjaunošanas pieprasījums, kad tas vajadzīgs |
| Migrācija | Jūsu pašreizējā servera migrācija, bez maksas | Pārslēgšanās brīdis |
Ja vēlaties, lai mūsu komandas iejaucas pašā lietojumprogrammā, šis pakalpojums tiek rēķināts par stundu vai par fiksētu summu, ar novērtējumu, kas paziņots pirms iejaukšanās.
Ar Simafri Managed VPS mūsu komandas uztur jūsu wallabag instances serveri atjauninātu, uzrauga to dienu un nakti un iejaucas, negaidot jūsu zvanu; tās arī proaktīvi seko jūsu instancei un iesaka noderīgus labojumus, ko ieviešat jūs paši vai jūsu MI asistents. Rezerves kopijas katru nakti tiek šifrētas un glabātas ārpus mašīnas, to atjaunošana ir iekļauta, un jūsu pašreizējā servera migrācija ir bez maksas.
Jā. wallabag ir ar MIT licenci: varat to izmantot, mainīt un izplatīt tālāk, gan darbā, gan citur, nepērkot nekādu licenci, ja vien saglabājat tās autortiesību paziņojumu. Paliek tikai servera izmaksas, uz kura tas darbojas.
Sāciet ar attēla wallabag/wallabag compose.yaml piemēru, ar MariaDB un Redis. Iestatiet SYMFONY__ENV__SECRET, paroles un savu adresi mainīgajā SYMFONY__ENV__DOMAIN_NAME, publicējiet portu uz 127.0.0.1, pēc tam palaidiet docker compose up -d un novietojiet priekšā HTTPS reverso starpniekserveri.
Uzstādīšana izveido administratoru, kura lietotājvārds un parole abi ir wallabag. Pirms atverat instanci publikai, nomainiet paroli sadaļā Config, cilnē Password, un e-pasta adresi cilnē User information.
Atarhivējiet Pocket eksporta ZIP: tajā ir CSV fails, piemēram, part_000000.csv. Izvēlnē Import izvēlieties Pocket CSV un augšupielādējiet šo failu. Tad wallabag ielādē katra raksta saturu; lielam eksportam ieslēdziet Redis iekšējos iestatījumos.
Projekts publicē Android un iOS lietotnes un paplašinājumu wallabagger pārlūkiem Firefox un Chrome, kas savienojas ar jūsu instanci pēc tās adreses, bez slīpsvītras beigās. iOS un wallabagger vajag API klientu, ko izveido sadaļā API clients management.
Attēls nolasa galveni X-Forwarded-Proto, lai zinātu, ka pieprasījums nāk pa HTTPS. Iestatiet starpniekserveri to sūtīt ar vērtību https, kopā ar jūsu domēna galveni Host, un ierakstiet adresi ar https:// mainīgajā SYMFONY__ENV__DOMAIN_NAME.
Nokopējiet trīs elementus: datubāzi, MariaDB gadījumā ar mariadb-dump, attēlu sējumu, kas piemontēts uz web/assets/images, un savu compose.yaml, kurā ir iestatījumi un slepenās vērtības. Sūtiet šīs kopijas ārpus servera.
Managed VPS aptver serveri: sistēmu, drošību, uzraudzību un rezerves kopijas. Mūsu komandas proaktīvi seko arī jūsu instancei un iesaka noderīgus labojumus, ko ieviešat jūs. Iejaukšanās lietojumprogrammā tiek rēķināta par stundu vai par fiksētu summu.
Simafri
Parunāsim par jūsu ieceri
Pasakiet mums dažos vārdos, kas jums vajadzīgs: mēs jums ātri atbildam.
Paldies! Jūsu pieprasījums ir nosūtīts. Drīzumā ar jums sazināsimies.
Labāk e-pastu? Rakstiet mums uz support@simafri.com.