A wallabag hosztolása Managed VPS-en azt jelenti, hogy a későbbre félretett cikkei egy saját gépen maradnak, amelyet csapataink naprakészen tartanak, és éjjel-nappal felügyelnek. A wallabag MIT licenc alatt álló, szabad és nyílt forráskódú „olvasd el később” alkalmazás. Ez az útmutató a hivatalos dokumentációját és hivatalos Docker-képét követi, a 2.6.17-es verzióban: a telepítést Docker Compose-zal, az első fiókot és a titkos értékeket, a HTTPS-t, az alkalmazásokat és a böngészőbővítményeket, az importálást a Pocketből és más szolgáltatásokból, az e-mailt, a mentéseket és a frissítéseket.
Szerző: Simon Vasconcelos Lee
Közzétéve 2026. november 18-ánOlvasási idő: 15 perc
wallabag/wallabag kép, MariaDB, Redis, és a webport a 127.0.0.1 címen közzétéve, egy HTTPS-es fordított proxy mögött.SYMFONY__ENV__SECRET értékét és a nyilvános címét a SYMFONY__ENV__DOMAIN_NAME változóban; ezután módosítsa a wallabag fiók jelszavát, amely wallabag.X-Forwarded-Proto: https fejlécet: ebből tudja a wallabag, hogy a látogatói HTTPS-en érkeznek.compose.yaml fájlját, a frissítéshez pedig módosítsa a kép címkéjét, és futtassa a migrációkat.A wallabag egy „olvasd el később” webalkalmazás: egy kattintással elment egy oldalt, és akkor olvassa el, amikor ideje engedi. A README így foglalja össze: kattintson, mentse, olvassa el, amikor szeretné. A wallabag kinyeri a cikk tartalmát, így az eredeti oldal felugró ablakai nem vonják el a figyelmét.
A wallabag az MIT licenc alatt jelenik meg, a szerzői jog 2013 óta Nicolas Lœuilleté. Ez ingyenesen biztosítja a szoftver használatának, másolásának, módosításának, egyesítésének, közzétételének, terjesztésének, allicencbe adásának és másolatai értékesítésének jogát. Futtathatja tehát saját magának, a csapatának vagy az ügyfeleinek, licenc vásárlása nélkül.
Az egyetlen feltétel a szerzői jogi megjegyzés és a licenc szövegének megtartása a szoftver minden másolatában vagy lényeges részében. A szöveg a szoftvert „ahogy van” állapotban, garancia nélkül adja.
A wallabag dokumentációja nem ad meg számot a memóriára vagy a processzorra. Felsorolja viszont, mire van szüksége az alkalmazásnak, a Docker-kép pedig beállít néhány értéket, amely segít a méretezésben:
memory_limit értékét, és ezt a PHP_MEMORY_LIMIT változó módosítja.A szerver mérete tehát a felhasználók számától, a cikkek mennyiségétől és az importálásaitól függ. Egy Managed VPS esetén írja le nekünk, hogyan használja, és mi azt a méretet javasoljuk, amely megfelel.
A wallabag/docker tároló teszi közzé a hivatalos wallabag/wallabag képet a Docker Hubon és a GitHub Container Registryben, egy példa Compose-fájllal együtt: wallabag, egy MariaDB-adatbázis és Redis. Egy olyan szerveren, amelyen telepítve van a Docker, hozzon létre egy mappát, és tegye bele ezt a compose.yaml fájlt, amely ezen a példán alapul:
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:
Az első indítás előtt cserélje le a három titkos értéket. A hexadecimális karakterláncok mindenhol működnek, azokban az SQL-parancsokban is, amelyeket a kép az adatbázis létrehozásához ír:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1 címen közzétéve: a tároló példája cím nélkül teszi közzé a konténer 80-as portját, a Docker pedig ilyenkor a szerver minden címén megnyitja. Helyileg közzétéve csak a fordított proxyn keresztül érhető el.MYSQL_ROOT_PASSWORD birtokában a kép létrehozza az adatbázist és a felhasználóját, majd lefuttatja a wallabag:install parancsot, amely létrehozza a táblákat és a wallabag fiókot. A naplóban megjelenő wallabag is ready! sor jelzi a végét.wallabag szolgáltatásból; a db szolgáltatás megtartja.wallabag-db az adatbázist, a wallabag-images a cikkek képeit őrzi. A telepítési dokumentáció példája is elnevezett köteteket használ.redis néven keresi.2.6.17, 2.6, 2 és latest. A teljes verziószám lehetővé teszi, hogy Ön válassza meg az egyes frissítések időpontját.Annak ellenőrzéséhez, hogy az alkalmazás válaszol, kérdezze le azt az útvonalat, amelyet a kép állapotellenőrzése használ:
curl http://127.0.0.1:8080/api/info
A kép a konténer minden indításakor újraolvassa a SYMFONY__ENV__* változókat, és üríti a gyorsítótárat. A compose.yaml módosítása után a docker compose up -d újra létrehozza a konténert, és alkalmazza az új beállításokat.
/var/www/wallabag/data/db/wallabag.sqlite helyen; ebben az esetben csatoljon kötetet a /var/www/wallabag/data útvonalra.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, az 5432-es port, valamint POSTGRES_USER és POSTGRES_PASSWORD, hogy a kép létrehozza az adatbázist. A kép 2.6.15-ös verziója javítja az adatbázis tulajdonjogát PostgreSQL 15 és újabb esetén.POPULATE_DATABASE=False értéket, majd egyszer inicializálja a docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n paranccsal. A README azt kéri, hogy ezt a parancsot nobody felhasználóként futtassa, hogy egyetlen fájl se kerüljön a root tulajdonába.A dokumentáció által dedikált szerverre ajánlott út a Git-tároló és annak Makefile fájlja, a Composerrel, a make eszközzel és a követelményoldalon felsorolt PHP-bővítményekkel:
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install
A webszerver ezután a web mappát szolgálja ki, belépési pontként az app.php fájllal: a virtuális hosztokról szóló oldal Nginx-, Apache-, Caddy- és lighttpd-konfigurációkat ad. Példái a wallabaget egy domain vagy aldomain gyökerében szolgálják ki, ez az a felállás, amelyet a karbantartók támogatnak.
A telepítés létrehoz egy adminisztrátori fiókot, amelynek felhasználóneve és jelszava egyaránt wallabag, a wallabag@wallabag.io címmel. Módosítsa őket, mielőtt a példányt megnyitja a nyilvánosság előtt. Egy SSH-alagút a szerver 8080-as portját a számítógépére hozza, a http://localhost:8080 címre; adja hozzá a -p kapcsolót és az ügyfélterületén feltüntetett SSH-portot.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag és wallabag adatokkal.| Változó | Alapértelmezett érték | Mire szolgál |
|---|---|---|
SYMFONY__ENV__SECRET | Nyilvános karakterlánc, minden példánynál ugyanaz | Entrópiát ad a biztonsági műveletekhez: a dokumentáció azt kéri, hogy az Ön példányára egyedi legyen |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | A példánya teljes címe, záró perjel nélkül |
SYMFONY__ENV__FOSUSER_REGISTRATION | false a Docker-képben | Megnyitja vagy lezárja a nyilvános regisztrációt |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Minden regisztrációhoz megerősítő e-mailt küld |
SYMFONY__ENV__LOCALE | en | A példány alapértelmezett nyelve, például fr |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | A kétlépcsős azonosítás alkalmazásában megjelenő példánynév |
A nyilvános regisztráció tehát a Docker-képben le van zárva. Ha a csapata számára szeretné megnyitni a példányt, hozza létre saját maga a fiókokat a „Users management” menüben, vagy nyissa meg a regisztrációt arra az időre, amíg a kollégák feliratkoznak, e-mailes megerősítéssel.
Az érzékenyebb beállítások az „Internal Settings” alatt találhatók, amely a példány adminisztrátorának van fenntartva: a cikkek nyilvános megosztása, az exportformátumok, a bejelentkezés fizetős oldalakra, a képek helyi letöltése és a háttérben zajló importálások.
A konténer HTTP-n, a saját 80-as portján, egy belső Nginxen keresztül szolgálja ki a wallabaget. A HTTPS-t az előtte álló fordított proxy kezeli. Ez a belső Nginx olvassa az X-Forwarded-Proto fejlécet: ha ennek értéke https, jelzi a PHP-nak, hogy a kérés titkosított, a wallabag pedig ennek megfelelően állítja elő a hivatkozásait és a sütijeit.
X-Forwarded-Proto fejléc: a proxynak https értékkel kell küldenie.Host fejléc: az Ön domainneve, hogy az alkalmazás átirányításai erre mutassanak.A Caddy maga szerzi be és újítja meg a Let’s Encrypt-tanúsítványt. A reverse_proxy direktívája alapértelmezésként megtartja a Host fejlécet, és hozzáadja az X-Forwarded-For, X-Forwarded-Proto és X-Forwarded-Host fejléceket:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
Ez a blok a Docker-kép README-jében szereplő Nginx-példa fejléceit használja, hozzáadja a Host fejlécet és a kép feltöltési korlátját, és a 80-as porton figyel, hogy a Certbot beállíthassa a HTTPS-t:
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
Ezután ellenőrizze, hogy a SYMFONY__ENV__DOMAIN_NAME a https:// címet tartalmazza, ugyanazt, mint a proxyja.
A wallabag a böngészőben működik, a projekt pedig alkalmazásokat és egy bővítményt is közzétesz, amelyek a címével, záró perjel nélkül kapcsolódnak a példányához.
| Eszköz | Mire szolgál | Mire van szüksége |
|---|---|---|
| Androidos alkalmazás | Szinkronizálja a cikklistáit, és megjeleníti őket a telefonján | A példány címe, a felhasználóneve és a jelszava; a hírcsatornák hozzáférési adatait az alkalmazás magától lekéri |
| iOS-es alkalmazás | Megjeleníti a cikkeit iPhone-on és iPaden | A cím, egy API-kliens azonosítója és titkos kulcsa, a felhasználóneve és a jelszava |
| wallabagger bővítmény, Firefoxhoz és Chrome-hoz | Elmenti a megnyitott oldalt, címkékkel, csillagozva vagy archiválva | A cím, egy API-kliens azonosítója és titkos kulcsa, a felhasználóneve és a jelszava |
| „bag it!” könyvjelző | Elmenti a megnyitott oldalt a könyvjelzősávról | Semmi: a „Howto” oldalról húzza át |
Az „Import” menü egy másik szolgáltatásból hozza át a cikkeit. A wallabag minden cikk tartalmát újra letölti, ami egy nagy exportnál időbe telik. A 2.6.17-es verzió importálói:
| Szolgáltatás | A megadandó fájl |
|---|---|
| Pocket, CSV-export | A Pocket exportjának ZIP-fájlja kibontás után: egy CSV-fájl, például part_000000.csv néven |
| Pocket, HTML-export | A Pocket régebbi exportjának HTML-fájlja, például ril_export.html |
| Instapaper | Az Instapaper beállítási oldaláról letöltött CSV |
| Omnivore | A kibontott export metadata_x_to_y.json fájljai, egyenként |
| Pinboard, Delicious | A JSON-exportjuk |
| Shaarli | A HTML-exportja |
| Firefox, Chrome | A Firefox JSON formátumú könyvjelzőmentése vagy a Chrome Bookmarks fájlja |
| Readability, elCurator | Az exportjuk |
| wallabag 1.x vagy 2.x | Egy másik példány JSON-exportja |
A 2.6.17-es verzió a Pocket CSV-importálásának javítását is hozza. A Pocket API-ján keresztüli importálás is létezik, egy fejlesztői kulccsal, amelyet az adminisztrátor a konfigurációban állít be.
Hogy egy nagy importálás ne tartsa fel az oldalt, a wallabag a Redisnek adja át, amelyet a fenti compose.yaml már tartalmaz:
1 értékkel.pocket_csv; ez feldolgozza a sort, majd tovább figyel, amíg le nem állítja.docker compose run --rm wallabag import pocket_csv
A többi típus: pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox és chrome.
A wallabag e-mailt küld a regisztráció megerősítéséhez, a jelszó visszaállításához és az e-mailben küldött kétlépcsős kódokhoz. Ezeket a SYMFONY__ENV__MAILER_DSN változóban leírt szerveren keresztül küldi, amelynek alapértéke smtp://127.0.0.1.
Simafri VPS-en állítson be egy hitelesítést igénylő SMTP-szervert az 587-es vagy a 465-ös porton: a domainje levelezési szolgáltatását vagy egy levélküldő szolgáltatást. A dokumentáció egysoros formátumot ad, felhasználóval, jelszóval, szerverrel és porttal:
- 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
@ helyett %40 áll. Ha egy kódolt karakter megakasztja az indítást, a dokumentáció a százalékjel megduplázását javasolja: %%40.FROM_EMAIL a wallabag összes e-mailjének feladója, a TWOFACTOR_SENDER a kétlépcsős kódok feladója. Használjon a domainjén egy olyan címet, amelyről az SMTP-szervere engedi a küldést.:465 értékkel.Ezután hozza létre újra a konténert a docker compose up -d paranccsal, és próbálja ki a bejelentkezési oldal „Forgot your password?” hivatkozásával.
A dokumentáció mentésekről szóló oldala három elemet nevez meg: a beállításokat, az adatbázist és a képeket. A Docker-képpel mindegyik itt található:
| Elem | Hol található | Hogyan másolható |
|---|---|---|
| A beállítások | Az Ön compose.yaml fájlja: a kép minden indításkor ebből állítja elő a parameters.yml fájlt | A fájl másolata, biztonságos helyen tartva, mert a titkos értékeit tartalmazza |
| Az adatbázis | A wallabag-db kötet | Export a mariadb-dump eszközzel |
| A képek | A wallabag-images kötet, a web/assets/images útvonalra csatolva | A mappa archívuma |
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
Ütemezze ezeket a másolatokat, és küldje őket a szerveren kívülre. A szerver lemezére téve ezek az archívumok a szerver éjszakai mentéseibe is bekerülnek. SQLite esetén a dokumentáció a data/db mappa másolását kéri.
Egy új telepítésen indítsa el a stacket ugyanazzal a compose.yaml fájllal, majd töltse vissza az adatbázist és a képeket:
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
Minden felhasználó JSON-ba is exportálhatja a cikkeit az „All entries” listából, és a wallabag 2.x importálóval újra importálhatja őket egy másik példányba. Az adminisztrátorok számára a wallabag:export parancs egy felhasználó cikkeit fájlba exportálja.
Dockerrel módosítsa a kép címkéjét a compose.yaml fájlban, készítsen mentést, majd töltse le az új képet, és hozza létre újra a konténert. A README ezután az adatbázis-migrációk futtatását kéri, ha egy kiadás ilyeneket hoz:
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 mappába kerülnek, a kiadási megjegyzések pedig a régi web/uploads/import mappa kiürítését kérik. Ebben a compose.yaml fájlban ez a mappa a konténeren belül van: az új képből létrehozott konténer nélküle indul.make update parancsot javítja, amely a 2.6.15-ös vagy régebbi példányokon egy aznap reggel közzétett alfa kiadást választott. Az elakadt Git-telepítéshez a kiadási megjegyzések megadják a javítást: git checkout 2.6.17 --force, majd make update.make update paranccsal történik, amely a migrációkat is lefuttatja, és üríti a gyorsítótárat.Frissítés előtt olvassa el minden verzió kiadási megjegyzéseit: ezek jelzik az adott verzióra jellemző lépéseket, például a 2.6.16-ban kiürítendő mappát.
A saját üzemeltetés az alkalmazás mellett a szerver gondozását is megköveteli. Egy Managed VPS esetén csapataink átveszik a szervert, és proaktívan követik a példányát; a wallabag továbbra is az Ön szoftvere marad, a beállításaival és az Ön cikkeivel.
| Téma | Csapataink | Ön |
|---|---|---|
| A szerver | Rendszer- és biztonsági frissítések, a szerveren végzett beavatkozásokkal együtt | A tevékenységének megfelelő időpont |
| A felügyelet | Éjjel-nappal, a hét minden napján követett szerver, beavatkozás a hívására való várakozás nélkül | A példánya naplóinak olvasása |
| wallabag | Proaktív követés: a hibák, lassulások, az adatbázis és a lemezterület észlelése, javítás ajánlása | A telepítése, a frissítései és a beállításai, amelyeket Ön vagy MI-asszisztense alkalmaz |
| A fiókok és a cikkek | A szerver, amely hordozza őket, felügyelve és mentve | A felhasználók, a regisztráció, az API-kliensek és az importálások |
| A mentések | Minden éjjel, titkosítva és a gépen kívül őrizve; a visszaállítással együtt | A wallabag saját exportjai, és a visszaállítási kérés, amikor szüksége van rá |
| Az átköltöztetés | A jelenlegi szervere átköltöztetve, ingyenesen | Az átállás időpontja |
Ha inkább azt szeretné, hogy csapataink magában az alkalmazásban avatkozzanak be, ez a szolgáltatás óradíjban vagy átalánydíjban számlázódik, a beavatkozás előtt közölt árajánlattal.
Egy Simafri Managed VPS esetében csapataink naprakészen tartják wallabag-példánya szerverét, éjjel-nappal felügyelik, és beavatkoznak anélkül, hogy a hívására várnának; proaktívan a példányát is követik, és javasolják a hasznos javításokat, amelyeket Ön vagy MI-asszisztense alkalmaz. A mentések minden éjjel titkosítva, a gépen kívül készülnek, a visszaállításuk a díj része, jelenlegi szervere átköltöztetése pedig ingyenes.
Igen. A wallabag MIT licenc alatt áll: használhatja, módosíthatja és továbbterjesztheti, a munkahelyén vagy bárhol máshol, licenc vásárlása nélkül, ha megtartja a szerzői jogi megjegyzését. Csak az azt futtató szerver költsége marad.
Induljon ki a wallabag/wallabag kép példa compose.yaml fájljából, MariaDB-vel és Redisszel. Állítsa be a SYMFONY__ENV__SECRET értékét, a jelszavakat és a címét a SYMFONY__ENV__DOMAIN_NAME változóban, tegye közzé a portot a 127.0.0.1 címen, majd futtassa a docker compose up -d parancsot, és helyezzen elé egy HTTPS-es fordított proxyt.
A telepítés létrehoz egy adminisztrátort, amelynek felhasználóneve és jelszava egyaránt wallabag. Módosítsa a jelszót a Config menü Password lapján, az e-mail-címet pedig a User information lapon, mielőtt a példányt megnyitja a nyilvánosság előtt.
Bontsa ki a Pocket exportjának ZIP-fájlját: egy CSV-fájlt tartalmaz, például part_000000.csv néven. Az Import menüben válassza a Pocket CSV lehetőséget, és töltse fel ezt a fájlt. A wallabag ezután letölti minden cikk tartalmát; nagy exportnál kapcsolja be a Redist a belső beállításokban.
A projekt Androidos és iOS-es alkalmazásokat, valamint a Firefoxhoz és Chrome-hoz készült wallabagger bővítményt teszi közzé, amelyek a címével, záró perjel nélkül kapcsolódnak a példányához. Az iOS-es alkalmazásnak és a wallabaggernek egy API-kliensre van szüksége, amelyet az API clients management menüben hozhat létre.
A kép az X-Forwarded-Proto fejlécből tudja, hogy a kérés HTTPS-en érkezik. Állítsa be, hogy a proxyja https értékkel küldje, a domainje Host fejlécével együtt, és írja a https:// címet a SYMFONY__ENV__DOMAIN_NAME változóba.
Másoljon három elemet: az adatbázist, MariaDB esetén a mariadb-dump eszközzel, a web/assets/images útvonalra csatolt képkötetet és a compose.yaml fájlját, amely a beállításokat és a titkos értékeket tartalmazza. Küldje ezeket a másolatokat a szerveren kívülre.
A Managed VPS a szervert fedi le: a rendszert, a biztonságot, a felügyeletet és a mentéseket. Csapataink emellett proaktívan követik a példányát, és javasolják a hasznos javításokat, amelyeket Ön alkalmaz. Az alkalmazáson belüli beavatkozás óradíjban vagy átalánydíjban számlázódik.
Simafri
Beszéljünk a weboldaláról
Meséljen néhány szóban a projektjéről: hamarosan jelentkezünk.
Köszönjük! Kérését elküldtük. Hamarosan válaszolunk.
Inkább e-mailben? Írjon nekünk ide: support@simafri.com.