Calibreov server sadržaja

Calibre Content server vam omogućava da pristupite svojim calibre bibliotekama i čitate knjige direktno u pregledaču na vašem omiljenom mobilnom telefonu ili tabletu. Zbog toga ne morate da instalirate nikakve posebne aplikacije za čitanje/upravljanje knjigama na telefonu. Samo koristite pregledač. Server preuzima i čuva knjigu koju čitate u oflajn kešu tako da možete da je čitate čak i kada nema internet veze.

Da biste pokrenuli server, kliknite na dugme Connect/share i izaberite Start Content server. Možda ćete dobiti poruku od zaštitnog zida vašeg računara ili antivirusnog programa sa pitanjem da li je u redu dozvoliti pristup za calibre.exe. Kliknite na dugme Allow ili OK. Zatim otvorite pregledač (po mogućstvu Chrome ili Firefox) na vašem računaru i ukucajte sledeću adresu:

http://127.0.0.1:8080

Otvoriće se stranica s vašim calibre bibliotekama. Izaberite neku od njih i pregledajte knjige u njoj. Kliknite na knjigu i prikazaće vam se svi metapodaci o knjizi, zajedno sa dugmadima za Read i Download knjige. Kliknite na dugme Read da biste počeli da čitate knjigu.

Белешка

Adresa korišćena iznad http://127.0.0.1:8080 će raditi samo na računaru na kojem je pokrenut calibre. Da biste pristupili serveru sa drugih računara/telefona/tableta/itd. moraćete da uradite malo više posla, kao što je opisano u sledećem odeljku.

Pristupanje Content serveru sa drugih uređaja

Obično će vam trebati dve vrste pristupa s drugih uređaja. Prva, jednostavnija vrsta je iz vaše kućne mreže. Ako pokrećete calibre na računaru u vašoj kućnoj mreži i takođe ste povezali vaše druge uređaje na istu kućnu mrežu, onda bi trebalo da lako možete da pristupite serveru na tim uređajima.

Pristupanje serveru sa uređaja u vašoj kućnoj mreži

Nakon pokretanja servera u calibre-u kao što je gore opisano, ponovo kliknite na dugme Connect/share. Umesto akcije Start Content server, trebalo bi da vidite akciju Stop Content server. Desno od ove akcije biće navedena IP adresa i broj porta. Oni izgledaju kao niz brojeva razdvojenih tačkama. Na primer:

Stop Content server [192.168.1.5, port 8080]

Ovi brojevi vam govore koju adresu da koristite za povezivanje sa serverom na vašim uređajima. Prateći gornji primer, adresa postaje:

http://192.168.1.5:8080

Prvi deo adrese je uvek http://, sledeći deo je IP adresa, što su brojevi pre zareza, i na kraju imamo broj porta koji se mora dodati IP adresi sa dvotačkom (:). Ako imate sreće, to bi trebalo da bude sve što vam treba i gledaćete calibre biblioteke na vašem uređaju. Ako ne, čitajte dalje.

Rešavanje problema sa vezom na kućnoj mreži

Ako ne možete da pristupite serveru sa vašeg uređaja, pokušajte sledeće korake:

  1. Proverite da li server radi otvaranjem adrese http://127.0.0.1:8080 u pregledaču koji radi na istom računaru kao i server.

  2. Proverite da li vaš zaštitni zid/antivirus dozvoljava veze sa vašim računarom na portu 8080 i sa programom calibre. Najlakši način da eliminišete zaštitni zid/antivirus kao izvor problema je da ih privremeno isključite i zatim pokušate da se povežete. Trebalo bi prvo da se isključite sa interneta, pre nego što isključite zaštitni zid, kako biste zaštitili svoj računar.

  3. Proverite da li su vaš uređaj i računar na istoj mreži. To znači da bi oba trebalo da budu povezana na isti bežični ruter. Konkretno, nijedan ne bi trebalo da koristi mobilnu ili direktnu WiFi vezu koju obezbeđuje ISP.

  4. Ako imate nestandardno mrežno podešavanje, može se desiti da je IP adresa prikazana u meniju Connect/share netačna. U tom slučaju ćete morati sami da otkrijete koja je ispravna IP adresa. Nažalost, s obzirom na beskonačnu raznolikost mogućih mrežnih konfiguracija, nije moguće dati vam uputstvo kako to da uradite.

  5. Ako ste postavili korisničko ime i lozinku, prvo pokušajte bez toga da vidite da li to izaziva probleme. Neki e-ink uređaji imaju pregledače koji ne podržavaju autentifikaciju. Ponekad to možete zaobići uključivanjem korisničkog imena i lozinke u URL, na primer: http://username:password@192.168.1.2:8080.

  6. Ako vam zatreba pomoć, možete je potražiti na calibre user forums.

