Хостване на Komga на Managed VPS: вашите комикси и манга на ваш сървър

Хостването на Komga на Managed VPS означава да четете комиксите, мангата и електронните си книги от своя собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Komga е медиен сървър, свободен софтуер с лиценз MIT. Това ръководство следва официалната му документация: паметта и хранилището, които да предвидите, инсталиране с Docker Compose, първият акаунт, конфигурацията, HTTPS, библиотеките, четенето през OPDS, Kobo и KOReader, резервните копия и обновленията.

Simon Vasconcelos Lee Автор: Публикувано на 22 ноември 2026 г.Време за четене: 14 минути

Всички ръководства

Накратко

  1. Лицензът MIT позволява свободно да използвате, променяте и разпространявате Komga, във фирма и другаде, стига да запазите бележката за авторските права.
  2. Хранилището се оразмерява според колекцията ви, пазена в /data; базата данни, индексът и журналите са в /config, на локален диск.
  3. Инсталирайте го с Docker Compose: образът gotson/komga, порт 25600, публикуван локално зад обратен прокси с HTTPS, и потребител, който притежава двете папки.
  4. Първият създаден акаунт става администратор: създайте го през SSH тунел, преди да отворите сървъра за публиката.
  5. Спрете Komga, копирайте папката /config извън сървъра, пазете копие на книгите си и обновявайте с docker compose pull.

Какво прави Komga

Komga е медиен сървър за вашите комикси, манга, BD, списания и електронни книги. Посочвате му папките, в които са файловете ви, той ги подрежда в библиотеки, серии и книги, после ги предоставя на браузър или на приложение за четене. Работи навсякъде, където работят Java или Docker.

Какво позволява лицензът MIT

Komga се разпространява под лиценза MIT, на името на Gauthier Roebroeck. Той дава безплатно правото да използвате, копирате, променяте, сливате, публикувате, разпространявате, преотстъпвате под лиценз и продавате копия на софтуера. Следователно можете да го пускате за себе си, семейството си, сдружението си или фирмата си, без да купувате лиценз.

Единственото условие е да запазите бележката за авторските права и текста на лиценза във всички копия или съществени части на софтуера. Текстът предоставя софтуера „такъв, какъвто е“, без гаранция.

Памет, процесор и хранилище: оразмеряване на сървъра

Документацията не определя минимална конфигурация. Тя дава обаче онова, което има значение при оразмеряването на сървъра: паметта на виртуалната машина на Java, задачите, които натоварват процесора, и преди всичко мястото, което заемат файловете ви.

Паметта на Java

Процесорът

Процесорът работи главно при сканирането и анализа на библиотеките. За всяка библиотека документацията предупреждава, че изчисляването на хешовете на файловете, на хешовете на страниците и на хешовете за KOReader, както и анализът на размерите на страниците, може да изразходва много ресурси при голяма библиотека. Броят на нишките, отделени за фоновите задачи, се задава в „Server Settings“.

Хранилището за книгите ви

Това е най-голямото перо и го измервате вие: размерът на колекцията ви плюс място за книгите, които смятате да добавите. Komga чете файловете ви там, където са, и не ги копира. Няколко точки от документацията променят сметката:

На Managed VPS ни разкажете за колекцията си, нейния размер, колко бързо расте и колко читатели имате, и ще ви препоръчаме подходящия размер.

Инсталиране с Docker Compose

Документацията публикува образа gotson/komga в Docker Hub и в ghcr.io, за процесори amd64, arm64 и arm. На сървър с инсталиран Docker създайте папка за Komga с двете ѝ подпапки и си запишете потребителския идентификатор:

Терминал
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id

Поставете в нея този compose.yaml, взет от примера в документацията. Заменете 1000:1000 със стойностите uid и gid, показани от id, а TZ с вашата часова зона:

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
Терминал
docker compose up -d
docker logs -f komga

Без Docker: файлът jar

Другият път в документацията за Linux сървър е файлът jar на всяка версия, публикуван в GitHub. Той изисква Java 17 или по-нова и пази конфигурацията си в ~/.komga:

Терминал
java -version
java -jar komga-1.30.1.jar

Първият акаунт и потребителите

При първия достъп Komga ви моли да създадете акаунт: имейл адрес и парола. Този първи акаунт получава всички роли, включително администрирането, и „заявява“ сървъра. Докато той не съществува, този формуляр отговаря на всеки, който стигне до страницата: създайте го, преди да отворите сървъра за публиката, през SSH тунел. Тогава порт 25600 на сървъра се появява на вашия компютър, на http://localhost:25600. Добавете -p и SSH порта, показан в клиентската ви зона.

