Mitināt Komga Managed VPS serverī: jūsu komiksi un manga jūsu serverī

Mitināt Komga Managed VPS serverī nozīmē lasīt savus komiksus, mangu un e-grāmatas no savas mašīnas, ko mūsu komandas uztur atjauninātu un uzrauga dienu un nakti. Komga ir mediju serveris, atvērtā koda programmatūra ar MIT licenci. Šis ceļvedis seko tā oficiālajai dokumentācijai: paredzamā atmiņa un krātuve, uzstādīšana ar Docker Compose, pirmais konts, konfigurācija, HTTPS, bibliotēkas, lasīšana caur OPDS, Kobo un KOReader, rezerves kopijas un atjauninājumi.

Simon Vasconcelos Lee Autors: Publicēts 2026. gada 22. novembrīLasīšanas laiks: 14 minūtes

Visi ceļveži

Galvenais

  1. MIT licence ļauj brīvi izmantot, mainīt un izplatīt tālāk Komga, darbā vai jebkur citur, ja vien saglabājat tā autortiesību paziņojumu.
  2. Krātuves apjomu nosaka jūsu kolekcija, kas glabājas /data; datubāze, indekss un žurnāli atrodas /config, lokālā diskā.
  3. Uzstādiet to ar Docker Compose: attēls gotson/komga, ports 25600, publicēts lokāli aiz HTTPS reversā starpniekservera, un lietotājs, kuram pieder abas mapes.
  4. Pirmais izveidotais konts kļūst par administratoru: izveidojiet to caur SSH tuneli, pirms atverat serveri publikai.
  5. Apturiet Komga, nokopējiet mapi /config ārpus servera, glabājiet savu grāmatu kopiju un atjauniniet ar docker compose pull.

Ko dara Komga

Komga ir mediju serveris jūsu komiksiem, mangai, BD, žurnāliem un e-grāmatām. Jūs norādāt tam mapes, kurās ir jūsu faili, tas tos sakārto bibliotēkās, sērijās un grāmatās, pēc tam pasniedz tos pārlūkprogrammai vai lasīšanas lietotnei. Tas darbojas visur, kur darbojas Java vai Docker.

Ko atļauj MIT licence

Komga tiek izplatīts ar MIT licenci, uz Gauthier Roebroeck vārda. Tā bez maksas piešķir tiesības izmantot, kopēt, mainīt, apvienot, publicēt, izplatīt, piešķirt apakšlicences un pārdot programmatūras kopijas. Tātad varat to darbināt sev, savai ģimenei, biedrībai vai uzņēmumam, nepērkot nekādu licenci.

Vienīgais nosacījums ir saglabāt autortiesību paziņojumu un licences tekstu visās programmatūras kopijās vai tās būtiskās daļās. Teksts nodrošina programmatūru «tādu, kāda tā ir», bez garantijas.

Atmiņa, procesors un krātuve: servera izmērs

Dokumentācija nenosaka minimālo konfigurāciju. Toties tā sniedz to, kas ir svarīgi servera izmēra noteikšanā: Java virtuālās mašīnas atmiņu, uzdevumus, kas noslogo procesoru, un galvenokārt vietu, ko aizņem jūsu faili.

Java atmiņa

Procesors

Procesors strādā galvenokārt bibliotēku skenēšanas un analīzes laikā. Katrai bibliotēkai dokumentācija brīdina, ka failu jaucējvērtību, lappušu jaucējvērtību un KOReader jaucējvērtību aprēķināšana, tāpat kā lappušu izmēru analīze, lielā bibliotēkā var patērēt daudz resursu. Fona uzdevumiem atvēlēto pavedienu skaitu iestata sadaļā «Server Settings».

Krātuve jūsu grāmatām

Tā ir lielākā pozīcija, un to izmērāt jūs: jūsu kolekcijas apjoms, plus vieta grāmatām, ko plānojat pievienot. Komga lasa jūsu failus tur, kur tie atrodas, un tos nekopē. Daži dokumentācijas punkti maina aprēķinu:

Ar Managed VPS pastāstiet mums par savu kolekciju, tās apjomu, cik ātri tā aug un cik lasītāju jums ir, un mēs ieteiksim piemērotu izmēru.

Uzstādīšana ar Docker Compose

Dokumentācija publicē attēlu gotson/komga Docker Hub un ghcr.io, procesoriem amd64, arm64 un arm. Serverī ar uzstādītu Docker izveidojiet mapi Komga ar tās divām apakšmapēm un pierakstiet savu lietotāja identifikatoru:

