Gostovanje Komga na Managed VPS: vaši stripi in mange na vašem strežniku

Gostovanje Komga na Managed VPS pomeni, da svoje stripe, mange in e-knjige berete z lastnega stroja, ki ga naše ekipe posodabljajo in podnevi in ponoči spremljajo. Komga je medijski strežnik, prosta programska oprema pod licenco MIT. Ta vodnik sledi njeni uradni dokumentaciji: pomnilnik in shramba, ki ju je treba predvideti, namestitev z Docker Compose, prvi račun, konfiguracija, HTTPS, knjižnice, branje prek OPDS, Kobo in KOReader, varnostne kopije in posodobitve.

Simon Vasconcelos Lee Avtor: Objavljeno 22. novembra 2026Čas branja: 14 minut

Vsi vodniki

Na kratko

  1. Licenca MIT dovoljuje prosto uporabo, spreminjanje in nadaljnje razširjanje programa Komga, v podjetju in drugod, če ohranite njegovo obvestilo o avtorskih pravicah.
  2. Shrambo dimenzionirate po svoji zbirki, shranjeni v /data; zbirka podatkov, indeks in dnevniki so v /config, na lokalnem disku.
  3. Namestite jo z Docker Compose: slika gotson/komga, vrata 25600, objavljena lokalno za obratnim posredniškim strežnikom s HTTPS, in uporabnik, ki je lastnik obeh map.
  4. Prvi ustvarjeni račun postane skrbnik: ustvarite ga prek tunela SSH, preden strežnik odprete javnosti.
  5. Ustavite Komgo, kopirajte mapo /config zunaj strežnika, ohranite kopijo svojih knjig in posodabljajte z docker compose pull.

Kaj počne Komga

Komga je medijski strežnik za vaše stripe, mange, francosko-belgijske stripe, revije in e-knjige. Usmerite jo na mape z vašimi datotekami, ona pa jih uredi v knjižnice, serije in knjige ter jih nato streže brskalniku ali bralni aplikaciji. Teče povsod, kjer tečeta Java ali Docker.

Kaj dovoljuje licenca MIT

Komga je objavljena pod licenco MIT, na ime Gauthierja Roebroecka. Ta brezplačno podeljuje pravico do uporabe, kopiranja, spreminjanja, združevanja, objave, razširjanja, podlicenciranja in prodaje kopij programske opreme. Poganjate jo torej lahko zase, za svojo družino, svoje društvo ali svoje podjetje, ne da bi morali kupiti licenco.

Edini pogoj je, da obvestilo o avtorskih pravicah in besedilo licence ohranite v vseh kopijah ali bistvenih delih programske opreme. Besedilo programsko opremo ponuja „takšno, kot je“, brez garancije.

Pomnilnik, procesor in shramba: dimenzioniranje strežnika

Dokumentacija ne določa najmanjše konfiguracije. Navaja pa tisto, kar šteje pri dimenzioniranju strežnika: pomnilnik navideznega stroja Java, opravila, ki obremenjujejo procesor, in predvsem prostor, ki ga zasedajo vaše datoteke.

Pomnilnik Jave

Procesor

Procesor dela predvsem med pregledovanjem in analizo knjižnic. Za vsako knjižnico dokumentacija opozarja, da lahko izračun zgoščenih vrednosti (hashev) datotek, strani in za KOReader, tako kot analiza dimenzij strani, pri veliki knjižnici porabi veliko virov. Število niti, namenjenih opravilom v ozadju, se nastavi v „Server Settings“.

Shramba za vaše knjige

To je največja postavka in izmerite jo sami: velikost vaše zbirke in prostor za knjige, ki jih nameravate dodati. Komga bere vaše datoteke tam, kjer so, in jih ne kopira. Nekaj točk iz dokumentacije spremeni izračun:

Na Managed VPS nam opišite svojo zbirko, njeno velikost, hitrost rasti in število bralcev, pa vam bomo priporočili pravo velikost.

Namestitev z Docker Compose

Dokumentacija objavlja sliko gotson/komga na Docker Hub in na ghcr.io, za procesorje amd64, arm64 in arm. Na strežniku z nameščenim Dockerjem ustvarite mapo za Komgo z njenima dvema podmapama in si zapišite svoj ID uporabnika:

