Masaüstü Calibre, e-kitap dünyasının en güçlü kütüphane yöneticisidir; ama bir sorunu vardır. Kitaplarınız bilgisayarınızın diskinde durur ve o bilgisayarın başında olmadığınızda koleksiyonunuza erişmenin kolay bir yolu yoktur. Tabletten yatakta okumak isterseniz, işteki bilgisayardan bir romanı hızlıca indirmek isterseniz veya ailenizin geri kalanına kütüphaneyi açmak isterseniz masaüstü Calibre tek başına yetmez. Yıllar içinde biriktirdiğiniz yüzlerce EPUB ve PDF, kullanışlı ama yalnızca tek makinede yaşayan bir arşive dönüşür.
Calibre-Web, tam olarak bu boşluğu doldurur. Mevcut Calibre veritabanınızın önüne modern, hafif bir web arayüzü koyar; böylece aynı kütüphaneyi tarayıcıdan görüntüler, arar, indirir ve hatta doğrudan tarayıcıda okursunuz. Bu rehberde Calibre-Web'in ne olduğunu, masaüstü Calibre ile ilişkisini, Docker ile adım adım kurulumunu, kütüphane yolunun (metadata.db) nasıl bağlandığını, çok kullanıcılı yetkilendirmeyi, tarayıcı içi okuyucuyu ve en pratik özelliklerden biri olan "Kindle'a gönder" akışını kıdemli bir sistem yöneticisinin gözünden ele alacağız. Amaç, verisi tamamen sizde kalan, reklamsız ve her cihazdan erişilebilir bir kişisel kütüphane sunucusunu baştan sona kurabilmenizdir.
Calibre-Web Nedir?#
Calibre-Web, Python ve Flask ile yazılmış, açık kaynaklı bir web uygulamasıdır. Görevi tek cümleyle özetlenebilir: var olan bir Calibre kütüphanesine tarayıcıdan erişim sağlamak. Kendi başına bir e-kitap dönüştürme veya meta veri düzenleme motoru olma iddiasında değildir; onun yerine masaüstü Calibre'nin ürettiği metadata.db veritabanını okur ve içindeki kitapları şık bir web arayüzünde sunar. Bu nedenle Calibre-Web'i "Calibre'nin web yüzü" olarak düşünmek en doğrusudur.
Arayüz sade ama işlevseldir. Kitaplar kapak görselleriyle bir ızgara halinde listelenir; yazara, seriye, etikete, yayıncıya, dile ve dereceye göre filtreleme yapabilirsiniz. Bir kitabın detay sayfasında kapağını, açıklamasını, biçimini (EPUB, PDF, MOBI, CBZ) ve indirme bağlantılarını görürsünüz. Arama kutusu başlık ve yazar üzerinde anında sonuç verir. Tüm bunlar mütevazı bir donanımda bile hızlı çalışır; Calibre-Web, birkaç yüz MB bellekle yetinen, hafif bir uygulamadır ve bir VPS'te rahatça yaşar.
Uygulamanın öne çıkan yetenekleri arasında çok kullanıcılı erişim, ince ayarlı yetkilendirme, tarayıcı içi okuyucu, e-postayla Kindle'a gönderme, OPDS akışı (harici okuma uygulamaları için), yükleme ve isteğe bağlı biçim dönüştürme yer alır. Kısacası, tek başına duran masaüstü koleksiyonunuzu, ekibin veya ailenin ortak kullanabileceği merkezi bir hizmete çevirir. Tüm veri sizin sunucunuzda durduğu için hangi kitabı ne zaman okuduğunuz bir şirketin sunucusuna gitmez.
Calibre-Web ile Calibre Arasındaki Fark#
Yeni başlayanların en sık karıştırdığı nokta budur: Calibre ile Calibre-Web aynı şey değildir ve genellikle birlikte kullanılırlar. Masaüstü Calibre, kitaplarınızı içe aktardığınız, meta verilerini düzenlediğiniz, biçim dönüştürmesi yaptığınız ve kütüphane yapısını (metadata.db + kitap klasörleri) oluşturduğunuz ağır bir masaüstü uygulamasıdır. Calibre-Web ise bu yapının üzerine oturan, yalnızca web erişimi sunan hafif bir sunucudur. İkisinin sorumlulukları net biçimde ayrılır.
Pratikte tipik iş akışı şöyledir: Yeni kitapları masaüstü Calibre ile kütüphaneye ekler ve düzenlersiniz; Calibre-Web ise sunucuda çalışıp bu kütüphaneyi tüm cihazlara açar. İkisi aynı metadata.db'yi paylaşır. Elbette Calibre-Web tek başına da kullanılabilir; yükleme özelliğini açarsanız tarayıcıdan kitap ekleyebilir, gerekli araçları kurarsanız dönüştürme de yaptırabilirsiniz. Ancak yoğun meta veri düzenleme için masaüstü Calibre hâlâ daha güçlüdür. Aşağıdaki tablo iki aracın rollerini karşılaştırıyor.
| Özellik | Masaüstü Calibre | Calibre-Web |
|---|---|---|
| Çalıştığı yer | Kişisel bilgisayar | Sunucu (tarayıcıdan erişim) |
| Ana görev | Kütüphane oluşturma ve düzenleme | Kütüphaneyi web'de sunma |
| Kaynak veritabanı | metadata.db'yi üretir | metadata.db'yi okur |
| Çoklu kullanıcı | Yok | Var (yetki bazlı) |
| Kaynak tüketimi | Ağır (masaüstü) | Hafif (birkaç yüz MB) |
| Uzaktan erişim | Zayıf | Temel özelliği |
| Biçim dönüştürme | Yerleşik ve güçlü | İsteğe bağlı eklenti ile |
Docker ile Calibre-Web Kurulumu#
Calibre-Web'i kurmanın en temiz yolu Docker'dır; çünkü Python bağımlılıkları, dönüştürme araçları ve yapılandırma imajın içinde gelir ve sisteminizi kirletmeden tek dosyayla kurulur. Docker kavramlarına yabancıysanız önce Docker'a giriş rehberimizi okumanızı, konteynerleri görsel bir panelden yönetmek isterseniz de Portainer yazımızı incelemenizi öneririm. En yaygın ve iyi bakımlı imaj LinuxServer.io tarafından sağlanır ve varsayılan olarak 8083 portunda çalışır.
Başlamadan önce sunucuda iki dizin planlayın: biri yapılandırma (/config), diğeri kütüphaneniz (/books). Aşağıdaki docker-compose.yml üretimde rahatça kullanabileceğiniz sade bir başlangıçtır. Dikkat edilecek satır DOCKER_MODS çevre değişkenidir; bu, imaja Calibre'nin ebook-convert aracını ekler ve hem yükleme sırasında dönüştürmeyi hem de Kindle'a gönderme için biçim çevirisini mümkün kılar.
services:
calibre-web:
image: lscr.io/linuxserver/calibre-web:latest
container_name: calibre-web
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Istanbul
# ebook-convert + Kindle'a gönderirken biçim dönüştürme için:
- DOCKER_MODS=linuxserver/mods:universal-calibre
volumes:
- /srv/calibre-web/config:/config
- /srv/kutuphane:/books # metadata.db burada olmalı
ports:
- "8083:8083"
restart: unless-stopped
Dizinleri hazırlayıp konteyneri başlatmak için şu komutları çalıştırın. PUID ve PGID değerlerinin, kütüphane dizininin sahibi olan kullanıcıyla eşleşmesi önemlidir; aksi halde konteyner dosyaları okuyamaz.
# Dizinleri oluştur ve sahipliği ayarla
sudo mkdir -p /srv/calibre-web/config /srv/kutuphane
sudo chown -R 1000:1000 /srv/calibre-web /srv/kutuphane
# Konteyneri ayağa kaldır
docker compose up -d
# Kayıtları izleyerek başlangıç durumunu doğrula
docker compose logs -f calibre-web
Tarayıcıdan http://sunucu-ip:8083 adresine gittiğinizde giriş ekranıyla karşılaşırsınız. Varsayılan yönetici hesabı kullanıcı adı admin, parola admin123 şeklindedir. İlk girişten sonra yapmanız gereken ilk iki iş, bu parolayı değiştirmek ve kütüphane yolunu tanıtmaktır.
Kütüphane Yolu ve metadata.db#
Calibre-Web'in çalışabilmesi için mutlaka bir metadata.db dosyasına ihtiyacı vardır. İlk açılışta uygulama sizden kütüphane veritabanının konumunu ister; Docker kurulumunda bu yol konteyner içinde /books, sunucuda ise az önce bağladığınız /srv/kutuphane dizinidir. Ekrandaki "Location of Calibre database" alanına /books yazıp kaydettiğinizde uygulama veritabanını okur ve kitaplarınız arayüzde belirir.
Elinizde zaten masaüstü Calibre ile oluşturulmuş bir kütüphane varsa iş kolaydır: o klasörün tamamını (metadata.db dosyası ve kitap alt klasörleriyle birlikte) /srv/kutuphane içine kopyalamanız yeterlidir. Henüz bir kütüphaneniz yoksa boş bir metadata.db üretmeniz gerekir. Bunu masaüstü Calibre'de boş bir kütüphane oluşturup dosyayı kopyalayarak ya da sunucuda Calibre'nin komut satırı aracıyla yapabilirsiniz.
# Sunucuda calibredb kuruluysa: boş dizinde list çalıştırmak metadata.db üretir
calibredb --with-library=/srv/kutuphane list
# Alternatif: masaüstü Calibre'de yeni boş kütüphane açıp
# yalnızca metadata.db dosyasını sunucuya taşıyın:
scp ~/Calibre-Kutuphanem/metadata.db kullanici@sunucu:/srv/kutuphane/
Kütüphaneyi tanıttıktan sonra karşılaşabileceğiniz en yaygın sorun izin hatalarıdır. Konteyner dosyaları okuyamıyorsa neredeyse her zaman sebep, dizin sahipliğinin PUID/PGID değerleriyle uyuşmamasıdır; chown -R 1000:1000 /srv/kutuphane komutunu yeniden çalıştırmak sorunu çözer. Bir diğer önemli kural, aynı metadata.db'ye masaüstü Calibre ve Calibre-Web'in aynı anda yazmamasıdır. Masaüstünde kütüphaneyi düzenlerken veritabanı kilitlenebilir; düzenlemeyi bitirdikten sonra değişiklikleri sunucuya senkronlamak en güvenli yaklaşımdır.
Kullanıcı Yönetimi ve Yetkiler#
Calibre-Web'i kişisel bir araçtan aile veya ekip hizmetine dönüştüren şey, çok kullanıcılı yapısıdır. Yönetici olarak Admin → Users menüsünden yeni kullanıcılar oluşturur ve her birine ayrı bir yetki seti tanımlarsınız. Yetkiler oldukça ince ayarlıdır: bir kullanıcının yalnızca kitap indirebilmesini, bir başkasının yükleme yapabilmesini, üçüncü birinin ise meta veri düzenleyebilmesini sağlayabilirsiniz. Böylece herkese yönetici parolası vermek zorunda kalmazsınız.
Yetkilerin ötesinde bir de görünürlük kısıtları vardır. Bir kullanıcıya yalnızca belirli etiketlere veya özel sütun değerlerine sahip kitapları gösterebilirsiniz. Örneğin çocuklar için açtığınız bir hesapta yalnızca "çocuk" etiketli kitapların görünmesini, yetişkin içeriğinin gizlenmesini sağlayabilirsiniz. Bu, tek bir kütüphaneyi farklı kitlelere bölmek için pratik bir yoldur. Aşağıdaki tablo tipik yetki alanlarını özetliyor.
| Yetki | Ne işe yarar |
|---|---|
| Kitap indirme | İndirme bağlantılarını görür |
| Yükleme | Tarayıcıdan yeni kitap ekleyebilir |
| Meta veri düzenleme | Başlık, yazar, kapak gibi alanları değiştirir |
| E-postayla gönderme | Kitabı Kindle/e-okuyucuya iletebilir |
| Yönetici | Kullanıcı ve ayarları yönetir |
| Etiket kısıtı | Yalnızca belirli etiketli kitapları görür |
Yeni bir kullanıcı eklerken parola belirlerken güçlü değerler seçmeye özen gösterin; bu sunucu internete açıksa zayıf parolalar en büyük risktir. Ayrıca "Guest" (misafir) girişini yalnızca gerçekten herkese açık bir kütüphane istiyorsanız etkinleştirin. Kimlik doğrulamayı daha da sıkılaştırmak isterseniz Calibre-Web'i bir ters proxy arkasına alıp temel HTTP kimlik doğrulaması veya bir kimlik sağlayıcı ekleyebilirsiniz.
Tarayıcı İçi E-Kitap Okuyucusu#
Calibre-Web'in belki de en keyifli özelliği, kitabı indirmeden doğrudan tarayıcıda okumanıza izin vermesidir. Bir kitabın detay sayfasında "Read in browser" (Tarayıcıda oku) bağlantısını gördüğünüzde, o biçim için gömülü bir okuyucu devreye girer. EPUB dosyaları için sayfa geçişli, yazı tipi ve boyutu ayarlanabilen akıcı bir okuyucu; PDF için sayfa görüntüleyici; CBZ/CBR gibi çizgi roman biçimleri için ise panel panel ilerleyen bir okuyucu açılır. TXT dosyaları da doğrudan görüntülenebilir.
Bu özellik, özellikle iş yerindeki bir bilgisayardan ya da kendinize ait olmayan bir cihazdan hızlıca bir bölüm okumak istediğinizde çok işe yarar; hiçbir şey indirmeniz veya kurmanız gerekmez. Okuyucu istemci tarafında (JavaScript ile) çalıştığı için sunucuya ek yük bindirmez ve kitap dosyası yalnızca gerektikçe akıtılır. EPUB okuyucusu kaldığınız yeri hatırlayarak sonraki açılışta oradan devam etmenizi de sağlar.
Tarayıcı içi okuyucu her biçimi desteklemez; örneğin MOBI veya AZW3 gibi Amazon biçimleri doğrudan okunamayabilir. Böyle durumlarda pratik çözüm, kitabı masaüstü Calibre ile EPUB'a çevirip kütüphaneye eklemek ya da yükleme sırasında Calibre-Web'in dönüştürmesini kullanmaktır. Kütüphanenizi olabildiğince EPUB ağırlıklı tutmak, hem tarayıcı okuyucusuyla hem de çoğu e-okuyucuyla en sorunsuz deneyimi verir.
Kindle'a Gönderme (Send to Kindle)#
Calibre-Web'in en çok sevilen özelliklerinden biri, bir kitabı tek tıkla Kindle veya başka bir e-okuyucuya e-postayla göndermesidir. Amazon Kindle cihazlarının her birinin @kindle.com uzantılı bir e-posta adresi vardır; bu adrese bir belge gönderdiğinizde Amazon onu otomatik olarak cihazınıza indirir. Calibre-Web bu mekanizmayı kullanır: kitabı, gerekiyorsa uygun biçime çevirip (EPUB veya AZW3) e-posta ekinde Kindle adresinize yollar.
Bu özelliği kullanmak için önce yönetici panelinde bir SMTP sunucusu tanımlamanız gerekir. Admin → Edit E-mail Server Settings bölümünde bir Gmail, kendi posta sunucunuz veya bir işlemsel e-posta hizmeti kullanabilirsiniz. Aşağıda tipik alanları örnekliyorum.
; Calibre-Web e-posta sunucusu ayarları (örnek)
smtp_hostname = smtp.gmail.com
smtp_port = 587
encryption = STARTTLS
smtp_login = [email protected]
smtp_password = uygulama-parolasi
from_email = [email protected]
Ayarları kaydettikten sonra her kullanıcı, kendi profil sayfasında Kindle e-posta adresini girer. Kritik bir ayrıntı, Amazon'un güvenlik gereği yalnızca "onaylı gönderen" listesindeki adreslerden gelen belgeleri kabul etmesidir. Bu yüzden Calibre-Web'in from_email adresini, Amazon hesabınızdaki Onaylı Kişisel Belge E-posta Listesi'ne eklemelisiniz; aksi halde gönderim sessizce reddedilir. Bu tek seferlik ayarı yaptıktan sonra, bir kitabın yanındaki "Send to Kindle" düğmesine basmak, o kitabı birkaç dakika içinde cihazınıza düşürmek için yeterlidir.
Kindle dışındaki e-okuyucular için de aynı mantık geçerlidir; birçok cihaz ve okuma uygulaması bir e-posta adresi veya OPDS akışıyla kitap alabilir. Calibre-Web'in yerleşik OPDS desteği sayesinde KOReader, Moon+ Reader gibi uygulamalar doğrudan kütüphanenize bağlanıp kitapları listeleyip indirebilir. Böylece tek bir merkezi kütüphaneden, elinizdeki her cihaza kitap taşıyabilirsiniz.
Ters Proxy ve Güvenli Erişim#
Calibre-Web'i yalnızca yerel ağınızda kullanacaksanız 8083 portu yeterlidir; ancak evin veya ofisin dışından erişecekseniz mutlaka bir alan adı ve HTTPS ile önüne bir ters proxy koymalısınız. Şifresiz HTTP üzerinden giriş yapmak, parolanızın ağda açık dolaşması demektir. Bir Nginx ters proxy, hem TLS sonlandırması yapar hem de uygulamayı doğrudan internete açmadan güvenli bir kapı sunar. Ücretsiz bir sertifikayı Let's Encrypt ile alabilir, düzenli yenileme için SSL sertifikası hizmetimize göz atabilirsiniz.
Aşağıdaki Nginx bloğu, kitap.ornek.com alan adını konteynerin 8083 portuna yönlendiren tipik bir yapılandırmadır. E-kitap dosyaları büyük olabileceği için yükleme boyutu sınırını yükseltmeyi unutmayın.
server {
listen 443 ssl http2;
server_name kitap.ornek.com;
ssl_certificate /etc/letsencrypt/live/kitap.ornek.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/kitap.ornek.com/privkey.pem;
client_max_body_size 256M; # büyük EPUB/PDF yüklemeleri için
location / {
proxy_pass http://127.0.0.1:8083;
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;
}
}
İnternete açık bir kütüphanede güvenliği katmanlı düşünmek gerekir. Güçlü yönetici parolası ve düzenli güncelleme temel adımlardır; bunun üzerine bir güvenlik duvarı, kötü niyetli isteklere karşı WAF veya hacimli saldırılara karşı DDoS koruması ekleyebilirsiniz. Kütüphaneniz zamanla değerli bir arşive dönüşeceği için düzenli yedekleme almayı da ihmal etmeyin; metadata.db ve kitap klasörlerinin bir kopyası, olası bir disk arızasında yıllarca biriktirdiğiniz koleksiyonu kurtarır.
Sıkça Sorulan Sorular#
Calibre-Web ile masaüstü Calibre'nin farkı nedir?#
Masaüstü Calibre kütüphaneyi oluşturup düzenlediğiniz ağır uygulamadır, Calibre-Web ise bu kütüphanenin metadata.db dosyasını okuyarak web arayüzü sunan hafif bir sunucudur. İkisi genellikle birlikte çalışır: kitapları masaüstü Calibre ile eklersiniz, Calibre-Web bunları tüm cihazlara açar. Calibre-Web tek başına da kullanılabilir ancak yoğun meta veri düzenleme için masaüstü sürüm hâlâ daha güçlüdür.
Calibre-Web'i çalıştırmak için mevcut bir Calibre kütüphanesi şart mı?#
Bir metadata.db dosyası şarttır ancak bunu masaüstü Calibre kurmadan da üretebilirsiniz. Zaten bir kütüphaneniz varsa klasörü olduğu gibi sunucuya kopyalarsınız. Yoksa masaüstü Calibre'de boş bir kütüphane açıp yalnızca metadata.db dosyasını taşıyabilir ya da sunucuda calibredb aracıyla boş bir veritabanı oluşturabilirsiniz. Dosya hazır olduğunda kütüphane yolunu /books olarak tanıtmanız yeterlidir.
Varsayılan yönetici giriş bilgileri nedir?#
İlk kurulumda kullanıcı adı admin ve parola admin123 olarak gelir. İlk girişten sonra yapmanız gereken en önemli iş bu parolayı güçlü bir değerle değiştirmektir. Sunucu internete açıksa varsayılan parolayı değiştirmeden bırakmak, kütüphanenizi herkese açık hale getiren ciddi bir güvenlik açığıdır.
Kitapları doğrudan Kindle'a nasıl gönderirim?#
Önce yönetici panelinde bir SMTP e-posta sunucusu tanımlar, ardından her kullanıcının profiline @kindle.com uzantılı Kindle adresini girersiniz. Kritik nokta, Calibre-Web'in gönderen e-posta adresini Amazon hesabınızdaki onaylı belge listesine eklemenizdir; aksi halde Amazon gönderiyi reddeder. Bu ayarlar tamamlandığında kitabın yanındaki "Send to Kindle" düğmesi, dosyayı gerekiyorsa uygun biçime çevirip birkaç dakikada cihazınıza iletir.
Calibre-Web ne kadar kaynak tüketir, küçük bir sunucuda çalışır mı?#
Calibre-Web oldukça hafiftir ve genellikle birkaç yüz MB bellekle yetinir, bu yüzden en mütevazı sanal sunucularda bile rahatça çalışır. Asıl kaynak yükü, yükleme sırasında biçim dönüştürme (ebook-convert) yaptığınızda geçici olarak artar. Kütüphaneniz on binlerce kitaba ulaşmadıkça 1 GB bellekli bir VPS fazlasıyla yeterlidir; disk alanınızı ise kitap koleksiyonunuzun boyutu belirler.
Aynı kütüphaneyi birden fazla kişi kullanabilir mi?#
Evet, Calibre-Web çok kullanıcılı olacak şekilde tasarlanmıştır. Yönetici olarak her kişiye ayrı hesap açar, indirme, yükleme, düzenleme ve e-postayla gönderme gibi yetkileri tek tek belirlersiniz. Ayrıca etiket veya özel sütun bazlı görünürlük kısıtlarıyla bir kullanıcıya kütüphanenin yalnızca bir bölümünü gösterebilirsiniz; bu, örneğin çocuklar için filtrelenmiş bir görünüm oluşturmayı kolaylaştırır.
Kapanış#
Calibre-Web, yıllar içinde biriktirdiğiniz e-kitap koleksiyonunu tek bir bilgisayarda hapsolmuş bir arşiv olmaktan çıkarıp her cihazdan erişilebilen, çok kullanıcılı ve reklamsız bir kişisel kütüphaneye dönüştürür. Docker ile kurulumu dakikalar sürer, mevcut Calibre veritabanınızın önüne oturur, tarayıcıda okuma ve Kindle'a gönderme gibi pratik özelliklerle günlük okuma alışkanlığınıza gerçekten değer katar. Verinizin tamamı sizde kaldığı için gizliliğinizden ödün vermeden, tamamen kendi kontrolünüzde bir çözüm elde edersiniz.
Bu kütüphaneyi 7/24 çalışan, hızlı ve güvenli bir altyapıda barındırmak isterseniz Clou.TR yanınızda. Docker tabanlı uygulamalar için tam yetkili bir ortam sunan sanal sunucu ve VDS paketlerimiz, kendi kütüphanenizi kurmak için idealdir; kurulum ve bakımla uğraşmak istemezseniz sunucu yönetimi hizmetimizle tüm işi bize bırakabilirsiniz. Kolayca kurulabilen açık kaynak uygulamalara göz atmak için App Center sayfamızı, alan adı ve barındırma seçenekleri için de alan adı ve hosting sayfalarımızı ziyaret edebilirsiniz. Kendi dijital kütüphanenizi kurmanın tam zamanı.