NAS上通过Docker部署Talebook个人书库

基于 Calibre 的自建书库方案，使用 Docker 部署，支持豆瓣读书 API 自动刮削封面和简介。

简介

Talebook 是基于 Calibre 的电子书管理系统，前端界面美观，数据管理简单。适合在 NAS 上通过 Docker 部署，搭建个人书库。

部署步骤

1. 准备 Docker 环境

确保 NAS 已安装 Docker 和 Docker Compose。建议使用带有图形界面的 NAS 系统（如群晖）。

2. 配置 docker-compose.yml

version: "2.4" services: # main service talebook: restart: always image: talebook/talebook volumes: - /volume2/BOOK:/data ports: - "8765:80" - "8443:443" environment: - PUID=1000 - PGID=1000 - TZ=Asia/Shanghai # 调整为『SSR=ON』可开启「服务器端渲染」模式 # 对于搜索引擎更友好，同时更消耗服务器性能 - SSR=OFF depends_on: - douban-rs-api # optional, for meta plugins # please set "http://douban-rs-api" in settings douban-rs-api: restart: always image: ghcr.io/cxfksword/douban-api-rs ports: - "8766:80"

3. 关键配置说明

配置项 说明 volumes /volume2/BOOK:/data 书籍存储目录，前者为宿主机路径 ports 8765:80 Web 访问端口 ports 8766:80 豆瓣 API 端口，必须映射否则无法使用

⚠️ 注意：豆瓣 API 服务的 80 端口必须映射出来（8766:80），否则无法正常使用豆瓣刮削功能。

4. 启动服务

docker-compose up -d

豆瓣 API 配置

为什么要配置豆瓣 API

Talebook 自带豆瓣读书 API，可以自动刮削书籍的封面、简介、作者等信息。如果不配置豆瓣 API，这些信息需要手动添加，非常麻烦。

配置步骤

1. 打开 Talebook 管理界面，进入「设置」

2. 找到「元数据获取」或「书籍信息」相关配置

3. 在豆瓣 API 地址处填写：http://[NAS内网IP]:8766

验证配置

添加新书后，进入书籍详情页，点击「获取元数据」，系统会自动搜索豆瓣上的书籍信息。

选择匹配度最高的书籍，点击「设置」，即可自动填充封面和简介。

效果展示

常见问题

容器体积大

Talebook 容器镜像约 2.2GB，这是因为包含了完整的 Calibre 引擎和依赖。

豆瓣 API 无法连接

检查以下几点：

1. 确保豆瓣 API 容器已启动

2. 确保 8766:80 端口已正确映射

3. 确保在 Talebook 设置中填写了正确的 API 地址（内网 IP + 端口）

书籍无法显示

检查数据目录权限，确保 PUID/PGID 与宿主机的用户匹配。

相关资源

• Talebook 官方仓库：https://github.com/talebook/talebook

• 豆瓣 API 项目：https://github.com/cxfksword/douban-api-rs

作者提示含AI生成内容。作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～