Terminal
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id

Vanjo postavite ta compose.yaml, povzet po primeru iz dokumentacije. Zamenjajte 1000:1000 z vrednostma uid in gid, ki ju izpiše id, in TZ s svojim časovnim pasom:

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

Brez Dockerja: datoteka jar

Druga pot iz dokumentacije za strežnik z Linuxom je datoteka jar vsake izdaje, objavljena na GitHubu. Potrebuje Javo 17 ali novejšo in svojo konfiguracijo hrani v ~/.komga:

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

Prvi račun in uporabniki

Ob prvem dostopu vas Komga prosi, da ustvarite račun: e-poštni naslov in geslo. Ta prvi račun dobi vse vloge, vključno s skrbništvom, in si strežnik „prisvoji“. Dokler ne obstaja, ta obrazec odgovarja vsakomur, ki pride do strani: ustvarite ga prek tunela SSH, preden strežnik odprete javnosti. Vrata 25600 strežnika se tedaj pokažejo na vašem računalniku, na http://localhost:25600. Dodajte -p in vrata SSH, prikazana v vašem uporabniškem območju.

Terminal, na vašem računalniku
ssh -L 25600:127.0.0.1:25600 user@komga.example.com

Nadaljnje račune ustvari skrbnik, v „Server Settings“, „Users“, z gumbom +. Vsak račun dobi vloge, ki jih potrebuje:

VlogaKaj omogoča
AdministratorUpravljanje knjižnic, uporabnikov in zbirk, urejanje metapodatkov, zagon pregledov, analiz in osvežitev metapodatkov
Page StreamingBranje stran za stranjo, na primer v spletnem bralniku
File DownloadPrenos datoteke knjige
Kobo SyncSinhronizacija e-bralnika Kobo, skupaj s File Download
KOReader SyncSinhronizacija napredka pri branju s KOReader

Izbris uporabnika dokončno izbriše ves njegov napredek pri branju: kopija /config, narejena tik pred tem, vam ohrani nadzor.

Ponastavitev gesla iz ukazne vrstice

Dokumentacija doda ukaz v compose.yaml, pod storitev komga; Komga uveljavi spremembo in se nato zažene kot običajno. Znova zaženite storitev, nato odstranite vrstico in jo znova zaženite še enkrat:

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

Ukaz --list-users, uporabljen na enak način, izpiše seznam računov v dnevnike.

Konfiguracija: spremenljivke ali application.yml

Komga ima privzete vrednosti za vsako nastavitev: konfiguracija le spremeni njeno vedenje. Opravi se s spremenljivkami okolja, kar je z Docker Compose najpreprostejša pot, ali z datoteko application.yml, ki jo ustvarite v mapi /config, od koder jo naloži slika Docker. Da ime lastnosti pretvorite v ime spremenljivke, zamenjajte pike s podčrtaji, odstranite vezaje in vse pretvorite v velike črke.

SpremenljivkaLastnostPrivzetoKaj počne
SERVER_PORTserver.port25600Vrata za API in spletni vmesnik
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/Osnovni URL, za streženje programa Komga iz podmape
SPRING_SESSION_TIMEOUTspring.session.timeout7 dniKako dolgo traja neaktivna seja, na primer 14d ali 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsBrezIzvori (origins), dovoljeni za CORS
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaNi nastavljenoDEBUG za podrobne dnevnike

Vrata in osnovni URL lahko nastavite tudi v „Server Settings“, ta nastavitev pa ima tedaj prednost pred konfiguracijo. Za pomnilnik Jave dodajte spremenljivko JAVA_TOOL_OPTIONS v razdelek environment. Primer iz dokumentacije nastavi največ 4 GB:

compose.yaml, v environment
      - JAVA_TOOL_OPTIONS=-Xmx4g

Vzorčni application.yml v dokumentaciji se začne s potjo do zbirke podatkov. Z Dockerjem jo pustite na /config/database.sqlite, njeni privzeti vrednosti: kjer koli drugje bi se zbirka podatkov ustvarila znotraj vsebnika in se ob njegovi ponovni izdelavi izgubila. Iz vzorca ohranite le vrstice, ki jih potrebujete.