Terminālis
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id

Ievietojiet tajā šo compose.yaml, kas ņemts no dokumentācijas piemēra. Aizstājiet 1000:1000 ar vērtībām uid un gid, ko parāda id, un TZ ar savu laika joslu:

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
Terminālis
docker compose up -d
docker logs -f komga

Bez Docker: jar fails

Otrs dokumentācijas ceļš Linux serverim ir katras versijas jar fails, kas publicēts GitHub. Tam vajag Java 17 vai jaunāku, un savu konfigurāciju tas glabā ~/.komga:

Terminālis
java -version
java -jar komga-1.30.1.jar

Pirmais konts un lietotāji

Pirmajā piekļuvē Komga lūdz izveidot kontu: e-pasta adresi un paroli. Šis pirmais konts saņem visas lomas, ieskaitot administrēšanu, un «pieprasa» serveri. Kamēr tas nepastāv, šī veidlapa atbild ikvienam, kas sasniedz lapu: izveidojiet to, pirms atverat serveri publikai, caur SSH tuneli. Tad servera ports 25600 parādās jūsu datorā, adresē http://localhost:25600. Pievienojiet -p un SSH portu, kas norādīts jūsu klienta zonā.

Terminālis, jūsu datorā
ssh -L 25600:127.0.0.1:25600 user@komga.example.com

Nākamos kontus izveido administrators sadaļā «Server Settings», «Users», ar pogu +. Katrs konts saņem tam vajadzīgās lomas:

LomaKo tā atļauj
AdministratorPārvaldīt bibliotēkas, lietotājus un kolekcijas, rediģēt metadatus, palaist skenēšanu, analīzi un metadatu atsvaidzināšanu
Page StreamingLasīt lappusi pēc lappuses, piemēram, tīmekļa lasītājā
File DownloadLejupielādēt grāmatas failu
Kobo SyncSinhronizēt Kobo e-lasītāju, kopā ar File Download
KOReader SyncSinhronizēt lasīšanas progresu ar KOReader

Dzēšot lietotāju, tiek neatgriezeniski izdzēsts viss viņa lasīšanas progress: /config kopija, kas izveidota tieši pirms tam, ļauj jums saglabāt kontroli.

Paroles atiestatīšana no komandrindas

Dokumentācija pievieno komandu failā compose.yaml, zem pakalpojuma komga; Komga piemēro izmaiņu, pēc tam startē kā parasti. Restartējiet pakalpojumu, pēc tam noņemiet rindu un restartējiet to vēlreiz:

compose.yaml, zem pakalpojuma komga
    command: --newpassword=YourNewPassword --reset=admin@example.org
Terminālis
docker compose up -d

Komanda --list-users, izmantota tādā pašā veidā, izvada kontu sarakstu žurnālos.

Konfigurācija: mainīgie vai application.yml

Komga ir noklusējuma vērtības katram iestatījumam: konfigurācija tikai maina tā uzvedību. To veic ar vides mainīgajiem, vienkāršāko ceļu ar Docker Compose, vai ar failu application.yml, ko izveidojat mapē /config, no kurienes to ielādē Docker attēls. Lai īpašības nosaukumu pārvērstu mainīgā nosaukumā, aizstājiet punktus ar pasvītrām, noņemiet defises un pārveidojiet uz lielajiem burtiem.

MainīgaisĪpašībaNoklusējumsKo tas dara
SERVER_PORTserver.port25600API un tīmekļa saskarnes ports
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/Bāzes URL, lai Komga pasniegtu no apakšmapes
SPRING_SESSION_TIMEOUTspring.session.timeout7 dienasCik ilgi ilgst neaktīva sesija, piemēram, 14d vai 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsNavCORS atļautie avoti
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaNav iestatītsDEBUG detalizētiem žurnāliem

Portu un bāzes URL var iestatīt arī sadaļā «Server Settings», un tad šim iestatījumam ir prioritāte pār konfigurāciju. Java atmiņai pievienojiet mainīgo JAVA_TOOL_OPTIONS sadaļā environment. Dokumentācijas piemērs iestata maksimumu 4 GB:

compose.yaml, sadaļā environment
      - JAVA_TOOL_OPTIONS=-Xmx4g

Dokumentācijas parauga application.yml sākas ar datubāzes ceļu. Ar Docker atstājiet to uz /config/database.sqlite, tā noklusējuma vērtību: jebkur citur datubāze tiktu izveidota konteinera iekšienē un pazaudēta, kad to izveido no jauna. Paturiet tikai tās parauga rindas, kas jums vajadzīgas.