Pristupanje serveru sa bilo kog mesta na internetu

Упозорење

Pre nego što ovo uradite, trebalo bi da uključite zaštitu korisničkim imenom/lozinkom na serveru, inače će svako na svetu moći da pristupi vašim knjigama. Idite na Preferences → Sharing → Sharing over the net i omogućite opciju Require username and password to access the content server.

Iako se određeni detalji o postavljanju pristupa internetu razlikuju u zavisnosti od mrežne konfiguracije i tipa računara koji koristite, osnovna šema je sledeća.

  1. Saznajte spoljnu IP adresu računara na kojem ćete pokrenuti server. To možete uraditi posetom sajtu What is my IP address u pregledaču koji radi na tom računaru.

  2. Ako je računar iza rutera, omogućite prosleđivanje portova na ruteru kako biste prosledili port 8080 (ili bilo koji port koji izaberete za pokretanje calibre Content servera) na računar.

  3. Proverite da li je calibre server dozvoljen kroz sve zaštitne zidove/antivirusne programe na vašem računaru.

  4. Sada bi trebalo da možete da pristupite serveru na bilo kom uređaju povezanom na internet koristeći IP adresu koju ste pronašli u prvom koraku. Na primer, ako je IP adresa koju ste pronašli bila 123.123.123.123, a port koji koristite za calibre server je 8080, adresa koju treba koristiti na vašem uređaju postaje: http://123.123.123.123:8080.

  5. Opciono, koristite uslugu kao što je no-ip da biste postavili adresu koja se lako pamti umesto IP adrese koju ste pronašli u prvom koraku.

Белешка

Za maksimalnu bezbednost, takođe bi trebalo da omogućite HTTPS na Content serveru. To možete učiniti direktno na serveru tako što ćete navesti putanju do HTTPS sertifikata koji će se koristiti u naprednim opcijama konfiguracije za server, ili možete postaviti obrnuti proksi kao što je opisano u nastavku, da biste koristili postojeću HTTPS postavku.

Interfejs servera

Interfejs servera je pojednostavljena verzija glavnog calibre interfejsa, optimizovana za upotrebu sa ekranima osetljivim na dodir. Početni ekran vam prikazuje knjige koje trenutno čitate, kao i omogućava vam da izaberete calibre biblioteku koju želite da pregledate. Server u calibre-u vam daje pristup svim vašim bibliotekama, a ne samo jednoj, kao ranije.

Lista knjiga

Lista knjiga na serveru je jednostavna mreža korica. Dodirnite koricu da biste videli detaljne metapodatke za knjigu ili da biste pročitali knjigu. Ako više volite detaljniju listu, možete promeniti podrazumevani prikaz klikom na tri vertikalne tačke u gornjem desnom uglu.

Sortiranje i pretraživanje liste knjiga bi trebalo da bude poznato korisnicima calibre-a. Može im se pristupiti klikom na njihove ikone u gornjem desnom uglu. Oba rade potpuno isto kao u glavnom programu calibre. Stranica za pretragu vam čak omogućava da konstruišete upite za pretragu klikom na autore/oznake/itd., baš kao što možete koristeći Pregledač oznaka u glavnom programu.

Veoma voljena funkcija glavnog programa, Virtual libraries je takođe prisutna u interfejsu servera. Kliknite na tri vertikalne tačke u gornjem desnom uglu da izaberete Virtuelnu biblioteku.

Pregledač knjiga

Možete čitati bilo koju knjigu u vašoj calibre biblioteci jednostavnim dodirom na nju, a zatim dodirom na dugme Read. Pregledač knjiga je veoma jednostavan za korišćenje. Možete i dodirnuti i prevući da biste okrenuli stranice. Prevlačenje gore/dole preskače između poglavlja. Dodirivanjem gornje četvrtine ekrana dobijate detaljne kontrole i podešavanja pregledača.

Ako ostavite Content server da radi, možete čak otvoriti istu knjigu na više uređaja i on će zapamtiti vašu poslednju pročitanu poziciju. Ako to ne učini, možete forsirati sinhronizaciju dodirom u gornjoj četvrtini i biranjem Sync.

