rakuyomi新手快速上手教程:3步从安装源到开读第一话
rakuyomi新手快速上手教程:3步从安装源到开读第一话
📚 rakuyomi 是一款专为 KOReader 打造的开源漫画阅读器插件,让你能在 Kindle、Kobo、reMarkable 等电子墨水屏设备(以及 Android 平板/电纸书)上直接搜索、下载并阅读网络漫画。本教程将带你用 3 步 完成从安装漫画源到点开第一话的完整流程,无需任何编程基础。
一、rakuyomi 是什么?有什么特点?
简单说,rakuyomi 相当于把"漫画聚合器"搬进了你的电子书阅读器。它的核心能力包括:
- 🌐 海量图源支持:兼容 Aidoku、LNReader、Mangayomi(JS/Dart)、Tachiyomi/Mihon (Keiyoushi) 生态的扩展源
- 📥 断点续读:翻到章节末页会自动下载并打开下一章,阅读不中断
- 📴 离线模式:提前下载章节存为
.cbz文件,没网也能看 - ⚡ 性能优化:数据库查询大幅提速,搜索、章节列表加载更快
- 💾 自动清理:存储达到上限(默认 2GB)自动删除旧章节腾出空间
插件前端入口在 frontend/rakuyomi.koplugin/main.lua,官方使用文档见 docs/src/user-guide/quickstart.md。
二、第 1 步:安装 rakuyomi 插件
1. 获取插件文件
从项目 Releases 页面下载与你设备匹配的安装包(不同设备对应不同 build,选型方法见 docs/src/user-guide/installation/choosing-a-build.md):
| 设备 | 建议 build |
|---|---|
| Kindle(第 4 代及以后,无键盘) | Kindle / Kindle (hard floats) |
| reMarkable | AArch64 或 Kindle |
| Kobo / PocketBook / 其他 ARM 设备 | Kindle |
| BOOX 等 Android 设备 | 插件 + Rakuyomi Bridge 伴侣 App |
💡 如果你是开发者,也可以直接克隆源码查看:
git clone https://gitcode.com/gh_mirrors/rak/rakuyomi
2. 复制插件到 KOReader 目录
- 解压下载的
.zip压缩包,得到rakuyomi.koplugin文件夹 - 将设备连接电脑,找到 KOReader 安装目录(常见位置:Kindle 在
koreader/,Kobo 在.adds/koreader/,Cervantes 在/mnt/private/koreader) - 进入其中的
plugins文件夹:
- 把整个
rakuyomi.koplugin文件夹复制进plugins目录即可:
📌 无需手动写配置文件:首次启动时 rakuyomi 会自动创建 rakuyomi 数据文件夹和默认的 settings.json(包含图源列表地址和语言设置)。想自定义可参考默认配置 backend/server/assets/default-settings.json。
⚠️ Android 设备注意:还需要侧载安装 Rakuyomi Bridge 伴侣 App 并点击 "Start Server",授予"所有文件访问"权限,详细步骤见 docs/src/user-guide/installation/installing-to-your-device.md。
三、第 2 步:安装漫画源(Manage Sources)
现在打开 KOReader,在文件管理器中 点击屏幕顶部唤出菜单栏,选择 Rakuyomi 进入插件首页(你会看到一个空的 Library 书架)。
点击左上角的 ☰ 菜单按钮,选择 Manage sources:
进入图源管理页后,左上角的 + 按钮可打开 Available sources 列表,里面就是所有可安装的漫画源。列表右侧标注 Installable 表示可安装,直接点按任意图源名称即可一键安装:
安装完成后点击左下角返回按钮回到 Library。此时你的"弹药库"就准备就绪了!
四、第 3 步:搜索漫画,开读第一话
1. 搜索漫画
再次打开 ☰ 菜单,选择 Search mangas,输入关键词(如作品名、作者名),即可看到搜索结果:
💡 小技巧:长按搜索结果中的漫画名,可以将其 加入书架(Library),方便以后在首页快速找到。
2. 打开章节列表
点按漫画标题,进入该作品的章节列表页(Chapter listing):
3. 点开第一话开始阅读
直接点击任意章节(比如 Chapter 1),rakuyomi 会通过 KOReader 阅读器打开漫画页面:
🎉 恭喜,你已经完成第一话的开读! 之后:
- 续读:在 Library 中支持"继续阅读"(continue read),自动定位上次读到位置
- 回插件:阅读中点击屏幕顶部菜单 → ☰ → Go back to Rakuyomi 即可返回
- 自动翻页:翻到章节最后一页继续向前翻,rakuyomi 会自动下载并打开下一章,实现无缝连读
五、进阶技巧:离线缓存与阅读优化
📴 批量下载未读章节
想提前囤章离线看?打开书架中某部漫画 → ☰ 菜单 → Download unread chapters...,填写要下载的数量(留空则全部下载):
下载进度可随时取消。章节会存为 .cbz 文件保存在 rakuyomi 的 downloads 目录中。
🎯 三个提升阅读体验的推荐设置
在 KOReader 底部菜单栏中调整(长按可设为 .cbz 文件默认值):
- View Mode 设为
page(整页模式,最适合漫画):
- Page Crop 设为
auto(自动裁剪页边白边) - Fit 设为
full(整页缩放到屏幕内,无需上下滑动)
更多细节请参考 docs/src/user-guide/reader-recommended-settings/README.md 和离线模式说明 docs/src/user-guide/offline-mode.md。
六、快速回顾
| 步骤 | 操作 | 关键入口 |
|---|---|---|
| ① 装插件 | 复制 rakuyomi.koplugin 到 plugins/ |
设备 KOReader 目录 |
| ② 装图源 | Manage sources → + → 点按安装 | ☰ 菜单 |
| ③ 开读 | Search mangas → 点作品 → 点章节 | ☰ 菜单 |
rakuyomi 还支持 Cookie 同步机器人、Scanlator 过滤、播放列表等高级功能,源码分别位于 telegram-cookie-bot/ 与 backend/server/src/job/,感兴趣可以继续探索。现在,拿起你的电纸书,开启漫画之旅吧!🚀