HTTPS un reversais starpniekserveris

Dokumentācija iesaka pirms Komga novietot reverso starpniekserveri, kas iegūst derīgu sertifikātu, un piedāvā Caddy, kas pats ģenerē savus Let’s Encrypt sertifikātus. Starpniekserverim jāiestata trīs galvenes, lai Komga zinātu katra pieprasījuma publisko adresi un protokolu:

Ar Caddy

Apakšdomēnā, bez bāzes URL Komga iestatījumos, Caddy pats iestata šīs galvenes:

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

Apakšmapē vispirms iestatiet Komga bāzes URL uz /komga, sadaļā «Server Settings» vai ar SERVER_SERVLET_CONTEXTPATH, pēc tam:

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

Ar Nginx

Dokumentācijas Nginx piemērs pārsūta arī WebSocket savienojumus. Pievienojiet šo bloku map faila /etc/nginx/nginx.conf sadaļā http:

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

Šis vietnes bloks izmanto dokumentācijas piemēra iestatījumus, uz porta 80, lai Certbot varētu uzstādīt HTTPS. Rinda X-Forwarded-Host ir pievienota, jo to prasa dokumentācijas galveņu saraksts:

Nginx bloks
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;
    }
}
Terminālis
sudo nginx -t
sudo certbot --nginx

Pilnais dokumentācijas piemērs parāda galīgo versiju: ports 80 pāradresēts uz HTTPS, un bloks uz porta 443 ar sertifikāta ceļiem.

Bibliotēkas, skenēšana un imports

Bibliotēka ir grāmatu grupa, kas glabājas zem saknes mapes. Komga izveido sēriju katrai apakšmapei, jebkurā dziļumā, un grāmatu katram failam, ievietotu tā vecākmapes sērijā. Metadatiem no EPUB failiem un no arhīvos esošajiem ComicInfo.xml failiem ir prioritāte pār mapju un failu nosaukumiem.

  1. Ievietojiet savus failus serverī, pa vienai ~/komga/data apakšmapei katrai bibliotēkai, caur SFTP vai ar rsync.
  2. Saskarnē noklikšķiniet uz + blakus «Libraries».
  3. Nosauciet bibliotēku, izvēlieties tās saknes mapi ar «Browse», piemēram, /data/manga, pēc tam noklikšķiniet uz «Add».
Terminālis, jūsu datorā
rsync -av manga/ user@komga.example.com:komga/data/manga/

Atkritne

Grāmata, kuras fails pazūd, nonāk atkritnē ar atzīmi «Unavailable», nevis tiek dzēsta: tās metadati, lasīšanas progress un saraksti atgriežas, ja fails atkal parādās savā vietā. Tātad varat pārdēvēt un pārvietot savus failus, neko nezaudējot. Atkritni iztukšo manuāli vai pēc katras skenēšanas, ja ieslēdzat šo opciju, kas tad elementus noņem uzreiz.

Grāmatu imports

Ekrāns «Import», «Books» iekārto jūsu sērijās grāmatas, kas atrodas citā servera mapē, piemēram, /data/import. Katram failam izvēlaties mērķa sēriju, numuru un nosaukumu; jau izmantots numurs piedāvā uzlabot esošo grāmatu, abas parādot blakus. Komga pārvieto failus vai izveido uz tiem cietās saites, kad failu sistēma to atļauj, un citādi tos nokopē.

Mainot bibliotēkas saknes mapi uz ceļu, kas nav saistīts ar veco, tiek izdzēstas tās sērijas, grāmatas un lasīšanas progress. BUJ apraksta, kā to pārvietot: failu jaucējvērtības ieslēgtas, automātiskā atkritnes iztukšošana izslēgta, pēc tam skenēšana pirms pārvietošanas.

Lasiet jebkur: OPDS, Kobo un KOReader

Tīmekļa lasītājs atveras pārlūkprogrammā, servera adresē. Lietotnei vai e-lasītājam Komga piedāvā trīs durvis, visas pasniedzamas pa HTTPS.

OPDS

Komga darbojas ar jebkuru OPDS lietotni, 1. vai 2. versijas. Norādiet lietotnei vienu no šīm adresēm, pēc tam sava Komga konta e-pasta adresi un paroli:

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

