Хостването на Komga на Managed VPS означава да четете комиксите, мангата и електронните си книги от своя собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Komga е медиен сървър, свободен софтуер с лиценз MIT. Това ръководство следва официалната му документация: паметта и хранилището, които да предвидите, инсталиране с Docker Compose, първият акаунт, конфигурацията, HTTPS, библиотеките, четенето през OPDS, Kobo и KOReader, резервните копия и обновленията.
Автор: Simon Vasconcelos Lee
Публикувано на 22 ноември 2026 г.Време за четене: 14 минути
/data; базата данни, индексът и журналите са в /config, на локален диск.gotson/komga, порт 25600, публикуван локално зад обратен прокси с HTTPS, и потребител, който притежава двете папки./config извън сървъра, пазете копие на книгите си и обновявайте с docker compose pull.Komga е медиен сървър за вашите комикси, манга, BD, списания и електронни книги. Посочвате му папките, в които са файловете ви, той ги подрежда в библиотеки, серии и книги, после ги предоставя на браузър или на приложение за четене. Работи навсякъде, където работят Java или Docker.
Komga се разпространява под лиценза MIT, на името на Gauthier Roebroeck. Той дава безплатно правото да използвате, копирате, променяте, сливате, публикувате, разпространявате, преотстъпвате под лиценз и продавате копия на софтуера. Следователно можете да го пускате за себе си, семейството си, сдружението си или фирмата си, без да купувате лиценз.
Единственото условие е да запазите бележката за авторските права и текста на лиценза във всички копия или съществени части на софтуера. Текстът предоставя софтуера „такъв, какъвто е“, без гаранция.
Документацията не определя минимална конфигурация. Тя дава обаче онова, което има значение при оразмеряването на сървъра: паметта на виртуалната машина на Java, задачите, които натоварват процесора, и преди всичко мястото, което заемат файловете ви.
OutOfMemoryException в журналите. Тогава ограничението се повишава с променливата JAVA_TOOL_OPTIONS, показана по-долу.Процесорът работи главно при сканирането и анализа на библиотеките. За всяка библиотека документацията предупреждава, че изчисляването на хешовете на файловете, на хешовете на страниците и на хешовете за KOReader, както и анализът на размерите на страниците, може да изразходва много ресурси при голяма библиотека. Броят на нишките, отделени за фоновите задачи, се задава в „Server Settings“.
Това е най-голямото перо и го измервате вие: размерът на колекцията ви плюс място за книгите, които смятате да добавите. Komga чете файловете ви там, където са, и не ги копира. Няколко точки от документацията променят сметката:
/data за книгите и вноса: документацията моли да поставите там библиотеките си и папката си за внос, така че вносът да създава твърди връзки вместо копия. Извън същата файлова система всеки внос заема мястото на едно копие./config пази основната база данни, с миниатюрите, генерирани за всяка книга, базата на задачите, базата на сесиите, индекса за търсене и журналите, които конфигурацията по подразбиране пази 7 дни и ограничава до 1 GB. Тя расте с размера на библиотеките ви./config: базите SQLite никога не трябва да са на мрежов дял като CIFS или NFS. Komga проверява това при стартиране и спира, ако не е така.На Managed VPS ни разкажете за колекцията си, нейния размер, колко бързо расте и колко читатели имате, и ще ви препоръчаме подходящия размер.
Документацията публикува образа 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 с вашата часова зона:
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: това е основната разлика спрямо примера от документацията, който го публикува на всички адреси. Документацията силно съветва HTTPS веднага щом Komga се отвори извън локалната ви мрежа, защото той използва удостоверяване HTTP Basic. Тогава интерфейсът е достъпен само през обратния прокси.user. Документацията моли монтираните папки да са собственост на същия потребител: тогава проблемите с правата изчезват./config пази базата данни и конфигурацията на Komga, на локален диск./data пази книгите ви и папката ви за внос. Всяка библиотека ще има там своя подпапка.1.x следва последната публикувана версия 1; 1.30.1 фиксира версия. Документацията описва latest като последния commit.version от примера в документацията е пропуснат: Docker Compose вече го смята за остарял и го пренебрегва.Другият път в документацията за 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 прилага промяната, после стартира както обикновено. Рестартирайте услугата, после махнете реда и я рестартирайте още веднъж:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Командата --list-users, използвана по същия начин, извежда списъка с акаунтите в журналите.
Komga има стойности по подразбиране за всяка настройка: конфигурацията само променя поведението му. Тя се прави с променливи на средата, най-лесният път с Docker Compose, или с файл application.yml, който създавате в папката /config, откъдето образът на Docker го зарежда. За да превърнете името на свойство в име на променлива, заменете точките с долни черти, махнете тиретата и преминете към главни букви.
| Променлива | Свойство | По подразбиране | Какво прави |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Портът за API и уеб интерфейса |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Базовият URL адрес, за да предоставяте Komga от подпапка |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 дни | Колко трае неактивна сесия, например 14d или 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Няма | Произходите, разрешени за CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Не е зададено | DEBUG за подробни журнали |
Портът и базовият URL адрес могат да се зададат и в „Server Settings“, и тогава тази настройка има предимство пред конфигурацията. За паметта на Java добавете променливата JAVA_TOOL_OPTIONS в раздела environment. Примерът в документацията задава максимум 4 GB:
- JAVA_TOOL_OPTIONS=-Xmx4g
Примерният application.yml в документацията започва с пътя до базата данни. С Docker го оставете на /config/database.sqlite, стойността му по подразбиране: на всяко друго място базата би се създала вътре в контейнера и би се загубила при пресъздаването му. Запазете само редовете от примера, които са ви нужни.
Документацията препоръчва да поставите пред Komga обратен прокси, който получава валиден сертификат, и предлага Caddy, който сам генерира сертификатите си от Let’s Encrypt. Проксито трябва да задава три заглавки, за да знае Komga публичния адрес и протокола на всяка заявка:
X-Forwarded-For, зададена или допълнена;X-Forwarded-Proto;X-Forwarded-Host.На поддомейн, без базов URL адрес в Komga, Caddy сам задава тези заглавки:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
В подпапка първо задайте базовия URL адрес на Komga на /komga, в „Server Settings“ или с SERVER_SERVLET_CONTEXTPATH, после:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Примерът за Nginx в документацията препраща и връзките WebSocket. Добавете този блок map в раздела http на /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Този блок за сайта използва настройките от примера в документацията, на порт 80, за да остави на Certbot да постави HTTPS. Редът X-Forwarded-Host е добавен, тъй като списъкът със заглавки в документацията го изисква:
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 в архивите имат предимство пред имената на папките и файловете.
~/komga/data за всяка библиотека, през SFTP или с rsync./data/manga, после щракнете „Add“.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga и /data/comics съществуват една до друга; /data и /data/manga не могат.#recycle.Книга, чийто файл изчезне, отива в кошчето, отбелязана като „Unavailable“, вместо да бъде изтрита: метаданните, напредъкът в четенето и списъците ѝ се връщат, ако файлът се появи отново на мястото си. Затова можете да преименувате и премествате файловете си, без да губите нищо. Кошчето се изпразва ръчно или след всяко сканиране, ако включите тази опция, която тогава премахва елементите веднага.
Екранът „Import“, „Books“ подрежда в сериите ви книги, които се намират в друга папка на сървъра, например /data/import. За всеки файл избирате целевата серия, номера и името; номер, който вече е зает, предлага да се надгради съществуващата книга, като двете се показват една до друга. Komga премества файловете или създава твърди връзки към тях, когато файловата система го позволява, а иначе ги копира.
Смяната на кореновата папка на библиотека с път, несвързан със стария, заличава нейните серии, книги и напредък в четенето. Страницата с често задавани въпроси описва как да я преместите: включено хеширане на файловете, изключено автоматично изпразване на кошчето, после сканиране преди преместването.
Уеб четецът се отваря в браузъра, на адреса на сървъра. За приложение или е-четец Komga предлага три входа, всички за предоставяне през HTTPS.
Komga работи с всяко приложение за OPDS, версия 1 или 2. Дайте на приложението един от тези адреси, после имейл адреса и паролата на акаунта си в Komga:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Каталогът във версия 1.2 добавя търсене по серии, чрез OpenSearch, и четене страница по страница без изтегляне, чрез разширението OPDS PSE. Документацията поддържа списък с изпробвани приложения, за Android, iOS и други системи, с това, което поддържа всяко от тях.
Вашият е-четец Kobo се синхронизира с Komga вместо с официалните сървъри на Kobo. Книгите EPUB от всички библиотеки пристигат с метаданните и корицата си, преобразувани в KEPUB в движение от Kepubify, който е включен в образа на Docker. Напредъкът в четенето се синхронизира в двете посоки.
.kobo/Kobo/Kobo eReader.conf, с показани скрити файлове.[OneStoreServices] заменете реда api_endpoint с адреса на сървъра си, последван от ключа ви.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 за адрес с HTTPS.KOReader чете Komga през OPDS и синхронизира напредъка си в четенето чрез сървъра за синхронизация на Komga:
https://komga.example.com/koreader.Всичко, което Komga знае за книгите ви, се намира в /config; самите книги остават в /data. Ето какво съдържа /config при конфигурацията по подразбиране:
| Елемент | Какво пази |
|---|---|
database.sqlite | Основната база данни: библиотеки, серии, книги, метаданни, потребители, напредък в четенето, колекции, списъци за четене и генерирани миниатюри |
tasks.sqlite | Чакащите фонови задачи |
sessions.sqlite | Сесиите за вход, съхранявани по подразбиране в базата данни от версия 1.30.0 |
lucene/ | Индексът за търсене |
fonts/ | Шрифтовете |
logs/ | Журналите, включително komga.log |
application.yml | Вашата конфигурация, ако сте създали такава |
Базите SQLite се копират при спрян Komga, за да е копието последователно. От папката на compose.yaml:
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
/config точно преди всяко обновяване.jar спрете Komga, после го стартирайте с файла jar на новата версия.Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Komga остава ваш софтуер, с неговите настройки и вашите книги.
| Тема | Нашите екипи | Вие |
|---|---|---|
| Сървърът | Обновления на системата и на сигурността, включително намеси на сървъра | Моментът, който пасва на вашата дейност |
| Наблюдението | Сървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането ви | Четенето на журналите на вашата инстанция |
| Komga | Проактивно проследяване: грешки, забавяния, памет и дисково пространство се откриват, препоръчва се корекция | Инсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент |
| Библиотеките и читателите | Сървърът, който ги носи, наблюдаван и архивиран | Библиотеките, акаунтите, ролите и API ключовете |
| Резервните копия | Всяка нощ, криптирани и пазени извън машината; възстановяването е включено | Копията, специфични за Komga, и заявката за възстановяване, когато ви потрябва |
| Миграцията | Сегашният ви сървър е мигриран, безплатно | Моментът на превключването |
Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.
С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Komga, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.
Да. Komga е с лиценз MIT: можете да го използвате, променяте и разпространявате във фирма, без да купувате лиценз, стига да запазите бележката за авторските права. Остава цената на сървъра, на който работи.
Документацията не определя минимум. По подразбиране Java ограничава паметта на Komga, обикновено около 1 GB. Ако журналите показват грешки OutOfMemoryException, повишете ограничението с JAVA_TOOL_OPTIONS, например -Xmx4g за 4 GB.
Създайте compose.yaml с образа gotson/komga, порт 25600, публикуван на 127.0.0.1, папка config, монтирана на /config, папка data, монтирана на /data, и потребител, който притежава двете, после изпълнете docker compose up -d. След това поставете обратен прокси с HTTPS пред порт 25600.
При първия достъп Komga иска имейл адрес и парола: този първи акаунт получава всички роли. Създайте го през SSH тунел, преди да отворите сървъра за публиката, после създайте другите акаунти в Server Settings, Users.
Адреса на сървъра си, последван от /opds/v2/catalog за OPDS 2 или от /opds/v1.2/catalog за OPDS 1.2, с имейл адреса и паролата на акаунта си в Komga.
Дайте на акаунта ролите Kobo Sync и File Download, генерирайте API ключ в Account Settings, после заменете реда api_endpoint във файла Kobo eReader.conf с https://your-server/kobo/your-key. Синхронизират се само книгите EPUB.
Спрете Komga, архивирайте папката config, стартирайте го отново и изпратете архива извън сървъра. Пазете и копие на книгите си. Правете копие точно преди всяко обновяване.
Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.
Simafri
Да поговорим за Вашия проект
Кажете ни с няколко думи от какво имате нужда: отговаряме Ви бързо.
Благодарим! Вашето запитване е изпратено. Ще се свържем с вас скоро.
Предпочитате имейл? Пишете ни на support@simafri.com.