基于 Readest 二开 · 轻量自部署

轻量自部署
阅读无界

Readest Lite 基于 Readest 深度定制,去除付费体系,保留全部核心功能。v8.12.2 防御性文件名生成(即使未来代码回归也永不返回空串)+ 上传/下载错误响应体加 hint/received 字段方便诊断。v8.12.1 紧急修复 v8.12.0 误覆盖 Lite 自定义代码。v8.12 全量同步上游 v0.11.17。单容器 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.4:Per-user 加密 vault,library/settings 按 userId AES-GCM 加密,密码不存客户端,跨账号彻底隔离。v8.5:配额真正 enforce,超额上传/翻译被拒绝。普通用户独立空间,互不干扰。

📥

远程下载

书库点「导入」→「Download from URL」,服务器自动抓取入库。v8.6:任务队列,有进度/状态/重试。v8.7:DownloadTask 表落库 + 用户中心面板v8.8:分块上传,大文件不被 CF 524 超时打断。v8.9:进度条/速度/ETA/用时 + 完整日志 + 批量下载 + 自动重命名 + Cookie/Headers 高级选项v8.10:中文汉化 + 下载记录折叠v8.11:foliate-js 自动更新(PDF pinch-zoom/翻页性能)v8.12:上游 v0.11.17 全量同步

🌐

翻译词典代理

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 下载进度/日志/批量/自动重命名/Cookie 高级选项、v8.10 中文汉化 + 笔记链接手机修复 + 登出安全 + 阅读统计 + 下载折叠、v8.11 合并上游 v0.11.17(Markdown + PDF 对比度 + TTS 粒度 + 最近阅读书架)、v8.12 上游 v0.11.17 全量同步(163 文件复制 + 58 Lite 自定义保留),每个版本都有可见的功能落地。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.12.2 防御性文件名生成 + 上传/下载错误响应体加 hint/received 字段
  • ✓ v8.12.1 紧急修复 v8.12.0 误覆盖 Lite 自定义(下载报 File not found + 关于弹官方页面)
  • ✓ v8.12 上游 v0.11.17 全量同步(163 文件复制 + 21 新文件 + 58 Lite 自定义保留 + Google Drive/payment 排除)
  • ✓ v8.11 合并上游 v0.11.17(Markdown 渲染 + PDF/CBZ 对比度 + TTS 高亮粒度 + 最近阅读书架 + foliate-js 自动更新)
  • ✓ v8.10.4 恢复跨设备视图设置同步(可选开关)
  • ✓ v8.10.3 登出隐藏全部书籍 + 移出分组不再踢出用户
  • ✓ v8.10.2 笔记导出链接绝对 URL + 用户管理折叠
  • ✓ v8.10.1 批量下载 per-URL Cookie/Headers 语法
  • ✓ v8.10 中文汉化 + 笔记链接手机修复 + 登出安全 + 阅读统计 + 下载记录折叠
  • ✓ v8.9 下载进度/速度/ETA/用时 + 完整日志 + 批量下载 + 自动重命名 + 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 —— 去除一切限制,只保留纯粹的阅读体验。