datahearth/calibre-web

快速参考

• 维护者：https://github.com/datahearth
• 获取帮助：https://github.com/datahearth/calibre-web-docker/issues

支持的标签及对应Dockerfile链接

• latest
• 0.6.24

什么是Calibre-Web？

Calibre-Web是一个Web应用，提供干净的界面用于浏览、阅读和下载使用现有Calibre数据库的电子书。此镜像包含Calibre二进制文件（用于元数据提取和电子书转换功能）以及ImageMagick（用于图像处理）。

为什么使用此镜像？

• 官方分发版本：基于Calibre-Web官方发布版本构建
• 完整解决方案：开箱即含Calibre二进制文件和ImageMagick
• 自动更新：当Calibre-Web发布新版本时自动构建
• 生产就绪：包含所有必要依赖以实现完整功能

如何使用此镜像

简单使用

bash
docker run -d \
  --name calibre-web \
  -p 8083:8083 \
  -v /path/to/calibre/library:/books \
  -v /path/to/config:/config \
  datahearth/calibre-web:latest

Docker Compose

yaml
version: "3.8"
services:
  calibre-web:
    image: datahearth/calibre-web:latest
    container_name: calibre-web
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - /path/to/calibre/library:/books
      - /path/to/config:/config
    ports:
      - 8083:8083
    restart: unless-stopped

配置

环境变量

卷

初始设置

1. 使用上述任一方法启动容器
2. 通过http://your-ip:8083访问Web界面
3. 默认登录凭据：
   • 用户名：admin
   • 密码：admin123
4. 进入管理面板，将库位置设置为/books

更新

要更新到最新版本：

bash
docker pull datahearth/calibre-web:latest
docker stop calibre-web
docker rm calibre-web
# 使用您偏好的方法重新运行容器

健康检查

此镜像包含健康检查，用于验证Web界面是否正常响应。健康检查：

• 每30秒运行一次
• 超时时间为3秒
• 允许3次重试后标记为不健康

故障排除

权限问题

如果遇到权限问题，请确保PUID和PGID与您的用户匹配：

bash
id $USER  # 在主机上运行此命令获取您的UID和GID

转换问题

如果书籍转换功能无法正常工作：

1. 验证Calibre-Web设置中Calibre二进制文件是否正确配置
2. 检查日志中是否有Python或依赖项错误
3. 确保容器有足够的资源

本地构建

bash
git clone https://github.com/datahearth/calibre-web-docker.git
cd calibre-web-docker
docker build -t calibre-web .

许可证

此镜像采用MIT许可证。但Calibre-Web及其依赖项有各自的许可证：

• Calibre-Web：GPL-3.0
• Calibre：GPL-3.0
• ImageMagick：ImageMagick License

支持的架构

• amd64
• arm64

镜像变体

• latest：最新稳定版本
• VERSION：特定版本发布

贡献

我们欢迎贡献！详情请访问我们的https://github.com/datahearth/calibre-web-docker%E3%80%82