Calibre-Web 群晖 Container Manager 部署教程)

适用：DSM7 + Container Manager，独立电子书书库网页管理，阅读、元信息管理。 说明：本教程不使用 PUID/PGID，规避群晖UID不匹配权限报错；不预装calibre转换模块，优先保证服务稳定启动。

# Calibre-Web 群晖 Container Manager 部署记录
## 简介
Calibre‑Web：Calibre电子书库的Web前端，浏览器直接浏览、阅读、管理EPUB/PDF等电子书，不需要安装Calibre客户端。
> 本次部署：不带Calibre格式转换引擎，优先保证快速稳定运行；如需格式转换可后续单独重建容器。

## 一、前置准备（群晖操作：File Station）
### 1. 创建目录
进入 `/volume1/docker/`
新建文件夹：`calibre-web`
在 `calibre-web` 内部新建2个子文件夹：
- `config`：存放Calibre‑Web程序配置
- `books`：Calibre书库目录（metadata.db + 全部电子书文件夹都放这里）

> 目录完整路径：
> - /volume1/docker/calibre-web/config
> - /volume1/docker/calibre-web/books

### 2. 准备Calibre书库文件
1. 在电脑本地使用Calibre软件新建书库，至少添加1本电子书。
2. 电脑Calibre书库目录内包含：`metadata.db` + 以作者命名的书籍文件夹。
3. **全部文件一起上传**到群晖 `/volume1/docker/calibre-web/books`
> ❗重要：不能只单独上传metadata.db，缺少书籍文件夹会导致配置反复弹窗。

### 3. 设置文件夹权限
File Station右键 `calibre-web` 文件夹 → 属性 → 权限
新增 `everyone` 用户，给予**读写权限**，勾选「应用到所有子文件夹和文件」。
> 临时规避权限问题，部署稳定后可按需收紧权限。

## 二、Container Manager 创建项目
1. 打开群晖【Container Manager】→【项目】→【创建】
2. 项目名称：`calibre-web`（自定义，建议小写）
3. 源：选择「编写docker-compose.yml」
4. 粘贴下面完整 compose 代码：
```yaml
services:
  calibre-web:
    image: lscr.io/linuxserver/calibre-web:latest
    container_name: calibre-web
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - /volume1/docker/calibre-web/config:/config
      - /volume1/docker/calibre-web/books:/books
    ports:
      - "8084:8083"
    restart: unless-stopped
  1. 点击【下一步】→【完成】，容器自动拉取镜像并启动。

端口说明：宿主机 8084，容器内部固定8083，确认群晖8084端口无占用。

三、首次初始化网页配置

  1. 浏览器访问地址：[http://192.168.0.51:8084](http://192.168.0.51:8084)（替换成你群晖内网IP）
  2. 默认账号：admin，默认密码：admin123
  3. 进入【数据库配置】页面：
    • Calibre数据库的位置输入框填写：/books/metadata.db
    • 两个复选框【图书馆的独立书籍文件】、【用Google Drive?】全部不勾选
    • 点击【保存】
  4. 成功：页面加载出书库列表，显示你上传的电子书； 失败：反复跳回数据库配置页面 → 检查两点：① books目录内metadata.db+书籍文件夹完整；② 文件夹读写权限。

四、基础安全与功能设置（必做）

进入网页后台【管理】

  1. 用户管理：修改admin默认密码，提升安全性。
  2. 基本配置：
    • 语言设置：zh_CN，保存刷新页面，切换中文界面。
    • 可选：勾选【允许上传书籍】，开启网页端直接上传电子书入库。

五、后续电子书添加方法

方法1（推荐）：电脑Calibre新增书籍 → 将电脑书库全部文件覆盖上传NAS books目录，刷新Calibre‑Web网页即可识别。 方法2：网页上传（开启上传权限后），网页直接上传EPUB/PDF。

六、常见问题

  1. 容器启动成功，网页打不开
    • 排查端口映射："8084:8083"，不能写反；确认宿主机8084端口没有被其他Docker占用。
  2. 保存数据库配置反复弹窗
    • 90%原因：books文件夹只有metadata.db，缺少电子书实体文件夹；其次是文件夹权限不足。
  3. 想启用电子书格式转换

    当前compose未加载calibre主程序，网页无格式转换。如需转换，需要增加DOCKER_MODS=linuxserver/mods:universal-calibre环境变量，重建容器；缺点：首次启动下载mod较慢，等待时间长。

使用方法

  1. 全选上面整块内容复制
  2. 电脑新建文本文档，粘贴进去
  3. 文件另存为，文件名填写 calibre-web.md，编码选 UTF-8，保存。

    可以用 Typora、Obsidian 打开浏览，也直接上传到你的BBS做学习备份。