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:

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.

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.

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.

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.

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.

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.

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.

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.

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

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.

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.

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.

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.