Searching book contents in OPDS applications

When full text indexing is enabled for a library, its OPDS catalog offers a catalog entry titled Search book contents. Open this entry and use the application's search control to find books by words and phrases inside them, using calibre's existing full text index. Each feed has a single search link, so clients do not have to choose between multiple search links. Results contain the normal book information and download links. A book is listed once even if more than one of its formats matches. Only books available to the current user are searched.

The original search continues to search book metadata. Content search uses the same SQLite full text query syntax as calibre's full text search window. It searches the text indexed so far; books still waiting to be indexed will not appear yet. The content search entry is absent when indexing is disabled. Both OPDS 1 and OPDS 2 catalogs support content search, through the normal search URL with full_text=y added to its query parameters.

Čitanje stripova u OPDS aplikacijama

Aplikacije koje podržavaju OPDS 2.0 i format Readium Divina mogu čitati CBZ stripove stranicu po stranicu, bez preuzimanja cele arhive. Povežite aplikaciju sa katalogom /opds na serveru. OPDS 2.0 aplikacije zahtevaju JSON katalog pomoću zaglavlja Accept: application/opds+json.

Stavke stripova sadrže vezu ka Divina manifestu. Server prikazuje listu stranica tek kada aplikacija otvori taj manifest, koristeći isti redosled stranica kao pri pretvaranju stripova u calibre-u. Za svaku stranicu ponuđeni su njen izvorni format slike, uključujući AVIF i JPEG XL, i alternativni formati koje server može da napravi. GIF stranice, koje mogu biti animirane, nude se samo u izvornom formatu. Aplikacija iz ponuđenih veza bira format slike koji podržava. JPEG se nudi kao podrazumevani format za AVIF i JPEG XL stranice kada je pretvaranje dostupno.

Za mange, datoteka ComicInfo.xml sa svojstvom Manga postavljenim na YesAndRightToLeft govori aplikaciji da koristi smer čitanja zdesna nalevo. Datoteka se može nalaziti u korenu arhive ili u fascikli koja sadrži slike stranica. Slike stranica ostaju u izvornom redosledu. Smer čitanja navodi se samo u manifestu stripa, a ne u OPDS izvorima, jer je za njegovo utvrđivanje potrebno otvoriti arhivu.

Uobičajena ograničenja u vezi sa korisničkim imenom, lozinkom i bibliotekama važe i za manifeste i slike stranica. Preuzimanje celih arhiva i dalje je dostupno. Ova funkcija podržava CBZ arhive; CBR i CB7 stripovi i dalje se mogu preuzeti kao cele datoteke.

Podrška za pregledače

Novi calibre server u velikoj meri koristi napredne HTML 5 i CSS 3 funkcije. Kao takav, zahteva ažuriran pregledač za korišćenje. Testiran je na Android Chrome-u i iOS Safari-ju, kao i na Chrome-u i Firefox-u na računaru.

Server pažljivo koristi funkcionalnost koja je ili već standardizovana ili je na putu standardizacije. Kao takav, ako trenutno ne radi sa vašim omiljenim pregledačem, verovatno će raditi kada taj pregledač uhvati korak.

Ako koristite posebno star ili ograničen pregledač ili ne želite da pokrećete JavaScript, možete koristiti mobile prikaz, jednostavnim dodavanjem /mobile na adresu servera.

Белешка

Na iOS-u, Apple dozvoljava samo jedan endžin pregledača, tako da su Firefox, Chrome i Safari zapravo isti pregledač ispod haube. Novi interfejs servera zahteva iOS 10.3.2 ili noviji. Na Androidu, server je testiran sa Chrome verzijom 58 i novijim.

Omogućavanje oflajn podrške

Server ima punu podršku za oflajn režim, možete otvoriti knjigu i kada se učita, nastaviti da je čitate oflajn. Međutim, tipični pregledači zahtevaju upotrebu HTTPS konekcija da bi omogućili oflajn režim (service workers). Zato podesite HTTPS podršku kao što je opisano iznad. Pomerite se do dna početne stranice i videćete poruku o statusu oflajn režima.

Alternativno, možete otvoriti knjigu i ostaviti karticu pregledača otvorenom. Sve dok kartica ostaje otvorena, možete nastaviti da čitate knjigu, čak i kada ste oflajn.

