开源·自托管·专注阅读

二毛图书

属于你的数字图书馆

一个开源的读物管理与阅读工具,
把硬盘里的藏书,变成随手可读的
私人图书馆。

开源免费多端访问数据自主掌控

FEATURES

为热爱阅读的你而做

简洁、专注,打造真正属于你的数字图书馆。

多格式支持

电子书、PDF、漫画与有声书,
让不同格式的藏书各得其所。

书库管理

用标签、书架与阅读状态,
整理属于你的数字收藏。

多端同步

电脑与手机连接同一服务器,
接着上一次的进度继续阅读。

阅读与聆听

专注的阅读界面与有声书播放,
换一种方式,继续好故事。

个性化阅读

调整字体、显示与翻页方式,
找到适合自己的阅读节奏。

数据自主掌控

图书保存在自己的服务器中,
按你的习惯管理与备份。

Kindle 推送

配置邮件发送,将 EPUB、PDF
推送到 Kindle,随时沉浸阅读。

OPDS 书库

在兼容 OPDS 的阅读器中浏览、下载。
第三方阅读器进度不参与同步。

多客户端阅读

电脑、手机浏览器与 Android 客户端,
连接同一书库,自由选择阅读设备。

DEPLOY

轻松部署,快速开始

在自己的设备上,开启你的私人图书馆。

使用 Docker Compose 部署

将以下完整配置保存为 compose.yaml,也可直接下载文件。

# 二毛图书主程序的 Docker Compose 配置(不是官网的部署配置)。
# 来源:https://github.com/GMD170629/ermao-library#docker-安装
# 保存到部署目录;创建 library、data/storage,并确认容器用户有相应权限。
services:
  web:
    image: gamersgu/shuku-starship-web:prod
    restart: unless-stopped
    user: "${PUID:-1000}:${PGID:-1000}"
    environment:
      STORAGE_ROOT: /app/storage
      PORT: 3000
      HOSTNAME: 0.0.0.0
    ports:
      - "3000:3000"
    volumes:
      - ./data/storage:/app/storage
      - ./library:/libraries/books

保存后,在同一目录运行:

mkdir -p library data/storage
docker compose up -d
docker compose ps

先确认目录权限:默认容器 UID/GID 为 1000,可通过 PUID/PGID 调整;data/storage 需可读写,library 需可读取(上传时需可写)。启动后访问 http://服务器地址:3000,并添加 /libraries/books 为书库路径。

查看详细部署文档

查看全部发布版本

Docker

NAS / 家庭服务器

  • amd64 / arm64
  • 持久化保存书库数据
  • 更新与部署方式统一
ERMAO BOOKS

FAQ

常见问题

如果没有找到答案,欢迎在 GitHub 上提交 Issue。

前往 GitHub 提问
二毛图书是免费的吗?

二毛图书采用 MIT 许可证开源,你可以下载、部署和使用。服务器、NAS、存储,以及自行启用的第三方服务费用由使用者承担。

查看开源许可证
支持哪些电子书格式?

支持 EPUB、MOBI、AZW3、TXT 等电子书,PDF,CBZ / CBR、ZIP / RAR 漫画图片包,以及 M4B、MP3、FLAC 等有声书。导入支持不等于每台设备都能直接播放;带 DRM 的文件不支持,音频播放也受设备解码能力影响。

查看格式与使用说明
图书和阅读数据会上传到云端吗?

书库与阅读数据由你自己的 NAS 或家庭服务器保存。本官网不会连接或读取你的书库。使用外部元数据服务、邮件等可选集成时,可能产生相应的网络请求,具体取决于你的配置。重要数据仍建议自行定期备份。

如何参与项目开发?

欢迎在 GitHub 提交问题、改进建议和 Pull Request。开始较大的改动前,建议先通过 Issue 讨论方案。文档补充、体验反馈和问题复现,同样是很有价值的贡献。

前往 GitHub
遇到问题应该怎么办?

先查看使用文档和已有 Issue。仍无法解决时,请提交部署方式、版本、复现步骤及经过脱敏的日志。请不要公开账户密码、访问令牌或个人书库文件。

提交问题反馈

DOWNLOAD

选择你的阅读入口

客户端连接已部署的书库;首次使用可先安装 NAS 服务端。

Windows / macOS / Linux

用浏览器打开你的服务器地址即可阅读,无需安装桌面客户端。