Koodo Reader：免费开源的跨平台电子书阅读器，如何 5 分钟上手-育师

Koodo Reader：免费开源的跨平台电子书阅读器，如何 5 分钟上手

【免费下载链接】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

Koodo Reader 是一款免费开源的跨平台电子书管理器与阅读器，支持 EPUB、PDF、MOBI、AZW3 等 15 种以上格式，覆盖 Windows、macOS、Linux、Android、iOS 和 Web 六个平台。除了阅读，它还负责书库管理和云同步备份，让你换设备后能从上次阅读的位置继续。下面按"装好 → 导入 → 调阅读 → 接同步"的顺序，带你把它跑起来。

Koodo Reader 支持哪些电子书格式

先确认你的书能不能读。根据 README 功能清单，目前支持：

标准电子书：EPUB、PDF、MOBI、AZW3、AZW（无 DRM）、FB2
漫画包：CBR、CBZ、CBT、CB7
文本文档：TXT、Markdown、DOCX
网页类：HTML、XML、XHTML、MHTML

格式的具体识别规则写在 src/constants/mimetype.tsx。除了打开文件，它还能做这些事：

单栏、双栏或连续滚动三种排版，支持竖排书籍
内置 Paddle 和 Tesseract 两个 OCR 引擎，扫描件也能转文字
内置 50 多个插件，覆盖翻译、词典、文本朗读，也支持自定义插件

Koodo Reader 安装命令：按平台选一条

普通用户不用自己编译，各平台都有现成渠道。挑对应你系统的一条执行即可：

# Windows winget install AppByTroye.KoodoReader

# macOS brew install --cask koodo-reader

# Linux（Flatpak 或 Snap 二选一） flatpak install flathub io.github.troyeguo.koodo-reader

Android 和 iOS 从各应用商店下载；Web 版直接打开浏览器访问即可，无需安装。

如果你更习惯 Docker 自托管，仓库里已经备好 Dockerfile 和 docker-compose.yml：

docker compose up -d

容器会暴露 80（Web 界面）、8080（HTTP 服务）和 7200（KOReader 进度同步）三个端口，上传目录挂载在/app/uploads。

想直接跑源码的话，克隆仓库后执行yarn && yarn dev（桌面模式）或yarn && yarn start（Web 模式）：

git clone https://gitcode.com/GitHub_Trending/koo/koodo-reader

导入第一本电子书的三种方式

打开应用后，把书放进书库有三种途径：

拖放导入：把 epub、pdf 等文件直接拖进窗口，支持一次拖多本
文件夹批量导入：选中一个目录，整个书库一次搬进来
云盘导入：连接 OneDrive、Google Drive、WebDAV 等服务后，直接从云端目录里选书，不用先下载到本地

导入后书籍会以封面或列表两种视图展示，可以加标签分类，也可以一键导出整个书库。

调整 Koodo Reader 阅读界面：字体、主题与背景

点开一本书后，通过设置面板（组件在 src/components/dialogs/settingDialog/）调整阅读体验：

文字：字号、字体、行距、段距、字间距都能单独调
配色：背景色、文字颜色、亮度，带夜间模式和主题色
排版：单栏、双栏、连续滚动切换，页边距可调
背景图：内置多张自然风景和都市风格背景，也可换成自己的图片

阅读中可以选词加书签、写笔记、做高亮和下划线；支持竖排的书籍还有专门的竖版排版。

Koodo Reader 云同步配置方法：连接云盘并选同步内容

同步是这个项目区别于普通阅读器的核心能力，逻辑在 src/utils/storage/syncService.ts。进入"同步设置"，它支持 13 种存储服务：OneDrive、Google Drive、Dropbox、iCloud、MEGA、pCloud、Yandex Disk、Box、FTP、SFTP、WebDAV、SMB 和对象存储。

配置分三步：