Upravljanje korisničkim nalozima samo iz komandne linije

Program calibre ima odeljak u Preferences koja vam omogućava da upravljate korisničkim nalozima za server. Međutim, ako želite da pokrenete samostalni server i ne možete da pokrenete glavni calibre program na istom računaru/korisničkom nalogu, možete takođe upravljati korisnicima koristeći samo komandnu liniju.

Možete upravljati korisničkim nalozima koristeći opciju --manage-users za samostalni program calibre-server. Pretpostavimo da želite da sačuvate bazu korisnika u fascikli /srv/calibre, onda je kreirate pokretanjem:

calibre-server --userdb /srv/calibre/users.sqlite --manage-users

Samo pratite uputstva da kreirate korisničke naloge, postavite njihove dozvole, itd. Kada završite, možete pokrenuti server kao:

calibre-server --userdb /srv/calibre/users.sqlite --enable-auth

Koristiće korisničke naloge koje ste kreirali u prethodnom koraku.

Sinhronizacija napretka čitanja sa KOReader-om

Server sadržaja može služiti kao server za sinhronizaciju napretka čitanja za pregledač e-knjiga KOReader, tako da uređaji na kojima se koristi KOReader mogu međusobno da sinhronizuju vaš položaj čitanja u knjigama. U KOReader-u otvorite Alatke → Sinhronizacija napretka → Prilagođeni server za sinhronizaciju i unesite adresu servera sadržaja, a zatim /kosync, na primer:

http://192.168.1.2:8080/kosync

Ako koristite URL prefiks, kao što je opisano u odeljku Korišćenje URL prefiksa, navedite ga ispred /kosync. Zatim koristite Prijava sa korisničkim imenom i lozinkom korisničkog naloga na serveru sadržaja. Nalozi se ne mogu praviti iz KOReader-a; njima upravlja calibre, kao što je opisano iznad. Korisnici koji imaju samo pravo čitanja ne mogu sinhronizovati položaje čitanja. Ako korisnički nalozi nisu omogućeni na serveru, može se koristiti bilo koje korisničko ime i lozinka, ali se položaji čitanja mogu sinhronizovati samo sa uređaja kojima je dozvoljeno da prave izmene bez autentifikacije; pogledajte opcije Dozvoli lokalnim vezama bez autentifikacije da prave izmene i Dozvoli vezama sa određenih IP adresa da prave izmene bez autentifikacije. Položaji čitanja sinhronizovani dok korisnički nalozi nisu omogućeni čuvaju se odvojeno od položaja korisničkih naloga. Položaji čitanja svakog korisnika čuvaju se zasebno u bazi korisnika servera.

By default, KOReader identifies books by a checksum of the book file. The Content server can change the metadata embedded in books when they are downloaded, so copies of a book downloaded at different times can have different checksums. Once KOReader has synced with the server, it remembers the checksums of downloaded books and of the library files they were created from, so that all copies of the same format of a book share one reading position. Different formats of a book have separate reading positions, as positions in one format cannot be used in another. Copies downloaded before KOReader first synced with the server, or obtained other than by downloading them from the server, are not recognized. If reading positions do not sync for such copies, set Document matching method in the KOReader progress sync settings to Filename on all devices and keep the file names of books the same.

Integracija calibre Content servera u druge servere

Ovde ćemo vam pokazati kako da integrišete calibre Content server u drugi server. Najčešći razlog za to je korišćenje SSL-a ili omogućavanje pristupa calibre biblioteci preko većeg sajta. Osnovna tehnika je pokretanje calibre servera i postavljanje obrnutog proksija (reverse proxy) do njega sa glavnog servera.

Obrnuti proksi je kada vaš glavni server prihvata dolazne zahteve i prosleđuje ih calibre serveru. Zatim čita odgovor sa calibre servera i prosleđuje ga klijentu. To znači da možete jednostavno pokrenuti calibre server kao i obično bez pokušaja da ga tesno povežete sa vašim glavnim serverom.

Korišćenje punog virtuelnog hosta

Najjednostavnija konfiguracija je posvetiti pun virtuelni host calibre serveru. U ovom slučaju, pokrenite calibre server kao:

calibre-server

Sada postavite virtuelni host na vašem glavnom serveru, na primer, za nginx:

http {
    client_max_body_size 64M;  # needed to upload large books
}

server {
    listen [::]:80;
    server_name myserver.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
    }
}

