基于 Readest 二开 · 轻量自部署

轻量自部署
阅读无界

Readest Lite 基于 Readest 深度定制,去除付费体系,保留全部核心功能。v8.15 合并上游 Readest v0.12.1(175 commits · ~100+ 文件):TTS Media Overlays(EPUB 3 SMIL 录制朗读)· 离线音频下载 · Ambient Mode · 主题 color/→theme/ 改名 · 注解 JSON 导出 + Copy Link + 数学渲染 · 翻译 Yandex/Azure 恢复 · Markdown YAML frontmatter + 脚注 · Command Palette · PDF 内存泄漏修复。单容器 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.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,数据卷持久化
持续迭代

每周一个版本,永远在变好

这不是一个"上线即弃"的项目。我们以周为节奏迭代,每个版本都解决真实用户反馈的问题。

🚀

高频迭代

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),每个版本都有可见的功能落地。GitHub Actions CI 全程守护,每个版本都打 git tag。

🛠

社区驱动

用户反馈的 bug 和功能建议直接进迭代队列。从 100TB 配额、字体本地化到 DeepL 切换,每项都源自真实部署场景。

🔄

零停机升级

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

🔗

开源透明

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

💻

CI 守护

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

📚

原版对齐

持续跟进上游 Readest 的内核升级,新格式支持、新 TTS 引擎、新批注能力都会第一时间落地到 Lite。

未来计划

路线图:下一步去哪

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

🚀

计划中

  • SQLite → PostgreSQL 迁移:支持更大规模部署,多容器共享数据库
  • 本地磁盘 → S3 无感迁移:MinIO 集成,现有书籍文件无损自动迁移
  • PostgreSQL 对象存储:替代本地文件系统,支持 S3 兼容存储

已完成

  • ✓ 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 —— 去除一切限制,只保留纯粹的阅读体验。