fprint/calibre-web

fprint/calibre-web 镜像文档

镜像概述

本镜像基于 linuxserver/calibre-web 构建，核心特点是内置空的 metadata.db 数据库，用于解决初始配置中的常见问题。Calibre-Web 是一款轻量级电子书管理系统，支持电子书的上传、管理、阅读和分享，本镜像优化了部署流程，适用于多种硬件和操作系统环境。

核心功能与特性

• 内置数据库：预包含空的 metadata.db，避免初始配置时的数据库缺失问题
• 多平台支持：兼容群晖NAS（x86架构）、斐讯N1（armbian系统）、CentOS7及Windows10等环境
• 快速部署：简化配置流程，提供默认访问凭证，开箱即用
• 灵活挂载：支持自定义电子书存储目录和端口映射

使用场景

• 个人电子书库管理与阅读
• 家庭局域网内电子书共享
• 轻量级服务器电子书服务搭建

详细使用方法

1. 群晖Docker部署

前提条件

• 群晖NAS（需x86架构CPU）
• 已安装Docker套件

部署步骤

1. 打开Docker套件，进入「注册表」，搜索 fprint/calibre-web，双击第一个结果，选择 latest 标签下载镜像（建议白天下载以保证速度）
2. 镜像下载完成后，在「映像」中双击 fprint/calibre-web 开始容器设置
3. 端口设置：容器内部端口固定为 8083，外部端口可根据需求自定义（如 8080）
4. 目录设置：容器内部目录为 /books，外部目录需选择子目录（不要直接使用群晖一级共享文件夹，避免权限问题）
5. 完成设置后启动容器，在浏览器中访问 NAS的IP:外部端口（如 192.168.1.100:8080）
6. 首次访问会弹出配置界面，输入配置文件路径 /config 并提交
7. 使用默认凭证登录：用户名 admin，密码 admin123

2. 斐讯N1（armbian系统）部署

前提条件

• 已刷入armbian系统的斐讯N1设备

部署步骤

1. 更新系统并安装Docker：

   bash
   apt-get update
   apt-get install docker.io -y
   

2. 拉取适用于N1的镜像：

   bash
   docker pull fprint/calibre-web:N1
   

3. 运行容器（替换端口和目录）：

   bash
   docker run -ti -p [本地端口]:8083 -v [本地目录]:/books fprint/calibre-web:N1 /bin/bash
   

   • [本地端口]：自定义访问端口（如 8083）
   • [本地目录]：电子书存储路径（如 /home/books）
4. 在浏览器中访问 N1的IP:本地端口（如 192.168.1.101:8083）
5. 配置界面输入 /config 并提交，使用默认凭证 admin/admin123 登录

3. CentOS7部署

前提条件

• CentOS7系统，已配置网络

部署步骤

1. 更新系统并安装Docker：

   bash
   yum update
   yum install docker -y
   

2. 拉取镜像：

   bash
   docker pull fprint/calibre-web
   

3. 运行容器（替换端口和目录）：

   bash
   docker run -ti -p [本地端口]:8083 -v [本地目录]:/books fprint/calibre-web:latest /bin/bash
   

   • [本地端口]：自定义访问端口（如 80）
   • [本地目录]：电子书存储路径（如 /home/books）
4. 在浏览器中访问 CentOS7的IP:本地端口（如 192.168.1.102:80）
5. 配置界面输入 /config 并提交，使用默认凭证 admin/admin123 登录

4. Windows10部署

前提条件

• 已启用CPU虚拟化（需在BIOS中设置）
• 已安装Docker Desktop（确保切换为Linux容器模式）

部署步骤

1. 环境检查：
   • 若提示内存不足，右键点击任务栏Docker图标，进入「设置」→「资源」调低内存分配
   • 确认容器模式为「Linux容器」（非Windows容器）
2. 打开命令提示符（cmd），运行容器（替换端口和目录）：

   bash
   docker run -ti -p [本地端口]:8083 -v \~/books:/books fprint/calibre-web:latest /bin/bash
   

   • [本地端口]：自定义访问端口（如 80）
   • \~/books：可替换为本地实际目录（如 D:\books）
3. 在浏览器中访问 Windows10的IP:本地端口（如 192.168.1.103:80）
4. 配置界面输入 /config 并提交，使用默认凭证 admin/admin123 登录

注意事项

• 首次登录后建议立即修改默认密码（admin123）以保障安全
• 外部目录需确保有读写权限，避免文件操作失败
• 不同平台的镜像标签不同：群晖/CentOS7/Windows10使用 latest，斐讯N1使用 N1 标签