Komga majutamine Managed VPS-is tähendab, et loete oma koomikseid, mangasid ja e-raamatuid masinast, mis on teie enda ning mida meie meeskonnad hoiavad ajakohasena ja jälgivad päeval ja öösel. Komga on MIT-litsentsiga vaba meediaserver. See juhend järgib selle ametlikku dokumentatsiooni: arvestatav mälu ja salvestusruum, paigaldus Docker Compose’iga, esimene konto, konfiguratsioon, HTTPS, raamatukogud, lugemine OPDS-i, Kobo ja KOReaderi kaudu, varukoopiad ja uuendused.
Autor: Simon Vasconcelos Lee
Avaldatud 22. novembril 2026Lugemisaeg: 15 minutit
/data; andmebaas, indeks ja logid asuvad kaustas /config, kohalikul kettal.gotson/komga, port 25600 kohalikult avaldatuna HTTPS-iga pöördproksi taga ja kasutaja, kellele kuuluvad mõlemad kaustad./config serverist välja, hoidke oma raamatutest koopiat ja uuendage käsuga docker compose pull.Komga on meediaserver teie koomiksite, mangade, prantsuse-belgia koomiksialbumite, ajakirjade ja e-raamatute jaoks. Te näitate talle kaustu, kus teie failid asuvad, tema korraldab need raamatukogudeks, sarjadeks ja raamatuteks ning serveerib neid seejärel brauserile või lugemisrakendusele. See töötab kõikjal, kus töötab Java või Docker.
Komga avaldatakse MIT-litsentsi all, Gauthier Roebroecki nimel. See annab tasuta õiguse tarkvara koopiaid kasutada, kopeerida, muuta, ühendada, avaldada, levitada, all-litsentsida ja müüa. Seega võite seda käitada endale, oma perele, ühingule või ettevõttele, 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.
Dokumentatsioon ei sea minimaalset konfiguratsiooni. Küll aga annab see serveri mõõtmiseks olulise teabe: Java virtuaalmasina mälu, protsessorit koormavad ülesanded ja eelkõige teie failide võetav ruum.
OutOfMemoryException logides. Piiri tõstetakse siis muutujaga JAVA_TOOL_OPTIONS, mida tutvustatakse allpool.Protsessor töötab peamiselt raamatukogude skannimise ja analüüsi ajal. Iga raamatukogu kohta hoiatab dokumentatsioon, et failiräside, lehekülgede räside ja KOReaderi räside arvutamine, nagu ka lehekülgede mõõtmete analüüs, võib suures raamatukogus nõuda palju ressursse. Taustaülesannetele eraldatud lõimede arv seadistatakse jaotises «Server Settings».
See on suurim kuluartikkel ja seda mõõdate teie: teie kogu maht pluss ruum raamatutele, mida kavatsete lisada. Komga loeb teie faile seal, kus need on, ega kopeeri neid. Mõned dokumentatsiooni punktid muudavad arvutust:
/data raamatutele ja importidele: dokumentatsioon palub paigutada sinna oma raamatukogud ja importimiskausta, et importimine looks koopiate asemel kõvalinke. Väljaspool sama failisüsteemi võtab iga import koopia jagu ruumi./config hoiab peamist andmebaasi koos iga raamatu jaoks loodud pisipiltidega, ülesannete andmebaasi, seansside andmebaasi, otsinguindeksit ja logisid, mida vaikekonfiguratsioon hoiab 7 päeva ja piirab 1 GB-ga. See kasvab koos teie raamatukogude suurusega./config: SQLite’i andmebaasid ei tohi kunagi asuda võrgujaos, nagu CIFS või NFS. Komga kontrollib seda käivitamisel ja peatub, kui see nii ei ole.Managed VPS-is kirjeldage meile oma kogu, selle mahtu, kasvutempot ja lugejate arvu ning soovitame sobiva suuruse.
Dokumentatsioon avaldab tõmmise gotson/komga Docker Hubis ja ghcr.io-s, protsessoritele amd64, arm64 ja arm. Looge serveris, kuhu Docker on paigaldatud, Komga jaoks kaust koos selle kahe alamkaustaga ja märkige üles oma kasutaja ID:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Pange sinna see compose.yaml, mis on võetud dokumentatsiooni näitest. Asendage 1000:1000 käsu id näidatud väärtustega uid ja gid ning TZ oma ajavööndiga:
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: see on peamine erinevus dokumentatsiooni näitest, mis avaldab selle kõigil aadressidel. Dokumentatsioon soovitab tungivalt HTTPS-i kohe, kui Komga avatakse väljaspool teie kohtvõrku, sest see kasutab HTTP põhiautentimist. Liides on siis kättesaadav ainult pöördproksi kaudu.user antud ID all. Dokumentatsioon palub, et ühendatud kaustad kuuluksid samale kasutajale: nii kaovad õiguste probleemid./config hoiab Komga andmebaasi ja konfiguratsiooni, kohalikul kettal./data sisaldab teie raamatuid ja importimiskausta. Igal raamatukogul on seal oma alamkaust.1.x järgib viimast avaldatud versiooni 1; 1.30.1 fikseerib versiooni. Dokumentatsioon jätab sildi latest viimasele commit’ile.version on välja jäetud: Docker Compose peab seda nüüd aegunuks ja eirab seda.Dokumentatsiooni teine tee Linuxi serveri jaoks on iga väljalaske jar-fail, mis avaldatakse GitHubis. See vajab Java 17 või uuemat ja hoiab oma konfiguratsiooni kaustas ~/.komga:
java -version
java -jar komga-1.30.1.jar
Esimesel külastusel palub Komga luua konto: e-posti aadressi ja parooli. See esimene konto saab kõik rollid, sealhulgas administreerimise, ja «nõuab» serveri endale. Kuni seda kontot pole, vastab see vorm igaühele, kes lehele jõuab: looge konto enne serveri avalikkusele avamist, SSH-tunneli kaudu. Serveri port 25600 ilmub siis teie arvutisse aadressile http://localhost:25600. Lisage -p ja teie kliendialas näidatud SSH-port.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
Järgmised kontod loob administraator jaotises «Server Settings», «Users» nupuga +. Iga konto saab vajalikud rollid:
| Roll | Mida see lubab |
|---|---|
| Administrator | Raamatukogude, kasutajate ja kogumike haldamine, metaandmete muutmine, skannimiste, analüüside ja metaandmete värskenduste käivitamine |
| Page Streaming | Lehekülghaaval lugemine, näiteks veebilugejas |
| File Download | Raamatu faili allalaadimine |
| Kobo Sync | Kobo e-lugeri sünkroonimine, koos rolliga File Download |
| KOReader Sync | Lugemise edenemise sünkroonimine KOReaderiga |
Kasutaja kustutamine kustutab pöördumatult kogu tema lugemise edenemise: vahetult enne tehtud koopia kaustast /config jätab kontrolli teie kätte.
Dokumentatsioon lisab käsu faili compose.yaml, teenuse komga alla; Komga rakendab muudatuse ja käivitub seejärel tavapäraselt. Taaskäivitage teenus, seejärel eemaldage rida ja taaskäivitage teenus veel kord:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Samamoodi kasutatav käsk --list-users kuvab logides kontode loendi.
Komgal on iga sätte jaoks vaikeväärtus: konfiguratsioon muudab ainult selle käitumist. Seda tehakse keskkonnamuutujatega, mis on Docker Compose’iga lihtsaim tee, või failiga application.yml, mille loote kausta /config, kust Dockeri tõmmis selle laadib. Atribuudi nimest muutuja nime saamiseks asendage punktid alakriipsudega, eemaldage sidekriipsud ja teisendage suurtähtedeks.
| Muutuja | Atribuut | Vaikimisi | Mida see teeb |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | API ja veebiliidese port |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Baas-URL, et serveerida Komgat alamkaustas |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 päeva | Mitteaktiivse seansi kestus, näiteks 14d või 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Puudub | CORS-i jaoks lubatud päritolud |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Määramata | DEBUG üksikasjalike logide jaoks |
Porti ja baas-URL-i saab seadistada ka jaotises «Server Settings» ning see säte on siis konfiguratsiooni ees ülimuslik. Java mälu jaoks lisage muutuja JAVA_TOOL_OPTIONS jaotisse environment. Dokumentatsiooni näide seab maksimumiks 4 GB:
- JAVA_TOOL_OPTIONS=-Xmx4g
Dokumentatsiooni näidisfail application.yml algab andmebaasi teega. Dockeriga hoidke see väärtusel /config/database.sqlite, mis on vaikeväärtus: mujal loodaks andmebaas konteineri sisse ja see läheks konteineri uuesti loomisel kaotsi. Jätke näitest alles ainult vajalikud read.
Dokumentatsioon soovitab paigutada Komga ette pöördproksi, mis hangib kehtiva sertifikaadi, ja soovitab Caddyt, mis loob oma Let’s Encrypti sertifikaadid ise. Proksi peab seadma kolm päist, et Komga teaks iga päringu avalikku aadressi ja protokolli:
X-Forwarded-For, seatud või täiendatud;X-Forwarded-Proto;X-Forwarded-Host.Alamdomeenil, ilma Komga baas-URL-ita, seab Caddy need päised ise:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
Alamkaustas seadke esmalt Komga baas-URL väärtusele /komga, jaotises «Server Settings» või muutujaga SERVER_SERVLET_CONTEXTPATH, ja seejärel:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Dokumentatsiooni Nginxi näide edastab ka WebSocketi ühendused. Lisage see plokk map faili /etc/nginx/nginx.conf jaotisse http:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
See saidi plokk kasutab dokumentatsiooni näite sätteid, pordil 80, et Certbot saaks HTTPS-i paigaldada. Rida X-Forwarded-Host on lisatud, kuna dokumentatsiooni päiste loend seda nõuab:
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
Dokumentatsiooni täielik näide näitab lõplikku versiooni: port 80 suunatud HTTPS-ile ja plokk pordil 443 koos sertifikaatide teedega.
Raamatukogu on raamatute rühm, mis asub juurkausta all. Komga loob iga alamkausta jaoks, mis tahes sügavusel, sarja ja iga faili jaoks raamatu, mis paigutatakse selle ülemkausta sarja. EPUB-failide ja arhiivides olevate failide ComicInfo.xml metaandmed on kausta- ja failinimede ees ülimuslikud.
~/komga/data alamkausta, SFTP kaudu või käsuga rsync./data/manga, ja klõpsake nuppu «Add».rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga ja /data/comics elavad kõrvuti; /data ja /data/manga mitte.#recycle.Raamat, mille fail kaob, liigub kustutamise asemel prügikasti, märkega «Unavailable»: selle metaandmed, lugemise edenemine ja loendid tulevad tagasi, kui fail ilmub oma kohale uuesti. Seega saate oma faile ümber nimetada ja teisaldada midagi kaotamata. Prügikast tühjendatakse käsitsi või pärast iga skannimist, kui lülitate selle valiku sisse, mis siis eemaldab üksused kohe.
Kuva «Import», «Books» paigutab teie sarjadesse raamatud, mis asuvad serveri teises kaustas, näiteks /data/import. Iga faili jaoks valite sihtsarja, numbri ja nime; juba kasutusel olev number pakub olemasoleva raamatu asendamist, näidates mõlemat kõrvuti. Komga teisaldab failid või loob kõvalingid, kui failisüsteem seda võimaldab, ja muul juhul kopeerib need.
Raamatukogu juurkausta muutmine vanaga mitte seotud teeks kustutab selle sarjad, raamatud ja lugemise edenemise. KKK kirjeldab, kuidas seda teisaldada: failiräsid sees, prügikasti automaatne tühjendamine väljas, seejärel skannimine enne teisaldamist.
Veebilugeja avaneb brauseris serveri aadressil. Rakenduse või e-lugeri jaoks pakub Komga kolme ust, mida kõiki tuleb serveerida HTTPS-i kaudu.
Komga töötab iga OPDS-rakendusega, versiooniga 1 või 2. Andke rakendusele üks neist aadressidest ning seejärel oma Komga konto e-posti aadress ja parool:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Versiooni 1.2 kataloog lisab sarjade järgi otsimise OpenSearchi kaudu ja lehekülghaaval lugemise ilma allalaadimiseta laienduse OPDS PSE kaudu. Dokumentatsioon peab testitud rakenduste loendit, Androidis, iOS-is ja mujal, koos sellega, mida igaüks toetab.
Teie Kobo e-luger sünkroonib Kobo ametlike serverite asemel Komgaga. Kõigi raamatukogude EPUB-raamatud jõuavad sinna koos metaandmete ja kaanepildiga, mille Kepubify, mis on Dockeri tõmmisesse lisatud, jooksvalt KEPUB-vormingusse teisendab. Lugemise edenemine sünkroonitakse mõlemas suunas.
.kobo/Kobo/Kobo eReader.conf, kui peidetud failid on nähtavaks tehtud.[OneStoreServices] rida api_endpoint oma serveri aadressiga, millele järgneb teie võti.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint port, HTTPS-aadressi puhul 443.KOReader loeb Komgat OPDS-i kaudu ja sünkroonib oma lugemise edenemise Komga sünkroonimisserveri kaudu:
https://komga.example.com/koreader.Kõik, mida Komga teie raamatutest teab, asub kaustas /config; teie raamatud ise jäävad kausta /data. Siin on see, mida /config vaikekonfiguratsiooniga sisaldab:
| Element | Mida see hoiab |
|---|---|
database.sqlite | Peamine andmebaas: raamatukogud, sarjad, raamatud, metaandmed, kasutajad, lugemise edenemine, kogumikud, lugemisloendid ja loodud pisipildid |
tasks.sqlite | Ootel taustaülesanded |
sessions.sqlite | Sisselogimisseansid, mida hoitakse alates versioonist 1.30.0 vaikimisi andmebaasis |
lucene/ | Otsinguindeks |
fonts/ | Fondid |
logs/ | Logid, sealhulgas komga.log |
application.yml | Teie konfiguratsioon, kui olete selle loonud |
SQLite’i andmebaasid kopeeritakse peatatud Komgaga, et koopia oleks terviklik. Kaustast, kus asub compose.yaml:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Saatke see arhiiv serverist välja nii sageli, kui lisate ja loete raamatuid. Hoidke ka oma raamatutest koopiat koos kaanepiltidega, mida hoiate failide kõrval: see on suurim maht, kuid muutub vähe ja rsync saadab ainult uue. Serveri kettale pandud, jõuavad need arhiivid ka selle öistesse varukoopiatesse.
Taastamiseks peatage Komga, asendage kaust config arhiivis olevaga, kontrollige, et see kuuluks endiselt failis compose.yaml määratud kasutajale, ja käivitage Komga uuesti.
Docker Compose’i puhul annab dokumentatsioon need käsud, mida käivitatakse kaustast, kus asub compose.yaml. Serverist ühendatud kaust /config säilitab teie sätted:
docker compose pull
docker compose up -d
docker image prune
/config koopia vahetult enne iga uuendust.jar peatage Komga ja käivitage see seejärel uue versiooni jar-failiga.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; Komga jääb teie tarkvaraks oma sätete ja teie raamatutega.
| 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 |
| Komga | Proaktiivne jälgimine: vead, aeglus, mälu ja kettaruum avastatakse, parandus soovitatakse | Selle paigaldus, uuendused ja sätted, mille rakendate teie või teie tehisintellekti assistent |
| Raamatukogud ja lugejad | Neid kandev server, jälgitud ja varundatud | Raamatukogud, kontod, rollid ja API-võtmed |
| Varukoopiad | Igal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldub | Komga enda koopiad 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 Komga 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. Komga on MIT-litsentsiga: võite seda ettevõttes kasutada, muuta ja edasi levitada, ilma et peaksite litsentsi ostma, tingimusel et säilitate selle autoriõiguse teate. Jääb ainult seda käitava serveri hind.
Dokumentatsioon ei sea miinimumi. Vaikimisi piirab Java Komga mälu, tavaliselt umbes 1 GB-ni. Kui logides on vigu OutOfMemoryException, tõstke piiri muutujaga JAVA_TOOL_OPTIONS, näiteks -Xmx4g 4 GB jaoks.
Looge compose.yaml tõmmisega gotson/komga, aadressil 127.0.0.1 avaldatud pordiga 25600, kausta /config ühendatud kaustaga config, kausta /data ühendatud kaustaga data ja kasutajaga, kellele mõlemad kuuluvad, ning käivitage docker compose up -d. Pange seejärel pordi 25600 ette HTTPS-iga pöördproksi.
Esimesel külastusel küsib Komga e-posti aadressi ja parooli: see esimene konto saab kõik rollid. Looge see SSH-tunneli kaudu enne serveri avalikkusele avamist ja looge seejärel teised kontod jaotises Server Settings, Users.
Teie serveri aadressi, millele järgneb OPDS 2 jaoks /opds/v2/catalog või OPDS 1.2 jaoks /opds/v1.2/catalog, koos teie Komga konto e-posti aadressi ja parooliga.
Andke kontole rollid Kobo Sync ja File Download, looge jaotises Account Settings API-võti ja asendage seejärel faili Kobo eReader.conf rida api_endpoint aadressiga https://your-server/kobo/your-key. Sünkroonitakse ainult EPUB-raamatuid.
Peatage Komga, arhiveerige kaust config, käivitage Komga uuesti ja saatke arhiiv serverist välja. Hoidke ka oma raamatutest koopiat. Tehke koopia vahetult enne iga uuendust.
Managed VPS katab serveri: süsteem, turvalisus, seire ja varukoopiad. Meie meeskonnad jälgivad ka teie instantsi proaktiivselt ja soovitavad teile kasulikud parandused, 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.