Talpinkite Komga Managed VPS serveryje: komiksai ir manga jūsų serveryje

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.

Simon Vasconcelos Lee Autorius: Paskelbta 2026 m. lapkričio 22 d.Skaitymo trukmė: 14 min.

Visi gidai

Svarbiausia

  1. MIT licencija leidžia laisvai naudoti, keisti ir platinti Komga, įmonėje ar bet kur kitur, jei išlaikote jos autorių teisių pranešimą.
  2. Saugykla parenkama pagal jūsų kolekciją, laikomą /data; duomenų bazė, indeksas ir žurnalai yra /config, vietiniame diske.
  3. Įdiekite ją su Docker Compose: atvaizdas gotson/komga, 25600 prievadas, paskelbtas vietoje už HTTPS atvirkštinio tarpinio serverio, ir naudotojas, kuriam priklauso abu katalogai.
  4. Pirmoji sukurta paskyra tampa administratoriaus paskyra: sukurkite ją per SSH tunelį, prieš atverdami serverį visuomenei.
  5. Sustabdykite Komga, nukopijuokite katalogą /config už serverio ribų, laikykite savo knygų kopiją ir atnaujinkite su docker compose pull.

Ką daro Komga

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.

Ką leidžia MIT licencija

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

Atmintis, procesorius ir saugykla: serverio dydis

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.

Java atmintis

Procesorius

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

Saugykla jūsų knygoms

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

Naudojant Managed VPS, papasakokite mums apie savo kolekciją, jos dydį, kaip greitai ji auga ir kiek turite skaitytojų, ir mes rekomenduosime tinkamą dydį.

Diegimas su Docker Compose

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

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

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

Be Docker: jar failas

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:

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

Pirmoji paskyra ir naudotojai

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.

Terminal, jūsų kompiuteryje
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:

VaidmuoKą leidžia
AdministratorTvarkyti bibliotekas, naudotojus ir kolekcijas, redaguoti metaduomenis, paleisti nuskaitymus, analizes ir metaduomenų atnaujinimus
Page StreamingSkaityti puslapis po puslapio, pavyzdžiui, žiniatinklio skaitykle
File DownloadAtsisiųsti knygos failą
Kobo SyncSinchronizuoti Kobo skaityklę, kartu su File Download
KOReader SyncSinchronizuoti 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ą.

Slaptažodžio atkūrimas komandų eilute

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

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

Komanda --list-users, naudojama tuo pačiu būdu, išveda paskyrų sąrašą į žurnalus.

Konfigūracija: kintamieji arba application.yml

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.

KintamasisSavybėNumatytoji reikšmėKą daro
SERVER_PORTserver.port25600API ir žiniatinklio sąsajos prievadas
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/Bazinis URL adresas, kad Komga būtų pateikiama iš pakatalogio
SPRING_SESSION_TIMEOUTspring.session.timeout7 dienosKiek trunka neaktyvi sesija, pavyzdžiui, 14d arba 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsNėraCORS leidžiamos kilmės vietos
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaNenustatytaDEBUG 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:

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

HTTPS ir atvirkštinis tarpinis serveris

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

Su Caddy

Subdomene, be bazinio URL adreso Komga, Caddy pats nustato šias antraštes:

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

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

Su Nginx

Dokumentacijos Nginx pavyzdys taip pat perduoda WebSocket ryšius. Pridėkite šį bloką map į failo /etc/nginx/nginx.conf skiltį http:

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

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

Visas dokumentacijos pavyzdys rodo galutinę versiją: 80 prievadas nukreiptas į HTTPS, o blokas 443 prievade su sertifikato keliais.

Bibliotekos, nuskaitymas ir importas

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.

  1. Įkelkite savo failus į serverį, po vieną ~/komga/data pakatalogį kiekvienai bibliotekai, per SFTP arba su rsync.
  2. Sąsajoje spustelėkite + šalia „Libraries“.
  3. Pavadinkite biblioteką, pasirinkite jos šakninį katalogą su „Browse“, pavyzdžiui, /data/manga, tada spustelėkite „Add“.
Terminal, jūsų kompiuteryje
rsync -av manga/ user@komga.example.com:komga/data/manga/

Šiukšlinė

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.

Knygų importas

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

Skaitykite bet kur: OPDS, Kobo ir KOReader

