基于 Readest 二开 · 轻量自部署

轻量自部署
阅读无界

Readest Lite 基于 Readest 深度定制,去除付费体系,保留全部核心功能。自 v8.23.2 起与上游分道扬镳,基于稳定基线独立维护。包含:回收站批量 · 跨用户文件管理 · 分组管理 Modal · Notion 同步 · ReadEra 导入 · 带登录网页小说导入 · 超级管理员 ENV 识别 · 资源全面本地化。单容器 Docker 部署,数据完全自主。

0
付费限制
100TB
软上限(不强制)
1
Docker 容器
localhost:8225
📚
📖
🌐
⚙
全部功能已开放
核心功能

保留原版 + 自部署增强

与 Readest 功能持续对齐,所有原版 Pro 专属功能无条件开放;额外内置多用户、远程下载、Web 搜索、翻译代理、Edge TTS 等自部署增强能力。

核心阅读能力

📚

多格式阅读

原生支持 EPUB、PDF、MOBI、AZW3 等主流电子书格式,无需转换直接打开,自动适配最佳排版。

🖥

分屏阅读

原版 Pro 功能,现无条件开放。支持双屏对照阅读,左原文右译文,或同时参考两本书。

🎤

TTS 朗读

原版 Pro 功能,现无条件开放。内置高质量语音合成,多语种多音色,可调语速音调。

☁

云端同步

阅读进度、批注、书签自动同步,多端无缝切换。同步协议完全兼容原版前端逻辑。

✍

无限批注与导出

原版 Pro 功能,现无条件开放。高亮、划线、笔记一应俱全,支持导出 Markdown 或纯文本。

🗃

实际无上限存储

100TB 软上限(不强制),实际只受磁盘空间约束。书籍、封面存于本地挂载卷,数据完全自主。

自部署增强 v7.0 · v8.0 · v8.1 · v8.2 · v8.3 · v8.4 · v8.5 · v8.6 · v8.7 · v8.8 · v8.9 · v8.10 · v8.11 · v8.12 · v8.13 · v8.14 · v8.15 · v8.16 · v8.17 · v8.18 · v8.19 · v8.21 · v8.22 · v8.23 新增

👥

多用户管理

管理员可创建普通用户,分配存储与翻译配额。v8.4:Per-user 加密 vault,library/settings 按 userId AES-GCM 加密,密码不存客户端,跨账号彻底隔离。v8.5:配额真正 enforce,超额上传/翻译被拒绝。普通用户独立空间,互不干扰。

📥

远程下载

书库点「导入」→「Download from URL」,服务器自动抓取入库。v8.6:任务队列,有进度/状态/重试。v8.7:DownloadTask 表落库 + 用户中心面板,5s 轮询、批量操作、跨设备同步可见。v8.8:分块上传,大文件不再被 Cloudflare 524 超时打断。

🌐

翻译词典代理

Google 翻译、Wikipedia、Wiktionary 全部走服务器代理,客户端无需加速器。v8.0:强制登录。v8.2:可关代理。v8.5:SSRF 黑名单。

📚

原版词典悬浮窗

选中文字点「Dictionary」弹悬浮窗显示 Wikipedia/Wiktionary 查询结果,点「Translate」弹翻译悬浮窗。保留原版 Readest 完整体验,代理透传。

🔊

Edge TTS

服务器端 WebSocket 连接微软 Edge TTS,高质量语音合成,多语种多音色,零成本零依赖。

🔤

字体本地化

阅读字体打包进镜像,不依赖外部 CDN,离线环境也能保持一致的中文渲染效果。

改动明细

只做减法,不加戏

严格遵循最小化改动原则:删除付费体系与注册限制,其余逻辑原封不动保留。

✕

已移除

  • −Pro 付费体系、定价页、订阅页、支付页面
  • −所有升级弹窗、Pro 标识徽章、升级入口
  • −isPro / checkPro / requirePro 校验代码
  • −注册功能入口,仅管理员可创建用户
  • −存储容量限制、文件数量限制
  • −Supabase Auth 依赖,替换为本地鉴权
  • −Supabase Postgres 依赖,替换为 SQLite
  • −对象存储依赖,替换为本地文件系统
✓

保留 / 新增

  • +全部阅读器内核、UI 交互、同步逻辑原封不动
  • +原 Pro 功能(分屏、TTS、导出批注)全部开放
  • +无限存储,无容量与文件数限制
  • +多用户系统,管理员可创建用户并分配配额
  • +远程书籍下载,服务器代理获取 URL 书籍(v8.1:同时写 Book 表,多端同步可见)
  • +翻译词典服务器代理,客户端无需加速器(v8.0:强制登录)
  • +Edge TTS 服务器端合成,零成本零依赖
  • +字体本地化,不依赖外部 CDN
  • +DeepL 翻译可选启用(默认关闭)
  • +100TB 软上限(实际只受磁盘约束)
  • +SQLite + Prisma 替代 Postgres,数据完全自主
  • +本地文件系统替代对象存储,书籍存于 /data/books
  • +全部 API 契约 1:1 复刻,前端零修改可对接
  • +单 Docker 镜像,端口 8225,数据卷持久化