Терминал, на вашия компютър
ssh -L 25600:127.0.0.1:25600 user@komga.example.com

Следващите акаунти се създават от администратора, в „Server Settings“, „Users“, с бутона +. Всеки акаунт получава ролите, които са му нужни:

РоляКакво позволява
AdministratorУправление на библиотеките, потребителите и колекциите, редактиране на метаданните, пускане на сканирания, анализи и опреснявания на метаданните
Page StreamingЧетене страница по страница, например в уеб четеца
File DownloadИзтегляне на файла на книга
Kobo SyncСинхронизиране на е-четец Kobo, заедно с File Download
KOReader SyncСинхронизиране на напредъка в четенето с KOReader

Изтриването на потребител заличава целия му напредък в четенето, без връщане назад: копие на /config, направено точно преди това, ви оставя в контрол.

Възстановяване на парола от командния ред

Документацията добавя командата към compose.yaml, под услугата komga; Komga прилага промяната, после стартира както обикновено. Рестартирайте услугата, после махнете реда и я рестартирайте още веднъж:

compose.yaml, под услугата komga
    command: --newpassword=YourNewPassword --reset=admin@example.org
Терминал
docker compose up -d

Командата --list-users, използвана по същия начин, извежда списъка с акаунтите в журналите.

Конфигурация: променливи или application.yml

Komga има стойности по подразбиране за всяка настройка: конфигурацията само променя поведението му. Тя се прави с променливи на средата, най-лесният път с Docker Compose, или с файл application.yml, който създавате в папката /config, откъдето образът на Docker го зарежда. За да превърнете името на свойство в име на променлива, заменете точките с долни черти, махнете тиретата и преминете към главни букви.

ПроменливаСвойствоПо подразбиранеКакво прави
SERVER_PORTserver.port25600Портът за API и уеб интерфейса
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/Базовият URL адрес, за да предоставяте Komga от подпапка
SPRING_SESSION_TIMEOUTspring.session.timeout7 дниКолко трае неактивна сесия, например 14d или 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsНямаПроизходите, разрешени за CORS
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaНе е зададеноDEBUG за подробни журнали

Портът и базовият URL адрес могат да се зададат и в „Server Settings“, и тогава тази настройка има предимство пред конфигурацията. За паметта на Java добавете променливата JAVA_TOOL_OPTIONS в раздела environment. Примерът в документацията задава максимум 4 GB:

compose.yaml, в environment
      - JAVA_TOOL_OPTIONS=-Xmx4g

Примерният application.yml в документацията започва с пътя до базата данни. С Docker го оставете на /config/database.sqlite, стойността му по подразбиране: на всяко друго място базата би се създала вътре в контейнера и би се загубила при пресъздаването му. Запазете само редовете от примера, които са ви нужни.

HTTPS и обратният прокси

Документацията препоръчва да поставите пред Komga обратен прокси, който получава валиден сертификат, и предлага Caddy, който сам генерира сертификатите си от Let’s Encrypt. Проксито трябва да задава три заглавки, за да знае Komga публичния адрес и протокола на всяка заявка:

С Caddy

На поддомейн, без базов URL адрес в Komga, Caddy сам задава тези заглавки:

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

В подпапка първо задайте базовия URL адрес на Komga на /komga, в „Server Settings“ или с SERVER_SERVLET_CONTEXTPATH, после:

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

С Nginx

Примерът за Nginx в документацията препраща и връзките WebSocket. Добавете този блок map в раздела http на /etc/nginx/nginx.conf:

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

Този блок за сайта използва настройките от примера в документацията, на порт 80, за да остави на Certbot да постави HTTPS. Редът X-Forwarded-Host е добавен, тъй като списъкът със заглавки в документацията го изисква:

Блок на 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;
    }
}
Терминал
sudo nginx -t
sudo certbot --nginx

Пълният пример в документацията показва крайния вариант: порт 80, пренасочен към HTTPS, и блокът на порт 443 с пътищата до сертификата.

Библиотеки, сканиране и внос

Библиотеката е група книги, пазени под коренова папка. Komga създава серия за всяка подпапка, на всяка дълбочина, и книга за всеки файл, поставена в серията на родителската му папка. Метаданните от файловете EPUB и от файловете ComicInfo.xml в архивите имат предимство пред имената на папките и файловете.

  1. Качете файловете си на сървъра, в отделна подпапка на ~/komga/data за всяка библиотека, през SFTP или с rsync.
  2. В интерфейса щракнете + до „Libraries“.
  3. Дайте име на библиотеката, изберете кореновата ѝ папка с „Browse“, например /data/manga, после щракнете „Add“.
