Komga majutamine Managed VPS-is: teie koomiksid ja mangad teie enda serveris

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.

Simon Vasconcelos Lee Autor: Avaldatud 22. novembril 2026Lugemisaeg: 15 minutit

Kõik juhendid

Lühidalt

  1. MIT-litsents lubab Komgat vabalt kasutada, muuta ja edasi levitada, ettevõttes ja mujal, tingimusel et säilitate selle autoriõiguse teate.
  2. Salvestusruum mõõdetakse teie kogu järgi, mis asub kaustas /data; andmebaas, indeks ja logid asuvad kaustas /config, kohalikul kettal.
  3. Paigaldage see Docker Compose’iga: tõmmis gotson/komga, port 25600 kohalikult avaldatuna HTTPS-iga pöördproksi taga ja kasutaja, kellele kuuluvad mõlemad kaustad.
  4. Esimesena loodud kontost saab administraator: looge see SSH-tunneli kaudu, enne kui serveri avalikkusele avate.
  5. Peatage Komga, kopeerige kaust /config serverist välja, hoidke oma raamatutest koopiat ja uuendage käsuga docker compose pull.

Mida Komga teeb

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.

Mida MIT-litsents lubab

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.

Mälu, protsessor ja salvestusruum: serveri mõõtmine

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.

Java mälu

Protsessor

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».

Teie raamatute salvestusruum

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:

Managed VPS-is kirjeldage meile oma kogu, selle mahtu, kasvutempot ja lugejate arvu ning soovitame sobiva suuruse.

Paigaldus Docker Compose’iga

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:

Terminal
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:

compose.yaml
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
Terminal
docker compose up -d
docker logs -f komga

Ilma Dockerita: jar-fail

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:

Terminal
java -version
java -jar komga-1.30.1.jar

Esimene konto ja kasutajad

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.

Terminal, teie arvutis
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:

RollMida see lubab
AdministratorRaamatukogude, kasutajate ja kogumike haldamine, metaandmete muutmine, skannimiste, analüüside ja metaandmete värskenduste käivitamine
Page StreamingLehekülghaaval lugemine, näiteks veebilugejas
File DownloadRaamatu faili allalaadimine
Kobo SyncKobo e-lugeri sünkroonimine, koos rolliga File Download
KOReader SyncLugemise 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.

Parooli lähtestamine käsurealt

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:

compose.yaml, teenuse komga all
    command: --newpassword=YourNewPassword --reset=admin@example.org
Terminal
docker compose up -d

Samamoodi kasutatav käsk --list-users kuvab logides kontode loendi.

Konfiguratsioon: muutujad või application.yml

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.

MuutujaAtribuutVaikimisiMida see teeb
SERVER_PORTserver.port25600API ja veebiliidese port
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/Baas-URL, et serveerida Komgat alamkaustas
SPRING_SESSION_TIMEOUTspring.session.timeout7 päevaMitteaktiivse seansi kestus, näiteks 14d või 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsPuudubCORS-i jaoks lubatud päritolud
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaMääramataDEBUG ü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:

compose.yaml, jaotises environment
      - 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.

HTTPS ja pöördproksi

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:

Caddy-ga

Alamdomeenil, ilma Komga baas-URL-ita, seab Caddy need päised ise:

Caddyfile
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:

