Jak skonfigurować serwer OPDS na iPhonie i iPadzie (poradnik 2026)

Krótka odpowiedź: aby skonfigurować serwer OPDS na iPhonie lub iPadzie, zainstaluj czytnik obsługujący OPDS, otwórz w nim sekcję Biblioteka lub Katalogi, dodaj nowy katalog, wklej pełny adres OPDS serwera (na przykład http://192.168.1.10:8080/opds dla Calibre Content Server, a nie sam adres IP), nadaj mu nazwę i podaj login oraz hasło tylko wtedy, gdy serwer o nie prosi. Zapisz, a aplikacja wyświetli wszystkie książki z tego serwera, gotowe do pobrania i czytania offline. Najczęstszy błąd to pominięcie ścieżki /opds albo numeru portu.

OPDS brzmi jak coś, do czego trzeba mieć doświadczenie z serwerami domowymi, a okazuje się zajmować około dwóch minut, gdy już znasz dwie rzeczy, na których wszyscy się potykają: dokładną ścieżkę, jakiej oczekuje serwer, oraz sposób, w jaki każdy serwer obsługuje logowanie.

Słowo ode mnie: nazywam się Petr Jahoda i tworzę justRead. Każde z opisanych tu połączeń OPDS ustawiłem osobiście, na prawdziwych serwerach i prawdziwym iPhonie, zamiast parafrazować specyfikację. Pułapki poniżej to te, na które sam trafiłem.

Czym właściwie jest OPDS

OPDS, czyli Open Publication Distribution System, to prosty standard pozwalający aplikacji do czytania przeglądać i pobierać książki z serwera. Najprościej to sobie wyobrazić tak: OPDS to RSS dla książek. Czytnik RSS wskazuje jeden adres kanału i pokazuje każdy nowy artykuł z tego źródła. Czytnik OPDS wskazuje jeden adres katalogu i pokazuje każdą książkę, którą serwer udostępnia, z okładkami, autorami, opisami i linkami do pobrania. Stukasz w książkę, pobiera się na urządzenie i czytasz ją offline.

Ponieważ jest to otwarty standard, a nie aplikacja jednej firmy, ten sam czytnik może łączyć się z bardzo różnymi źródłami w ten sam sposób: publiczna biblioteka jak Project Gutenberg, domowy serwer multimediów i twoja własna kolekcja w Calibre mówią tym samym językiem. Nic nie jest przywiązane do sklepu ani do konta.

Spotkasz dwie wersje:

• OPDS 1.2 to wersja, którą mówi dziś praktycznie wszystko. Opiera się na Atomie, formacie kanałów XML, więc katalog to w istocie dokument XML z listą książek i podsekcji. Gdy ktoś podaje ci w 2026 roku adres OPDS, prawie na pewno jest to 1.2.
• OPDS 2.0 to nowszy zapis tego samego pomysłu oparty na JSON-ie. Jest czystszy dla programistów i zaczyna się pojawiać (Komga udostępnia obie wersje), ale przyjmuje się dopiero powoli. Nie musisz wybierać. Dobry czytnik sam ustali wersję, a w praktyce będziesz używać 1.2.

Czego potrzebujesz na start

Do połączenia z dowolnym katalogiem OPDS wystarczą dwie informacje, a często tylko pierwsza:

1. Adres katalogu. To punkt końcowy OPDS, zwykle zakończony /opds albo podobną ścieżką. W przypadku katalogu publicznego projekt publikuje go na swojej stronie. W przypadku własnego serwera jest to adres serwera plus ścieżka OPDS używana przez to konkretne oprogramowanie (i właśnie tu najczęściej wszystko się sypie, jest o tym osobny rozdział niżej).
2. Login i hasło, ale tylko jeśli serwer tego wymaga. Katalogi publiczne są zwykle otwarte. Serwery prywatne, jak twoje Calibre czy Komga, mogą wymagać logowania. Jeśli tak, podajesz je raz, a aplikacja je zapamiętuje.

To cała lista. Żadnych kont u osób trzecich, żadnej usługi synchronizacji pośrodku, żadnego ręcznego przenoszenia plików kablem.

Krok 1: zainstaluj czytnik OPDS

iOS i iPadOS same nie przeglądają katalogów OPDS, więc potrzebujesz aplikacji, która obsługuje ten standard. justRead to czytnik EPUB i PDF na iPhone'a i iPada z wbudowanym OPDS: ma Project Gutenberg i Internet Archive jako katalogi wbudowane, pozwala dodawać własne serwery i obsługuje wyszukiwanie po stronie serwera, stronicowanie oraz przeglądanie według kategorii, dzięki czemu nawet ogromne katalogi pozostają wygodne. Niezależnie od wybranej aplikacji szukasz sekcji OPDS lub Katalogi w jej bibliotece albo ustawieniach. Jeśli chcesz najpierw poznać pełny zakres możliwości, przegląd czytnika OPDS opisuje, co aplikacja obsługuje.

Jedno uczciwe ograniczenie na start: justRead czyta pliki EPUB i PDF. Katalogi OPDS oferujące wyłącznie inne formaty nadal da się przeglądać, ale pobierzesz z nich tylko wydania EPUB i PDF.

Krok 2: dodaj pierwszy katalog, krok po kroku

Najszybciej zobaczysz OPDS w działaniu na darmowym katalogu publicznym, a w justRead najszybszy wariant nie wymaga w ogóle pisania.

Bez pisania (wbudowane). justRead ma Project Gutenberg i Internet Archive jako katalogi wbudowane. Otwórz Bibliotekę, przejdź do sekcji katalogów i już tam są. Stuknij Project Gutenberg i od razu przeglądasz ponad 70 000 książek z domeny publicznej, bez wklejania adresu. To najkrótsza możliwa droga do pobranej książki. Zrób tak raz, żeby potwierdzić, że cały mechanizm działa, zanim dodasz cokolwiek własnego.

Ręcznie (dowolny katalog). Aby dodać katalog przez adres, w większości czytników, a w justRead konkretnie, postępuje się tak:

1. Otwórz Bibliotekę.
2. Wybierz dodaj katalog OPDS.
3. Wklej adres katalogu w pole adresu. Wklej, nie przepisuj, żeby nie wprowadzić literówki w ścieżce ani w porcie.
4. Nazwij go tak, żebyś później go rozpoznał, na przykład „Domowe Calibre" albo „Gutenberg".
5. Jeśli serwer wymaga logowania, podaj login i hasło. Jeśli nie, zostaw puste.
6. Zapisz.

Katalog pojawi się na twojej liście. Stuknij, aby przeglądać. Większe katalogi otwierają się w sekcje, przez które można schodzić w głąb, więc możesz przeglądać według kategorii zamiast przewijać jedną gigantyczną listę. Wyszukiwanie po stronie serwera pozwala odpytać serwer o tytuł lub autora bez pobierania wszystkiego, a stronicowanie ładuje długie wyniki w rozsądnych porcjach.

To sześciokrokowe działanie to cała umiejętność. Reszta tego poradnika dotyczy jednej rzeczy: poprawnej wartości w kroku 3.

Pułapka ścieżki /opds, dokładnie

Jeśli masz zapamiętać jedno, zapamiętaj to: adres OPDS prawie nigdy nie jest samym adresem serwera. Goły adres IP albo nazwa hosta wskazuje stronę serwera dla ludzi, a nie kanał OPDS dla maszyn. Wskaż czytnikowi http://192.168.1.10:8080, a dostaniesz błąd albo pusty katalog; wskaż http://192.168.1.10:8080/opds, a pojawi się twoja biblioteka. Szkodę robią dwa szczegóły, ścieżka i port, a każdy serwer traktuje je inaczej.

• Calibre Content Server domyślnie udostępnia OPDS pod /opds na porcie 8080: http://<ip>:8080/opds. Pominiesz :8080, a połączenie umiera, zanim się zacznie. Pominiesz /opds, a trafisz w czytnik webowy zamiast w kanał.
• Komga udostępnia kanał OPDS 1.2 pod głębszą ścieżką: http://<host>:25600/opds/v1.2/catalog. Port to domyślnie 25600, a katalog leży kilka segmentów w głąb.
• Kavita robi to jeszcze inaczej: zamiast loginu i hasła wpisuje klucz API wprost w adres: http://<host>:5000/api/opds/<twoj-klucz-api>. Nie ma osobnego hasła, bo kluczem jest właśnie ten fragment adresu. Skopiuj cały gotowy adres z ustawień Kavity i zostaw pola logowania puste.

Zasada brzmi: dobrze ustaw port, dobrze ustaw ścieżkę i sprawdź, czy dane logowania mieszkają w adresie, czy w polach. Gdy połączenie zawodzi, dziewięć razy na dziesięć chodzi o jedno z tych trzech.

Krok 3: podłącz Calibre Content Server

Najpopularniejszy katalog prywatny to twoja własna biblioteka Calibre. Calibre, darmowy menedżer e-booków na komputer, potrafi udostępnić całą kolekcję przez OPDS w kilku kliknięciach:

1. Na komputerze otwórz Calibre i kliknij Połącz/udostępnij na pasku narzędzi.
2. Wybierz Uruchom serwer treści.
3. Znajdź lokalny adres IP komputera (coś w rodzaju 192.168.1.10). Punkt końcowy OPDS to wtedy http://192.168.1.10:8080/opds, gdzie 8080 to domyślny port Calibre.

Na iPhonie lub iPadzie dodaj ten adres jako nowy katalog OPDS według sześciu kroków powyżej. Dwie rzeczy ułatwiają to w justRead: potrafi automatycznie wykryć Calibre Content Server w tej samej sieci Wi-Fi, więc być może w ogóle nie będziesz musiał szukać i wpisywać adresu IP, oraz obsługuje uwierzytelnianie HTTP Digest, czyli schemat logowania, którego Calibre używa po włączeniu opcji wymagania nazwy użytkownika i hasła.

Kilka realiów serwera treści warto znać: Calibre musi pozostać otwarte i uruchomione na komputerze, oba urządzenia muszą być w tej samej sieci, chyba że skonfigurujesz dostęp zdalny, a jeśli adres IP komputera się zmieni (a domowe routery robią to same z siebie), zmieni się razem z nim adres katalogu. Zarezerwowanie stałego IP w routerze albo użycie nazwy .local komputera pozwala uniknąć problemu „wczoraj działało, dziś nie".

Jeśli chcesz porządnie ustawić stronę serwerową, poradnik o Calibre Content Server zajmuje się wyłącznie tym. A jeśli chcesz, żeby postęp czytania i oceny wracały do komputera, synchronizacja biblioteki Calibre dokłada do tego synchronizację dwukierunkową.

Wzorce adresów dla serwerów własnych

Uwagi do tabeli: pokazane porty to typowe wartości domyślne każdego projektu, ale każdą z nich można zmienić przy instalacji, więc przy problemach sprawdź swoją w ustawieniach serwera. Domyślny port calibre-web to często 8083, ale zależy to całkowicie od sposobu wdrożenia. COPS zmieniał punkt wejścia między wersjami, więc jeśli feed.php nie działa, sprawdź dokładny link OPDS w panelu administracyjnym zamiast zgadywać.

Startowa lista publicznych katalogów OPDS

Nie potrzebujesz własnego serwera, żeby używać OPDS.

• Project Gutenberg (zweryfikowany, bez logowania): https://www.gutenberg.org/ebooks.opds/. Ponad 70 000 książek z domeny publicznej, w pełni otwarte i legalne do pobrania. W justRead jest wbudowany.
• Wolne Lektury (zweryfikowany 2026-08-31, bez logowania): https://wolnelektury.pl/opds/. To najważniejsza pozycja na tej liście dla polskiego czytelnika, bo jest to prawdziwy, żywy katalog OPDS po polsku, z lekturami i klasyką w domenie publicznej. Wiele języków nie ma odpowiednika i musi się zadowolić filtrem językowym Gutenberga; polski ma własne, porządne źródło.
• Unglue.it (zweryfikowany, bez logowania): https://unglue.it/api/opds/. Katalog książek na licencjach Creative Commons.
• Standard Ebooks (prawdziwy kanał, ale zamknięty): projekt publikuje kanał OPDS pod https://standardebooks.org/feeds/opds, ale jest on zarezerwowany dla wspierających i zwraca 401 dla pozostałych.

Szerszy, na bieżąco weryfikowany przegląd, łącznie z martwymi kanałami, których należy unikać, znajdziesz w najlepszych darmowych katalogach OPDS na 2026. Tamten wpis odpowiada na pytanie „gdzie wskazać", ten na pytanie „jak wskazać".

HTTP, HTTPS, certyfikaty i logowanie

Domowe serwery lokalne działają zwykle po zwykłym HTTP w twojej własnej sieci, i to jest w porządku, bo ruch nigdy nie opuszcza domu. Dla Calibre Content Server w twoim Wi-Fi wpiszesz http://, nie https://, i tak ma być.

W chwili, gdy chcesz sięgnąć po katalog spoza domu, HTTPS zaczyna mieć znaczenie, a iOS jest pod tym względem surowy:

• iOS odrzuca niezaufane certyfikaty. Jeśli twój serwer używa certyfikatu z własnym podpisem, iOS odmówi połączenia, zamiast pokazać w czytniku przycisk „kontynuuj mimo to". Pewne rozwiązanie to prawdziwy certyfikat: postaw serwer za nazwą domeny i wystaw darmowy certyfikat (na przykład przez Let's Encrypt), zwykle za pośrednictwem reverse proxy.
• Uwierzytelnianie Basic i Digest. Basic wysyła login i hasło przy każdym żądaniu (bezpieczne po HTTPS, odsłonięte po zwykłym HTTP), a Digest to schemat wyzwanie-odpowiedź, który nigdy nie wysyła surowego hasła. Calibre Content Server używa Digest, a justRead go obsługuje. Jeden błędny znak w loginie czyta się dla aplikacji jak „odmowa dostępu", a nie „złe hasło", dlatego literówki udają awarie połączenia.

Nic się nie pojawia? Pełna lista kontrolna

1. Zła ścieżka. Użyłeś samego adresu zamiast pełnej ścieżki OPDS. Dodaj /opds (Calibre), /opds/v1.2/catalog (Komga) albo to, co dokumentuje twój serwer. To przyczyna numer jeden.
2. Brak portu. Pominąłeś :8080 (Calibre), :25600 (Komga), :5000 (Kavita) albo :8083 (calibre-web).
3. Ta sama sieć? Telefon i serwer muszą być w tym samym Wi-Fi. Telefony chętnie wracają do sieci komórkowej; jeśli jesteś na 5G, a serwer ma adres 192.168.x.x, jest po prostu nieosiągalny.
4. Adres lokalny z zewnątrz. Adres 192.168.x.x albo 10.x.x.x działa tylko w domu. Zdalnie potrzebujesz VPN-a albo domeny i reverse proxy.
5. Zapora blokuje port. Najczęstsza awaria przy Calibre: serwer działa, adres jest poprawny, ale zapora komputera po cichu blokuje połączenia przychodzące na 8080.
6. Serwer wcale nie działa. Wczytaj ten sam adres w przeglądarce na komputerze w tej samej sieci: jeśli przeglądarka też nie daje rady, problem leży po stronie serwera, nie aplikacji.
7. Literówka w logowaniu. Uważaj na automatyczną wielką literę i na spację doklejoną przy wklejaniu.
8. Odrzucony certyfikat HTTPS. Serwer zdalny z certyfikatem własnym jest odrzucany przez iOS.
9. Adres się zmienił. Router przydzielił komputerowi nowy adres IP. Zarezerwuj stałe IP albo używaj nazwy .local.

Najszybsza pojedyncza diagnostyka to punkt 6: otwórz dokładny adres OPDS w Safari albo przeglądarce na komputerze w tej samej sieci. Jeśli widzisz surowy XML, serwer i adres są dobre, a problem tkwi w aplikacji lub danych logowania.

Gdzie OPDS pasuje do twojego czytania

OPDS zamienia iPhone'a lub iPada w nakładkę na dowolną bibliotekę, publiczną czy prywatną, bez ręcznego przenoszenia plików. Gdy katalog jest już skonfigurowany, dodanie nowej książki to dwa stuknięcia.

• Dopiero zaczynasz z e-bookami na iOS? Zacznij od jak czytać EPUB na iPhonie i iPadzie.
• Chcesz pełny obraz możliwości czytnika OPDS? Zobacz przegląd czytnika OPDS.
• Wybierasz katalogi publiczne? Skorzystaj z najlepszych darmowych katalogów OPDS na 2026.

justRead ma 14 dni bezpłatnego okresu próbnego, więc możesz skonfigurować pierwszy katalog i sprawdzić, że wszystko działa, zanim zdecydujesz. Pobierz justRead z App Store i dodaj dziś swój pierwszy katalog OPDS.

Najczęstsze pytania

Czym jest katalog OPDS?
To kanał pozwalający aplikacji do czytania przeglądać i pobierać książki z serwera, podobnie jak czytnik RSS subskrybuje kanał wiadomości. Wskazujesz aplikacji adres katalogu, a ona wyświetla wszystkie książki, jakie serwer oferuje.

Jaki jest poprawny adres OPDS dla Calibre Content Server?
To lokalne IP komputera plus port Calibre plus ścieżka /opds: http://192.168.1.10:8080/opds. Dwa błędy, które to psują, to samo IP bez /opds oraz zapomniany port :8080.

Czy potrzebuję Calibre, żeby używać OPDS na iPhonie?
Nie. Możesz łączyć się z katalogami publicznymi bez własnego serwera, a w justRead Gutenberg i Internet Archive są wbudowane. Dla polskiego czytelnika szczególnie warto dodać Wolne Lektury.

Dlaczego mój serwer OPDS nie łączy się na iOS?
Zwykle w tej kolejności: zła ścieżka (brak /opds), brak numeru portu, telefon i serwer w różnych sieciach, zapora blokująca port, literówka w logowaniu albo certyfikat HTTPS z własnym podpisem, którego iOS nie ufa.

Dlaczego Kavita nie pyta o login i hasło?
Kavita umieszcza klucz API bezpośrednio w adresie OPDS, więc kluczem są dane uwierzytelniające. Skopiuj pełny adres z ustawień Kavity i zostaw pola logowania puste.

Jaka jest różnica między OPDS 1.2 a 2.0?
OPDS 1.2 to starsza wersja oparta na XML i Atomie, i to nią mówi dziś prawie każdy serwer i czytnik. OPDS 2.0 to nowsza wersja oparta na JSON-ie, wdrażana dopiero powoli.

Czy OPDS działa po HTTPS z certyfikatem własnym na iPhonie?
Działa po HTTPS z certyfikatem zaufanym. iOS odrzuca certyfikaty z własnym podpisem, więc do dostępu zdalnego postaw serwer za prawdziwą domeną i darmowym certyfikatem. Zwykłe HTTP jest w porządku w twoim własnym Wi-Fi.

Ile książek OPDS wytrzyma na telefonie?
Bardzo duże biblioteki są w porządku, bo OPDS działa w trybie przeglądania: aplikacja pobiera książkę dopiero po stuknięciu, a nie cały katalog.

Gdzie wskazać, gdy już działa: darmowe katalogi OPDS, które w tym miesiącu nadal wydawały książki, albo prostsze miejsca na darmowe EPUB-y, jeśli serwer to więcej zachodu, niż chciałeś.