A Komga hosztolása Managed VPS-en azt jelenti, hogy képregényeit, mangáit és e-könyveit egy saját gépről olvassa, amelyet csapataink naprakészen tartanak, és éjjel-nappal felügyelnek. A Komga egy MIT licenc alatt álló, szabad szoftveres médiaszerver. Ez az útmutató a hivatalos dokumentációját követi: a tervezendő memóriát és tárhelyet, a telepítést Docker Compose-zal, az első fiókot, a konfigurációt, a HTTPS-t, a könyvtárakat, az olvasást OPDS-en, Kobón és KOReaderen át, a mentéseket és a frissítéseket.
Szerző: Simon Vasconcelos Lee
Közzétéve 2026. november 22-énOlvasási idő: 14 perc
/data mappában tárolt gyűjteményéhez méretezi; az adatbázis, az index és a naplók a /config mappában, helyi lemezen vannak.gotson/komga image, a helyben közzétett 25600-as port egy HTTPS-t használó fordított proxy mögött, és egy felhasználó, aki mindkét mappa tulajdonosa./config mappát a szerveren kívülre, őrizzen meg egy másolatot a könyveiről, és frissítsen a docker compose pull paranccsal.A Komga médiaszerver a képregényei, mangái, frankofón képregényei, magazinjai és e-könyvei számára. Megadja neki a fájljait tartalmazó mappákat, ő pedig könyvtárakba, sorozatokba és könyvekbe rendezi őket, majd egy böngészőnek vagy olvasóalkalmazásnak szolgálja ki őket. Bárhol fut, ahol a Java vagy a Docker fut.
A Komga az MIT licenc alatt jelenik meg, Gauthier Roebroeck nevén. 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 családjának, az egyesületének vagy a vállalkozásának, 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 dokumentáció nem ír elő minimális konfigurációt. Azt viszont megadja, ami a szerver méretezésénél számít: a Java virtuális gép memóriáját, a processzort terhelő feladatokat, és mindenekelőtt a fájljai által elfoglalt helyet.
OutOfMemoryException hibák a naplókban. A korlátot ekkor a lentebb bemutatott JAVA_TOOL_OPTIONS változóval lehet megemelni.A processzor főként a könyvtárak beolvasása és elemzése közben dolgozik. A dokumentáció minden könyvtárnál figyelmeztet, hogy a fájlok, az oldalak és a KOReader hash-értékeinek kiszámítása, akárcsak az oldalméretek elemzése, egy nagy könyvtárnál sok erőforrást fogyaszthat. A háttérfeladatokra szánt szálak száma a „Server Settings” alatt állítható be.
Ez a legnagyobb tétel, és Ön méri fel: a gyűjteménye mérete, plusz hely a hozzáadni tervezett könyveknek. A Komga ott olvassa a fájljait, ahol vannak, és nem másolja le őket. A dokumentáció néhány pontja módosítja a számítást:
/data mappa a könyveknek és az importoknak: a dokumentáció azt kéri, hogy ide tegye a könyvtárait és az importmappáját, hogy az importok másolatok helyett hard linkeket hozzanak létre. Ugyanazon a fájlrendszeren kívül minden import egy másolatnyi helyet foglal./config mappa tárolja a fő adatbázist a könyvenként generált bélyegképekkel, a feladatok adatbázisát, a munkamenetek adatbázisát, a keresési indexet és a naplókat, amelyeket az alapértelmezett konfiguráció 7 napig őriz meg, és 1 GB-ban korlátoz. A könyvtárai méretével együtt nő./config számára: az SQLite-adatbázisok soha nem lehetnek hálózati megosztáson, például CIFS-en vagy NFS-en. A Komga ezt induláskor ellenőrzi, és leáll, ha nem így van.Egy Managed VPS esetén írja le nekünk a gyűjteményét, annak méretét, növekedési ütemét és az olvasók számát, mi pedig ajánlunk Önnek egy megfelelő méretet.
A dokumentáció a gotson/komga image-et a Docker Hubon és a ghcr.io-n teszi közzé, amd64, arm64 és arm processzorokhoz. Egy Dockerrel rendelkező szerveren hozzon létre egy mappát a Komgának a két almappájával, és jegyezze fel a felhasználói azonosítóját:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Tegye bele ezt a compose.yaml fájlt, amely a dokumentáció példáján alapul. Cserélje le az 1000:1000 értéket az id által kiírt uid és gid értékekre, a TZ értékét pedig a saját időzónájára:
services:
komga:
image: gotson/komga:1.x
container_name: komga
volumes:
- type: bind
source: ./config
target: /config
- type: bind
source: ./data
target: /data
ports:
- "127.0.0.1:25600:25600"
user: "1000:1000"
environment:
- TZ=Europe/London
restart: unless-stopped
docker compose up -d
docker logs -f komga
127.0.0.1 címen közzétett 25600-as port: ez a fő eltérés a dokumentáció példájától, amely minden címen közzéteszi. A dokumentáció erősen ajánlja a HTTPS-t, amint a Komga a helyi hálózatán kívül is elérhetővé válik, mert alapszintű HTTP-hitelesítést (basic) használ. A felület ekkor csak a fordított proxyn keresztül érhető el.user sorban megadott azonosítóval fut. A dokumentáció azt kéri, hogy a csatolt mappák tulajdonosa ugyanez a felhasználó legyen: így a jogosultsági problémák eltűnnek./config a Komga adatbázisát és konfigurációját tárolja, helyi lemezen./data a könyveit és az importmappáját tárolja. Minden könyvtárnak saját almappája lesz benne.1.x címke a legutóbb közzétett 1-es verziót követi; az 1.30.1 rögzíti a verziót. A dokumentáció a latest címkét a legutóbbi commitként írja le.version sora kimaradt: a Docker Compose ma már elavultnak tekinti és figyelmen kívül hagyja.A dokumentáció másik útja egy linuxos szerverhez az egyes kiadások GitHubon közzétett jar fájlja. Java 17-et vagy újabbat igényel, a konfigurációját pedig a ~/.komga mappában tárolja:
java -version
java -jar komga-1.30.1.jar
Az első megnyitáskor a Komga egy fiók létrehozását kéri: egy e-mail-címet és egy jelszót. Ez az első fiók minden szerepkört megkap, az adminisztrációt is, és „birtokba veszi” a szervert. Amíg nem létezik, ez az űrlap bárkinek válaszol, aki eljut az oldalig: hozza létre SSH-alagúton keresztül, mielőtt a szervert megnyitja a nyilvánosság előtt. A szerver 25600-as portja ekkor megjelenik a számítógépén, a http://localhost:25600 címen. Adja hozzá a -p kapcsolót és az ügyfélterületén feltüntetett SSH-portot.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
A további fiókokat az adminisztrátor hozza létre a „Server Settings”, „Users” alatt, a + gombbal. Minden fiók megkapja a szükséges szerepköröket:
| Szerepkör | Mit tesz lehetővé |
|---|---|
| Administrator | A könyvtárak, felhasználók és gyűjtemények kezelése, a metaadatok szerkesztése, beolvasások, elemzések és metaadat-frissítések indítása |
| Page Streaming | Oldalanként olvasás, például a webes olvasóban |
| File Download | Egy könyv fájljának letöltése |
| Kobo Sync | Kobo e-könyv-olvasó szinkronizálása, a File Download szerepkörrel együtt |
| KOReader Sync | Az olvasási előrehaladás szinkronizálása a KOReaderrel |
Egy felhasználó törlése visszavonhatatlanul törli a teljes olvasási előrehaladását: egy közvetlenül előtte készített /config másolattal Ön kezében marad az irányítás.
A dokumentáció a parancsot a compose.yaml fájlba, a komga szolgáltatás alá teszi; a Komga végrehajtja a módosítást, majd a szokásos módon elindul. Indítsa újra a szolgáltatást, majd törölje a sort, és indítsa újra még egyszer:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Az ugyanígy használt --list-users parancs a fiókok listáját írja ki a naplókba.
A Komga minden beállításhoz alapértelmezett értékkel rendelkezik: a konfiguráció csak a viselkedését módosítja. Környezeti változókkal történik, ami Docker Compose mellett a legegyszerűbb út, vagy egy application.yml fájllal, amelyet a /config mappában hoz létre, ahonnan a Docker-image betölti. Egy tulajdonságnév változónévvé alakításához cserélje a pontokat aláhúzásjelre, törölje a kötőjeleket, és alakítson mindent nagybetűssé.
| Változó | Tulajdonság | Alapérték | Mire szolgál |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Az API és a webes felület portja |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Az alap-URL, a Komga almappából való kiszolgálásához |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 nap | Meddig tart egy inaktív munkamenet, például 14d vagy 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Nincs | A CORS számára engedélyezett eredetek (origins) |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Nincs beállítva | DEBUG a részletes naplókhoz |
A port és az alap-URL a „Server Settings” alatt is beállítható, és ez a beállítás ekkor elsőbbséget élvez a konfigurációval szemben. A Java memóriájához adja hozzá a JAVA_TOOL_OPTIONS változót az environment részhez. A dokumentáció példája legfeljebb 4 GB-ot állít be:
- JAVA_TOOL_OPTIONS=-Xmx4g
A dokumentáció minta-application.yml fájlja az adatbázis útvonalával kezdődik. Dockerrel hagyja a /config/database.sqlite értéken, az alapértelmezésen: bárhol máshol az adatbázis a konténeren belül jönne létre, és a konténer újralétrehozásakor elveszne. A mintából csak azokat a sorokat tartsa meg, amelyekre szüksége van.
A dokumentáció azt ajánlja, hogy a Komga elé egy érvényes tanúsítványt szerző fordított proxy kerüljön, és a Caddyt javasolja, amely maga generálja a Let’s Encrypt tanúsítványait. A proxynak három fejlécet kell beállítania, hogy a Komga ismerje az egyes kérések nyilvános címét és protokollját:
X-Forwarded-For, beállítva vagy kiegészítve;X-Forwarded-Proto;X-Forwarded-Host.Aldomainen, a Komgában beállított alap-URL nélkül, a Caddy maga állítja be ezeket a fejléceket:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
Almappában először állítsa a Komga alap-URL-jét /komga értékre, a „Server Settings” alatt vagy a SERVER_SERVLET_CONTEXTPATH változóval, majd:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
A dokumentáció Nginx-példája a WebSocket-kapcsolatokat is továbbítja. Adja hozzá ezt a map blokkot az /etc/nginx/nginx.conf fájl http részéhez:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Ez a webhelyblokk a dokumentáció példájának beállításait használja, a 80-as porton, hogy a Certbot telepíthesse a HTTPS-t. Az X-Forwarded-Host sort hozzáadtuk, mivel a dokumentáció fejléclistája kéri:
server {
listen 80;
listen [::]:80;
server_name komga.example.com;
client_max_body_size 20000m;
location / {
proxy_pass http://127.0.0.1:25600;
proxy_http_version 1.1;
proxy_redirect off;
proxy_buffering off;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
}
}
sudo nginx -t
sudo certbot --nginx
A dokumentáció teljes példája a végleges változatot mutatja: a HTTPS-re átirányított 80-as portot, és a 443-as porton lévő blokkot a tanúsítvány útvonalaival.
A könyvtár egy gyökérmappa alatt tárolt könyvek csoportja. A Komga minden almappához, bármilyen mélységben, létrehoz egy sorozatot, és minden fájlhoz egy könyvet, amelyet a szülőmappája sorozatába sorol. Az EPUB-fájlok és az archívumokban lévő ComicInfo.xml fájlok metaadatai elsőbbséget élveznek a mappa- és fájlnevekkel szemben.
~/komga/data almappába, SFTP-n vagy rsync segítségével./data/manga, majd kattintson az „Add” gombra.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga és a /data/comics megfér egymás mellett; a /data és a /data/manga nem.#recycle.Az a könyv, amelynek a fájlja eltűnik, törlés helyett a lomtárba kerül „Unavailable” jelöléssel: a metaadatai, az olvasási előrehaladása és a listái visszatérnek, ha a fájl újra megjelenik a helyén. Így a fájljait átnevezheti és áthelyezheti anélkül, hogy bármi elveszne. A lomtár kézzel ürül, vagy minden beolvasás után, ha bekapcsolja ezt az opciót, amely ekkor azonnal eltávolítja az elemeket.
Az „Import”, „Books” képernyő a sorozataiba sorolja a szerver egy másik mappájában lévő könyveket, például a /data/import mappából. Minden fájlnál kiválasztja a célsorozatot, a számot és a nevet; egy már foglalt szám a meglévő könyv újabb változatra cserélését kínálja fel, a kettőt egymás mellett mutatva. A Komga áthelyezi a fájlokat, vagy hard linket hoz létre rájuk, ha a fájlrendszer lehetővé teszi, egyébként pedig lemásolja őket.
Ha egy könyvtár gyökérmappáját a régivel össze nem függő útvonalra változtatja, azzal törli a sorozatait, könyveit és az olvasási előrehaladást. A GYIK leírja, hogyan lehet áthelyezni: bekapcsolt fájl-hash-elés, kikapcsolt automatikus lomtárürítés, majd egy beolvasás az áthelyezés előtt.
A webes olvasó a böngészőben nyílik meg, a szerver címén. Alkalmazáshoz vagy e-könyv-olvasóhoz a Komga három bejáratot kínál, mindhármat HTTPS-en keresztül kiszolgálva.
A Komga bármely 1-es vagy 2-es verziójú OPDS-alkalmazással működik. Adja meg az alkalmazásnak az alábbi címek egyikét, majd a Komga-fiókja e-mail-címét és jelszavát:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Az 1.2-es verziójú katalógus sorozat szerinti keresést ad hozzá, OpenSearch révén, valamint letöltés nélküli, oldalankénti olvasást, az OPDS PSE bővítménnyel. A dokumentáció vezet egy listát a tesztelt alkalmazásokról Androidra, iOS-re és más platformokra, azzal együtt, hogy melyik mit támogat.
A Kobo e-könyv-olvasója a hivatalos Kobo-szerverek helyett a Komgával szinkronizál. Az összes könyvtár EPUB-könyvei a metaadataikkal és a borítójukkal érkeznek, menet közben KEPUB formátumra konvertálva a Docker-image részét képező Kepubify segítségével. Az olvasási előrehaladás mindkét irányban szinkronizálódik.
.kobo/Kobo/Kobo eReader.conf fájlt, a rejtett fájlok megjelenítésével.[OneStoreServices] csoportban cserélje le az api_endpoint sort a szervere címére, amelyet a kulcsa követ.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint cím portja, HTTPS-cím esetén 443.A KOReader OPDS-en keresztül olvassa a Komgát, az olvasási előrehaladását pedig a Komga szinkronizálási szerverén keresztül szinkronizálja:
https://komga.example.com/koreader címet.Minden, amit a Komga a könyveiről tud, a /config mappában van; maguk a könyvek a /data mappában maradnak. Ezt tartalmazza a /config az alapértelmezett konfigurációval:
| Elem | Mit tárol |
|---|---|
database.sqlite | A fő adatbázis: könyvtárak, sorozatok, könyvek, metaadatok, felhasználók, olvasási előrehaladás, gyűjtemények, olvasási listák és generált bélyegképek |
tasks.sqlite | A függőben lévő háttérfeladatok |
sessions.sqlite | A bejelentkezési munkamenetek, az 1.30.0-s verzió óta alapértelmezés szerint az adatbázisban tárolva |
lucene/ | A keresési index |
fonts/ | A betűtípusok |
logs/ | A naplók, köztük a komga.log |
application.yml | Az Ön konfigurációja, ha létrehozott ilyet |
Az SQLite-adatbázisokat leállított Komga mellett kell másolni, hogy a másolat konzisztens legyen. A compose.yaml mappájából:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Küldje ezt az archívumot a szerveren kívülre olyan gyakran, ahogyan könyveket ad hozzá és olvas. Őrizzen meg egy másolatot a könyveiről is, a fájlok mellett tartott borítókkal együtt: ez a legnagyobb adatmennyiség, de keveset változik, és az rsync csak az újdonságokat küldi el. A szerver lemezére téve ezek az archívumok a szerver éjszakai mentéseibe is bekerülnek.
A visszaállításhoz állítsa le a Komgát, cserélje le a config mappát az archívumban lévőre, ellenőrizze, hogy továbbra is a compose.yaml fájlban megadott felhasználó a tulajdonosa, majd indítsa újra.
Docker Compose esetén a dokumentáció ezeket a parancsokat adja meg, a compose.yaml mappájából. A szerverről csatolt /config mappa megőrzi a beállításait:
docker compose pull
docker compose up -d
docker image prune
/config mappáról.jar fájllal állítsa le a Komgát, majd indítsa el az új verzió jar fájljával.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 Komga továbbra is az Ön szoftvere marad, a beállításaival és az Ön könyveivel.
| 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 |
| Komga | Proaktív követés: a hibák, lassulások, a memória é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 könyvtárak és az olvasók | A szerver, amely hordozza őket, felügyelve és mentve | A könyvtárak, a fiókok, a szerepkörök és az API-kulcsok |
| A mentések | Minden éjjel, titkosítva és a gépen kívül őrizve; a visszaállítással együtt | A Komga saját másolatai, é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 Komga-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 Komga MIT licenc alatt áll: licenc vásárlása nélkül használhatja, módosíthatja és terjesztheti tovább vállalkozásban, feltéve, hogy megtartja a szerzői jogi megjegyzését. Marad a költsége annak a szervernek, amelyen fut.
A dokumentáció nem ír elő minimumot. Alapértelmezés szerint a Java korlátozza a Komga memóriáját, általában nagyjából 1 GB-ra. Ha a naplókban OutOfMemoryException hibák jelennek meg, emelje meg a korlátot a JAVA_TOOL_OPTIONS változóval, például -Xmx4g értékkel 4 GB-hoz.
Hozzon létre egy compose.yaml fájlt a gotson/komga image-gel, a 127.0.0.1 címen közzétett 25600-as porttal, a /config útvonalra csatolt config mappával, a /data útvonalra csatolt data mappával és egy felhasználóval, aki mindkettő tulajdonosa, majd futtassa a docker compose up -d parancsot. Ezután helyezzen a 25600-as port elé egy HTTPS-t használó fordított proxyt.
Az első megnyitáskor a Komga egy e-mail-címet és egy jelszót kér: ez az első fiók minden szerepkört megkap. Hozza létre SSH-alagúton keresztül, mielőtt a szervert megnyitja a nyilvánosság előtt, majd a többi fiókot a Server Settings, Users menüpont alatt hozza létre.
A szervere címét, utána a /opds/v2/catalog útvonallal az OPDS 2-höz, vagy a /opds/v1.2/catalog útvonallal az OPDS 1.2-höz, a Komga-fiókja e-mail-címével és jelszavával együtt.
Adja meg a fióknak a Kobo Sync és a File Download szerepkört, hozzon létre egy API-kulcsot az Account Settings alatt, majd cserélje le a Kobo eReader.conf fájl api_endpoint sorát a https://sajat-szerver/kobo/sajat-kulcs címre. Csak az EPUB-könyvek szinkronizálódnak.
Állítsa le a Komgát, archiválja a config mappát, indítsa újra, és küldje az archívumot a szerveren kívülre. Őrizzen meg egy másolatot a könyveiről is. Közvetlenül minden frissítés előtt is készítsen másolatot.
A Managed VPS a szervert fedi le: a rendszert, a biztonságot, a felügyeletet és a mentéseket. Csapataink proaktívan a példányát is követik, és javasolják a hasznos javításokat, amelyeket Ön alkalmaz. Az alkalmazásban végzett 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.