Žiniatinklio skaityklė atsidaro naršyklėje, serverio adresu. Programai ar skaityklei Komga siūlo trejas duris, visas teiktinas per HTTPS.

OPDS

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

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

Kobo Sync

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.

  1. Suteikite paskyrai vaidmenis Kobo Sync ir File Download.
  2. Sugeneruokite API raktą savo paskyros puslapyje, „Account Settings“, ir užsirašykite jį: jis rodomas tik kartą. Kiekvienai skaityklei naudokite atskirą raktą.
  3. Prijunkite Kobo prie kompiuterio ir atidarykite failą .kobo/Kobo/Kobo eReader.conf, įjungę paslėptų failų rodymą.
  4. Grupėje [OneStoreServices] pakeiskite eilutę api_endpoint savo serverio adresu, po kurio eina jūsų raktas.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

KOReader Sync

KOReader skaito Komga per OPDS ir sinchronizuoja savo skaitymo pažangą per Komga sinchronizavimo serverį:

  1. Suteikite paskyrai vaidmenį KOReader Sync ir bibliotekos parinktyse įjunkite failų maišos reikšmių skaičiavimą KOReader.
  2. Sugeneruokite API raktą savo paskyros puslapyje.
  3. KOReader programoje, atidarę knygą, eikite į „Progress sync“, tada „Custom sync server“, ir įveskite https://komga.example.com/koreader.
  4. Skiltyje „Register / Login“ įveskite API raktą kaip naudotojo vardą ir bet kokią reikšmę kaip slaptažodį, kurio Komga nenaudoja.
  5. Skiltyje „Document matching method“ pasirinkite „Binary“.

Atsarginės kopijos

Viskas, ką Komga žino apie jūsų knygas, yra /config; pačios knygos lieka /data. Štai ką /config turi su numatytąja konfigūracija:

ElementasKą laiko
database.sqlitePagrindinė duomenų bazė: bibliotekos, serijos, knygos, metaduomenys, naudotojai, skaitymo pažanga, kolekcijos, skaitymo sąrašai ir sugeneruotos miniatiūros
tasks.sqliteLaukiančios foninės užduotys
sessions.sqlitePrisijungimo 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.ymlJū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:

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

Atnaujinimai

Su Docker Compose dokumentacija pateikia šias komandas, vykdomas compose.yaml kataloge. Katalogas /config, prijungtas iš serverio, išsaugo jūsų nustatymus:

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

Kas ką daro Managed VPS serveryje

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.

TemaMūsų komandosJūs
ServerisSistemos ir saugumo atnaujinimai, įskaitant įsikišimą serveryjeJūsų veiklai tinkamas momentas
StebėsenaServeris stebimas 24 val. per parą, 7 dienas per savaitę, įsikišant nelaukiant jūsų skambučioJūsų egzemplioriaus žurnalų skaitymas
KomgaProaktyvi stebėsena: klaidos, sulėtėjimai, atmintis ir disko vieta pastebimi, rekomenduojamas pataisymasJos diegimas, atnaujinimai ir nustatymai, kuriuos pritaikote jūs arba jūsų DI asistentas
Bibliotekos ir skaitytojaiJuos nešantis serveris, stebimas ir saugomas atsarginėmis kopijomisBibliotekos, paskyros, vaidmenys ir API raktai
Atsarginės kopijosKiekvieną naktį, šifruotos ir saugomos už mašinos ribų; atkūrimas įskaičiuotasKomga savos kopijos ir atkūrimo prašymas, kai jo prireikia
PerkėlimasJūsų dabartinis serveris perkeliamas nemokamaiPerjungimo 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ą.

Komga serveryje, kurį prižiūrime už jus

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.

Žiūrėti Managed VPS

Dažni klausimai

Ar Komga nemokama įmonei?

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.

Kiek atminties reikia Komga?

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.

Kaip įdiegti Komga su Docker Compose?

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

Kaip sukurti Komga administratoriaus paskyrą?

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.

Kokį OPDS adresą nurodyti skaitymo programai?

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.

Kaip sinchronizuoti Kobo skaityklę su Komga?

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.

Kaip sukurti Komga atsarginę kopiją?

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

Ar Managed VPS apima Komga?

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.

Šaltiniai ir oficiali dokumentacija

Susisiekite su mumis