Găzduirea Komga pe un Managed VPS: benzile desenate și manga pe serverul propriu

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.

Simon Vasconcelos Lee Autor: Publicat la 22 noiembrie 2026Timp de citire: 15 minute

Toate ghidurile

Esențialul

  1. Licența MIT permite folosirea, modificarea și redistribuirea liberă a Komga, în firmă ca oriunde altundeva, cu condiția să păstrați mențiunea sa de copyright.
  2. Stocarea se dimensionează după colecția dumneavoastră, păstrată în /data; baza de date, indexul și jurnalele stau în /config, pe un disc local.
  3. Instalați-l cu Docker Compose: imaginea gotson/komga, portul 25600 publicat local în spatele unui proxy invers în HTTPS și un utilizator care deține cele două directoare.
  4. Primul cont creat devine administratorul: creați-l printr-un tunel SSH înainte de a deschide serverul publicului.
  5. Opriți Komga, copiați directorul /config în afara serverului, păstrați o copie a cărților dumneavoastră și actualizați cu docker compose pull.

Ce face Komga

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.

Ce permite licența MIT

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.

Memoria, procesorul și stocarea: dimensionarea serverului

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

Memoria Java

Procesorul

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

Stocarea cărților dumneavoastră

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:

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

Instalarea cu Docker Compose

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:

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

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

Fără Docker: fișierul jar

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:

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

Primul cont și utilizatorii

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.

Terminal, pe computerul dumneavoastră
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:

RolCe permite
AdministratorGestionarea bibliotecilor, utilizatorilor și colecțiilor, editarea metadatelor, lansarea scanărilor, analizelor și reîmprospătărilor de metadate
Page StreamingCitirea pagină cu pagină, în cititorul web de exemplu
File DownloadDescărcarea fișierului unei cărți
Kobo SyncSincronizarea unui cititor Kobo, împreună cu File Download
KOReader SyncSincronizarea 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.

Resetarea unei parole din linia de comandă

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

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

Comanda --list-users, folosită la fel, afișează în jurnale lista conturilor.

Configurarea: variabile sau application.yml

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ăProprietateImplicitCe face
SERVER_PORTserver.port25600Portul API-ului și al interfeței web
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/URL-ul de bază, pentru a servi Komga într-un subdirector
SPRING_SESSION_TIMEOUTspring.session.timeout7 zileDurata unei sesiuni inactive, de exemplu 14d sau 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsNiciunaOriginile permise pentru CORS
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaNesetatDEBUG 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:

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

HTTPS și proxy-ul invers

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:

Cu Caddy

Pe un subdomeniu, fără URL de bază în Komga, Caddy setează singur aceste antete:

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

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

Cu Nginx

Exemplul Nginx din documentație transmite și conexiunile WebSocket. Adăugați acest bloc map în secțiunea http din /etc/nginx/nginx.conf:

nginx.conf, în http
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:

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

Exemplul complet din documentație arată versiunea finală: portul 80 redirecționat către HTTPS și blocul pe 443 cu căile certificatelor.

Bibliotecile, scanările și importurile

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.

  1. Puneți fișierele pe server, într-un subdirector al ~/komga/data pentru fiecare bibliotecă, prin SFTP sau cu rsync.
  2. În interfață, faceți clic pe + lângă „Libraries”.
  3. Dați un nume bibliotecii, alegeți-i directorul rădăcină cu „Browse”, de exemplu /data/manga, apoi faceți clic pe „Add”.
Terminal, pe computerul dumneavoastră
rsync -av manga/ user@komga.example.com:komga/data/manga/

Coșul de gunoi

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.

Importul de cărți

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.

Citiți oriunde: OPDS, Kobo și KOReader

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.

OPDS

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:

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

Sincronizarea Kobo

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.

  1. Dați contului rolurile Kobo Sync și File Download.
  2. Generați o cheie API pe pagina contului dumneavoastră, „Account Settings”, și notați-o: este afișată o singură dată. Folosiți câte o cheie pentru fiecare cititor.
  3. Conectați Kobo la computer și deschideți fișierul .kobo/Kobo/Kobo eReader.conf, cu fișierele ascunse afișate.
  4. În grupul [OneStoreServices], înlocuiți linia api_endpoint cu adresa serverului dumneavoastră urmată de cheie.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

Sincronizarea KOReader

KOReader citește Komga prin OPDS și își sincronizează progresul de citire prin serverul de sincronizare al Komga:

  1. Dați contului rolul KOReader Sync și activați hash-urile de fișiere pentru KOReader în opțiunile bibliotecii.
  2. Generați o cheie API pe pagina contului dumneavoastră.
  3. În KOReader, cu o carte deschisă, mergeți la „Progress sync”, apoi la „Custom sync server”, și introduceți https://komga.example.com/koreader.
  4. În „Register / Login”, introduceți cheia API drept nume de utilizator și orice valoare drept parolă, pe care Komga nu o folosește.
  5. La „Document matching method”, alegeți „Binary”.

Backupurile

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

ElementCe păstrează
database.sqliteBaza de date principală: biblioteci, serii, cărți, metadate, utilizatori, progres de citire, colecții, liste de citire și miniaturi generate
tasks.sqliteSarcinile de fundal în așteptare
sessions.sqliteSesiunile 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.ymlConfiguraț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:

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

Actualizările

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:

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

Cine ce face pe un Managed VPS

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

SubiectEchipele noastreDumneavoastră
ServerulActualizări de sistem și de securitate, intervenții pe server incluseMomentul potrivit activității dumneavoastră
MonitorizareaServer urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelulCitirea jurnalelor instanței dumneavoastră
KomgaUrmă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 cititoriiServerul care le poartă, supravegheat și salvatBibliotecile, 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
MigrareaServerul dumneavoastră actual migrat, gratuitMomentul 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.

Komga, pe un server întreținut pentru dumneavoastră

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

Descoperiți gama Managed VPS

Întrebări frecvente

Este Komga gratuit pentru o firmă?

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

De câtă memorie are nevoie Komga?

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.

Cum instalez Komga cu Docker Compose?

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.

Cum creez contul de administrator Komga?

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.

Ce adresă OPDS îi dau aplicației mele de citire?

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.

Cum sincronizez un cititor Kobo cu 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.

Cum fac backup la Komga?

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.

Acoperă un Managed VPS și Komga?

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.

Surse și documentație oficială

Contactați-ne