1.2. versijas katalogs pievieno meklēšanu pa sērijām, caur OpenSearch, un lasīšanu lappusi pēc lappuses bez lejupielādes, caur paplašinājumu OPDS PSE. Dokumentācija uztur pārbaudītu lietotņu sarakstu, Android, iOS un citām sistēmām, ar to, ko katra atbalsta.

Kobo Sync

Jūsu Kobo e-lasītājs sinhronizējas ar Komga oficiālo Kobo serveru vietā. EPUB grāmatas no visām bibliotēkām pienāk ar saviem metadatiem un vāku, uzreiz konvertētas uz KEPUB ar Kepubify, kas iekļauts Docker attēlā. Lasīšanas progress sinhronizējas abos virzienos.

  1. Piešķiriet kontam lomas Kobo Sync un File Download.
  2. Ģenerējiet API atslēgu sava konta lapā «Account Settings» un pierakstiet to: tā tiek parādīta tikai vienreiz. Izmantojiet vienu atslēgu katram e-lasītājam.
  3. Pievienojiet Kobo savam datoram un atveriet failu .kobo/Kobo/Kobo eReader.conf, ar redzamiem slēptajiem failiem.
  4. Grupā [OneStoreServices] aizstājiet rindu api_endpoint ar sava servera adresi, kam seko jūsu atslēga.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

KOReader Sync

KOReader lasa Komga caur OPDS un sinhronizē savu lasīšanas progresu caur Komga sinhronizācijas serveri:

  1. Piešķiriet kontam lomu KOReader Sync un bibliotēkas opcijās ieslēdziet failu jaucējvērtības KOReader vajadzībām.
  2. Ģenerējiet API atslēgu sava konta lapā.
  3. KOReader, ar atvērtu grāmatu, dodieties uz «Progress sync», pēc tam «Custom sync server», un ievadiet https://komga.example.com/koreader.
  4. Sadaļā «Register / Login» ievadiet API atslēgu kā lietotājvārdu un jebkuru vērtību kā paroli, ko Komga neizmanto.
  5. Sadaļā «Document matching method» izvēlieties «Binary».

Rezerves kopijas

Viss, ko Komga zina par jūsu grāmatām, atrodas /config; pašas grāmatas paliek /data. Lūk, ko /config satur ar noklusējuma konfigurāciju:

ElementsKo tas glabā
database.sqliteGalvenā datubāze: bibliotēkas, sērijas, grāmatas, metadati, lietotāji, lasīšanas progress, kolekcijas, lasīšanas saraksti un ģenerētie sīktēli
tasks.sqliteGaidošie fona uzdevumi
sessions.sqlitePieteikšanās sesijas, kopš 1.30.0 versijas pēc noklusējuma glabātas datubāzē
lucene/Meklēšanas indekss
fonts/Fonti
logs/Žurnāli, ieskaitot komga.log
application.ymlJūsu konfigurācija, ja to izveidojāt

SQLite datubāzes kopē, kad Komga ir apturēts, lai kopija būtu konsekventa. No compose.yaml mapes:

Terminālis, mapē ~/komga
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start

Sūtiet šo arhīvu ārpus servera tik bieži, cik pievienojat un lasāt grāmatas. Glabājiet arī savu grāmatu kopiju, ar vākiem, ko turat blakus failiem: tas ir smagākais apjoms, bet tas maz mainās, un rsync sūta tikai jauno. Glabāti servera diskā, šie arhīvi ietilpst arī tā nakts rezerves kopijās.

Lai atjaunotu, apturiet Komga, aizstājiet mapi config ar to, kas ir arhīvā, pārbaudiet, vai tā joprojām pieder lietotājam no compose.yaml, pēc tam startējiet to no jauna.

Atjauninājumi

Ar Docker Compose dokumentācija sniedz šīs komandas, no compose.yaml mapes. Mape /config, piemontēta no servera, saglabā jūsu iestatījumus:

Terminālis
docker compose pull
docker compose up -d
docker image prune

Kurš ko dara Managed VPS serverī

Mitināšana savā serverī prasa uzturēt serveri papildus lietojumprogrammai. Ar Managed VPS mūsu komandas uzņemas serveri un proaktīvi seko jūsu instancei; Komga paliek jūsu programmatūra ar saviem iestatījumiem un jūsu grāmatām.