HTTPS in obratni posredniški strežnik

Dokumentacija priporoča, da pred Komgo postavite obratni posredniški strežnik, ki pridobi veljavno potrdilo, in predlaga Caddy, ki sam ustvarja potrdila Let’s Encrypt. Posredniški strežnik mora nastaviti tri glave, da Komga pozna javni naslov in protokol vsake zahteve:

S Caddy

Na poddomeni, brez osnovnega URL-ja v nastavitvah programa Komga, Caddy te glave nastavi sam:

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

V podmapi najprej nastavite osnovni URL programa Komga na /komga, v „Server Settings“ ali s spremenljivko SERVER_SERVLET_CONTEXTPATH, nato:

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

Z Nginx

Primer za Nginx v dokumentaciji posreduje tudi povezave WebSocket. Ta blok map dodajte v razdelek http datoteke /etc/nginx/nginx.conf:

nginx.conf, v http
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

Ta blok spletišča uporablja nastavitve iz primera v dokumentaciji, na vratih 80, da lahko Certbot namesti HTTPS. Vrstica X-Forwarded-Host je dodana, ker jo zahteva seznam glav v dokumentaciji:

Blok Nginx
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

Celoten primer v dokumentaciji prikazuje končno različico: vrata 80, preusmerjena na HTTPS, in blok na vratih 443 s potmi do potrdila.

Knjižnice, pregledi in uvozi

Knjižnica je skupina knjig, shranjena pod korensko mapo. Komga ustvari serijo za vsako podmapo, na kateri koli globini, in knjigo za vsako datoteko, uvrščeno v serijo njene nadrejene mape. Metapodatki iz datotek EPUB in iz datotek ComicInfo.xml znotraj arhivov imajo prednost pred imeni map in datotek.

  1. Postavite datoteke na strežnik, v eno podmapo ~/komga/data na knjižnico, prek SFTP ali z rsync.
  2. V vmesniku kliknite + poleg „Libraries“.
  3. Poimenujte knjižnico, izberite njeno korensko mapo z „Browse“, na primer /data/manga, nato kliknite „Add“.
Terminal, na vašem računalniku
rsync -av manga/ user@komga.example.com:komga/data/manga/

Koš

Knjiga, katere datoteka izgine, se namesto izbrisa premakne v koš z oznako „Unavailable“: njeni metapodatki, napredek pri branju in seznami se vrnejo, če se datoteka znova pojavi na svojem mestu. Svoje datoteke torej lahko preimenujete in premikate, ne da bi kar koli izgubili. Koš se prazni ročno ali po vsakem pregledu, če vklopite to možnost, ki tedaj elemente takoj odstrani.

Uvoz knjig

Zaslon „Import“, „Books“ v vaše serije uvrsti knjige, ki so v drugi mapi strežnika, na primer /data/import. Za vsako datoteko izberete ciljno serijo, številko in ime; že uporabljena številka ponudi nadgradnjo obstoječe knjige, pri čemer sta obe prikazani druga ob drugi. Komga datoteke premakne ali zanje ustvari trde povezave, kadar datotečni sistem to dovoljuje, sicer pa jih kopira.

Sprememba korenske mape knjižnice v pot, ki ni povezana s staro, izbriše njene serije, knjige in napredek pri branju. FAQ opisuje, kako jo premakniti: vklopljeno računanje zgoščenih vrednosti datotek, izklopljeno samodejno praznjenje koša, nato pregled pred premikom.

Berite kjer koli: OPDS, Kobo in KOReader

Spletni bralnik se odpre v brskalniku, na naslovu strežnika. Za aplikacijo ali e-bralnik Komga ponuja troje vrat, vsa za streženje prek HTTPS.

OPDS

Komga deluje s katero koli aplikacijo OPDS, različice 1 ali 2. Aplikaciji vpišite enega od teh naslovov, nato e-poštni naslov in geslo svojega računa Komga:

Naslovi OPDS
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog

Katalog različice 1.2 doda iskanje po serijah, prek OpenSearch, in branje stran za stranjo brez prenosa, prek razširitve OPDS PSE. Dokumentacija vodi seznam preizkušenih aplikacij, za Android, iOS in drugod, s tem, kar vsaka podpira.