Caddyfile
example.com {
    reverse_proxy /komga/* 127.0.0.1:25600
}

Nginxiga

Dokumentatsiooni Nginxi näide edastab ka WebSocketi ühendused. Lisage see plokk map faili /etc/nginx/nginx.conf jaotisse http:

nginx.conf, jaotises 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:

Nginxi plokk
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;
    }
}
Terminal
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.

Raamatukogud, skannimine ja importimine

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.

  1. Pange oma failid serverisse, iga raamatukogu jaoks ühte kausta ~/komga/data alamkausta, SFTP kaudu või käsuga rsync.
  2. Klõpsake liideses jaotise «Libraries» kõrval nuppu +.
  3. Andke raamatukogule nimi, valige nupuga «Browse» selle juurkaust, näiteks /data/manga, ja klõpsake nuppu «Add».
Terminal, teie arvutis
rsync -av manga/ user@komga.example.com:komga/data/manga/

Prügikast

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.

Raamatute importimine

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.

Lugege kõikjal: OPDS, Kobo ja KOReader

Veebilugeja avaneb brauseris serveri aadressil. Rakenduse või e-lugeri jaoks pakub Komga kolme ust, mida kõiki tuleb serveerida HTTPS-i kaudu.

OPDS

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:

OPDS-aadressid
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.

Kobo sünkroonimine

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.

  1. Andke kontole rollid Kobo Sync ja File Download.
  2. Looge oma konto lehel «Account Settings» API-võti ja kirjutage see üles: seda näidatakse ainult üks kord. Kasutage iga e-lugeri jaoks eraldi võtit.
  3. Ühendage Kobo oma arvutiga ja avage fail .kobo/Kobo/Kobo eReader.conf, kui peidetud failid on nähtavaks tehtud.
  4. Asendage rühmas [OneStoreServices] rida api_endpoint oma serveri aadressiga, millele järgneb teie võti.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

KOReaderi sünkroonimine

KOReader loeb Komgat OPDS-i kaudu ja sünkroonib oma lugemise edenemise Komga sünkroonimisserveri kaudu:

  1. Andke kontole roll KOReader Sync ja lülitage raamatukogu valikutes sisse KOReaderi failiräsid.
  2. Looge oma konto lehel API-võti.
  3. Avage KOReaderis raamat, minge jaotisse «Progress sync», seejärel «Custom sync server» ja sisestage https://komga.example.com/koreader.
  4. Sisestage jaotises «Register / Login» kasutajanimeks API-võti ja parooliks mis tahes väärtus, mida Komga ei kasuta.
  5. Valige jaotises «Document matching method» väärtus «Binary».

Varukoopiad

Kõik, mida Komga teie raamatutest teab, asub kaustas /config; teie raamatud ise jäävad kausta /data. Siin on see, mida /config vaikekonfiguratsiooniga sisaldab:

ElementMida see hoiab
database.sqlitePeamine andmebaas: raamatukogud, sarjad, raamatud, metaandmed, kasutajad, lugemise edenemine, kogumikud, lugemisloendid ja loodud pisipildid
tasks.sqliteOotel taustaülesanded
sessions.sqliteSisselogimisseansid, mida hoitakse alates versioonist 1.30.0 vaikimisi andmebaasis
lucene/Otsinguindeks
fonts/Fondid
logs/Logid, sealhulgas komga.log
application.ymlTeie konfiguratsioon, kui olete selle loonud

SQLite’i andmebaasid kopeeritakse peatatud Komgaga, et koopia oleks terviklik. Kaustast, kus asub compose.yaml:

Terminal, kaustas ~/komga
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.

Uuendused

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:

Terminal
docker compose pull
docker compose up -d
docker image prune

Kes mida teeb Managed VPS-is

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.

TeemaMeie meeskonnadTeie
ServerSüsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatudHetk, mis sobib teie tegevusele
SeireServerit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamataTeie instantsi logide lugemine
KomgaProaktiivne jälgimine: vead, aeglus, mälu ja kettaruum avastatakse, parandus soovitatakseSelle paigaldus, uuendused ja sätted, mille rakendate teie või teie tehisintellekti assistent
Raamatukogud ja lugejadNeid kandev server, jälgitud ja varundatudRaamatukogud, kontod, rollid ja API-võtmed
VarukoopiadIgal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldubKomga enda koopiad ja taastamistaotlus, kui seda vajate
ÜleviimineTeie 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.

Komga teie eest hoitud serveris

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.

Vaadake Managed VPS

Korduma kippuvad küsimused

Kas Komga on ettevõttele 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.

Kui palju mälu Komga vajab?

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.

Kuidas paigaldada Komga Docker Compose’iga?

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.

Kuidas luua Komga administraatori konto?

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.

Millise OPDS-aadressi peaksin oma lugemisrakendusele andma?

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.

Kuidas sünkroonida Kobo e-lugerit Komgaga?

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.

Kuidas Komgat varundada?

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.

Kas Managed VPS katab Komga?

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.

Allikad ja ametlik dokumentatsioon

Võtke meiega ühendust