TematsMūsu komandasJūs
ServerisSistēmas un drošības atjauninājumi, ieskaitot iejaukšanos serverīBrīdis, kas der jūsu darbam
UzraudzībaServeris tiek uzraudzīts 24/7, iejaucoties, negaidot jūsu zvanuJūsu instances žurnālu lasīšana
KomgaProaktīva sekošana: kļūdas, palēninājumi, atmiņa un diska vieta tiek pamanīti, labojums tiek ieteiktsTā uzstādīšana, atjauninājumi un iestatījumi, ko ieviešat jūs vai jūsu MI asistents
Bibliotēkas un lasītājiServeris, kas tās nes, uzraudzīts un ar rezerves kopijāmBibliotēkas, konti, lomas un API atslēgas
Rezerves kopijasKatru nakti, šifrētas un glabātas ārpus mašīnas; atjaunošana iekļautaKomga raksturīgās kopijas un atjaunošanas pieprasījums, kad tas vajadzīgs
MigrācijaJūsu pašreizējā servera migrācija, bez maksasPārslēgšanās brīdis

Ja vēlaties, lai mūsu komandas iejaucas pašā lietojumprogrammā, šis pakalpojums tiek rēķināts par stundu vai par fiksētu summu, ar novērtējumu, kas paziņots pirms iejaukšanās.

Komga serverī, ko uzturam jūsu vietā

Ar Simafri Managed VPS mūsu komandas uztur jūsu Komga instances serveri atjauninātu, uzrauga to dienu un nakti un iejaucas, negaidot jūsu zvanu; tās arī proaktīvi seko jūsu instancei un iesaka noderīgus labojumus, ko ieviešat jūs paši vai jūsu MI asistents. Rezerves kopijas katru nakti tiek šifrētas un glabātas ārpus mašīnas, to atjaunošana ir iekļauta, un jūsu pašreizējā servera migrācija ir bez maksas.

Skatīt Managed VPS

Biežāk uzdotie jautājumi

Vai Komga uzņēmumam ir bez maksas?

Jā. Komga ir ar MIT licenci: varat to izmantot, mainīt un izplatīt tālāk darbā, nepērkot nekādu licenci, ja vien saglabājat tā autortiesību paziņojumu. Paliek tikai servera izmaksas, uz kura tas darbojas.

Cik daudz atmiņas vajag Komga?

Dokumentācija nenosaka minimumu. Pēc noklusējuma Java ierobežo Komga atmiņu, parasti ap 1 GB. Ja žurnālos redzamas kļūdas OutOfMemoryException, palieliniet ierobežojumu ar JAVA_TOOL_OPTIONS, piemēram, -Xmx4g 4 GB atmiņai.

Kā uzstādīt Komga ar Docker Compose?

Izveidojiet compose.yaml ar attēlu gotson/komga, portu 25600, publicētu uz 127.0.0.1, mapi config, piemontētu uz /config, mapi data, piemontētu uz /data, un lietotāju, kuram pieder abas, un palaidiet docker compose up -d. Pēc tam pirms porta 25600 novietojiet HTTPS reverso starpniekserveri.

Kā izveidot Komga administratora kontu?

Pirmajā piekļuvē Komga prasa e-pasta adresi un paroli: šis pirmais konts saņem visas lomas. Izveidojiet to caur SSH tuneli, pirms atverat serveri publikai, pēc tam izveidojiet pārējos kontus sadaļā Server Settings, Users.

Kādu OPDS adresi norādīt lasīšanas lietotnei?

Sava servera adresi, kam seko /opds/v2/catalog OPDS 2 vajadzībām vai /opds/v1.2/catalog OPDS 1.2 vajadzībām, ar sava Komga konta e-pasta adresi un paroli.

Kā sinhronizēt Kobo e-lasītāju ar Komga?

Piešķiriet kontam lomas Kobo Sync un File Download, ģenerējiet API atslēgu sadaļā Account Settings, pēc tam faila Kobo eReader.conf rindu api_endpoint aizstājiet ar https://your-server/kobo/your-key. Tiek sinhronizētas tikai EPUB grāmatas.

Kā veidot Komga rezerves kopiju?

Apturiet Komga, arhivējiet mapi config, startējiet to no jauna un nosūtiet arhīvu ārpus servera. Glabājiet arī savu grāmatu kopiju. Izveidojiet kopiju tieši pirms katra atjauninājuma.

Vai Managed VPS aptver Komga?

Managed VPS aptver serveri: sistēmu, drošību, uzraudzību un rezerves kopijas. Mūsu komandas proaktīvi seko arī jūsu instancei un iesaka noderīgus labojumus, ko ieviešat jūs. Iejaukšanās lietojumprogrammā tiek rēķināta par stundu vai par fiksētu summu.

Avoti un oficiālā dokumentācija

Sazinieties ar mums