Găzduirea Komga pe un Managed VPS înseamnă să vă citiți benzile desenate, manga și cărțile electronice de pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. Komga este un server media liber sub licență MIT. Acest ghid urmează documentația sa oficială: memoria și stocarea de prevăzut, instalarea cu Docker Compose, primul cont, configurarea, HTTPS, bibliotecile, citirea prin OPDS, Kobo și KOReader, backupurile și actualizările.
Autor: Simon Vasconcelos Lee
Publicat la 22 noiembrie 2026Timp de citire: 15 minute
/data; baza de date, indexul și jurnalele stau în /config, pe un disc local.gotson/komga, portul 25600 publicat local în spatele unui proxy invers în HTTPS și un utilizator care deține cele două directoare./config în afara serverului, păstrați o copie a cărților dumneavoastră și actualizați cu docker compose pull.Komga este un server media pentru benzile desenate, manga, benzile desenate franco-belgiene, revistele și cărțile dumneavoastră electronice. Îi indicați directoarele în care se află fișierele, el le organizează în biblioteci, serii și cărți, apoi le servește unui browser sau unei aplicații de citire. Rulează oriunde rulează Java sau Docker.
Komga este publicat sub licența MIT, pe numele lui Gauthier Roebroeck. Ea acordă gratuit dreptul de a folosi, copia, modifica, fuziona, publica, distribui, sublicenția și vinde copii ale software-ului. Îl puteți deci rula pentru dumneavoastră, familia, asociația sau firma dumneavoastră, fără nicio licență de cumpărat.
Singura condiție este păstrarea mențiunii de copyright și a textului licenței în toate copiile sau părțile substanțiale ale software-ului. Textul furnizează software-ul „ca atare” („as is”), fără garanție.
Documentația nu fixează nicio configurație minimă. Ea dă în schimb ceea ce contează pentru dimensionarea serverului: memoria mașinii virtuale Java, sarcinile care solicită procesorul și, mai ales, spațiul ocupat de fișierele dumneavoastră.
OutOfMemoryException în jurnale. Limita se ridică atunci cu variabila JAVA_TOOL_OPTIONS, prezentată mai jos.Procesorul lucrează mai ales în timpul scanărilor și analizelor bibliotecilor. Pentru fiecare dintre ele, documentația avertizează că calculul hash-urilor de fișiere, al hash-urilor de pagini și al hash-urilor pentru KOReader, ca și analiza dimensiunilor paginilor, poate consuma multe resurse pe o bibliotecă mare. Numărul de fire de execuție dedicate sarcinilor de fundal se setează în „Server Settings”.
Este postul cel mai greu și se măsoară de partea dumneavoastră: dimensiunea colecției, plus spațiul pentru cărțile pe care plănuiți să le adăugați. Komga vă citește fișierele acolo unde se află și nu le copiază. Câteva puncte din documentație schimbă calculul:
/data pentru cărți și importuri: documentația cere să vă puneți acolo bibliotecile și directorul de import, pentru ca importurile să creeze legături fizice (hard links) în loc de copii. În afara aceluiași sistem de fișiere, fiecare import ocupă spațiul unei copii./config păstrează baza de date principală, cu miniaturile generate pentru fiecare carte, baza de date a sarcinilor, pe cea a sesiunilor, indexul de căutare și jurnalele, pe care configurația implicită le păstrează 7 zile și le plafonează la 1 GB. El crește odată cu dimensiunea bibliotecilor dumneavoastră./config: bazele de date SQLite nu trebuie să se afle niciodată pe o partajare de rețea precum CIFS sau NFS. Komga verifică acest lucru la pornire și se oprește dacă nu este cazul.Pe un Managed VPS, descrieți-ne colecția dumneavoastră, dimensiunea ei, ritmul de creștere și numărul de cititori, și vă recomandăm dimensiunea potrivită.
Documentația publică imaginea gotson/komga pe Docker Hub și pe ghcr.io, pentru procesoare amd64, arm64 și arm. Pe un server unde Docker este instalat, creați un director pentru Komga, cu cele două subdirectoare ale sale, și notați-vă identificatorul de utilizator:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Puneți în el acest compose.yaml, preluat din exemplul documentației. Înlocuiți 1000:1000 cu valorile uid și gid afișate de id, iar TZ cu fusul dumneavoastră orar:
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: este principala diferență față de exemplul din documentație, care îl publică pe toate adresele. Documentația recomandă insistent HTTPS de îndată ce Komga se deschide în afara rețelei locale, deoarece folosește autentificarea HTTP de bază. Interfața este atunci accesibilă doar prin proxy-ul invers.user. Documentația cere ca directoarele montate să aparțină aceluiași utilizator: problemele de permisiuni dispar astfel./config păstrează baza de date și configurația Komga, pe un disc local./data conține cărțile și directorul de import. Fiecare bibliotecă va avea acolo propriul subdirector.1.x urmărește ultima versiune 1 publicată; 1.30.1 fixează o versiune. Documentația rezervă latest ultimului commit.version din exemplul documentației este omisă: Docker Compose o consideră astăzi învechită și o ignoră.Cealaltă cale din documentație pentru un server Linux este fișierul jar al fiecărei versiuni, publicat pe GitHub. El cere Java 17 sau mai nou și își păstrează configurația în ~/.komga:
java -version
java -jar komga-1.30.1.jar
La primul acces, Komga cere crearea unui cont: o adresă de e-mail și o parolă. Acest prim cont primește toate rolurile, inclusiv administrarea, și „revendică” serverul. Cât timp nu există, acest formular răspunde oricui ajunge la pagină: creați-l înainte de a deschide serverul publicului, printr-un tunel SSH. Portul 25600 al serverului apare atunci pe computerul dumneavoastră, la http://localhost:25600. Adăugați -p și portul SSH indicat în spațiul dumneavoastră de client.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
Conturile următoare sunt create de administrator, în „Server Settings”, „Users”, cu butonul +. Fiecare cont primește rolurile de care are nevoie:
| Rol | Ce permite |
|---|---|
| Administrator | Gestionarea bibliotecilor, utilizatorilor și colecțiilor, editarea metadatelor, lansarea scanărilor, analizelor și reîmprospătărilor de metadate |
| Page Streaming | Citirea pagină cu pagină, în cititorul web de exemplu |
| File Download | Descărcarea fișierului unei cărți |
| Kobo Sync | Sincronizarea unui cititor Kobo, împreună cu File Download |
| KOReader Sync | Sincronizarea progresului de citire cu KOReader |
Ștergerea unui utilizator îi șterge tot progresul de citire, fără cale de întoarcere: o copie a /config făcută chiar înainte vă păstrează controlul.
Documentația adaugă comanda în compose.yaml, sub serviciul komga; Komga aplică schimbarea, apoi pornește normal. Reporniți serviciul, apoi scoateți linia și reporniți-l încă o dată:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Comanda --list-users, folosită la fel, afișează în jurnale lista conturilor.
Komga are valori implicite pentru fiecare setare: configurarea servește doar la schimbarea comportamentului său. Ea se face prin variabile de mediu, calea cea mai simplă cu Docker Compose, sau printr-un fișier application.yml pe care îl creați în directorul /config, unde imaginea Docker îl încarcă. Pentru a trece de la numele unei proprietăți la cel al unei variabile, înlocuiți punctele cu liniuțe de subliniere, eliminați cratimele și treceți la majuscule.
| Variabilă | Proprietate | Implicit | Ce face |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Portul API-ului și al interfeței web |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | URL-ul de bază, pentru a servi Komga într-un subdirector |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 zile | Durata unei sesiuni inactive, de exemplu 14d sau 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Niciuna | Originile permise pentru CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Nesetat | DEBUG pentru jurnale detaliate |
Portul și URL-ul de bază se pot seta și în „Server Settings”, iar această setare are atunci prioritate față de configurație. Pentru memoria Java, adăugați variabila JAVA_TOOL_OPTIONS în secțiunea environment. Exemplul din documentație fixează un maximum de 4 GB:
- JAVA_TOOL_OPTIONS=-Xmx4g
Exemplul de application.yml din documentație începe cu calea bazei de date. Cu Docker, păstrați-o la /config/database.sqlite, valoarea sa implicită: în altă parte, baza de date ar fi creată în container și pierdută la recrearea acestuia. Păstrați din exemplu doar liniile de care aveți nevoie.
Documentația recomandă plasarea în fața Komga a unui proxy invers care obține un certificat valid și sugerează Caddy, care își generează singur certificatele Let’s Encrypt. Proxy-ul trebuie să seteze trei antete, pentru ca Komga să cunoască adresa publică și protocolul fiecărei cereri:
X-Forwarded-For, setat sau completat;X-Forwarded-Proto;X-Forwarded-Host.Pe un subdomeniu, fără URL de bază în Komga, Caddy setează singur aceste antete:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
Într-un subdirector, setați mai întâi URL-ul de bază al Komga la /komga, în „Server Settings” sau cu SERVER_SERVLET_CONTEXTPATH, apoi:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Exemplul Nginx din documentație transmite și conexiunile WebSocket. Adăugați acest bloc map în secțiunea http din /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Acest bloc de site preia setările exemplului din documentație, pe portul 80, pentru a lăsa Certbot să instaleze HTTPS. Linia X-Forwarded-Host este adăugată, deoarece lista de antete din documentație o cere:
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
Exemplul complet din documentație arată versiunea finală: portul 80 redirecționat către HTTPS și blocul pe 443 cu căile certificatelor.
O bibliotecă este un grup de cărți, păstrat sub un director rădăcină. Komga creează o serie pentru fiecare subdirector, la orice adâncime, și o carte pentru fiecare fișier, plasată în seria directorului său părinte. Metadatele fișierelor EPUB și ale fișierelor ComicInfo.xml din arhive au prioritate față de numele directoarelor și fișierelor.
~/komga/data pentru fiecare bibliotecă, prin SFTP sau cu rsync./data/manga, apoi faceți clic pe „Add”.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga și /data/comics coexistă; /data și /data/manga, nu.#recycle.O carte al cărei fișier dispare trece în coșul de gunoi, marcată „Unavailable”, în loc să fie ștearsă: metadatele, progresul de citire și listele ei revin dacă fișierul reapare la locul lui. Vă puteți deci redenumi și muta fișierele fără să pierdeți nimic. Coșul se golește manual sau după fiecare scanare, dacă activați această opțiune, care șterge atunci elementele imediat.
Ecranul „Import”, „Books” plasează în seriile dumneavoastră cărți aflate într-un alt director al serverului, /data/import de exemplu. Pentru fiecare fișier, alegeți seria de destinație, numărul și numele; un număr deja folosit propune înlocuirea cărții existente, cu cele două afișate una lângă alta. Komga mută fișierele sau creează legături fizice când sistemul de fișiere permite acest lucru, iar altfel le copiază.
Schimbarea directorului rădăcină al unei biblioteci cu o cale fără legătură cu cea veche îi șterge seriile, cărțile și progresul de citire. Întrebările frecvente descriu cum se mută: hash-urile de fișiere activate, golirea automată a coșului dezactivată, apoi o scanare înainte de mutare.
Cititorul web se deschide în browser, la adresa serverului. Pentru o aplicație sau un cititor electronic, Komga oferă trei porți, toate de servit în HTTPS.
Komga funcționează cu orice aplicație OPDS, versiunea 1 sau 2. Dați aplicației una dintre aceste adrese, apoi adresa de e-mail și parola contului dumneavoastră Komga:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Catalogul în versiunea 1.2 adaugă căutarea după serie, prin OpenSearch, și citirea pagină cu pagină fără descărcare, prin extensia OPDS PSE. Documentația ține o listă de aplicații testate, pe Android, iOS și în alte părți, cu ceea ce acceptă fiecare.
Cititorul dumneavoastră Kobo se sincronizează cu Komga în locul serverelor oficiale Kobo. Cărțile EPUB din toate bibliotecile ajung cu metadatele și coperta lor, convertite din mers în KEPUB de Kepubify, inclus în imaginea Docker. Progresul de citire se sincronizează în ambele sensuri.
.kobo/Kobo/Kobo eReader.conf, cu fișierele ascunse afișate.[OneStoreServices], înlocuiți linia api_endpoint cu adresa serverului dumneavoastră urmată de cheie.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 pentru o adresă în HTTPS.KOReader citește Komga prin OPDS și își sincronizează progresul de citire prin serverul de sincronizare al Komga:
https://komga.example.com/koreader.Tot ce știe Komga despre cărțile dumneavoastră stă în /config; cărțile însele rămân în /data. Iată ce conține /config cu configurația implicită:
| Element | Ce păstrează |
|---|---|
database.sqlite | Baza de date principală: biblioteci, serii, cărți, metadate, utilizatori, progres de citire, colecții, liste de citire și miniaturi generate |
tasks.sqlite | Sarcinile de fundal în așteptare |
sessions.sqlite | Sesiunile de conectare, păstrate implicit în baza de date începând cu versiunea 1.30.0 |
lucene/ | Indexul de căutare |
fonts/ | Fonturile |
logs/ | Jurnalele, printre care komga.log |
application.yml | Configurația dumneavoastră, dacă ați creat-o |
Bazele de date SQLite se copiază cu Komga oprit, pentru o copie coerentă. Din directorul fișierului compose.yaml:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Trimiteți această arhivă în afara serverului, în ritmul adăugărilor și lecturilor dumneavoastră. Păstrați și o copie a cărților, cu copertele pe care le țineți lângă fișiere: este volumul cel mai mare, dar se schimbă puțin, iar rsync trimite doar noutățile. Puse pe discul serverului, aceste arhive intră și în backupurile sale de noapte.
Pentru restaurare, opriți Komga, înlocuiți directorul config cu cel din arhivă, verificați că aparține în continuare utilizatorului din compose.yaml, apoi porniți-l din nou.
Cu Docker Compose, documentația dă aceste comenzi, de rulat din directorul fișierului compose.yaml. Directorul /config, montat de pe server, vă păstrează setările:
docker compose pull
docker compose up -d
docker image prune
/config chiar înainte de fiecare actualizare.jar, opriți Komga, apoi porniți-l cu jar-ul noii versiuni.Găzduirea pe propriul server cere să țineți serverul pe lângă aplicație. Pe un Managed VPS, echipele noastre preiau serverul și vă urmăresc proactiv instanța; Komga rămâne software-ul dumneavoastră, cu setările sale și cărțile dumneavoastră.
| Subiect | Echipele noastre | Dumneavoastră |
|---|---|---|
| Serverul | Actualizări de sistem și de securitate, intervenții pe server incluse | Momentul potrivit activității dumneavoastră |
| Monitorizarea | Server urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelul | Citirea jurnalelor instanței dumneavoastră |
| Komga | Urmărire proactivă: erori, încetiniri, memorie și spațiu pe disc depistate, corectură recomandată | Instalarea, actualizările și setările sale, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI |
| Bibliotecile și cititorii | Serverul care le poartă, supravegheat și salvat | Bibliotecile, conturile, rolurile și cheile API |
| Backupurile | În fiecare noapte, criptate și păstrate în afara mașinii; restaurare inclusă | Copiile proprii Komga și cererea de restaurare, când aveți nevoie de ea |
| Migrarea | Serverul dumneavoastră actual migrat, gratuit | Momentul trecerii |
Dacă preferați ca echipele noastre să intervină în aplicația însăși, această prestație se facturează la oră sau la preț fix, cu o ofertă comunicată înainte de intervenție.
Cu un Managed VPS Simafri, echipele noastre țin la zi serverul instanței dumneavoastră Komga, îl monitorizează zi și noapte și intervin fără a vă aștepta apelul; ele vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI. Backupurile sunt criptate în fiecare noapte și păstrate în afara mașinii, restaurarea lor este inclusă, iar migrarea serverului actual este gratuită.
Da. Komga este sub licență MIT: îl puteți folosi, modifica și redistribui în firmă fără nicio licență de cumpărat, cu condiția să păstrați mențiunea sa de copyright. Rămâne costul serverului pe care rulează.
Documentația nu fixează niciun minim. Implicit, Java limitează memoria Komga, de obicei în jur de 1 GB. Dacă jurnalele arată erori OutOfMemoryException, ridicați limita cu JAVA_TOOL_OPTIONS, de exemplu -Xmx4g pentru 4 GB.
Creați un compose.yaml cu imaginea gotson/komga, portul 25600 publicat pe 127.0.0.1, un director config montat pe /config, un director data montat pe /data și un utilizator care le deține pe amândouă, apoi rulați docker compose up -d. Puneți apoi un proxy invers în HTTPS în fața portului 25600.
La primul acces, Komga cere o adresă de e-mail și o parolă: acest prim cont primește toate rolurile. Creați-l printr-un tunel SSH înainte de a deschide serverul publicului, apoi creați celelalte conturi în Server Settings, Users.
Adresa serverului dumneavoastră urmată de /opds/v2/catalog pentru OPDS 2 sau de /opds/v1.2/catalog pentru OPDS 1.2, cu adresa de e-mail și parola contului dumneavoastră Komga.
Dați contului rolurile Kobo Sync și File Download, generați o cheie API în Account Settings, apoi înlocuiți linia api_endpoint din fișierul Kobo eReader.conf cu https://adresa-serverului/kobo/cheia-api. Se sincronizează doar cărțile EPUB.
Opriți Komga, arhivați directorul config, porniți-l din nou și trimiteți arhiva în afara serverului. Păstrați și o copie a cărților. Faceți o copie chiar înainte de fiecare actualizare.
Un Managed VPS acoperă serverul: sistemul, securitatea, monitorizarea și backupurile. Echipele noastre vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră. O intervenție în aplicație se facturează la oră sau la preț fix.
Simafri
Să discutăm despre site-ul dumneavoastră
Povestiți-ne despre proiectul dumneavoastră în câteva cuvinte: vă vom răspunde rapid.
Mulțumim! Cererea dumneavoastră a fost trimisă. Vă vom răspunde în curând.
Preferați e-mailul? Scrieți-ne la support@simafri.com.