Komgan hostaus Managed VPS:llä tarkoittaa, että luette sarjakuvianne, mangojanne ja e-kirjojanne koneelta, joka on teidän ja jota tiimimme pitävät ajan tasalla ja valvovat yötä päivää. Komga on MIT-lisenssillä julkaistu avoimen lähdekoodin mediapalvelin. Tämä opas seuraa sen virallista dokumentaatiota: tarvittava muisti ja tallennustila, asennus Docker Composella, ensimmäinen tili, määritykset, HTTPS, kirjastot, lukeminen OPDS:n, Kobon ja KOReaderin kautta, varmuuskopiot ja päivitykset.
Kirjoittaja: Simon Vasconcelos Lee
Julkaistu 22. marraskuuta 2026Lukuaika: 14 minuuttia
/data; tietokanta, hakemisto ja lokit ovat kansiossa /config, paikallisella levyllä.gotson/komga, portti 25600 julkaistuna paikallisesti HTTPS:llä toimivan käänteisen välityspalvelimen takana ja käyttäjä, joka omistaa molemmat kansiot./config palvelimen ulkopuolelle, säilyttäkää kopio kirjoistanne ja päivittäkää komennolla docker compose pull.Komga on mediapalvelin sarjakuville, mangoille, ranskalais-belgialaisille sarjakuva-albumeille, aikakauslehdille ja e-kirjoille. Osoitatte sille kansiot, joissa tiedostonne ovat, ja se järjestää ne kirjastoiksi, sarjoiksi ja kirjoiksi ja tarjoaa ne sitten selaimelle tai lukusovellukselle. Se toimii kaikkialla, missä Java tai Docker toimii.
Komga julkaistaan MIT-lisenssillä Gauthier Roebroeckin nimissä. Se antaa maksutta oikeuden käyttää, kopioida, muokata, yhdistää, julkaista, levittää, alilisensoida ja myydä ohjelmiston kopioita. Voitte siis ajaa sitä itsellenne, perheellenne, yhdistyksellenne tai yrityksellenne ostamatta lisenssiä.
Ainoa ehto on säilyttää tekijänoikeusilmoitus ja lisenssin teksti kaikissa ohjelmiston kopioissa tai sen olennaisissa osissa. Teksti toimittaa ohjelmiston ”sellaisenaan”, ilman takuuta.
Dokumentaatio ei määrää vähimmäiskokoonpanoa. Sen sijaan se kertoo, mikä palvelimen mitoituksessa ratkaisee: Java-virtuaalikoneen muisti, suoritinta kuormittavat tehtävät ja ennen kaikkea tiedostojenne viemä tila.
OutOfMemoryException lokeissa. Rajaa nostetaan silloin muuttujalla JAVA_TOOL_OPTIONS, joka esitetään alempana.Suoritin työskentelee lähinnä kirjastojen skannauksen ja analyysin aikana. Jokaisen kirjaston kohdalla dokumentaatio varoittaa, että tiedostotiivisteiden, sivutiivisteiden ja KOReader-tiivisteiden laskeminen, kuten sivujen mittojen analysointikin, voi viedä paljon resursseja suuressa kirjastossa. Taustatehtäville varattujen säikeiden määrä asetetaan kohdassa ”Server Settings”.
Tämä on suurin erä, ja mittaatte sen itse: kokoelmanne koko sekä tilaa kirjoille, joita aiotte lisätä. Komga lukee tiedostonne niiden omalta paikalta eikä kopioi niitä. Muutama dokumentaation kohta muuttaa laskelmaa:
/data kirjoille ja tuonneille: dokumentaatio pyytää sijoittamaan sinne kirjastonne ja tuontikansionne, jotta tuonnit luovat kovia linkkejä kopioiden sijaan. Saman tiedostojärjestelmän ulkopuolella jokainen tuonti vie kopion verran tilaa./config sisältää päätietokannan ja jokaiselle kirjalle luodut pienoiskuvat, tehtävien tietokannan, istuntojen tietokannan, hakuindeksin ja lokit, jotka oletusmääritys säilyttää 7 päivää ja rajaa 1 Gt:hen. Se kasvaa kirjastojenne koon mukana./config: SQLite-tietokannat eivät saa koskaan sijaita verkkojaossa, kuten CIFS tai NFS. Komga tarkistaa tämän käynnistyessään ja pysähtyy, jos näin ei ole.Managed VPS -palvelimella kertokaa meille kokoelmastanne, sen koosta, kasvuvauhdista ja lukijoidenne määrästä, niin suosittelemme sopivaa kokoa.
Dokumentaatio julkaisee imagen gotson/komga Docker Hubissa ja ghcr.io:ssa amd64-, arm64- ja arm-suorittimille. Luokaa Dockerilla varustetulle palvelimelle Komgalle kansio ja sen kaksi alikansiota, ja merkitkää muistiin käyttäjätunnisteenne:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Sijoittakaa kansioon tämä compose.yaml, joka on otettu dokumentaation esimerkistä. Korvatkaa 1000:1000 komennon id näyttämillä arvoilla uid ja gid, ja TZ aikavyöhykkeellänne:
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: tämä on tärkein poikkeama dokumentaation esimerkistä, joka julkaisee sen kaikissa osoitteissa. Dokumentaatio suosittelee painokkaasti HTTPS:ää heti, kun Komga avataan lähiverkon ulkopuolelle, koska se käyttää HTTP:n perustodennusta. Käyttöliittymään pääsee silloin vain käänteisen välityspalvelimen kautta.user annetulla tunnisteella. Dokumentaatio pyytää, että liitetyt kansiot ovat saman käyttäjän omistuksessa: silloin käyttöoikeusongelmat katoavat./config sisältää Komgan tietokannan ja määritykset, paikallisella levyllä./data sisältää kirjanne ja tuontikansionne. Jokainen kirjasto saa sinne oman alikansionsa.1.x seuraa viimeisintä julkaistua versiota 1; 1.30.1 lukitsee version. Dokumentaatio kuvaa tunnisteen latest viimeisimmäksi commitiksi.version on jätetty pois: Docker Compose pitää sitä nykyään vanhentuneena ja ohittaa sen.Dokumentaation toinen tapa Linux-palvelimelle on kunkin julkaisun jar-tiedosto, joka julkaistaan GitHubissa. Se vaatii Java 17:n tai uudemman ja tallentaa määrityksensä kansioon ~/.komga:
java -version
java -jar komga-1.30.1.jar
Ensimmäisellä käynnillä Komga pyytää teitä luomaan tilin: sähköpostiosoitteen ja salasanan. Tämä ensimmäinen tili saa kaikki roolit, ylläpito mukaan lukien, ja ”ottaa palvelimen haltuunsa”. Niin kauan kuin tiliä ei ole, lomake vastaa kenelle tahansa, joka pääsee sivulle: luokaa se ennen kuin avaatte palvelimen yleisölle, SSH-tunnelin kautta. Palvelimen portti 25600 näkyy silloin tietokoneellanne osoitteessa http://localhost:25600. Lisätkää -p ja asiakasalueellanne näkyvä SSH-portti.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
Muut tilit luo ylläpitäjä kohdassa ”Server Settings”, ”Users” painikkeella +. Jokainen tili saa tarvitsemansa roolit:
| Rooli | Mitä se sallii |
|---|---|
| Administrator | Kirjastojen, käyttäjien ja kokoelmien hallinta, metatietojen muokkaus, skannausten, analyysien ja metatietojen päivitysten käynnistys |
| Page Streaming | Lukeminen sivu kerrallaan, esimerkiksi verkkolukijassa |
| File Download | Kirjan tiedoston lataaminen |
| Kobo Sync | Kobo-lukulaitteen synkronointi, yhdessä roolin File Download kanssa |
| KOReader Sync | Lukemisen edistymisen synkronointi KOReaderin kanssa |
Käyttäjän poistaminen pyyhkii kaiken hänen lukuedistymisensä, eikä sitä voi perua: juuri ennen otettu kopio kansiosta /config pitää ohjat käsissänne.
Dokumentaatio lisää komennon tiedostoon compose.yaml, palvelun komga alle; Komga toteuttaa muutoksen ja käynnistyy sitten tavalliseen tapaan. Käynnistäkää palvelu uudelleen, poistakaa sitten rivi ja käynnistäkää palvelu vielä kerran uudelleen:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Samalla tavalla käytetty komento --list-users tulostaa tilien luettelon lokeihin.
Komgalla on oletusarvo jokaiselle asetukselle: määritykset muuttavat vain sen toimintaa. Ne tehdään ympäristömuuttujilla, mikä on helpoin tapa Docker Composen kanssa, tai tiedostolla application.yml, jonka luotte kansioon /config, josta Docker-image lataa sen. Ominaisuuden nimestä saa muuttujan nimen korvaamalla pisteet alaviivoilla, poistamalla väliviivat ja kirjoittamalla kaiken isoin kirjaimin.
| Muuttuja | Ominaisuus | Oletus | Mitä se tekee |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Rajapinnan ja verkkokäyttöliittymän portti |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Perus-URL, jolla Komga tarjotaan alikansiosta |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 päivää | Kuinka kauan passiivinen istunto kestää, esimerkiksi 14d tai 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Ei mitään | CORS:lle sallitut alkuperät |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Ei asetettu | DEBUG yksityiskohtaisille lokeille |
Portin ja perus-URL:n voi asettaa myös kohdassa ”Server Settings”, ja tämä asetus menee silloin määritysten edelle. Java-muistia varten lisätkää muuttuja JAVA_TOOL_OPTIONS osioon environment. Dokumentaation esimerkki asettaa enimmäismääräksi 4 Gt:
- JAVA_TOOL_OPTIONS=-Xmx4g
Dokumentaation esimerkkitiedosto application.yml alkaa tietokannan polulla. Dockerin kanssa pitäkää se arvossa /config/database.sqlite, joka on sen oletusarvo: missä tahansa muualla tietokanta luotaisiin kontin sisään ja se katoaisi, kun kontti luodaan uudelleen. Ottakaa esimerkistä vain tarvitsemanne rivit.
Dokumentaatio suosittelee sijoittamaan Komgan eteen käänteisen välityspalvelimen, joka hankkii voimassa olevan varmenteen, ja ehdottaa Caddya, joka luo itse Let’s Encrypt -varmenteensa. Välityspalvelimen on asetettava kolme otsaketta, jotta Komga tuntee jokaisen pyynnön julkisen osoitteen ja protokollan:
X-Forwarded-For, asetettuna tai täydennettynä;X-Forwarded-Proto;X-Forwarded-Host.Aliverkkotunnuksessa, ilman perus-URL:ää Komgassa, Caddy asettaa nämä otsakkeet itse:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
Alikansiossa asettakaa ensin Komgan perus-URL arvoon /komga, kohdassa ”Server Settings” tai muuttujalla SERVER_SERVLET_CONTEXTPATH, ja sitten:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Dokumentaation Nginx-esimerkki välittää myös WebSocket-yhteydet. Lisätkää tämä lohko map tiedoston /etc/nginx/nginx.conf osioon http:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Tämä sivustolohko käyttää dokumentaation esimerkin asetuksia portissa 80, jotta Certbot voi ottaa HTTPS:n käyttöön. Rivi X-Forwarded-Host on lisätty, koska dokumentaation otsakeluettelo vaatii sen:
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
Dokumentaation täydellinen esimerkki näyttää lopullisen version: portti 80 ohjattuna HTTPS:ään ja lohko portissa 443 varmenteen polkuineen.
Kirjasto on joukko kirjoja juurikansion alla. Komga luo sarjan jokaiselle alikansiolle millä tahansa syvyydellä ja kirjan jokaiselle tiedostolle, ja sijoittaa sen yläkansionsa sarjaan. EPUB-tiedostojen ja arkistojen sisältämien ComicInfo.xml-tiedostojen metatiedot menevät kansioiden ja tiedostojen nimien edelle.
~/komga/data alikansioon kirjastoa kohden, SFTP:llä tai komennolla rsync./data/manga, ja napsauttakaa sitten ”Add”.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga ja /data/comics ovat rinnakkain; /data ja /data/manga eivät käy.#recycle.Kirja, jonka tiedosto katoaa, siirtyy roskakoriin merkinnällä ”Unavailable” sen sijaan, että se poistettaisiin: sen metatiedot, lukuedistyminen ja listat palaavat, jos tiedosto ilmestyy taas paikalleen. Voitte siis nimetä ja siirtää tiedostojanne menettämättä mitään. Roskakori tyhjennetään käsin, tai jokaisen skannauksen jälkeen, jos otatte sen valinnan käyttöön, jolloin kohteet poistuvat heti.
Näkymä ”Import”, ”Books” sijoittaa sarjoihinne kirjoja, jotka ovat palvelimen toisessa kansiossa, esimerkiksi /data/import. Jokaiselle tiedostolle valitsette kohdesarjan, numeron ja nimen; jo käytössä oleva numero tarjoaa olemassa olevan kirjan päivittämistä, ja molemmat näytetään rinnakkain. Komga siirtää tiedostot, tai luo kovia linkkejä, kun tiedostojärjestelmä sen sallii, ja muuten kopioi ne.
Jos kirjaston juurikansio vaihdetaan polkuun, jolla ei ole yhteyttä vanhaan, sen sarjat, kirjat ja lukuedistyminen poistuvat. Usein kysyttyjen kysymysten sivu kuvaa, miten kirjasto siirretään: tiedostotiivisteet käyttöön, roskakorin automaattinen tyhjennys pois käytöstä ja sitten skannaus ennen siirtoa.
Verkkolukija avautuu selaimessa palvelimen osoitteessa. Sovellukselle tai lukulaitteelle Komga tarjoaa kolme kulkutietä, jotka kaikki on tarjottava HTTPS:n kautta.
Komga toimii minkä tahansa OPDS-sovelluksen kanssa, versio 1 tai 2. Antakaa sovellukselle jokin näistä osoitteista ja sitten Komga-tilinne sähköpostiosoite ja salasana:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Version 1.2 luettelo lisää sarjahaun OpenSearchin kautta ja sivu kerrallaan lukemisen ilman latausta laajennuksen OPDS PSE kautta. Dokumentaatio ylläpitää luetteloa testatuista sovelluksista Androidilla, iOS:llä ja muualla sekä siitä, mitä kukin tukee.
Kobo-lukulaitteenne synkronoituu Komgan kanssa Kobon virallisten palvelimien sijaan. Kaikkien kirjastojen EPUB-kirjat saapuvat metatietoineen ja kansineen, ja Kepubify, joka sisältyy Docker-imageen, muuntaa ne lennossa KEPUB-muotoon. Lukemisen edistyminen synkronoituu molempiin suuntiin.
.kobo/Kobo/Kobo eReader.conf piilotiedostot näkyvissä.[OneStoreServices] rivi api_endpoint palvelimenne osoitteella, jonka perään tulee avaimenne.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint portti, HTTPS-osoitteelle 443.KOReader lukee Komgaa OPDS:n kautta ja synkronoi lukemisen edistymisen Komgan synkronointipalvelimen kautta:
https://komga.example.com/koreader.Kaikki, mitä Komga tietää kirjoistanne, on kansiossa /config; itse kirjat pysyvät kansiossa /data. Tässä on, mitä /config sisältää oletusmäärityksellä:
| Kohde | Mitä se sisältää |
|---|---|
database.sqlite | Päätietokanta: kirjastot, sarjat, kirjat, metatiedot, käyttäjät, lukuedistyminen, kokoelmat, lukulistat ja luodut pienoiskuvat |
tasks.sqlite | Odottavat taustatehtävät |
sessions.sqlite | Kirjautumisistunnot, jotka tallennetaan oletuksena tietokantaan versiosta 1.30.0 alkaen |
lucene/ | Hakuindeksi |
fonts/ | Fontit |
logs/ | Lokit, mukaan lukien komga.log |
application.yml | Määrityksenne, jos olette luoneet sellaisen |
SQLite-tietokannat kopioidaan Komgan ollessa pysäytettynä, jotta kopio on yhtenäinen. Tiedoston compose.yaml kansiosta:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Lähettäkää tämä arkisto palvelimen ulkopuolelle yhtä usein kuin lisäätte ja luette kirjoja. Säilyttäkää myös kopio kirjoistanne ja kansikuvista, joita pidätte tiedostojen vieressä: se on suurin tietomäärä, mutta se muuttuu vähän, ja rsync lähettää vain uuden. Palvelimen levyllä säilytettyinä nämä arkistot sisältyvät myös sen öisiin varmuuskopioihin.
Palauttaaksenne pysäyttäkää Komga, korvatkaa kansio config arkiston kansiolla, tarkistakaa, että sen omistaa edelleen tiedoston compose.yaml käyttäjä, ja käynnistäkää Komga uudelleen.
Docker Composen kanssa dokumentaatio antaa nämä komennot tiedoston compose.yaml kansiosta. Palvelimelta liitetty kansio /config säilyttää asetuksenne:
docker compose pull
docker compose up -d
docker image prune
/config juuri ennen jokaista päivitystä.jar-tiedoston kanssa pysäyttäkää Komga ja käynnistäkää se sitten uuden version jar-tiedostolla.Oma hostaus vaatii palvelimen ylläpitoa sovelluksen lisäksi. Managed VPS -palvelimella tiimimme huolehtivat palvelimesta ja seuraavat instanssianne proaktiivisesti; Komga pysyy teidän ohjelmananne asetuksineen ja kirjoinenne.
| Aihe | Tiimimme | Te |
|---|---|---|
| Palvelin | Järjestelmä- ja tietoturvapäivitykset, toimenpiteet palvelimella mukaan lukien | Toimintaanne sopiva ajankohta |
| Valvonta | Palvelinta seurataan ympäri vuorokauden joka päivä, ja puututaan asiaan odottamatta yhteydenottoanne | Instanssinne lokien lukeminen |
| Komga | Proaktiivinen seuranta: virheet, hitaus, muisti ja levytila havaitaan, ja korjausta suositellaan | Sen asennus, päivitykset ja asetukset, jotka toteutatte itse tai tekoälyavustajanne kanssa |
| Kirjastot ja lukijat | Niitä kantava palvelin, valvottuna ja varmuuskopioituna | Kirjastot, tilit, roolit ja API-avaimet |
| Varmuuskopiot | Joka yö, salattuina ja koneen ulkopuolella säilytettyinä; palautus sisältyy | Komgan omat kopiot sekä palautuspyyntö, kun tarvitsette sitä |
| Siirto | Nykyinen palvelimenne siirretään, veloituksetta | Käyttöönoton ajankohta |
Jos haluatte tiimiemme toimivan itse sovelluksessa, tämä palvelu laskutetaan tuntiveloituksella tai kiinteällä hinnalla, ja arvio annetaan ennen toimenpidettä.
Simafrin Managed VPS -palvelussa tiimimme pitävät Komga-instanssinne palvelimen ajan tasalla, valvovat sitä yötä päivää ja toimivat odottamatta yhteydenottoanne; ne seuraavat myös instanssianne proaktiivisesti ja suosittelevat teille hyödyllisiä korjauksia, jotka toteutatte itse tai tekoälyavustajanne kanssa. Varmuuskopiot salataan joka yö ja säilytetään koneen ulkopuolella, niiden palautus sisältyy, ja nykyisen palvelimenne siirto tehdään veloituksetta.
Kyllä. Komga on MIT-lisenssillä: voitte käyttää, muokata ja jakaa sitä edelleen yrityksessä ilman ostettavaa lisenssiä, kunhan säilytätte sen tekijänoikeusilmoituksen. Jäljelle jää sitä pyörittävän palvelimen kustannus.
Dokumentaatio ei määrää vähimmäismäärää. Oletuksena Java rajoittaa Komgan muistia, yleensä noin 1 Gt:hen. Jos lokeissa näkyy virheitä OutOfMemoryException, nostakaa rajaa muuttujalla JAVA_TOOL_OPTIONS, esimerkiksi -Xmx4g, joka antaa 4 Gt.
Luokaa compose.yaml, jossa on image gotson/komga, portti 25600 julkaistuna osoitteessa 127.0.0.1, polkuun /config liitetty config-kansio, polkuun /data liitetty data-kansio ja käyttäjä, joka omistaa molemmat, ja ajakaa docker compose up -d. Asettakaa sen jälkeen porttiin 25600 HTTPS:llä toimiva käänteinen välityspalvelin.
Ensimmäisellä käynnillä Komga pyytää sähköpostiosoitetta ja salasanaa: tämä ensimmäinen tili saa kaikki roolit. Luokaa se SSH-tunnelin kautta ennen kuin avaatte palvelimen yleisölle, ja luokaa sitten muut tilit kohdassa Server Settings, Users.
Palvelimenne osoitteen, jonka perään tulee /opds/v2/catalog OPDS 2:lle tai /opds/v1.2/catalog OPDS 1.2:lle, sekä Komga-tilinne sähköpostiosoitteen ja salasanan.
Antakaa tilille roolit Kobo Sync ja File Download, luokaa API-avain kohdassa Account Settings ja korvatkaa sitten tiedoston Kobo eReader.conf rivi api_endpoint osoitteella https://your-server/kobo/your-key. Vain EPUB-kirjat synkronoidaan.
Pysäyttäkää Komga, arkistoikaa config-kansio, käynnistäkää Komga uudelleen ja lähettäkää arkisto palvelimen ulkopuolelle. Säilyttäkää myös kopio kirjoistanne. Ottakaa kopio juuri ennen jokaista päivitystä.
Managed VPS kattaa palvelimen: järjestelmän, tietoturvan, valvonnan ja varmuuskopiot. Tiimimme seuraavat myös instanssianne proaktiivisesti ja suosittelevat hyödyllisiä korjauksia, jotka toteutatte itse. Toimenpide sovelluksessa laskutetaan tuntiveloituksella tai kiinteällä hinnalla.
Simafri
Jutellaan hankkeestasi
Kerro meille muutamalla sanalla, mitä tarvitset: vastaamme sinulle nopeasti.
Kiitos! Pyyntösi on lähetetty. Vastaamme sinulle pian.
Suositko sähköpostia? Kirjoita meille osoitteeseen support@simafri.com.