Терминал, на вашия компютър
rsync -av manga/ user@komga.example.com:komga/data/manga/

Кошчето

Книга, чийто файл изчезне, отива в кошчето, отбелязана като „Unavailable“, вместо да бъде изтрита: метаданните, напредъкът в четенето и списъците ѝ се връщат, ако файлът се появи отново на мястото си. Затова можете да преименувате и премествате файловете си, без да губите нищо. Кошчето се изпразва ръчно или след всяко сканиране, ако включите тази опция, която тогава премахва елементите веднага.

Внос на книги

Екранът „Import“, „Books“ подрежда в сериите ви книги, които се намират в друга папка на сървъра, например /data/import. За всеки файл избирате целевата серия, номера и името; номер, който вече е зает, предлага да се надгради съществуващата книга, като двете се показват една до друга. Komga премества файловете или създава твърди връзки към тях, когато файловата система го позволява, а иначе ги копира.

Смяната на кореновата папка на библиотека с път, несвързан със стария, заличава нейните серии, книги и напредък в четенето. Страницата с често задавани въпроси описва как да я преместите: включено хеширане на файловете, изключено автоматично изпразване на кошчето, после сканиране преди преместването.

Четене навсякъде: OPDS, Kobo и KOReader

Уеб четецът се отваря в браузъра, на адреса на сървъра. За приложение или е-четец Komga предлага три входа, всички за предоставяне през HTTPS.

OPDS

Komga работи с всяко приложение за OPDS, версия 1 или 2. Дайте на приложението един от тези адреси, после имейл адреса и паролата на акаунта си в Komga:

Адреси на OPDS
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog

Каталогът във версия 1.2 добавя търсене по серии, чрез OpenSearch, и четене страница по страница без изтегляне, чрез разширението OPDS PSE. Документацията поддържа списък с изпробвани приложения, за Android, iOS и други системи, с това, което поддържа всяко от тях.

Kobo Sync

Вашият е-четец Kobo се синхронизира с Komga вместо с официалните сървъри на Kobo. Книгите EPUB от всички библиотеки пристигат с метаданните и корицата си, преобразувани в KEPUB в движение от Kepubify, който е включен в образа на Docker. Напредъкът в четенето се синхронизира в двете посоки.

  1. Дайте на акаунта ролите Kobo Sync и File Download.
  2. Генерирайте API ключ на страницата на акаунта си, „Account Settings“, и си го запишете: той се показва само веднъж. Използвайте по един ключ за всеки е-четец.
  3. Свържете Kobo с компютъра си и отворете файла .kobo/Kobo/Kobo eReader.conf, с показани скрити файлове.
  4. В групата [OneStoreServices] заменете реда api_endpoint с адреса на сървъра си, последван от ключа ви.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

KOReader Sync

KOReader чете Komga през OPDS и синхронизира напредъка си в четенето чрез сървъра за синхронизация на Komga:

  1. Дайте на акаунта ролята KOReader Sync и включете хеширането на файловете за KOReader в опциите на библиотеката.
  2. Генерирайте API ключ на страницата на акаунта си.
  3. В KOReader, с отворена книга, отидете в „Progress sync“, после „Custom sync server“, и въведете https://komga.example.com/koreader.
  4. В „Register / Login“ въведете API ключа като потребителско име и каквато и да е стойност като парола, която Komga не използва.
  5. В „Document matching method“ изберете „Binary“.

Резервните копия

Всичко, което Komga знае за книгите ви, се намира в /config; самите книги остават в /data. Ето какво съдържа /config при конфигурацията по подразбиране:

ЕлементКакво пази
database.sqliteОсновната база данни: библиотеки, серии, книги, метаданни, потребители, напредък в четенето, колекции, списъци за четене и генерирани миниатюри
tasks.sqliteЧакащите фонови задачи
sessions.sqliteСесиите за вход, съхранявани по подразбиране в базата данни от версия 1.30.0
lucene/Индексът за търсене
fonts/Шрифтовете
logs/Журналите, включително komga.log
application.ymlВашата конфигурация, ако сте създали такава

Базите SQLite се копират при спрян Komga, за да е копието последователно. От папката на compose.yaml:

Терминал, в ~/komga
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start

Изпращайте този архив извън сървъра толкова често, колкото добавяте и четете книги. Пазете и копие на книгите си, с кориците, които държите до файловете: това е най-тежкият обем, но той се променя малко и rsync изпраща само новото. Поставени на диска на сървъра, тези архиви влизат и в нощните му резервни копия.

За възстановяване спрете Komga, заменете папката config с тази от архива, проверете, че тя все още е собственост на потребителя от compose.yaml, после го стартирайте отново.

