Readest-Lite-NodeByte

Readest-Lite
轻量自部署,阅读无界

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 部署,数据完全自主。

  • 持续迭代更新
  • 专业技术开发
永久开源,终身免费发现错误issue提交,我们会尽快修复
NodeByteNodeByte

功能特点

核心功能

保留原版 + 自部署增强

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

核心阅读能力

📚

多格式阅读

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

🖥

分屏阅读

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

🎤

TTS 朗读

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

云端同步

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

无限批注与导出

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

🗃

实际无上限存储

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

自部署增强

v7.0 · v8.0 · ... · v8.15 新增
👥

多用户管理

管理员可创建普通用户,分配存储与翻译配额。v8.4:Per-user 加密 vault,跨账号彻底隔离。v8.5:配额真正 enforce,超额上传/翻译被拒绝。

📥

远程下载

书库点「导入」→「Download from URL」。v8.6:任务队列,有进度/状态/重试。v8.8:分块上传,大文件不再被 Cloudflare 524 超时打断。

🌐

翻译词典代理

Google 翻译、Wikipedia、Wiktionary 全部走服务器代理,客户端无需加速器。v8.5:SSRF 黑名单

📚

原版词典悬浮窗

选中文字点「Dictionary」弹悬浮窗显示查询结果,保留原版 Readest 完整体验。

🔊

Edge TTS

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

🔤

字体本地化

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

疑难解答

01启动后无法访问?docker ps 确认容器状态为 Up curl http://localhost:8225 在服务器本地测试 检查防火墙:sudo ufw allow 8225 docker logs readest-lite 查看错误日志
02如何修改密码?修改 .env 中的 ADMIN_PASSWORD,然后 docker compose down && docker compose up -d。
03如何换端口?修改 docker-compose.yml 端口映射:"9000:8225"(左边是对外端口)。
04切换账号后,原来账号的书会泄露吗?v8.3 起不会。登出时系统会彻底清空当前账号的: 书库列表(library.json 覆盖为空) 同步游标(lastSyncedAtBooks/Configs/Notes 重置为 0) 第三方服务凭据(WebDAV/KOSync/Readwise/Hardcover/AI 全部重置) App Lock PIN(清空) 上传/下载队列(清空) 登录新账号后,系统走全量 pull(since=0),只拉取新账号的云端书。本地 Books/ 目录下的书籍文件保留(不删),但不会出现在新账号的书库列表里——除非新账号的云端也有同 hash 的书。 未登录时导入的书:如果你没登录就导入了书,登录账号后这些书会自动同步到当前登录的账号(不会被清空)。
05书籍存在哪里?data/books/uploads/ 存书籍原文,data/books/covers/ 存封面图,容器重建不丢失。
06支持多用户吗?支持!管理员登录后在「用户中心」可以看到「用户管理」面板,可以创建普通用户、设置用户名密码、分配存储和翻译配额。普通用户登录后只能看到自己的账号信息,没有管理权限。
07如何使用远程下载?在书库页面点击「导入」→「Download from URL」,输入书籍直链地址(如 https://example.com/book.epub)。v8.1 修复了书架不显示问题:下载完成后服务器同时写入 Book 表,新书会出现在书库中,多端 sync 同步可见。
08翻译和词典需要登录吗?v8.0 起所有翻译/词典代理强制要求登录,包括: /api/translate/google(Google 翻译) /api/proxy/wiki(Wikipedia / Wiktionary 词典查询) /api/proxy/resource(通用资源代理) /api/deepl/translate(DeepL,本就强制登录) 未登录调用返回 401。客户端无需加速器:只要服务器能访问 Google,前端通过代理就能用。
09v8.2 代理开关怎么用?登录后进入「设置 → Integrations → Network」,有「Server Proxy」开关: 开启(默认):翻译/词典走服务器代理,客户端无需加速器 关闭:客户端直连 Google/Wikipedia 等目标 URL,需要客户端本地网络能访问这些站点(例如客户端在国外网络或自备加速器) 注意:Edge TTS 不受此开关影响(始终保持 wss 直连 + https 代理降级行为)。DeepL 也不受影响(API key 在服务器,必须走代理)。
10100TB 配额是硬限制吗?不是。100TB 是前端展示用的软上限,实际不强制执行——上传代码不查配额,真正的限制只有宿主机磁盘空间。管理员在用户管理面板设置的 storageQuotaMB 字段当前为展示型(v8.3 计划补上 enforce 逻辑)。
11翻译和词典需要加速器吗?不需要(代理开启时)。Google 翻译、Wikipedia、Wiktionary 都通过服务器代理访问。只要服务器能访问 Google(如国外 VPS),客户端无需加速器即可使用。如果关了代理开关,客户端需要自己能访问这些站点。
12如何启用 DeepL 翻译?在 .env 中设置 DEEPL_ENABLED=true 和 DEEPL_FREE_API_KEYS 或 DEEPL_PRO_API_KEYS,重启容器即可。
13如何迁移数据?直接复制整个 data/ 目录到新服务器,用相同参数启动容器即可。SQLite 文件可跨平台使用。

去提交错误

我们会尽快修复,感谢您的支持!

提交Bug