如何用 Docker 部署私有電子書庫Koodo Reader 完整部署教程【免費下載鏈接】koodo-readerA modern ebook manager and reader with sync and backup capacities for Windows, macOS, Linux, Android, iOS and Web項目地址: https://gitcode.com/GitHub_Trending/koo/koodo-readerKoodo Reader 是一個免費開源的電子書管理器兼閱讀器支持 EPUB、PDF、MOBI 等主流格式可在手機、平板和電腦上使用。本教程帶你用 Docker 把它部署到家用服務器或 NAS 上部署完成后你在任何一臺聯(lián)網(wǎng)設備的瀏覽器里打開同一個地址就能管理同一個書庫、繼續(xù)同一本沒讀完的書。整個過程只需一條構建命令適合第一次接觸容器部署的用戶。 自建書庫能幫你做什么部署完成后在瀏覽器訪問服務器地址并登錄你會得到一個可以日常使用的書庫批量導入電子書EPUB、PDF、MOBI、AZW3、TXT、FB2以及 CBZ 等漫畫壓縮包格式跨設備閱讀手機上午讀到一半回家用電腦接著翻進度在同一個書庫里書架整理搜索、標簽、排序、批量導出批注導出高亮、筆記、書簽支持導出為 Markdown、CSV 等格式插件擴展內置 OCR 文字識別、翻譯、文字轉語音等插件也可以接入自己的 AI 接口云盤同步書庫可備份到 OneDrive、WebDAV、FTP 等也能直接從云盤導入書籍? 啟動服務前的環(huán)境檢查清單部署前逐項核對每一項都對應部署后最常見的故障來源Docker 與 Docker Compose 已安裝分別在終端執(zhí)行docker -v和docker compose version能輸出版本號即可。Docker Compose 是一個工具作用是用一份配置文件同時管理容器、端口和數(shù)據(jù)目錄。確認端口空閑本服務需要兩個端口——80 提供網(wǎng)頁8080 提供上傳和同步服務。如果機器上已有網(wǎng)站或反向代理占用 80 端口先記下部署時把映射改掉見下文排坑部分。準備書籍存放目錄上傳的書籍會保存在掛載到容器內的主機目錄示例配置使用/opt/uploads。先執(zhí)行mkdir -p /opt/uploads創(chuàng)建它并確認該目錄對 Docker 進程可寫否則上傳會失敗。磁盤容量容器鏡像本身只有幾百 MB大頭是書籍文件。按你現(xiàn)有電子書總量加 20% 余量預留即可初期不需要大容量。 構建并啟動容器第一步獲取項目文件git clone https://gitcode.com/GitHub_Trending/koo/koodo-reader cd koodo-reader第二步修改登錄賬號和密碼網(wǎng)頁端需要賬號密碼登錄。示例配置 docker-compose.yml 里默認是 admin / securePass123僅限局域網(wǎng)使用暴露到公網(wǎng)前必須改掉。打開你克隆目錄下的docker-compose.yml把environment中SERVER_USERNAME和SERVER_PASSWORD的默認值改成自己的。第三步開啟文件服務示例配置中 8080 端口的文件服務默認是關閉的此時網(wǎng)頁只能瀏覽不能上傳書籍。在environment段補上兩個開關environment: - SERVER_USERNAME你的用戶名 - SERVER_PASSWORD你的密碼 - ENABLE_HTTP_SERVERtrue - ENABLE_KOREADER_SERVERtrueENABLE_HTTP_SERVERtrue開啟 8080 文件服務上傳書籍依賴它ENABLE_KOREADER_SERVERtrue開啟 KOReader 電紙書進度同步不用 KOReader 可省略如果還想把書庫以 OPDS 目錄一種其他閱讀應用可像訂閱報刊一樣拉取的書目協(xié)議分享給別的設備再加一行ENABLE_OPDStrue它依賴前一個開關。第四步構建并啟動docker compose up -d --build--build讓 Compose 先根據(jù) Dockerfile 構建鏡像鏡像以 Caddy一個體積小的 Web 服務器為基礎在 80 端口提供網(wǎng)頁同時啟動 httpserver/ 下的 Go 文件服務監(jiān)聽 8080。首次構建約需幾分鐘之后改配置只需再執(zhí)行一次docker compose up -d。 驗證訪問并導入第一本書瀏覽器訪問http://服務器IP用剛設置的賬號密碼登錄?？吹娇瞻讜苷f明部署已完成。上傳一本本地的 EPUB 或 PDF文件經 8080 端口寫入/opt/uploads頁面自動完成索引。打開這本書翻幾頁順手加一條高亮批注。用手機瀏覽器登錄同一地址打開同一本書確認進度和高亮都在——多設備同步鏈路即打通。?? 啟動后最容易踩的 3 個坑網(wǎng)頁打不開或顯示的不是本服務多半是端口沖突。用docker compose logs看容器是否正常運行再用docker port koodo-reader查看實際映射。若 80 被占把ports改成8081:80這類寫法訪問時加上端口號即可。上傳失敗或重啟后書不見了先確認ENABLE_HTTP_SERVERtrue已設置再確認主機目錄可寫。如果掛載的目錄在容器啟動時不存在Docker 會創(chuàng)建為一個歸 root 所有的目錄容器刪除重建后書籍隨之丟失——所以清單里的預創(chuàng)建步驟不能省。忘記改默認密碼容器日志出現(xiàn) Using default password 說明仍在用 securePass123 運行公網(wǎng)下這是直接風險。更穩(wěn)妥的做法是參照 docker-compose-secret.yml把密碼單獨存進一個文本文件通過 Docker Secret容器專用的機密注入機制傳進容器配置文件里不留明文。 書庫跑起來之后可以探索的方向KOReader 電紙書同步配合已開啟的同步服務瀏覽器端與電紙書之間雙向同步閱讀進度OPDS 目錄訂閱開啟ENABLE_OPDS后其他閱讀器把服務器地址添加為 OPDS 源即可瀏覽整個書庫不必把文件拷到每臺設備云備份與插件在書庫設置里接入 OneDrive、WebDAV 等做異地備份按需啟用 OCR、翻譯、文字轉語音插件參考信息README_cn.md中文說明· Dockerfile鏡像構建· docker-compose.yml容器配置· httpserver/Go 文件服務源碼【免費下載鏈接】koodo-readerA modern ebook manager and reader with sync and backup capacities for Windows, macOS, Linux, Android, iOS and Web項目地址: https://gitcode.com/GitHub_Trending/koo/koodo-reader創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 如何用 Docker 部署私有電子書庫：Koodo Reader 完整部署教程
如何用 Docker 部署私有電子書庫Koodo Reader 完整部署教程【免費下載鏈接】koodo-readerA modern ebook manager and reader with sync and backup capacities for Windows, macOS, Linux, Android, iOS and Web項目地址: https://gitcode.com/GitHub_Trending/koo/koodo-readerKoodo Reader 是一個免費開源的電子書管理器兼閱讀器支持 EPUB、PDF、MOBI 等主流格式可在手機、平板和電腦上使用。本教程帶你用 Docker 把它部署到家用服務器或 NAS 上部署完成后你在任何一臺聯(lián)網(wǎng)設備的瀏覽器里打開同一個地址就能管理同一個書庫、繼續(xù)同一本沒讀完的書。整個過程只需一條構建命令適合第一次接觸容器部署的用戶。 自建書庫能幫你做什么部署完成后在瀏覽器訪問服務器地址并登錄你會得到一個可以日常使用的書庫批量導入電子書EPUB、PDF、MOBI、AZW3、TXT、FB2以及 CBZ 等漫畫壓縮包格式跨設備閱讀手機上午讀到一半回家用電腦接著翻進度在同一個書庫里書架整理搜索、標簽、排序、批量導出批注導出高亮、筆記、書簽支持導出為 Markdown、CSV 等格式插件擴展內置 OCR 文字識別、翻譯、文字轉語音等插件也可以接入自己的 AI 接口云盤同步書庫可備份到 OneDrive、WebDAV、FTP 等也能直接從云盤導入書籍? 啟動服務前的環(huán)境檢查清單部署前逐項核對每一項都對應部署后最常見的故障來源Docker 與 Docker Compose 已安裝分別在終端執(zhí)行docker -v和docker compose version能輸出版本號即可。Docker Compose 是一個工具作用是用一份配置文件同時管理容器、端口和數(shù)據(jù)目錄。確認端口空閑本服務需要兩個端口——80 提供網(wǎng)頁8080 提供上傳和同步服務。如果機器上已有網(wǎng)站或反向代理占用 80 端口先記下部署時把映射改掉見下文排坑部分。準備書籍存放目錄上傳的書籍會保存在掛載到容器內的主機目錄示例配置使用/opt/uploads。先執(zhí)行mkdir -p /opt/uploads創(chuàng)建它并確認該目錄對 Docker 進程可寫否則上傳會失敗。磁盤容量容器鏡像本身只有幾百 MB大頭是書籍文件。按你現(xiàn)有電子書總量加 20% 余量預留即可初期不需要大容量。 構建并啟動容器第一步獲取項目文件git clone https://gitcode.com/GitHub_Trending/koo/koodo-reader cd koodo-reader第二步修改登錄賬號和密碼網(wǎng)頁端需要賬號密碼登錄。示例配置 docker-compose.yml 里默認是 admin / securePass123僅限局域網(wǎng)使用暴露到公網(wǎng)前必須改掉。打開你克隆目錄下的docker-compose.yml把environment中SERVER_USERNAME和SERVER_PASSWORD的默認值改成自己的。第三步開啟文件服務示例配置中 8080 端口的文件服務默認是關閉的此時網(wǎng)頁只能瀏覽不能上傳書籍。在environment段補上兩個開關environment: - SERVER_USERNAME你的用戶名 - SERVER_PASSWORD你的密碼 - ENABLE_HTTP_SERVERtrue - ENABLE_KOREADER_SERVERtrueENABLE_HTTP_SERVERtrue開啟 8080 文件服務上傳書籍依賴它ENABLE_KOREADER_SERVERtrue開啟 KOReader 電紙書進度同步不用 KOReader 可省略如果還想把書庫以 OPDS 目錄一種其他閱讀應用可像訂閱報刊一樣拉取的書目協(xié)議分享給別的設備再加一行ENABLE_OPDStrue它依賴前一個開關。第四步構建并啟動docker compose up -d --build--build讓 Compose 先根據(jù) Dockerfile 構建鏡像鏡像以 Caddy一個體積小的 Web 服務器為基礎在 80 端口提供網(wǎng)頁同時啟動 httpserver/ 下的 Go 文件服務監(jiān)聽 8080。首次構建約需幾分鐘之后改配置只需再執(zhí)行一次docker compose up -d。 驗證訪問并導入第一本書瀏覽器訪問http://服務器IP用剛設置的賬號密碼登錄?？吹娇瞻讜苷f明部署已完成。上傳一本本地的 EPUB 或 PDF文件經 8080 端口寫入/opt/uploads頁面自動完成索引。打開這本書翻幾頁順手加一條高亮批注。用手機瀏覽器登錄同一地址打開同一本書確認進度和高亮都在——多設備同步鏈路即打通。?? 啟動后最容易踩的 3 個坑網(wǎng)頁打不開或顯示的不是本服務多半是端口沖突。用docker compose logs看容器是否正常運行再用docker port koodo-reader查看實際映射。若 80 被占把ports改成8081:80這類寫法訪問時加上端口號即可。上傳失敗或重啟后書不見了先確認ENABLE_HTTP_SERVERtrue已設置再確認主機目錄可寫。如果掛載的目錄在容器啟動時不存在Docker 會創(chuàng)建為一個歸 root 所有的目錄容器刪除重建后書籍隨之丟失——所以清單里的預創(chuàng)建步驟不能省。忘記改默認密碼容器日志出現(xiàn) Using default password 說明仍在用 securePass123 運行公網(wǎng)下這是直接風險。更穩(wěn)妥的做法是參照 docker-compose-secret.yml把密碼單獨存進一個文本文件通過 Docker Secret容器專用的機密注入機制傳進容器配置文件里不留明文。 書庫跑起來之后可以探索的方向KOReader 電紙書同步配合已開啟的同步服務瀏覽器端與電紙書之間雙向同步閱讀進度OPDS 目錄訂閱開啟ENABLE_OPDS后其他閱讀器把服務器地址添加為 OPDS 源即可瀏覽整個書庫不必把文件拷到每臺設備云備份與插件在書庫設置里接入 OneDrive、WebDAV 等做異地備份按需啟用 OCR、翻譯、文字轉語音插件參考信息README_cn.md中文說明· Dockerfile鏡像構建· docker-compose.yml容器配置· httpserver/Go 文件服務源碼【免費下載鏈接】koodo-readerA modern ebook manager and reader with sync and backup capacities for Windows, macOS, Linux, Android, iOS and Web項目地址: https://gitcode.com/GitHub_Trending/koo/koodo-reader創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考