Обновленията

С Docker Compose документацията дава тези команди, от папката на compose.yaml. Папката /config, монтирана от сървъра, запазва настройките ви:

Терминал
docker compose pull
docker compose up -d
docker image prune

Кой какво прави на Managed VPS

Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Komga остава ваш софтуер, с неговите настройки и вашите книги.

ТемаНашите екипиВие
СървърътОбновления на системата и на сигурността, включително намеси на сървъраМоментът, който пасва на вашата дейност
НаблюдениетоСървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането виЧетенето на журналите на вашата инстанция
KomgaПроактивно проследяване: грешки, забавяния, памет и дисково пространство се откриват, препоръчва се корекцияИнсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент
Библиотеките и читателитеСървърът, който ги носи, наблюдаван и архивиранБиблиотеките, акаунтите, ролите и API ключовете
Резервните копияВсяка нощ, криптирани и пазени извън машината; възстановяването е включеноКопията, специфични за Komga, и заявката за възстановяване, когато ви потрябва
МиграциятаСегашният ви сървър е мигриран, безплатноМоментът на превключването

Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.

Komga, на сървър, поддържан вместо вас

С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Komga, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.

Разгледайте Managed VPS

Често задавани въпроси

Безплатен ли е Komga за фирма?

Да. Komga е с лиценз MIT: можете да го използвате, променяте и разпространявате във фирма, без да купувате лиценз, стига да запазите бележката за авторските права. Остава цената на сървъра, на който работи.

Колко памет е нужна на Komga?

Документацията не определя минимум. По подразбиране Java ограничава паметта на Komga, обикновено около 1 GB. Ако журналите показват грешки OutOfMemoryException, повишете ограничението с JAVA_TOOL_OPTIONS, например -Xmx4g за 4 GB.

Как се инсталира Komga с Docker Compose?

Създайте compose.yaml с образа gotson/komga, порт 25600, публикуван на 127.0.0.1, папка config, монтирана на /config, папка data, монтирана на /data, и потребител, който притежава двете, после изпълнете docker compose up -d. След това поставете обратен прокси с HTTPS пред порт 25600.

Как се създава администраторският акаунт на Komga?

При първия достъп Komga иска имейл адрес и парола: този първи акаунт получава всички роли. Създайте го през SSH тунел, преди да отворите сървъра за публиката, после създайте другите акаунти в Server Settings, Users.

Какъв адрес на OPDS да дам на приложението си за четене?

Адреса на сървъра си, последван от /opds/v2/catalog за OPDS 2 или от /opds/v1.2/catalog за OPDS 1.2, с имейл адреса и паролата на акаунта си в Komga.

Как се синхронизира е-четец Kobo с Komga?

Дайте на акаунта ролите Kobo Sync и File Download, генерирайте API ключ в Account Settings, после заменете реда api_endpoint във файла Kobo eReader.conf с https://your-server/kobo/your-key. Синхронизират се само книгите EPUB.

Как се архивира Komga?

Спрете Komga, архивирайте папката config, стартирайте го отново и изпратете архива извън сървъра. Пазете и копие на книгите си. Правете копие точно преди всяко обновяване.

Покрива ли Managed VPS Komga?

Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.

Източници и официална документация

Свързани ръководства

Колко RAM е нужна за VPS: правилото, според всяка употребаПаметта (RAM) е ресурсът, който най-често определя размера на един VPS: тя свършва първа, а когато свърши, сървърът не се забавя, а спира услуги. Това ръководство дава правилото за изчисление, колко консумира всеки компонент на едно приложение, типични профили и начина да измерите сървър, който вече работи.Резервни копия на VPS: какво да проверите, преди да подпишетеПочти всяко предложение за VPS обявява „включени резервни копия“. Зад тези думи може да стои копие всяка нощ, пазено извън машината и възстановявано от експерти, или моментна снимка, поставена на същия диск като сървъра. Това ръководство дава въпросите, които правят разликата, какво означава всеки отговор и как да проверите, че едно резервно копие наистина се възстановява.Разлика между управляван и неуправляван VPS: кой какво правиРазликата между управляван и неуправляван VPS се свежда до един въпрос: кой се грижи за сървъра, след като той вече работи. Думата „управляван“ обаче няма официално определение и от един хостинг доставчик до друг обхваща всичко от простото инсталиране на системата до цялостното стопанисване на сървъра. Това ръководство показва кой какво прави, ред по ред, заедно с междинното ниво на експертното съдействие, и дава въпросите, които премахват двусмислието, преди да подпишете.
Свържете се с нас