BookHeaven/BookHeaven.Server

这是什么？

核心功能

• 01按作者、系列、合集和标签整理书籍
• 02编辑元数据和封面，修改会写回电子书文件
• 03从网络获取封面和元数据
• 04按配置记录阅读进度，并支持手动调整
• 05提供 /opds/v1 的 OPDS 接口并支持 KOReader 同步
• 06BookHeaven Reader 安卓应用可自动发现服务器

适用场景

• 在家庭服务器上托管个人电子书库，并在多台设备上阅读
• 为支持 OPDS 的电子阅读应用提供书目目录
• 在 KOReader 与中心服务器之间同步阅读进度
• 为阅读书籍的设备统一管理自定义字体

快速上手

1. 1

   从 GitHub Container Registry 拉取容器镜像

   docker pull ghcr.io/bookheaven/bookheaven-server:latest
2. 2

   使用 Docker run 启动服务器，映射网页端口和数据文件夹

   docker run -d --name bookheaven --user 1000:1000 -p 8080:8080 -p 27007:27007/udp -v $PWD/data:/app/data -v $PWD/import:/app/import -e SERVER_URL=https://bookheaven.yourdomain.tld ghcr.io/bookheaven/bookheaven-server:latest
3. 3

   在浏览器中打开端口 8080 的网页界面

使用前须知

• !不建议将数据文件夹存放在网络共享上，因为项目使用 SQLite，已知存在问题。

收录于专题

标签

常见问题

BookHeaven.Server 是什么？

自托管的电子书库管理网页服务，支持 OPDS、KOReader 同步及 BookHeaven 安卓阅读器接口。 BookHeaven Server 是一个网页应用，用于在自己的机器上管理和阅读电子书库。它可以按作者、系列和合集整理书籍，支持添加标签，并直接从电子书文件中读取元数据。修改书名、作者或封面后会写回文件，封面和元数据也可以从网上获取。

BookHeaven.Server 可以免费使用吗？用的什么许可证？

BookHeaven.Server 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

BookHeaven.Server 还在维护吗？

活跃维护中。BookHeaven.Server 最近一次提交是在 2026年11月5日。

BookHeaven.Server 适合用来做什么？

在家庭服务器上托管个人电子书库，并在多台设备上阅读 为支持 OPDS 的电子阅读应用提供书目目录 在 KOReader 与中心服务器之间同步阅读进度 为阅读书籍的设备统一管理自定义字体

BookHeaven.Server 怎么安装和运行？

从 GitHub Container Registry 拉取容器镜像: docker pull ghcr.io/bookheaven/bookheaven-server:latest 使用 Docker run 启动服务器，映射网页端口和数据文件夹: docker run -d --name bookheaven --user 1000:1000 -p 8080:8080 -p 27007:27007/udp -v $PWD/data:/app/data -v $PWD/import:/app/import -e SERVER_URL=https://bookheaven.yourdomain.tld ghcr.io/bookheaven/bookheaven-server:latest 在浏览器中打开端口 8080 的网页界面

在哪里获取 BookHeaven.Server？

源代码和安装说明在 GitHub 上：https://github.com/BookHeaven/BookHeaven.Server