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.
Avtor: Simon Vasconcelos Lee
Objavljeno 22. novembra 2026Čas branja: 14 minut
/data; zbirka podatkov, indeks in dnevniki so v /config, na lokalnem disku.gotson/komga, vrata 25600, objavljena lokalno za obratnim posredniškim strežnikom s HTTPS, in uporabnik, ki je lastnik obeh map./config zunaj strežnika, ohranite kopijo svojih knjig in posodabljajte z docker compose pull.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.
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.
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.
OutOfMemoryException v dnevnikih. Omejitev se tedaj dvigne s spremenljivko JAVA_TOOL_OPTIONS, prikazano v nadaljevanju.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“.
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:
/data za knjige in uvoze: dokumentacija prosi, da vanjo postavite svoje knjižnice in mapo za uvoz, da uvozi ustvarjajo trde povezave namesto kopij. Zunaj istega datotečnega sistema vsak uvoz zasede prostor kopije./config hrani glavno zbirko podatkov s sličicami, ustvarjenimi za vsako knjigo, zbirko opravil, zbirko sej, iskalni indeks in dnevnike, ki jih privzeta konfiguracija hrani 7 dni in omeji na 1 GB. Raste z velikostjo vaših knjižnic./config: zbirke podatkov SQLite nikoli ne smejo biti na omrežni skupni rabi, kot sta CIFS ali NFS. Komga to preveri ob zagonu in se ustavi, če ni tako.Na Managed VPS nam opišite svojo zbirko, njeno velikost, hitrost rasti in število bralcev, pa vam bomo priporočili pravo velikost.
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:
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:
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: to je glavno odstopanje od primera iz dokumentacije, ki jih objavi na vseh naslovih. Dokumentacija močno priporoča HTTPS, takoj ko je Komga odprta zunaj vašega lokalnega omrežja, ker uporablja osnovno preverjanje pristnosti HTTP (basic). Vmesnik je tedaj dosegljiv le prek obratnega posredniškega strežnika.user. Dokumentacija prosi, da je lastnik priklopljenih map isti uporabnik: težave z dovoljenji tedaj izginejo./config hrani zbirko podatkov in konfiguracijo programa Komga, na lokalnem disku./data hrani vaše knjige in vašo mapo za uvoz. Vsaka knjižnica bo v njej imela svojo podmapo.1.x sledi zadnji objavljeni različici 1; 1.30.1 zaklene različico. Dokumentacija opisuje latest kot zadnji commit.version iz primera v dokumentaciji je izpuščena: Docker Compose jo zdaj šteje za zastarelo in jo prezre.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:
java -version
java -jar komga-1.30.1.jar
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.
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:
| Vloga | Kaj omogoča |
|---|---|
| Administrator | Upravljanje knjižnic, uporabnikov in zbirk, urejanje metapodatkov, zagon pregledov, analiz in osvežitev metapodatkov |
| Page Streaming | Branje stran za stranjo, na primer v spletnem bralniku |
| File Download | Prenos datoteke knjige |
| Kobo Sync | Sinhronizacija e-bralnika Kobo, skupaj s File Download |
| KOReader Sync | Sinhronizacija 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.
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:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Ukaz --list-users, uporabljen na enak način, izpiše seznam računov v dnevnike.
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.
| Spremenljivka | Lastnost | Privzeto | Kaj počne |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Vrata za API in spletni vmesnik |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Osnovni URL, za streženje programa Komga iz podmape |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 dni | Kako dolgo traja neaktivna seja, na primer 14d ali 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Brez | Izvori (origins), dovoljeni za CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Ni nastavljeno | DEBUG 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:
- 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.
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:
X-Forwarded-For, nastavljena ali dopolnjena;X-Forwarded-Proto;X-Forwarded-Host.Na poddomeni, brez osnovnega URL-ja v nastavitvah programa Komga, Caddy te glave nastavi sam:
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:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Primer za Nginx v dokumentaciji posreduje tudi povezave WebSocket. Ta blok map dodajte v razdelek http datoteke /etc/nginx/nginx.conf:
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:
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
Celoten primer v dokumentaciji prikazuje končno različico: vrata 80, preusmerjena na HTTPS, in blok na vratih 443 s potmi do potrdila.
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.
~/komga/data na knjižnico, prek SFTP ali z rsync./data/manga, nato kliknite „Add“.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga in /data/comics obstajata druga ob drugi; /data in /data/manga ne moreta.#recycle.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.
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.
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.
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:
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.
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.
.kobo/Kobo/Kobo eReader.conf, s prikazanimi skritimi datotekami.[OneStoreServices] zamenjajte vrstico api_endpoint z naslovom svojega strežnika, ki mu sledi vaš ključ.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 za naslov HTTPS.KOReader bere Komgo prek OPDS in svoj napredek pri branju sinhronizira prek strežnika za sinhronizacijo programa Komga:
https://komga.example.com/koreader.Vse, kar Komga ve o vaših knjigah, je v /config; same knjige ostanejo v /data. Tole vsebuje /config pri privzeti konfiguraciji:
| Element | Kaj hrani |
|---|---|
database.sqlite | Glavna 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.sqlite | Seje 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.yml | Vaša konfiguracija, če ste jo ustvarili |
Zbirke podatkov SQLite se kopirajo, ko je Komga ustavljena, da je kopija skladna. Iz mape datoteke compose.yaml:
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.
Z Docker Compose dokumentacija navaja te ukaze, iz mape datoteke compose.yaml. Mapa /config, priklopljena s strežnika, ohrani vaše nastavitve:
docker compose pull
docker compose up -d
docker image prune
/config.jar ustavite Komgo, nato jo zaženite z datoteko jar nove različice.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.
| Tema | Naše ekipe | Vi |
|---|---|---|
| Strežnik | Posodobitve sistema in varnosti, vključno s posegi na strežniku | Trenutek, ki ustreza vaši dejavnosti |
| Nadzor | Strežnik pod nadzorom 24 ur na dan, 7 dni v tednu, s posegom brez čakanja na vaš klic | Branje dnevnikov vaše instance |
| Komga | Proaktivno spremljanje: napake, upočasnitve, pomnilnik in prostor na disku, s priporočenim popravkom | Namestitev, posodobitve in nastavitve, ki jih uvedete vi ali vaš AI pomočnik |
| Knjižnice in bralci | Strežnik, ki jih nosi, pod nadzorom in varnostno kopiran | Knjižnice, računi, vloge in ključi API |
| Varnostne kopije | Vsako noč, šifrirane in shranjene zunaj stroja; obnova je vključena | Kopije, značilne za Komgo, in zahteva za obnovo, ko jo potrebujete |
| Selitev | Selitev vašega sedanjega strežnika, brezplačno | Trenutek 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Pogovorimo se o vašem projektu
Povejte nam v nekaj besedah, kaj potrebujete: hitro se vam oglasimo.
Hvala! Vaše povpraševanje je bilo poslano. Kmalu vam bomo odgovorili.
Imate raje e-pošto? Pišite nam na support@simafri.com.