johngong/calibre-web Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

群晖NAS自用calibre-web方案

项目简介

本文介绍群晖NAS上通过Docker部署的calibre-web电子书管理方案，整合了ebook-convert格式转换工具及calibre-server服务，支持多架构（amd64/arm64v8/arm32v7）。

• 项目地址：GitHub
• 感谢上游项目：
  calibre-web、calibre

版本信息

版本升级注意事项

1. 功能冲突：0.6.22版本新增“下载时嵌入元数据”功能，可能导致calibre-server与calibre-web冲突。若需同时启用，需设置环境变量ENABLE_CALIBREDB_URLLIBRARYPATH=true。
2. 变量名变更：0.6.16-5.35.0及以后版本，变量名从USER/PASSWORD/WEBLANGUAGE改为CALIBRE_SERVER_USER/CALIBRE_SERVER_PASSWORD/CALIBRE_SERVER_WEB_LANGUAGE（详见下方“变量名变更表”）。
3. 中文目录支持：新版通过环境变量CALIBRE_ASCII_FILENAME=false开启中文目录（非拼音），旧版CN版需手动替换，替换前务必备份书库。
4. 自动添加图书：新增“自动添加图书”功能（配置autoaddbooks文件夹，图书添加后自动删除），使用前建议备份图书。
5. arm架构限制：arm版ebook-convert可能无法转换PDF格式；calibre-server的OPDS功能在arm设备上可能不可用。
6. 元数据搜索：0.6.16及以前版本未集成Google Scholar搜索；豆瓣搜索功能在0.6.18及以前需设置ENABLE_DOUBAN_SEARCH=true，0.6.16及以前需额外部署豆瓣API服务并配置DOUBANIP。

Docker命令行设置

变量名变更对照

操作步骤

1. 下载镜像

   镜像源	命令
   DockerHub	docker pull johngong/calibre-web:latest
   GitHub	docker pull ghcr.io/gshang2017/calibre-web:latest

2. 创建容器

   bash
   docker create  \
      --name=calibre-web  \
      -p 8083:8083  \
      -p 8080:8080  \
      -v /本地配置文件路径:/config  \
      -v /本地书库路径:/library  \
      -v /本地自动添加文件夹路径:/autoaddbooks  \
      -e UID=1000  \
      -e GID=1000  \
      -e CALIBRE_SERVER_USER=用户名  \
      -e CALIBRE_SERVER_PASSWORD=用户密码 \
      --restart unless-stopped  \
      johngong/calibre-web:latest
   

3. 运行容器：docker start calibre-web

4. 停止容器：docker stop calibre-web

5. 删除容器：docker rm calibre-web

6. 删除镜像：docker image rm johngong/calibre-web:latest

群晖Docker设置

1. 卷配置

2. 端口配置

3. 环境变量配置

其他说明

• calibre-server上传：配置用户名和密码后，可通过calibre-server上传图书。
• PDF字体设置：转换PDF时需字体支持，将字体文件复制到/config/fonts（旧版为/config/calibre-server/calibrefonts），重启容器即可生效。
• 多语言支持：
  • calibre-web支持语言：en/cs/de/es/fr/zh_Hans_CN/zh_Hant_TW等（通过CALIBRE_WEB_LANGUAGE设置）。
  • calibre-server支持语言：en/zh_CN/ja/ko等（通过CALIBRE_SERVER_WEB_LANGUAGE设置）。