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.
Autors: Simon Vasconcelos Lee
Publicēts 2026. gada 22. novembrīLasīšanas laiks: 14 minūtes
/data; datubāze, indekss un žurnāli atrodas /config, lokālā diskā.gotson/komga, ports 25600, publicēts lokāli aiz HTTPS reversā starpniekservera, un lietotājs, kuram pieder abas mapes./config ārpus servera, glabājiet savu grāmatu kopiju un atjauniniet ar docker compose pull.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.
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.
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.
OutOfMemoryException žurnālos. Tad ierobežojumu palielina ar mainīgo JAVA_TOOL_OPTIONS, kas parādīts tālāk.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».
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:
/data grāmatām un importam: dokumentācija lūdz tur novietot jūsu bibliotēkas un importa mapi, lai imports veidotu cietās saites, nevis kopijas. Ārpus tās pašas failu sistēmas katrs imports aizņem kopijas vietu./config glabā galveno datubāzi ar katrai grāmatai ģenerētajiem sīktēliem, uzdevumu datubāzi, sesiju datubāzi, meklēšanas indeksu un žurnālus, ko noklusējuma konfigurācija glabā 7 dienas un ierobežo līdz 1 GB. Tā aug līdz ar jūsu bibliotēku apjomu./config: SQLite datubāzes nekad nedrīkst atrasties tīkla koplietojumā, piemēram, CIFS vai NFS. Komga to pārbauda startējot un apstājas, ja tā nav.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.
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:
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:
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: šī ir galvenā atšķirība no dokumentācijas piemēra, kas to publicē uz visām adresēm. Dokumentācija stingri iesaka HTTPS, tiklīdz Komga tiek atvērts ārpus jūsu lokālā tīkla, jo tas izmanto HTTP Basic autentifikāciju. Tad saskarne ir sasniedzama tikai caur reverso starpniekserveri.user. Dokumentācija lūdz, lai piemontētās mapes piederētu tam pašam lietotājam: tad atļauju problēmas pazūd./config glabā Komga datubāzi un konfigurāciju, lokālā diskā./data glabā jūsu grāmatas un importa mapi. Katrai bibliotēkai tur būs sava apakšmape.1.x seko jaunākajai publicētajai 1. versijai; 1.30.1 fiksē versiju. Dokumentācija apraksta latest kā jaunāko commit.version no dokumentācijas piemēra ir izlaista: Docker Compose to tagad uzskata par novecojušu un ignorē.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:
java -version
java -jar komga-1.30.1.jar
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ā.
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:
| Loma | Ko tā atļauj |
|---|---|
| Administrator | Pārvaldīt bibliotēkas, lietotājus un kolekcijas, rediģēt metadatus, palaist skenēšanu, analīzi un metadatu atsvaidzināšanu |
| Page Streaming | Lasīt lappusi pēc lappuses, piemēram, tīmekļa lasītājā |
| File Download | Lejupielādēt grāmatas failu |
| Kobo Sync | Sinhronizēt Kobo e-lasītāju, kopā ar File Download |
| KOReader Sync | Sinhronizē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.
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:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Komanda --list-users, izmantota tādā pašā veidā, izvada kontu sarakstu žurnālos.
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šība | Noklusējums | Ko tas dara |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | API un tīmekļa saskarnes ports |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Bāzes URL, lai Komga pasniegtu no apakšmapes |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 dienas | Cik ilgi ilgst neaktīva sesija, piemēram, 14d vai 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Nav | CORS atļautie avoti |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Nav iestatīts | DEBUG 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:
- 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.
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:
X-Forwarded-For, iestatīta vai papildināta;X-Forwarded-Proto;X-Forwarded-Host.Apakšdomēnā, bez bāzes URL Komga iestatījumos, Caddy pats iestata šīs galvenes:
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:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Dokumentācijas Nginx piemērs pārsūta arī WebSocket savienojumus. Pievienojiet šo bloku map faila /etc/nginx/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:
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
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ē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.
~/komga/data apakšmapei katrai bibliotēkai, caur SFTP vai ar rsync./data/manga, pēc tam noklikšķiniet uz «Add».rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga un /data/comics pastāv blakus; /data un /data/manga nevar.#recycle.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.
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.
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.
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:
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.
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.
.kobo/Kobo/Kobo eReader.conf, ar redzamiem slēptajiem failiem.[OneStoreServices] aizstājiet rindu api_endpoint ar sava servera adresi, kam seko jūsu atslēga.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint ports, 443 HTTPS adresei.KOReader lasa Komga caur OPDS un sinhronizē savu lasīšanas progresu caur Komga sinhronizācijas serveri:
https://komga.example.com/koreader.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:
| Elements | Ko tas glabā |
|---|---|
database.sqlite | Galvenā 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.sqlite | Gaidošie fona uzdevumi |
sessions.sqlite | Pieteikš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.yml | Jū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:
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.
Ar Docker Compose dokumentācija sniedz šīs komandas, no compose.yaml mapes. Mape /config, piemontēta no servera, saglabā jūsu iestatījumus:
docker compose pull
docker compose up -d
docker image prune
/config kopiju tieši pirms katra atjauninājuma.jar failu apturiet Komga, pēc tam startējiet to ar jaunās versijas jar.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.
| Temats | Mūsu komandas | Jūs |
|---|---|---|
| Serveris | Sistēmas un drošības atjauninājumi, ieskaitot iejaukšanos serverī | Brīdis, kas der jūsu darbam |
| Uzraudzība | Serveris tiek uzraudzīts 24/7, iejaucoties, negaidot jūsu zvanu | Jūsu instances žurnālu lasīšana |
| Komga | Proaktīva sekošana: kļūdas, palēninājumi, atmiņa un diska vieta tiek pamanīti, labojums tiek ieteikts | Tā uzstādīšana, atjauninājumi un iestatījumi, ko ieviešat jūs vai jūsu MI asistents |
| Bibliotēkas un lasītāji | Serveris, kas tās nes, uzraudzīts un ar rezerves kopijām | Bibliotēkas, konti, lomas un API atslēgas |
| Rezerves kopijas | Katru nakti, šifrētas un glabātas ārpus mašīnas; atjaunošana iekļauta | Komga raksturīgās kopijas un atjaunošanas pieprasījums, kad tas vajadzīgs |
| Migrācija | Jūsu pašreizējā servera migrācija, bez maksas | Pā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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Parunāsim par jūsu ieceri
Pasakiet mums dažos vārdos, kas jums vajadzīgs: mēs jums ātri atbildam.
Paldies! Jūsu pieprasījums ir nosūtīts. Drīzumā ar jums sazināsimies.
Labāk e-pastu? Rakstiet mums uz support@simafri.com.