Kobo Sync

Vaš e-bralnik Kobo se sinhronizira s Komgo namesto z uradnimi strežniki Kobo. Knjige EPUB iz vseh knjižnic prispejo z metapodatki in naslovnico, sproti pretvorjene v KEPUB z orodjem Kepubify, ki je del slike Docker. Napredek pri branju se sinhronizira v obe smeri.

  1. Računu dodelite vlogi Kobo Sync in File Download.
  2. Ustvarite ključ API na strani svojega računa, „Account Settings“, in si ga zapišite: prikaže se le enkrat. Uporabljajte en ključ na e-bralnik.
  3. Kobo povežite z računalnikom in odprite datoteko .kobo/Kobo/Kobo eReader.conf, s prikazanimi skritimi datotekami.
  4. V skupini [OneStoreServices] zamenjajte vrstico api_endpoint z naslovom svojega strežnika, ki mu sledi vaš ključ.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

KOReader Sync

KOReader bere Komgo prek OPDS in svoj napredek pri branju sinhronizira prek strežnika za sinhronizacijo programa Komga:

  1. Računu dodelite vlogo KOReader Sync in v možnostih knjižnice vklopite računanje zgoščenih vrednosti datotek za KOReader.
  2. Ustvarite ključ API na strani svojega računa.
  3. V KOReaderju, z odprto knjigo, pojdite v „Progress sync“, nato „Custom sync server“, in vpišite https://komga.example.com/koreader.
  4. V „Register / Login“ vpišite ključ API kot uporabniško ime, kot geslo pa katero koli vrednost, ki je Komga ne uporablja.
  5. V „Document matching method“ izberite „Binary“.

Varnostne kopije

Vse, kar Komga ve o vaših knjigah, je v /config; same knjige ostanejo v /data. Tole vsebuje /config pri privzeti konfiguraciji:

ElementKaj hrani
database.sqliteGlavna zbirka podatkov: knjižnice, serije, knjige, metapodatki, uporabniki, napredek pri branju, zbirke, bralni seznami in ustvarjene sličice
tasks.sqliteČakajoča opravila v ozadju
sessions.sqliteSeje prijave, od različice 1.30.0 privzeto shranjene v zbirki podatkov
lucene/Iskalni indeks
fonts/Pisave
logs/Dnevniki, vključno s komga.log
application.ymlVaša konfiguracija, če ste jo ustvarili

Zbirke podatkov SQLite se kopirajo, ko je Komga ustavljena, da je kopija skladna. Iz mape datoteke compose.yaml:

Terminal, v ~/komga
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start

Ta arhiv pošiljajte zunaj strežnika tako pogosto, kot dodajate in berete knjige. Ohranite tudi kopijo svojih knjig, z naslovnicami, ki jih hranite ob datotekah: to je največji obseg, vendar se malo spreminja, rsync pa pošlje le novo. Postavljeni na disk strežnika ti arhivi vstopijo tudi v njegove nočne varnostne kopije.

Za obnovo ustavite Komgo, zamenjajte mapo config z mapo iz arhiva, preverite, da je njen lastnik še vedno uporabnik iz compose.yaml, nato jo znova zaženite.

Posodobitve

Z Docker Compose dokumentacija navaja te ukaze, iz mape datoteke compose.yaml. Mapa /config, priklopljena s strežnika, ohrani vaše nastavitve:

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

Kdo kaj dela na Managed VPS

Samostojno gostovanje poleg aplikacije zahteva tudi vzdrževanje strežnika. Na Managed VPS naše ekipe prevzamejo strežnik in proaktivno spremljajo vašo instanco; Komga ostaja vaša programska oprema, z vašimi nastavitvami in vašimi knjigami.