持续迭代

从 v8.23.2 起与上游分道扬镳,独立维护

v8.0 → v8.23.2 我们持续合并上游;v8.24 合并尝试遇到严重回归后,决定不再跟踪上游,基于 v8.23.2 + 上游 v0.12.6 长期独立维护。后续只在用户提交 issue/PR 或修复 bug 时更新。

🚀

历史迭代回顾(v7.0 → v8.23.2)

v7.0 多用户、v8.0 代理强制登录、v8.1 修复远程下载、v8.2 代理开关 + Readest Lite 品牌、v8.3 账号切换数据隔离、v8.4 Per-user 加密 vault、v8.5 配额 enforce、v8.6 合并上游 0.11.12 + 分享永久 + 下载队列、v8.7 跨设备下载任务队列、v8.8 分块上传规避 CF 524、v8.9-v8.10 中文汉化 + 阅读统计、v8.11-v8.12 合并上游 v0.11.17、v8.13 Auto Scroll + 翻页动画 + TTS 大改版、v8.14 RSS 订阅 + Issue #5 修复、v8.15 上游 v0.12.1 合并(TTS Media Overlays + 主题改名 + 注解 JSON 导出 + Command Palette)、v8.16 上游 v0.12.6 合并(daisyUI 5 + Tailwind 4 + Notebook + TTS 歌词视图)、v8.17-v8.18 上游 v0.12.6 移植 + feed:// 分享 + 加密设置同步、v8.19 回收站 + 文件去重 + 角色层级 super_admin > admin > user、v8.21 回收站批量 + 跨用户文件管理 + 分组管理 Modal、v8.22 Notion 同步 + ReadEra 导入 + 带登录网页小说导入 + CORS 修复、v8.23 删除有声书 + 删除 RSS favicon + 修复超级管理员 + 分组融合 + 资源全面本地化。

👐

🔀 与上游分道扬镳(v8.23.2 起)

不再跟踪上游:上游 v0.12.7+ 的新功能(iOS CarPlay / Android Auto / BookOrbit / KOReader / RSS / OPDS / localsend)不会进入 Lite。长期基线:v8.23.2 + 上游 v0.12.6,稳定可靠。更新策略:只在①用户提交 bug ②用户提 PR 加特色功能 ③安全修复 时更新。版本号:从 v8.23.3 开始递增,不再用 v8.24+ 避免与上游混淆。

🛠

社区驱动 · NodeByte

用户反馈的 bug 和功能建议直接进迭代队列。从 100TB 配额、字体本地化到 DeepL 切换,每项都源自真实部署场景。所有问题优先前往 NodeByte 社区 反馈,作者亲自在社区回答问题。

📦

回收站 + 跨用户文件管理

v8.19 回收站:删除书籍 30 天可恢复,批量恢复/删除。v8.21 管理员文件管理:浏览所有用户文件,批量移动/复制到其他用户,支持多目标批量复制。v8.22 分组管理:书库三点菜单 → 分组管理 Modal,搜索/添加/编辑/删除/排序。

📝

Notion 同步 + ReadEra 导入

v8.22 Notion 同步:代理路由绕过 CORS,同步笔记到 Notion 数据库。ReadEra 注释导入:从 ReadEra 备份导入高亮/书签/进度。带登录网页小说导入:Cookie + 自定义请求头,支持需要登录的站点。

🔄

零停机升级

SQLite 自动迁移、数据卷持久化,docker compose pull && up -d 一条命令完成升级,旧数据无损。

🔗

开源透明

全代码 AGPL-3.0 开源,PR 与 issue 公开可见。每个 commit 都有详细的修改说明,便于审查与二开。

💻

CI 守护

每次 push 自动跑 Docker 镜像构建 + smoke test,失败即阻塞合并。你拉到的每个镜像都验证过启动 + 登录 + API 响应。

✅

Lite 现有功能全部保留

JWT 多用户、Prisma storage、回收站、跨用户文件管理、Notion 同步、ReadEra 导入、带登录网页小说导入、Edge TTS、字体本地化、代理翻译/词典、分组管理、分享永久链接 — 全部保留,不会因不合并上游而丢失。

未来计划

路线图:下一步去哪

透明公开迭代方向,用户可追踪进度、提建议、参与讨论。

🚀

