飛牛 OS 部署 Calibre-WebDocker 整理電子書庫、上傳 PDF 到固定公網(wǎng)訪問前言我以前整理電子書最常做的事情不是閱讀而是在一層層文件夾里找書小說、技術(shù)資料、PDF、EPUB 混著放臨時(shí)下載的文件名看不出內(nèi)容換到手機(jī)上又得重新翻一遍。把硬盤擴(kuò)容并不能解決這件事真正缺的是能按書名、作者和簡介查找的統(tǒng)一入口。Calibre-Web 恰好適合給已有書庫做一個(gè)網(wǎng)頁界面書還放在自己的設(shè)備上瀏覽器負(fù)責(zé)展示、搜索和訪問不必因?yàn)閾Q了閱讀設(shè)備就重新整理文件。這次我用飛牛 OS 的 Docker 搭建這套書庫。先準(zhǔn)備config與books兩個(gè)目錄啟動(dòng)lscr.io/linuxserver/calibre-web:latest再連接/books下的metadata.db。打開后臺(tái)以后繼續(xù)修改中文顯示、開啟上傳權(quán)限、上傳一本 PDF 并補(bǔ)齊基本信息確認(rèn)書籍確實(shí)出現(xiàn)在首頁。局域網(wǎng)訪問跑通再通過 cpolar 給8083配置隨機(jī)公網(wǎng)地址最后預(yù)留固定二級(jí)子域名cw1。我會(huì)特別留意幾個(gè)容易混淆的地方書籍文件和數(shù)據(jù)庫不是同一回事瀏覽器能登錄不等于書庫初始化完成能生成公網(wǎng)地址也不代表默認(rèn)管理員密碼已經(jīng)適合長期對(duì)外使用。我更愿意先拿一份熟悉的 PDF 把上傳、保存和書目顯示逐個(gè)確認(rèn)再開始配置遠(yuǎn)程入口免得日后找不到書時(shí)分不清是網(wǎng)絡(luò)還是書庫本身出了問題。一、Calibre-Web 是書庫入口不是另一個(gè)網(wǎng)盤我希望打開瀏覽器就能看到書名、封面和分類而不是面對(duì)一堆下載文件名。Calibre-Web 提供的正是這層書庫界面它讀取 Calibre 格式的書庫及其metadata.db把書籍信息組織成可瀏覽、可查找的頁面。實(shí)際文件仍存放在 NAS 的書庫目錄上傳操作也會(huì)寫入相應(yīng)的存儲(chǔ)位置“網(wǎng)頁門面”不等于文件憑空脫離了本地硬盤。這類部署尤其適合已經(jīng)把 PDF、EPUB、MOBI 和其他資料集中放在一臺(tái)設(shè)備上的人。我的目標(biāo)先定得簡單一些完成數(shù)據(jù)庫連接、顯示一本上傳的 PDF再從外網(wǎng)打開同一座書庫。在線閱讀、格式處理或跨設(shè)備閱讀進(jìn)度等具體體驗(yàn)應(yīng)按實(shí)際格式與客戶端分別確認(rèn)不能僅憑首頁截圖就認(rèn)定全部能力已經(jīng)驗(yàn)證。二、在飛牛 OS 上準(zhǔn)備 Docker 與書庫目錄打開飛牛 OS先進(jìn)入 Docker。鏡像倉庫里搜索Calibre-Web按頁面步驟下載鏡像隨后到文件管理器中建立docker文件夾并在下面準(zhǔn)備books與config兩個(gè)目錄。前者作為書庫位置后者保存應(yīng)用配置。先把目錄安排好再啟動(dòng)容器后面查文件、備份和排錯(cuò)都比較清楚。書庫初始化的演示中還準(zhǔn)備了一個(gè)metadata.db文件配套文件地址是https://xiaoxu.lanzoub.com/iYSDi2ae3xud 。這里要注意Calibre-Web 需要的是能夠識(shí)別的 Calibre 書庫數(shù)據(jù)庫而不是任意零字節(jié)文件改個(gè)名字。若選中數(shù)據(jù)庫后無法保存或讀取書籍應(yīng)先檢查文件是否存在、是否是有效數(shù)據(jù)庫以及/books的讀寫權(quán)限。通過終端遠(yuǎn)程進(jìn)入飛牛 OS使用sudo -i切換到管理員用戶在確認(rèn)宿主機(jī)路徑存在后執(zhí)行 Docker 命令dockerrun-d--namecalibre-web-ePUID1000-ePGID1000-eTZAsia/Shanghai-p8083:8083-v/vol1/1000/docker/calibre/config:/config-v/vol1/1000/docker/books:/books--restartunless-stopped lscr.io/linuxserver/calibre-web:latest這條命令使用鏡像lscr.io/linuxserver/calibre-web:latest容器名為calibre-web端口映射是8083:8083。PUID1000和PGID1000關(guān)系到容器寫入文件時(shí)的權(quán)限TZAsia/Shanghai設(shè)置時(shí)區(qū)兩個(gè)掛載分別是/vol1/1000/docker/calibre/config:/config和/vol1/1000/docker/books:/books。因此文件管理器里建目錄時(shí)要核對(duì)完整路徑命令中的配置目錄比書籍目錄多了一級(jí)calibre不要只看見同名config就以為已經(jīng)對(duì)應(yīng)上。三、先登錄再把數(shù)據(jù)庫指向 /books容器啟動(dòng)后在瀏覽器訪問http://IP:8083其中IP換成飛牛 OS 的局域網(wǎng)地址。登錄頁使用的示例初始賬號(hào)為admin密碼為admin123。如果登錄后反復(fù)跳回登錄頁可以先嘗試強(qiáng)制刷新或清理瀏覽器緩存但在后面開放公網(wǎng)之前應(yīng)該先改掉默認(rèn)密碼。登錄成功后還不能把空頁面當(dāng)成已經(jīng)有了圖書館。Calibre-Web 接下來需要知道書庫數(shù)據(jù)庫在哪里打開數(shù)據(jù)庫路徑選擇器按頁面操作返回上層目錄再進(jìn)入books選擇metadata.db點(diǎn)擊select并保存。目錄結(jié)構(gòu)與數(shù)據(jù)庫文件要一起核對(duì)這一步?jīng)Q定應(yīng)用能否讀取后續(xù)上傳與管理的書籍信息。四、切換中文、開放上傳并用一本 PDF 驗(yàn)證數(shù)據(jù)庫連接好以后先在用戶設(shè)置里切換中文顯示再進(jìn)入管理權(quán)限和基本設(shè)置勾選上傳權(quán)限并保存。這個(gè)權(quán)限開關(guān)很關(guān)鍵找不到“上傳書籍”按鈕時(shí)不一定是容器或端口出錯(cuò)也可能只是沒有開放對(duì)應(yīng)功能。隨后選取一份 PDF 上傳補(bǔ)充書名等基本信息再保存并返回書庫查看。這比只展示登錄頁更能證明整條鏈路/books可以使用、數(shù)據(jù)庫能夠記錄書籍、頁面也能把上傳結(jié)果展示出來。這里演示的是 PDF 上傳不把其他格式的轉(zhuǎn)換效果或閱讀進(jìn)度同步寫成已經(jīng)完成的測(cè)試。五、書庫在內(nèi)網(wǎng)能打開以后再安裝 cpolar書已經(jīng)能從飛牛 OS 的8083頁面找到下一步才考慮人在外面怎樣進(jìn)入。cpolar 的職責(zé)只是把現(xiàn)有 Web 服務(wù)提供到公網(wǎng)書籍文件、數(shù)據(jù)庫和 Calibre-Web 容器仍在 NAS 上不會(huì)因?yàn)橛辛斯W(wǎng)地址就變成托管在外部的書庫。先在飛牛 OS 設(shè)置中開啟 SSH使用設(shè)備局域網(wǎng) IP 遠(yuǎn)程連接。按 Linux 安裝方式執(zhí)行sudocurlhttps://get.cpolar.sh|sh安裝后檢查 cpolar 服務(wù)狀態(tài)sudosystemctl status cpolar服務(wù)正常時(shí)通過飛牛 OS 的局域網(wǎng) IP 加9200進(jìn)入 cpolar 管理界面用已經(jīng)注冊(cè)的賬號(hào)登錄。這里需要區(qū)分兩個(gè)端口9200是隧道管理頁面真正需要被外部訪問的書庫仍是8083。六、先用隨機(jī)域名驗(yàn)證公網(wǎng)訪問進(jìn)入隧道管理 → 創(chuàng)建隧道名稱填寫cw協(xié)議選 HTTP本地地址填8083域名類型選隨機(jī)域名地區(qū)選China Top。創(chuàng)建后到在線隧道列表復(fù)制生成的地址再用另一臺(tái)不在同一局域網(wǎng)內(nèi)的設(shè)備打開確認(rèn)看到的是 Calibre-Web 頁面。這一層驗(yàn)證的是“外部瀏覽器 → cpolar → NAS 的8083→ Calibre-Web”不是重新部署一套書庫。如果公網(wǎng)地址能打開但書籍打不開還應(yīng)回到數(shù)據(jù)庫、目錄掛載及應(yīng)用權(quán)限這一層繼續(xù)排查。七、為經(jīng)常使用的書庫保留固定入口隨機(jī)地址適合先試通網(wǎng)絡(luò)需要長期從手機(jī)、平板或其他地方進(jìn)入時(shí)固定二級(jí)子域名更方便收藏。進(jìn)入 cpolar 的預(yù)留頁面選擇保留二級(jí)子域名地區(qū)為china top示例名稱為cw1按提示填寫備注并保留。名稱有唯一性最終以自己賬號(hào)實(shí)際保留成功的結(jié)果為準(zhǔn)。再回到隧道管理 → 隧道列表找到前面名為cw的隧道點(diǎn)擊編輯把域名類型改為二級(jí)子域名在Sub Domain中填寫預(yù)留成功的名稱地區(qū)選擇China Top點(diǎn)擊更新。到在線隧道列表查看新的固定地址并從外部瀏覽器再次訪問確認(rèn)。固定的是訪問入口而不是容器永不停止或 NAS 永不斷網(wǎng)。也不要忘記公開地址會(huì)擴(kuò)大書庫的可訪問范圍除了更改初始密碼還應(yīng)根據(jù)家庭使用范圍管理賬號(hào)、上傳權(quán)限和藏書分享范圍。電子書的上傳、下載與分享也應(yīng)遵守相應(yīng)內(nèi)容的使用授權(quán)。總結(jié)以前面對(duì)一整盤電子書我最花時(shí)間的是尋找和辨認(rèn)文件現(xiàn)在有了 Calibre-Web能把查書、瀏覽書目信息和上傳新書集中到一個(gè)頁面。飛牛 OS 負(fù)責(zé)承載容器和書庫/config保存應(yīng)用配置/books對(duì)應(yīng)藏書與書庫數(shù)據(jù)庫這三個(gè)位置弄清楚以后比只追求一個(gè)漂亮首頁更便于長期維護(hù)。從本地的8083到 cpolar 隨機(jī)地址再到固定二級(jí)子域名cw1遠(yuǎn)程訪問只是最后一環(huán)。真正值得留意的還是數(shù)據(jù)庫是否有效、目錄是否準(zhǔn)確、上傳權(quán)限是否打開以及默認(rèn)賬號(hào)是否已經(jīng)更換。把這些基礎(chǔ)環(huán)節(jié)確認(rèn)好這座私人圖書館才不只是能訪問也能繼續(xù)往里添書、整理和使用。