TemaNaše ekipeVi
StrežnikPosodobitve sistema in varnosti, vključno s posegi na strežnikuTrenutek, ki ustreza vaši dejavnosti
NadzorStrežnik pod nadzorom 24 ur na dan, 7 dni v tednu, s posegom brez čakanja na vaš klicBranje dnevnikov vaše instance
KomgaProaktivno spremljanje: napake, upočasnitve, pomnilnik in prostor na disku, s priporočenim popravkomNamestitev, posodobitve in nastavitve, ki jih uvedete vi ali vaš AI pomočnik
Knjižnice in bralciStrežnik, ki jih nosi, pod nadzorom in varnostno kopiranKnjižnice, računi, vloge in ključi API
Varnostne kopijeVsako noč, šifrirane in shranjene zunaj stroja; obnova je vključenaKopije, značilne za Komgo, in zahteva za obnovo, ko jo potrebujete
SelitevSelitev vašega sedanjega strežnika, brezplačnoTrenutek preklopa

Če želite, da naše ekipe posežejo v samo aplikacijo, se ta storitev zaračuna po urah ali pavšalno, z oceno stroškov, sporočeno pred posegom.

Komga na strežniku, ki ga vzdržujemo za vas

Z Managed VPS Simafri naše ekipe strežnik vaše instance Komga sproti posodabljajo, ga podnevi in ponoči nadzirajo ter posežejo brez čakanja na vaš klic; vašo instanco tudi proaktivno spremljajo in vam priporočajo koristne popravke, ki jih uvedete vi ali vaš AI pomočnik. Varnostne kopije so vsako noč šifrirane in shranjene zunaj stroja, njihova obnova je vključena, selitev vašega sedanjega strežnika pa je brezplačna.

Odkrijte Managed VPS

Pogosta vprašanja

Ali je Komga za podjetje brezplačna?

Da. Komga je pod licenco MIT: v podjetju jo lahko uporabljate, spreminjate in nadalje razširjate, ne da bi morali kupiti licenco, če ohranite njeno obvestilo o avtorskih pravicah. Ostane le strošek strežnika, na katerem teče.

Koliko pomnilnika potrebuje Komga?

Dokumentacija ne določa najmanjše vrednosti. Privzeto Java omeji pomnilnik programa Komga, običajno na približno 1 GB. Če dnevniki kažejo napake OutOfMemoryException, omejitev dvignite z JAVA_TOOL_OPTIONS, na primer -Xmx4g za 4 GB.

Kako namestiti Komgo z Docker Compose?

Ustvarite compose.yaml s sliko gotson/komga, vrati 25600, objavljenimi na 127.0.0.1, mapo config, priklopljeno na /config, mapo data, priklopljeno na /data, in uporabnikom, ki je lastnik obeh, nato zaženite docker compose up -d. Pred vrata 25600 nato postavite obratni posredniški strežnik s HTTPS.

Kako ustvariti skrbniški račun programa Komga?

Ob prvem dostopu Komga zahteva e-poštni naslov in geslo: ta prvi račun dobi vse vloge. Ustvarite ga prek tunela SSH, preden strežnik odprete javnosti, nato ostale račune ustvarite v Server Settings, Users.

Kateri naslov OPDS vpišem v bralno aplikacijo?

Naslov svojega strežnika, ki mu sledi /opds/v2/catalog za OPDS 2 ali /opds/v1.2/catalog za OPDS 1.2, skupaj z e-poštnim naslovom in geslom svojega računa Komga.

Kako sinhronizirati e-bralnik Kobo s Komgo?

Računu dodelite vlogi Kobo Sync in File Download, ustvarite ključ API v Account Settings, nato v datoteki Kobo eReader.conf zamenjajte vrstico api_endpoint z https://vas-streznik/kobo/vas-kljuc. Sinhronizirajo se le knjige EPUB.

Kako varnostno kopirati Komgo?

Ustavite Komgo, arhivirajte mapo config, jo znova zaženite in arhiv pošljite zunaj strežnika. Ohranite tudi kopijo svojih knjig. Kopijo naredite tudi tik pred vsako posodobitvijo.

Ali Managed VPS pokriva Komgo?

Managed VPS pokriva strežnik: sistem, varnost, nadzor in varnostne kopije. Naše ekipe proaktivno spremljajo tudi vašo instanco in vam priporočajo koristne popravke, ki jih uvedete vi. Poseg v aplikacijo se zaračuna po urah ali pavšalno.

Viri in uradna dokumentacija

Stopite v stik z nami