rakuyomi新手快速上手教程:3步从安装源到开读第一话

原创2026-11-05 11:21:561,923 阅读

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 目录

  1. 解压下载的 .zip 压缩包,得到 rakuyomi.koplugin 文件夹
  2. 将设备连接电脑,找到 KOReader 安装目录(常见位置:Kindle 在 koreader/,Kobo 在 .adds/koreader/,Cervantes 在 /mnt/private/koreader)
  3. 进入其中的 plugins 文件夹:

KOReader安装目录下的plugins文件夹

  1. 把整个 rakuyomi.koplugin 文件夹复制进 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:

rakuyomi库菜单:搜索漫画、管理图源、设置入口

进入图源管理页后,左上角的 + 按钮可打开 Available sources 列表,里面就是所有可安装的漫画源。列表右侧标注 Installable 表示可安装,直接点按任意图源名称即可一键安装:

rakuyomi可安装的漫画源列表

安装完成后点击左下角返回按钮回到 Library。此时你的"弹药库"就准备就绪了!


四、第 3 步:搜索漫画,开读第一话

1. 搜索漫画

再次打开 ☰ 菜单,选择 Search mangas,输入关键词(如作品名、作者名),即可看到搜索结果:

rakuyomi漫画搜索结果显示页

💡 小技巧:长按搜索结果中的漫画名,可以将其 加入书架(Library),方便以后在首页快速找到。

2. 打开章节列表

点按漫画标题,进入该作品的章节列表页(Chapter listing):

漫画章节列表页

3. 点开第一话开始阅读

直接点击任意章节(比如 Chapter 1),rakuyomi 会通过 KOReader 阅读器打开漫画页面:

rakuyomi漫画阅读效果

🎉 恭喜,你已经完成第一话的开读! 之后:

  • 续读:在 Library 中支持"继续阅读"(continue read),自动定位上次读到位置
  • 回插件:阅读中点击屏幕顶部菜单 → ☰ → Go back to Rakuyomi 即可返回
  • 自动翻页:翻到章节最后一页继续向前翻,rakuyomi 会自动下载并打开下一章,实现无缝连读

五、进阶技巧:离线缓存与阅读优化

📴 批量下载未读章节

想提前囤章离线看?打开书架中某部漫画 → ☰ 菜单 → Download unread chapters...,填写要下载的数量(留空则全部下载):

下载未读章节对话框

下载进度可随时取消。章节会存为 .cbz 文件保存在 rakuyomi 的 downloads 目录中。

🎯 三个提升阅读体验的推荐设置

在 KOReader 底部菜单栏中调整(长按可设为 .cbz 文件默认值):

  1. View Mode 设为 page(整页模式,最适合漫画):

阅读器视图模式设为整页

  1. Page Crop 设为 auto(自动裁剪页边白边)
  2. 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/,感兴趣可以继续探索。现在,拿起你的电纸书,开启漫画之旅吧!🚀

登录后查看全文
rakuyomi