计划中

  • ▶ 有声书播放(自研):内置 HTML5 音频播放器,支持 .mp3/.m4a/.m4b 上传 → 自动识别 → 播放/暂停/进度条/速度/章节切换/进度保存。v8.22.3 曾实现但因稳定性问题暂时移除,计划重新开发更稳定的版本
  • ▶ RSS 站点 favicon 自动识别:v8.23 移除,计划用更稳定的方式重新实现(当前使用默认 RSS 橙色图标)
  • ▶ SQLite → PostgreSQL 迁移:支持更大规模部署,多容器共享数据库
  • ▶ 本地磁盘 → S3 无感迁移:MinIO 集成,现有书籍文件无损自动迁移
  • ▶ 全文搜索:跨书籍内容搜索
✅

已完成

  • 🔀 v8.23.2 起:与上游 Readest 分道扬镳 — 不再合并上游 v0.12.7+,基于 v8.23.2 + 上游 v0.12.6 长期独立维护。后续只在用户提交 issue/PR 或修复 bug 时更新。版本号从 v8.23.3 开始递增,不再用 v8.24+ 避免与上游混淆。
  • ✓ v8.23 删除有声书(加到 TODO)+ 删除 RSS favicon + 修复超级管理员 ENV 识别(init-admin.mjs 不再降级 super_admin)+ 分组管理与书库融合 + 资源全面本地化
  • ✓ v8.22 Notion 笔记同步 + ReadEra 注释导入 + 带登录网页小说导入 + CORS 错误根除(updater web 短路 + constants URL 本地化)
  • ✓ v8.21 回收站批量选择 + 管理员跨用户文件管理(移动/复制端点 + AdminFileTransfer 组件)+ 分组管理 Modal(搜索/添加/编辑/删除/排序)
  • ✓ v8.19 回收站(30 天自动清理)+ 文件去重 + 引用计数 + 角色层级 super_admin > admin > user + 审计日志与回滚
  • ✓ v8.17-v8.18 上游 v0.12.1 → v0.12.6 批量合入(163 commits, 42 features · feed:// 分享 · 加密设置同步 · 用户头像)
  • ✓ v8.16 上游 Readest v0.12.6 合并:daisyUI 5 + Tailwind CSS 4 + Notebook 工作区 + TTS 歌词视图 + 自定义快捷键 + 跨页 PDF 选择 + 脚注弹窗跳转 + Auto Scroll 改进 + 全屏封面查看器 + 封面下载进度 + 隐藏封面隐私 + 网文导入章节选择 + 文件夹导入并发
  • ✓ v8.15 上游 Readest v0.12.1 合并:TTS Media Overlays + 离线音频下载 + Ambient Mode + 主题 color/→theme/ 改名 + 注解 JSON 导出 + Copy Link + 数学渲染 + 翻译 Yandex/Azure 恢复 + Markdown YAML frontmatter + 脚注 + Command Palette + PDF 内存泄漏修复
  • ✓ v8.14 上游 v0.11.18→v0.11.20 合入 + RSS/Atom/JSON feed 订阅 + Issue #5 分块上传 merge 修复(stream require vs await import)
  • ✓ v8.13 上游 v0.11.18 合入:Auto Scroll + 翻页动画 + PDF 暗色页眉 + TTS 大改版
  • ✓ v8.11-v8.12 上游 v0.11.17 合入:Markdown 渲染 + PDF/CBZ 对比度 + TTS 高亮粒度
  • ✓ v8.9-v8.10 中文汉化 + 阅读统计(总/今日/本周 + 书榜)+ 批量下载 Cookie/Headers
  • ✓ v8.8 分块上传规避 Cloudflare 524 超时(5MB/块 · 流式合并)
  • ✓ v8.7 跨设备下载任务队列(DownloadTask 表 + 用户中心面板 + 5s 轮询)
  • ✓ v8.6 合并上游 0.11.12 + 图片保存 + 分享永久 + 下载任务队列
  • ✓ v8.5 配额 enforce + 真实配额 UI + SSRF 黑名单
  • ✓ v8.4 Per-user 加密 vault(AES-GCM)
  • ✓ v8.3 账号切换数据隔离
  • ✓ v8.2 代理开关 + Readest Lite 品牌
  • ✓ v8.1 远程下载修复 + ADMIN_USERNAME
  • ✓ v8.0 代理强制登录
  • ✓ v7.0 多用户管理 + Edge TTS + 字体本地化
❌

已放弃

  • ✕ WebSearchPopup 悬浮窗(X-Frame-Options 拒绝 iframe)
  • ✕ 代理路由白名单(改为 SSRF 黑名单)
  • ✕ sync config 跨设备同步(改为设备本地保留)

数据自主,功能全开,多用户 · 远程下载 · 持续迭代

Readest Lite —— 去除一切限制,只保留纯粹的阅读体验。