Success
Kısa cevap: iPhone veya iPad'de OPDS sunucusu kurmak için OPDS destekleyen bir okuyucu uygulaması yükleyin, Kitaplık veya Kataloglar bölümünü açın, yeni katalog ekleyin, sunucunun tam OPDS adresini yapıştırın (örneğin Calibre Content Server için http://192.168.1.10:8080/opds, çıplak IP adresi değil), bir ad verin ve yalnızca sunucu istiyorsa kullanıcı adı ile parola girin. Kaydedin, uygulama o sunucudaki her kitabı listeler ve indirip çevrimdışı okuyabilirsiniz. En sık yapılan hata /opds yolunu ya da port numarasını atlamaktır.
OPDS kulağa ev sunucusu deneyimi gerektiren bir şey gibi geliyor, ama herkesin takıldığı iki şeyi bildikten sonra yaklaşık iki dakika sürüyor: sunucunun beklediği tam yol ve her sunucunun oturum açmayı nasıl ele aldığı.
Bir not: adım Petr Jahoda, justRead uygulamasını ben yapıyorum. Burada anlatılan her OPDS bağlantısını bir belgeyi başka sözcüklerle yazmak yerine gerçek sunucular ve gerçek bir iPhone üzerinde bizzat kurdum. Aşağıdaki tuzaklar benim de takıldıklarım.
OPDS aslında nedir
OPDS, açılımıyla Open Publication Distribution System, bir okuma uygulamasının sunucudan kitap taramasına ve indirmesine izin veren basit bir standart. En temiz benzetme şu: OPDS, kitaplar için RSS'tir. Bir RSS okuyucusu tek bir besleme adresine bakar ve o kaynaktan gelen her yeni yazıyı gösterir. Bir OPDS okuyucusu tek bir katalog adresine bakar ve sunucunun sunduğu her kitabı kapaklar, yazarlar, açıklamalar ve indirme bağlantılarıyla gösterir.
Tek bir şirketin uygulaması değil, açık bir standart olduğu için aynı okuyucu çok farklı kaynaklara aynı mekanizmayla bağlanabilir: Project Gutenberg gibi bir kamu malı kütüphanesi, bir ev medya sunucusu ve kendi Calibre koleksiyonunuz aynı dili konuşur. Hiçbir şey bir mağazaya ya da hesaba bağlı değildir.
Karşınıza iki sürüm çıkacak:
- OPDS 1.2, bugün neredeyse her şeyin konuştuğu sürüm. XML besleme biçimi Atom üzerine kurulu, yani bir katalog aslında kitapları ve alt bölümleri listeleyen bir XML belgesi. 2026'da size bir OPDS adresi verildiğinde neredeyse kesinlikle 1.2'dir.
- OPDS 2.0, aynı fikrin JSON tabanlı yeni yazımı. Geliştiriciler için daha temiz ve görünmeye başladı (örneğin Komga ikisini birden sunuyor), ama yaygınlaşması henüz erken. Seçim yapmanız gerekmiyor.
Başlamadan önce neye ihtiyacınız var
- Katalog adresi. Bu, OPDS uç noktasıdır ve genellikle
/opdsya da benzer bir yolla biter. Kendi sunucunuz için bu, sunucunun adresi artı o yazılımın kullandığı OPDS yoludur; kurulumların çoğu tam burada başarısız olur. - Kullanıcı adı ve parola, yalnızca sunucu istiyorsa. Genel kataloglar genellikle açıktır. Kendi Calibre veya Komga sunucunuz gibi özel sunucular oturum açma isteyebilir.
Liste bu kadar. Üçüncü taraf hesabı yok, araya giren senkronizasyon servisi yok, kabloyla elle dosya taşıma yok.
Adım 1: bir OPDS okuyucusu yükleyin
iOS ve iPadOS kendi başına OPDS kataloglarını taramaz. justRead iPhone ve iPad için OPDS'i yerleşik gelen bir EPUB ve PDF okuyucusu: Project Gutenberg ve Internet Archive yerleşik katalog olarak gelir, kendi sunucularınızı ekleyebilirsiniz, ve sunucu tarafı arama, sayfalama ve kategoriye göre gezinme sayesinde çok büyük kataloglar bile kullanışlı kalır. Hangi uygulamayı seçerseniz seçin, aradığınız şey kitaplığında veya ayarlarında bir OPDS ya da Kataloglar bölümü. Tam özellik dökümü için OPDS okuyucu genel bakışı sayfasına bakın.
Baştan söylenmesi gereken dürüst bir sınır: justRead EPUB ve PDF dosyaları okur. Yalnızca başka biçimler sunan OPDS katalogları yine de taranır, ama sadece EPUB ve PDF sürümlerini indirebilirsiniz.
Adım 2: ilk kataloğunuzu adım adım ekleyin
Hiç yazmadan (yerleşik). justRead Project Gutenberg ve Internet Archive ile birlikte gelir. Kitaplığı açın, katalog alanına gidin, zaten oradalar. Project Gutenberg'e dokunun ve hemen 70.000'den fazla kamu malı kitaba göz atmaya başlayın. Her şeyin çalıştığını doğrulamak için önce bunu bir kez yapın.
Elle (herhangi bir katalog). Adresle katalog eklemek için akış çoğu okuyucuda aynı, justRead'de şöyle:
- Kitaplığı açın.
- OPDS kataloğu ekle seçeneğini seçin.
- Katalog adresini adres alanına yapıştırın. Yeniden yazmayın ki yolda veya portta yazım hatası yapmayasınız.
- Sonradan tanıyacağınız bir ad verin, örneğin "Evdeki Calibre".
- Sunucu oturum açma istiyorsa kullanıcı adı ve parolayı girin. İstemiyorsa boş bırakın.
- Kaydedin.
Katalog listenizde belirir. Taramak için dokunun. Büyük kataloglar içine girilebilen bölümler halinde açılır, böylece dev bir listeyi kaydırmak yerine kategoriye göre gezebilirsiniz.
Bu altı adım işin tamamı. Rehberin geri kalanı tek bir değeri doğru yapmakla ilgili: 3. adımdaki adres.
/opds yolu tuzağı, ayrıntısıyla
Buradan tek bir şey alacaksanız şunu alın: OPDS adresi neredeyse hiçbir zaman yalnızca sunucunun adresi değildir. Çıplak IP ya da ana bilgisayar adı sunucunun insanlar için hazırlanmış web sayfasını gösterir, makinelerin okuduğu OPDS beslemesini değil. Okuyucuyu http://192.168.1.10:8080 adresine yönlendirirseniz hata ya da boş katalog alırsınız; http://192.168.1.10:8080/opds adresine yönlendirirseniz kitaplığınız görünür.
- Calibre Content Server OPDS'i varsayılan olarak
8080portunda/opdsaltında sunar:http://<ip>:8080/opds. - Komga OPDS 1.2 beslemesini daha derin bir yolda sunar:
http://<host>:25600/opds/v1.2/catalog. - Kavita farklı davranır: kullanıcı adı ve parola yerine API anahtarını doğrudan adrese gömer:
http://<host>:5000/api/opds/<api-anahtariniz>. Ayrı bir parola yoktur, çünkü adresteki anahtar kimlik bilgisidir. Kavita'nın ayarlarından hazır adresin tamamını kopyalayın ve oturum açma alanlarını boş bırakın.
Kural şu: portu doğru yapın, yolu doğru yapın ve kimlik bilgisinin adreste mi yoksa alanlarda mı yaşadığını kontrol edin. Bağlantı başarısız olduğunda onda dokuz bunlardan biridir.
Adım 3: bir Calibre Content Server bağlayın
En popüler özel katalog kendi Calibre kitaplığınızdır.
- Bilgisayarınızda Calibre'yi açın ve araç çubuğunda Bağlan/paylaş'a tıklayın.
- İçerik Sunucusunu Başlat'ı seçin.
- Bilgisayarınızın yerel IP adresini bulun (
192.168.1.10gibi). OPDS uç noktası o zamanhttp://192.168.1.10:8080/opdsolur.
iPhone veya iPad'inizde bu adresi yukarıdaki altı adımla yeni bir OPDS kataloğu olarak ekleyin. justRead burada iki şeyle işi kolaylaştırır: aynı Wi-Fi'daki bir Calibre Content Server'ı otomatik bulabilir, yani IP'yi bulup yazmanız hiç gerekmeyebilir, ve Calibre'nin kullandığı HTTP Digest kimlik doğrulamasını destekler.
Bilmeye değer birkaç gerçek: katalogun çalışması için Calibre bilgisayarda açık kalmalı, uzaktan erişim kurmadıysanız iki cihaz aynı ağda olmalı, ve bilgisayarın IP adresi değişirse (ev yönlendiricileri bunu kendiliğinden yapar) katalog adresi de değişir. Yönlendiricide sabit IP ayırmak ya da makinenin .local adını kullanmak "dün çalışıyordu, bugün bozuldu" sorununu önler.
Sunucu tarafını düzgün kurmak isterseniz Calibre Content Server rehberi yalnızca onunla ilgilenir.
Kendi sunucularınız için adres kalıpları
| Sunucu | Ne için en iyi | OPDS uç noktası kalıbı |
|---|---|---|
| Calibre Content Server | Mevcut masaüstü Calibre kitaplığınız | http://<ip>:8080/opds |
| calibre-web | Web arayüzlü Calibre kitaplığı | http://<host>:8083/opds |
| Komga | Çizgi roman ve manga, ayrıca EPUB | http://<host>:25600/opds/v1.2/catalog |
| Kavita | Çizgi roman, manga ve e-kitaplar | http://<host>:5000/api/opds/<api-anahtariniz> |
| COPS | Calibre veritabanı üzerinde hafif PHP kataloğu | http://<host>/cops/feed.php |
Tabloyla ilgili notlar: gösterilen portlar her projenin yaygın varsayılanlarıdır, ama hepsi kurulumda değiştirilebilir, bu yüzden bağlantı başarısız olursa kendi ayarlarınızdan doğrulayın.
Genel OPDS katalogları için başlangıç listesi
Kendi sunucunuz olmadan da OPDS kullanabilirsiniz.
- Project Gutenberg (doğrulandı, oturum açma yok):
https://www.gutenberg.org/ebooks.opds/. 70.000'den fazla kamu malı kitap. justRead'de yerleşik gelir. - Unglue.it (doğrulandı, oturum açma yok):
https://unglue.it/api/opds/. Creative Commons lisanslı e-kitaplar. - Standard Ebooks (gerçek besleme, ama kapalı):
https://standardebooks.org/feeds/opdsadresinde bir OPDS beslemesi yayımlıyor, ama tamamı destekçilere ayrılmış ve diğerlerine 401 döndürüyor.
Türkçe okuyanlar için önemli bir uyarı: Project Gutenberg'in Türkçe dil filtresi sıfır kitap döndürür, başka listelerin ima ettiği gibi bir kitap bile değil, ve doğrulanmış bir Türkçe OPDS kataloğu yoktur. Ayrıntılar ve Türkçe için gerçek çözüm 2026'nın en iyi ücretsiz OPDS katalogları yazısında. O yazı "nereye yönlendirmeli" sorusunun sahibi, bu yazı "nasıl yönlendirmeli" sorusunun.
HTTP, HTTPS, sertifikalar ve oturum açma
Yerel ev sunucuları genellikle kendi ağınızda düz HTTP üzerinden çalışır ve bu sorun değil, çünkü trafik evden hiç çıkmaz. Wi-Fi'nizdeki bir Calibre Content Server için https:// değil http:// yazacaksınız ve bu beklenen bir durumdur.
Kataloğa evinizin dışından ulaşmak istediğiniz anda HTTPS önem kazanır ve iOS bu konuda katıdır:
- iOS güvenilmeyen sertifikaları reddeder. Sunucunuz kendinden imzalı sertifika kullanıyorsa iOS bağlantıyı reddeder, okuyucuda "yine de devam et" düğmesi göstermez. Güvenilir çözüm gerçek bir sertifikadır: sunucuyu bir alan adının arkasına koyup ücretsiz sertifika alın (örneğin Let's Encrypt ile), genellikle bir ters vekil sunucu üzerinden.
- Basic ve Digest kimlik doğrulaması. Basic, kullanıcı adı ve parolayı her istekle gönderir (HTTPS üzerinde güvenli, düz HTTP'de açıkta), Digest ise ham parolayı hiç göndermeyen bir sor-cevapla şemadır. Calibre Digest kullanır ve justRead bunu destekler. Tek bir yanlış karakter uygulamaya "erişim reddedildi" olarak okunur, "yanlış parola" değil; bu yüzden yazım hataları bağlantı arızası gibi görünür.
Hiçbir şey görünmüyor mu? Tam kontrol listesi
- Yanlış yol. Tam OPDS yolu yerine çıplak adresi kullandınız.
/opds(Calibre) veya/opds/v1.2/catalog(Komga) ekleyin. Bir numaralı sebep budur. - Eksik port.
:8080,:25600,:5000veya:8083düşmüş. - Aynı ağ mı? Telefon ve sunucu aynı Wi-Fi'da olmalı. Telefonlar mobil veriye kaçmayı sever; 5G'deyseniz ve sunucu
192.168.x.xise ulaşılamaz. - Dışarıdan yerel IP.
192.168.x.xyalnızca evinizde çalışır. Uzaktan erişim için VPN ya da alan adı ve ters vekil gerekir. - Güvenlik duvarı portu engelliyor. Calibre'nin en yaygın arızası: sunucu çalışıyor, adres doğru, ama bilgisayarın güvenlik duvarı 8080'e gelen bağlantıları sessizce engelliyor.
- Sunucu aslında çalışmıyor. Aynı ağdaki bir masaüstü tarayıcıda tam adresi açın: tarayıcı da ulaşamıyorsa sorun sunucudadır, uygulamada değil.
- Kimlik bilgisi yazım hatası. İlk harfin otomatik büyütülmesine ve yapıştırmadan gelen boşluğa dikkat edin.
- HTTPS sertifikası reddedildi.
- Adres değişti. Yönlendirici bilgisayara yeni bir IP verdi. Sabit IP ayırın ya da
.localadını kullanın.
En hızlı tek teşhis 6. maddedir: aynı ağdaki bir tarayıcıda tam OPDS adresini açın. Ham XML görüyorsanız sunucu ve adres iyidir, sorun uygulamada ya da kimlik bilgilerindedir.
OPDS okuma düzeninizde nereye oturur
OPDS, iPhone veya iPad'i yönlendirebildiğiniz her kütüphanenin ön yüzüne dönüştürür, dosyaları elle taşımadan. Katalog kurulduktan sonra yeni bir kitap eklemek iki dokunuş.
- iOS'ta e-kitaplara yeni misiniz? iPhone ve iPad'de EPUB nasıl okunur ile başlayın.
- Bir OPDS okuyucusunun neler yapabildiğinin tam resmi için OPDS okuyucu genel bakışı.
- Hangi genel katalogları ekleyeceğinize karar veriyorsanız 2026'nın en iyi ücretsiz OPDS katalogları.
- Kendi Calibre'nizi mi çalıştırıyorsunuz? Calibre Content Server rehberi sunucu tarafını, Calibre eşitleme ise iki yönlü ilerleme ve puan eşitlemesini anlatır.
justRead 14 günlük ücretsiz deneme sunar. justRead'i App Store'dan indirin ve ilk OPDS kataloğunuzu bugün ekleyin.
Sık sorulan sorular
OPDS kataloğu nedir?
Bir okuma uygulamasının sunucudan kitap taramasına ve indirmesine izin veren bir beslemedir, tıpkı bir RSS okuyucusunun haber beslemesine abone olması gibi.
Calibre Content Server için doğru OPDS adresi nedir?
Bilgisayarınızın yerel IP'si, Calibre'nin portu ve /opds yolu: http://192.168.1.10:8080/opds. Onu bozan iki hata /opds olmadan çıplak IP kullanmak ve :8080 portunu unutmaktır.
iPhone'da OPDS kullanmak için Calibre'ye ihtiyacım var mı?
Hayır. Kendi sunucunuz olmadan genel kataloglara bağlanabilirsiniz ve justRead'de Gutenberg ile Internet Archive yerleşik gelir.
OPDS sunucum iOS'ta neden bağlanmıyor?
Sırasıyla en yaygın nedenler: yanlış yol (/opds eksik), eksik port numarası, telefon ve sunucunun farklı ağlarda olması, portu engelleyen güvenlik duvarı, oturum açma yazım hatası veya iOS'un güvenmediği kendinden imzalı bir HTTPS sertifikası.
Kavita neden kullanıcı adı ve parola sormuyor?
Kavita API anahtarını doğrudan OPDS adresine koyar, yani anahtar kimlik bilgisidir. Tam adresi Kavita'nın ayarlarından kopyalayın ve oturum açma alanlarını boş bırakın.
OPDS 1.2 ile 2.0 arasındaki fark nedir?
OPDS 1.2, Atom üzerine kurulu eski XML sürümüdür ve bugün neredeyse her sunucu ile okuyucu onu konuşur. OPDS 2.0 daha yeni JSON tabanlı sürümdür ve yaygınlaşması erken aşamadadır.
OPDS iPhone'da HTTPS ve kendinden imzalı sertifikalarla çalışır mı?
Güvenilir sertifikayla HTTPS üzerinde çalışır. iOS kendinden imzalı sertifikaları doğrudan reddeder, bu yüzden uzaktan erişim için sunucuyu gerçek bir alan adı ve ücretsiz sertifika arkasına koyun.
Ev OPDS sunucuma evin dışından ulaşabilir miyim?
Yalnızca evinizin içinde çözümlenen 192.168.x.x adresiyle hayır. Uzaktan ulaşmak için ya VPN ile eve bağlanın ya da sunucuyu alan adı ve güvenilir sertifikalı ters vekil üzerinden yayınlayın.
OPDS telefonda kaç kitap kaldırabilir?
Çok büyük kitaplıklar sorun değil, çünkü OPDS önce tarama üzerine kuruludur: uygulama kitabı yalnızca siz dokunduğunuzda indirir, katalogun tamamını değil.