Ili, za Apache:

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so

<VirtualHost *:80>
    ServerName myserver.example.com
    AllowEncodedSlashes On
    ProxyPreserveHost On
    ProxyPass "/"  "http://localhost:8080/"
</VirtualHost>

Korišćenje URL prefiksa

Ako ne želite da posvetite pun virtuelni host za calibre, možete ga podesiti da koristi URL prefiks. Pokrenite calibre server kao:

calibre-server --url-prefix /calibre --port 8080

Ključni parametar ovde je --url-prefix /calibre. Ovo uzrokuje da Content server servira sve URL-ove sa prefiksom /calibre. Da biste ovo videli na delu, posetite http://localhost:8080/calibre u vašem pregledaču. Trebalo bi da vidite normalan veb sajt Content servera, ali sada će raditi pod /calibre.

Sa nginx-om, potrebna konfiguracija je:

http {
    client_max_body_size 64M;  # needed to upload large books
}

proxy_set_header X-Forwarded-For $remote_addr;
location /calibre/ {
    proxy_buffering off;
    proxy_pass http://127.0.0.1:8080$request_uri;
}
location /calibre {
    # we need a trailing slash for the Application Cache to work
    rewrite /calibre /calibre/ permanent;
}

Za Apache, prvo omogućite proxy module u Apache-u, dodavanjem sledećeg u httpd.conf:

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so

Tačna tehnika za omogućavanje proxy modula će varirati u zavisnosti od vaše Apache instalacije. Kada omogućite proxy module, dodajte sledeća pravila u httpd.conf (ili ako koristite virtuelne hostove u conf fajl za dotični virtuelni host):

AllowEncodedSlashes On
RewriteEngine on
RewriteRule ^/calibre/(.*) http://127.0.0.1:8080/calibre/$1 [proxy]
RedirectMatch permanent ^/calibre$ /calibre/

To je sve, sada ćete moći da pristupite calibre Content serveru pod /calibre URL-om na vašem glavnom serveru. Gore navedena pravila prosleđuju sve zahteve pod /calibre calibre serveru koji radi na portu 8080 i zahvaljujući opciji --url-prefix iznad, calibre server ih transparentno obrađuje.

Белешка

Kada koristite obrnuti proksi, trebalo bi da kažete calibre Content serveru da sluša samo na localhost-u, koristeći --listen-on 127.0.0.1. Na taj način, server će slušati samo konekcije koje dolaze sa istog računara, tj. sa obrnutog proksija.

Белешка

Ako ste podesili SSL za vaš glavni server, trebalo bi da kažete calibre serveru da koristi osnovnu autentifikaciju umesto digest autentifikacije, jer je brža. Da biste to uradili, prosledite opciju --auth-mode=basic komandi calibre-server.

Pravljenje servisa za calibre server na savremenom Linux sistemu

Možete lako kreirati servis za pokretanje calibre-a pri pokretanju na savremenom Linux sistemu zasnovanom na systemd. Samo kreirajte fajl /etc/systemd/system/calibre-server.service sa sadržajem prikazanim ispod:

[Unit]
Description=calibre Content server
After=network.target

[Service]
Type=simple
User=mylinuxuser
Group=mylinuxgroup
ExecStart=/opt/calibre/calibre-server "/path/to/calibre library folder"

[Install]
WantedBy=multi-user.target

Promenite mylinuxuser i mylinuxgroup u korisnika i grupu pod kojima želite da se server pokreće. Ovo bi trebalo da bude isti korisnik i grupa koji poseduju fajlove u folderu calibre biblioteke. Imajte na umu da generalno nije dobra ideja pokretati server kao root. Takođe promenite putanju do foldera calibre biblioteke da odgovara vašem sistemu. Možete dodati više biblioteka ako je potrebno. Pogledajte pomoć za komandu calibre-server.

Sada pokrenite:

sudo systemctl start calibre-server

da biste pokrenuli server. Proverite njegov status sa:

sudo systemctl status calibre-server

Da biste ga podesili da se pokreće pri pokretanju sistema, pokrenite:

sudo systemctl enable calibre-server

Белешка

calibre server ne zahteva pokrenut X server, ali zahteva instalirane X biblioteke jer se neke komponente koje koristi povezuju sa njima.

Белешка

calibre server takođe podržava systemd aktivaciju soketa, tako da i to možete koristiti, ako je potrebno.