当前位置：首页 > news >正文

电子书管理与阅读平台BookHeaven

news 2025/10/4 6:57:07

在这里插入图片描述

简介

什么是 BookHeaven ？

BookHeaven 包含了 Server 和 Reader 两部分，其中 Server 是一个旨在提供便捷方式来管理和阅读个人电子书库的服务器应用。它允许您将书籍按作者和系列进行组织，并添加标签进行筛选。您还可以统一管理字体，方便阅读设备下载使用。目前支持 epub 和 PDF 格式。

老苏之前介绍过 EPUB 阅读器 BookHaven，和我们今天的 BookHeaven 就差一个字母

文章传送门：BookHaven：一个现代化的浏览器端EPUB阅读器

主要特点

💻现代化UI：拥有一个现代化且响应迅速的用户界面。
🔍自动发现：客户端应用程序可以自动发现服务器，无需手动配置 IP 地址。
🏷️元数据处理：能从电子书文件本身读取元数据（如标题、作者），并允许用户随时编辑。所有更改（包括封面）都会被保存回文件。
☁️元数据获取：可以从互联网上抓取书籍的封面和元数据。
🕙进度跟踪：自动跟踪书籍的阅读进度，也支持手动设置。包括开始/结束日期、阅读时长、百分比等。
🅰️字体管理：您可以上传并配置字体，供所有阅读设备轻松下载和使用。
👥多用户支持：可以创建多个用户档案，以隔离不同用户的阅读数据。
📖OPDS 支持：内置 OPDS 服务，方便与支持 OPDS 的阅读器（如KOReader）集成。访问地址为 http://服务器IP:端口/opds。

应用场景

为个人或家庭打造一个集中的云端书库。
通过 OPDS 协议，将书库接入各种电子书阅读器。
跨设备同步和跟踪阅读进度。

总之，BookHeaven 是一个功能丰富、灵活且易于使用的电子书管理工具，适合各种用户需求。

在群晖上安装

在群晖上以 Docker 方式安装。

本文写作时， latest 版本对应为 0.13.0；

Docker CLI 安装

# 新建文件夹 bookheaven 和 子目录
mkdir -p /volume1/docker/bookheaven/{data,import}# 进入 bookheaven 目录
cd /volume1/docker/bookheaven# 修改目录权限
chmod a+rw data# 运行容器
docker run -d \--name bookheaven \--restart unless-stopped \--user 1000:1000 \-p 8327:8080 \-p 27007:27007/udp \-v $(pwd)/data:/app/data \-v $(pwd)/import:/app/import \-e SERVER_URL='http://<你的群晖IP>:8327' \-e TZ='Asia/Shanghai' \ghcr.io/bookheaven/bookheaven-server:latest

客户端不强制使用 https，所以 SERVER_URL 可以使用局域网地址；

Docker Compose

将下面的内容保存为 docker-compose.yml 文件。

services:bookheaven:image: ghcr.io/bookheaven/bookheaven-server:latestcontainer_name: bookheavenvolumes:# point the /app/data path to a persistent location on your host# this is where all your books, covers, fonts, etc will be stored# make sure the user running the container down below has read and write permissions to this folder- ./data:/app/data# optional: if you want to import books by copying them directly into a folder on your host- ./import:/app/importports:# web ui- 8327:8080# optional: required for auto discovery, changing the default port is not supported for now since it's hardcoded in the client- 27007:27007/udpenvironment:# optional: required for auto discovery, change to your desired domain or ip:port, including the protocol (http or https)- SERVER_URL=http://192.168.0.197:8327- TZ=Asia/Shanghaiuser: 1000:1000restart: unless-stopped

然后通过 SSH 登录到您的群晖，执行下面的命令：

# 新建文件夹 bookheaven 和 子目录
mkdir -p /volume1/docker/bookheaven/{data,import}# 进入 bookheaven 目录
cd /volume1/docker/bookheaven# 修改目录权限
chmod a+rw data# 将 docker-compose.yml 放入当前目录# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:8327 就能看到 BookHeaven 的界面

点 + 号开始创建个人资料，需要输入姓名

会显示在左侧菜单

似乎只支持 epub 和 pdf 格式，而且也不支持批量

随便上传了几本用于测试

选中一本

可以下载和编辑，但是不支持网页端阅读

客户端

如果你有一个安卓电子阅读器，可以通过客户端应用，连接到您的服务器并轻松下载和阅读您的所有书籍。

不仅如此，它还会跟踪您每本书的进度和阅读时间，可以随时手动同步到您的服务器。

常规使用完全不需要连接，因此您可以节省宝贵的电池寿命。

Android 客户端下载地址： https://github.com/BookHeaven/BookHeaven.Reader/releases

局域网中会自动识别服务器地址，除非你设置不正确，导致连不上。安装完成后默认 Local 是空的

切换到 Server 选一本书，点 下载 按钮下载

再切回到 Local，就有我们刚才下载的书了

右上角支持 Backup profile 和 Sync Process

参考文档

BookHeaven/BookHeaven.Server: Official BookHeaven Server web app to manage your ebook library.
地址：https://github.com/BookHeaven/BookHeaven.Server

BookHeaven/BookHeaven.Reader: Official BookHeaven reader app. Developed for Android e-ink readers (although it can work on any Android device), it connects to your BookHeaven Server instance to download ebooks, fonts and sync reading progress.
地址：https://github.com/BookHeaven/BookHeaven.Reader