Komga talpinimas Managed VPS serveryje reiškia, kad savo komiksus, mangą ir elektronines knygas skaitote iš savo mašinos, kurią mūsų komandos prižiūri atnaujintą ir stebi dieną bei naktį. Komga yra medijos serveris, laisva programinė įranga su MIT licencija. Šis gidas seka oficialią jos dokumentaciją: kiek atminties ir saugyklos reikia, diegimą su Docker Compose, pirmąją paskyrą, konfigūraciją, HTTPS, bibliotekas, skaitymą per OPDS, Kobo ir KOReader, atsargines kopijas ir atnaujinimus.
Autorius: Simon Vasconcelos Lee
Paskelbta 2026 m. lapkričio 22 d.Skaitymo trukmė: 14 min.
/data; duomenų bazė, indeksas ir žurnalai yra /config, vietiniame diske.gotson/komga, 25600 prievadas, paskelbtas vietoje už HTTPS atvirkštinio tarpinio serverio, ir naudotojas, kuriam priklauso abu katalogai./config už serverio ribų, laikykite savo knygų kopiją ir atnaujinkite su docker compose pull.Komga yra medijos serveris jūsų komiksams, mangai, BD, žurnalams ir elektroninėms knygoms. Nurodote jai katalogus, kuriuose yra jūsų failai, ji suskirsto juos į bibliotekas, serijas ir knygas, tada pateikia juos naršyklei arba skaitymo programai. Ji veikia visur, kur veikia Java arba Docker.
Komga platinama pagal MIT licenciją, Gauthier Roebroeck vardu. Ji nemokamai suteikia teisę naudoti, kopijuoti, keisti, sujungti, skelbti, platinti, suteikti sublicencijas ir parduoti programinės įrangos kopijas. Taigi galite ją paleisti sau, savo šeimai, asociacijai ar įmonei, nepirkdami jokios licencijos.
Vienintelė sąlyga yra išlaikyti autorių teisių pranešimą ir licencijos tekstą visose programinės įrangos kopijose ar esminėse jos dalyse. Tekstas pateikia programinę įrangą „tokią, kokia yra“, be garantijų.
Dokumentacija nenustato minimalios konfigūracijos. Tačiau ji pateikia tai, kas svarbu parenkant serverio dydį: Java virtualiosios mašinos atmintį, procesorių apkraunančias užduotis ir, svarbiausia, vietą, kurią užima jūsų failai.
OutOfMemoryException žurnaluose. Tada riba padidinama kintamuoju JAVA_TOOL_OPTIONS, parodytu toliau.Procesorius daugiausia dirba bibliotekų nuskaitymo ir analizės metu. Kiekvienai bibliotekai dokumentacija perspėja, kad failų maišos reikšmių, puslapių maišos reikšmių ir KOReader maišos reikšmių skaičiavimas, kaip ir puslapių matmenų analizė, didelėje bibliotekoje gali sunaudoti daug išteklių. Foninėms užduotims skirtų gijų skaičius nustatomas skiltyje „Server Settings“.
Tai didžiausia dalis, ir ją išmatuojate jūs: jūsų kolekcijos dydis ir vieta knygoms, kurias planuojate pridėti. Komga skaito jūsų failus ten, kur jie yra, ir jų nekopijuoja. Keli dokumentacijos punktai keičia skaičiavimą:
/data knygoms ir importui: dokumentacija prašo ten laikyti savo bibliotekas ir importo katalogą, kad importuojant būtų kuriamos kietosios nuorodos vietoj kopijų. Už tos pačios failų sistemos ribų kiekvienas importas užima kopijos vietą./config laiko pagrindinę duomenų bazę su kiekvienai knygai sugeneruotomis miniatiūromis, užduočių duomenų bazę, sesijų duomenų bazę, paieškos indeksą ir žurnalus, kuriuos numatytoji konfigūracija laiko 7 dienas ir riboja iki 1 GB. Jis auga kartu su jūsų bibliotekų dydžiu./config: SQLite duomenų bazės niekada neturi būti tinklo bendrinamame ištekliuje, pavyzdžiui, CIFS ar NFS. Komga tai patikrina paleidimo metu ir sustoja, jei taip nėra.Naudojant Managed VPS, papasakokite mums apie savo kolekciją, jos dydį, kaip greitai ji auga ir kiek turite skaitytojų, ir mes rekomenduosime tinkamą dydį.
Dokumentacija skelbia atvaizdą gotson/komga Docker Hub ir ghcr.io, procesoriams amd64, arm64 ir arm. Serveryje su įdiegtu Docker sukurkite katalogą Komga su dviem jo pakatalogiais ir užsirašykite savo naudotojo identifikatorių:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Įdėkite į jį šį compose.yaml, paimtą iš dokumentacijos pavyzdžio. Pakeiskite 1000:1000 reikšmėmis uid ir gid, kurias rodo id, o TZ savo laiko juosta:
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: tai pagrindinis skirtumas nuo dokumentacijos pavyzdžio, kuris jį skelbia visais adresais. Dokumentacija primygtinai pataria naudoti HTTPS, kai tik Komga atveriama už jūsų vietinio tinklo ribų, nes ji naudoja HTTP Basic autentifikavimą. Tada sąsaja pasiekiama tik per atvirkštinį tarpinį serverį.user. Dokumentacija prašo, kad prijungti katalogai priklausytų tam pačiam naudotojui: tada teisių problemos išnyksta./config laiko Komga duomenų bazę ir konfigūraciją, vietiniame diske./data laiko jūsų knygas ir importo katalogą. Kiekviena biblioteka ten turės savo pakatalogį.1.x seka naujausią paskelbtą 1 versiją; 1.30.1 užfiksuoja versiją. Dokumentacija latest apibūdina kaip naujausią commit.version iš dokumentacijos pavyzdžio praleista: Docker Compose dabar ją laiko pasenusia ir ignoruoja.Kitas dokumentacijos kelias Linux serveriui yra kiekvienos versijos jar failas, skelbiamas GitHub. Jam reikia Java 17 arba naujesnės, o savo konfigūraciją jis laiko ~/.komga:
java -version
java -jar komga-1.30.1.jar
Pirmą kartą prisijungus Komga paprašo sukurti paskyrą: el. pašto adresą ir slaptažodį. Ši pirmoji paskyra gauna visus vaidmenis, įskaitant administravimą, ir „perima“ serverį. Kol jos nėra, ši forma atsako kiekvienam, kas pasiekia puslapį: sukurkite ją prieš atverdami serverį visuomenei, per SSH tunelį. Tada serverio 25600 prievadas atsiranda jūsų kompiuteryje, adresu http://localhost:25600. Pridėkite -p ir SSH prievadą, nurodytą jūsų kliento zonoje.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
Kitas paskyras kuria administratorius, skiltyje „Server Settings“, „Users“, mygtuku +. Kiekviena paskyra gauna jai reikalingus vaidmenis:
| Vaidmuo | Ką leidžia |
|---|---|
| Administrator | Tvarkyti bibliotekas, naudotojus ir kolekcijas, redaguoti metaduomenis, paleisti nuskaitymus, analizes ir metaduomenų atnaujinimus |
| Page Streaming | Skaityti puslapis po puslapio, pavyzdžiui, žiniatinklio skaitykle |
| File Download | Atsisiųsti knygos failą |
| Kobo Sync | Sinchronizuoti Kobo skaityklę, kartu su File Download |
| KOReader Sync | Sinchronizuoti skaitymo pažangą su KOReader |
Ištrynus naudotoją, visa jo skaitymo pažanga ištrinama negrįžtamai: /config kopija, padaryta prieš pat tai, palieka jus valdančius situaciją.
Dokumentacija prideda komandą į compose.yaml, po paslauga komga; Komga pritaiko pakeitimą, tada paleidžiama kaip įprasta. Iš naujo paleiskite paslaugą, tada pašalinkite eilutę ir paleiskite ją iš naujo dar kartą:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Komanda --list-users, naudojama tuo pačiu būdu, išveda paskyrų sąrašą į žurnalus.
Komga turi numatytąsias reikšmes kiekvienam nustatymui: konfigūracija tik keičia jos elgseną. Ji atliekama aplinkos kintamaisiais, paprasčiausiu keliu su Docker Compose, arba failu application.yml, kurį sukuriate kataloge /config, iš kurio jį įkelia Docker atvaizdas. Kad savybės pavadinimą paverstumėte kintamojo pavadinimu, taškus pakeiskite pabraukimais, pašalinkite brūkšnelius ir rašykite didžiosiomis raidėmis.
| Kintamasis | Savybė | Numatytoji reikšmė | Ką daro |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | API ir žiniatinklio sąsajos prievadas |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Bazinis URL adresas, kad Komga būtų pateikiama iš pakatalogio |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 dienos | Kiek trunka neaktyvi sesija, pavyzdžiui, 14d arba 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Nėra | CORS leidžiamos kilmės vietos |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Nenustatyta | DEBUG išsamiems žurnalams |
Prievadą ir bazinį URL adresą taip pat galima nustatyti skiltyje „Server Settings“, ir tada šis nustatymas turi pirmenybę prieš konfigūraciją. Java atminčiai pridėkite kintamąjį JAVA_TOOL_OPTIONS į skiltį environment. Dokumentacijos pavyzdys nustato daugiausia 4 GB:
- JAVA_TOOL_OPTIONS=-Xmx4g
Dokumentacijos pavyzdinis application.yml prasideda duomenų bazės keliu. Su Docker palikite jį /config/database.sqlite, jo numatytąją reikšmę: bet kur kitur duomenų bazė būtų sukurta konteinerio viduje ir prarasta jį atkuriant. Palikite tik tas pavyzdžio eilutes, kurių jums reikia.
Dokumentacija rekomenduoja priešais Komga pastatyti atvirkštinį tarpinį serverį, kuris gauna galiojantį sertifikatą, ir siūlo Caddy, kuris pats generuoja savo Let’s Encrypt sertifikatus. Tarpinis serveris turi nustatyti tris antraštes, kad Komga žinotų kiekvienos užklausos viešąjį adresą ir protokolą:
X-Forwarded-For, nustatyta arba papildyta;X-Forwarded-Proto;X-Forwarded-Host.Subdomene, be bazinio URL adreso Komga, Caddy pats nustato šias antraštes:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
Pakatalogyje pirmiausia nustatykite Komga bazinį URL adresą į /komga, skiltyje „Server Settings“ arba su SERVER_SERVLET_CONTEXTPATH, tada:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Dokumentacijos Nginx pavyzdys taip pat perduoda WebSocket ryšius. Pridėkite šį bloką map į failo /etc/nginx/nginx.conf skiltį http:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Šis svetainės blokas naudoja dokumentacijos pavyzdžio nustatymus, 80 prievadu, kad Certbot galėtų įdiegti HTTPS. Eilutė X-Forwarded-Host pridėta, nes jos reikalauja dokumentacijos antraščių sąrašas:
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
Visas dokumentacijos pavyzdys rodo galutinę versiją: 80 prievadas nukreiptas į HTTPS, o blokas 443 prievade su sertifikato keliais.
Biblioteka yra knygų grupė, laikoma po šakniniu katalogu. Komga sukuria seriją kiekvienam pakatalogiui, bet kokiame gylyje, ir knygą kiekvienam failui, priskirtą jo tėvinio katalogo serijai. EPUB failų ir archyvuose esančių ComicInfo.xml failų metaduomenys turi pirmenybę prieš katalogų ir failų pavadinimus.
~/komga/data pakatalogį kiekvienai bibliotekai, per SFTP arba su rsync./data/manga, tada spustelėkite „Add“.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga ir /data/comics gyvena greta; /data ir /data/manga negali.#recycle.Knyga, kurios failas dingsta, perkeliama į šiukšlinę ir pažymima „Unavailable“, užuot buvusi ištrinta: jos metaduomenys, skaitymo pažanga ir sąrašai sugrįžta, jei failas vėl atsiranda savo vietoje. Taigi galite pervadinti ir perkelti savo failus nieko neprarasdami. Šiukšlinė ištuštinama rankiniu būdu arba po kiekvieno nuskaitymo, jei įjungiate šią parinktį, kuri tada elementus pašalina iš karto.
Ekranas „Import“, „Books“ į jūsų serijas įtraukia knygas, esančias kitame serverio kataloge, pavyzdžiui, /data/import. Kiekvienam failui pasirenkate tikslinę seriją, numerį ir pavadinimą; jau naudojamas numeris siūlo atnaujinti esamą knygą, abi rodant greta. Komga perkelia failus arba sukuria į juos kietąsias nuorodas, kai failų sistema tai leidžia, o kitu atveju juos nukopijuoja.
Pakeitus bibliotekos šakninį katalogą į kelią, nesusijusį su senuoju, ištrinamos jos serijos, knygos ir skaitymo pažanga. DUK aprašo, kaip ją perkelti: įjungtas failų maišos reikšmių skaičiavimas, išjungtas automatinis šiukšlinės tuštinimas, tada nuskaitymas prieš perkėlimą.
Žiniatinklio skaityklė atsidaro naršyklėje, serverio adresu. Programai ar skaityklei Komga siūlo trejas duris, visas teiktinas per HTTPS.
Komga veikia su bet kuria OPDS programa, 1 arba 2 versijos. Nurodykite programai vieną iš šių adresų, tada savo Komga paskyros el. pašto adresą ir slaptažodį:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
1.2 versijos katalogas prideda paiešką pagal seriją, per OpenSearch, ir skaitymą puslapis po puslapio be atsisiuntimo, per plėtinį OPDS PSE. Dokumentacija tvarko išbandytų programų sąrašą, Android, iOS ir kitoms sistemoms, su tuo, ką kiekviena palaiko.
Jūsų Kobo skaityklė sinchronizuojasi su Komga vietoj oficialių Kobo serverių. EPUB knygos iš visų bibliotekų atkeliauja su savo metaduomenimis ir viršeliu, realiuoju laiku konvertuotos į KEPUB programa Kepubify, kuri yra Docker atvaizde. Skaitymo pažanga sinchronizuojama abiem kryptimis.
.kobo/Kobo/Kobo eReader.conf, įjungę paslėptų failų rodymą.[OneStoreServices] pakeiskite eilutę api_endpoint savo serverio adresu, po kurio eina jūsų raktas.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint prievadas, 443 HTTPS adresui.KOReader skaito Komga per OPDS ir sinchronizuoja savo skaitymo pažangą per Komga sinchronizavimo serverį:
https://komga.example.com/koreader.Viskas, ką Komga žino apie jūsų knygas, yra /config; pačios knygos lieka /data. Štai ką /config turi su numatytąja konfigūracija:
| Elementas | Ką laiko |
|---|---|
database.sqlite | Pagrindinė duomenų bazė: bibliotekos, serijos, knygos, metaduomenys, naudotojai, skaitymo pažanga, kolekcijos, skaitymo sąrašai ir sugeneruotos miniatiūros |
tasks.sqlite | Laukiančios foninės užduotys |
sessions.sqlite | Prisijungimo sesijos, nuo 1.30.0 versijos pagal numatytuosius nustatymus saugomos duomenų bazėje |
lucene/ | Paieškos indeksas |
fonts/ | Šriftai |
logs/ | Žurnalai, įskaitant komga.log |
application.yml | Jūsų konfigūracija, jei ją sukūrėte |
SQLite duomenų bazės kopijuojamos sustabdžius Komga, kad kopija būtų nuosekli. Iš compose.yaml katalogo:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Siųskite šį archyvą už serverio ribų taip dažnai, kaip pridedate ir skaitote knygas. Taip pat laikykite savo knygų kopiją, su viršeliais, kuriuos laikote šalia failų: tai didžiausia apimtis, bet ji mažai keičiasi, o rsync siunčia tik tai, kas nauja. Laikomi serverio diske, šie archyvai taip pat patenka į jo naktines atsargines kopijas.
Norėdami atkurti, sustabdykite Komga, pakeiskite katalogą config archyve esančiu, patikrinkite, ar jis vis dar priklauso compose.yaml nurodytam naudotojui, tada vėl ją paleiskite.
Su Docker Compose dokumentacija pateikia šias komandas, vykdomas compose.yaml kataloge. Katalogas /config, prijungtas iš serverio, išsaugo jūsų nustatymus:
docker compose pull
docker compose up -d
docker image prune
/config kopiją prieš pat kiekvieną atnaujinimą.jar failu sustabdykite Komga, tada paleiskite ją su naujos versijos jar.Talpinant savo serveryje, be programos reikia prižiūrėti ir patį serverį. Naudojant Managed VPS, mūsų komandos perima serverį ir proaktyviai stebi jūsų egzempliorių; Komga lieka jūsų programa su savo nustatymais ir jūsų knygomis.
| Tema | Mūsų komandos | Jūs |
|---|---|---|
| Serveris | Sistemos ir saugumo atnaujinimai, įskaitant įsikišimą serveryje | Jūsų veiklai tinkamas momentas |
| Stebėsena | Serveris stebimas 24 val. per parą, 7 dienas per savaitę, įsikišant nelaukiant jūsų skambučio | Jūsų egzemplioriaus žurnalų skaitymas |
| Komga | Proaktyvi stebėsena: klaidos, sulėtėjimai, atmintis ir disko vieta pastebimi, rekomenduojamas pataisymas | Jos diegimas, atnaujinimai ir nustatymai, kuriuos pritaikote jūs arba jūsų DI asistentas |
| Bibliotekos ir skaitytojai | Juos nešantis serveris, stebimas ir saugomas atsarginėmis kopijomis | Bibliotekos, paskyros, vaidmenys ir API raktai |
| Atsarginės kopijos | Kiekvieną naktį, šifruotos ir saugomos už mašinos ribų; atkūrimas įskaičiuotas | Komga savos kopijos ir atkūrimo prašymas, kai jo prireikia |
| Perkėlimas | Jūsų dabartinis serveris perkeliamas nemokamai | Perjungimo momentas |
Jei norite, kad mūsų komandos įsikištų į pačią programą, ši paslauga apmokestinama valandomis arba fiksuota kaina, o skaičiavimas pateikiamas prieš įsikišimą.
Su Simafri Managed VPS mūsų komandos palaiko jūsų Komga egzemplioriaus serverį atnaujintą, stebi jį dieną ir naktį ir įsikiša nelaukdamos jūsų skambučio; jos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs arba jūsų DI asistentas. Atsarginės kopijos kiekvieną naktį šifruojamos ir saugomos už mašinos ribų, jų atkūrimas įskaičiuotas, o jūsų dabartinio serverio perkėlimas nemokamas.
Taip. Komga platinama pagal MIT licenciją: įmonėje ją galite naudoti, keisti ir platinti nieko nepirkdami dėl licencijos, jei išlaikote jos autorių teisių pranešimą. Lieka tik ją vykdančio serverio kaina.
Dokumentacija nenustato minimumo. Pagal numatytuosius nustatymus Java riboja Komga atmintį, paprastai apie 1 GB. Jei žurnaluose matomos klaidos OutOfMemoryException, padidinkite ribą su JAVA_TOOL_OPTIONS, pavyzdžiui, -Xmx4g 4 GB atminčiai.
Sukurkite compose.yaml su atvaizdu gotson/komga, 25600 prievadu, paskelbtu adresu 127.0.0.1, katalogu config, prijungtu prie /config, katalogu data, prijungtu prie /data, ir naudotoju, kuriam priklauso abu, tada paleiskite docker compose up -d. Po to prieš 25600 prievadą pastatykite HTTPS atvirkštinį tarpinį serverį.
Pirmą kartą prisijungus Komga paprašo el. pašto adreso ir slaptažodžio: ši pirmoji paskyra gauna visus vaidmenis. Sukurkite ją per SSH tunelį, prieš atverdami serverį visuomenei, tada kitas paskyras sukurkite skiltyje Server Settings, Users.
Savo serverio adresą, po kurio eina /opds/v2/catalog OPDS 2 versijai arba /opds/v1.2/catalog OPDS 1.2 versijai, su savo Komga paskyros el. pašto adresu ir slaptažodžiu.
Suteikite paskyrai vaidmenis Kobo Sync ir File Download, sugeneruokite API raktą skiltyje Account Settings, tada failo Kobo eReader.conf eilutę api_endpoint pakeiskite į https://jūsų-serveris/kobo/jūsų-raktas. Sinchronizuojamos tik EPUB knygos.
Sustabdykite Komga, suarchyvuokite katalogą config, vėl ją paleiskite ir nusiųskite archyvą už serverio ribų. Taip pat laikykite savo knygų kopiją. Padarykite kopiją prieš pat kiekvieną atnaujinimą.
Managed VPS apima serverį: sistemą, saugumą, stebėseną ir atsargines kopijas. Mūsų komandos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs. Įsikišimas į pačią programą apmokestinamas valandomis arba fiksuota kaina.
Simafri
Pakalbėkime apie jūsų sumanymą
Pasakykite mums keliais žodžiais, ko jums reikia: greitai jums atsakome.
Ačiū! Jūsų užklausa išsiųsta. Netrukus su jumis susisieksime.
Labiau mėgstate el. paštą? Rašykite mums adresu support@simafri.com.