# book_init

**Repository Path**: alg037/bookinitialization

## Basic Information

- **Project Name**: book_init
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-24
- **Last Updated**: 2026-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# calibre-web 一键部署

基于 Docker 的 calibre-web 一键部署方案，使用 `johngong/calibre-web` 镜像，适用于 Ubuntu/Debian 系统。

## 📋 目录

- [项目简介](#项目简介)
- [环境要求](#环境要求)
- [快速开始](#快速开始)
- [脚本说明](#脚本说明)
- [手动部署](#手动部署)
- [配置详解](#配置详解)
- [常见问题](#常见问题)
- [常用命令](#常用命令)

---

## 项目简介

[calibre-web](https://github.com/janeczku/calibre-web) 是一个基于 Calibre 的 Web 电子书管理应用，提供美观的 Web 界面用于管理和阅读电子书。本项目使用 Docker 容器化部署，支持：

- 🚀 一键部署，无需手动配置
- 📂 数据持久化，不丢失书库数据
- 🔄 容器自动重启，系统重启后自动启动
- 🎨 美观的 Web 管理界面
- 📱 支持多种设备访问

## 环境要求

| 组件 | 要求 |
|------|------|
| 操作系统 | Ubuntu 18.04+ / Debian 10+ |
| 架构 | x86_64 / ARM64 |
| 磁盘空间 | 至少 1GB（镜像 + 数据） |
| 内存 | 至少 512MB |

> **注意**: 脚本会自动安装 Docker（如未安装），需要 root 或 sudo 权限。

## 快速开始

### 1. 下载脚本

```bash
# 克隆仓库
git clone https://github.com/yourusername/calibre_deploy.git
cd calibre_deploy

# 或直接下载脚本
wget https://raw.githubusercontent.com/yourusername/calibre_deploy/main/deploy.sh
```

### 2. 添加执行权限

```bash
chmod +x deploy.sh
```

### 3. 一键部署

```bash
# 使用 root 用户
sudo ./deploy.sh
```

### 4. 访问使用

部署完成后，打开浏览器访问：

```
http://your-server-ip:8083
```

**默认登录信息**:

| 用户名 | 密码 |
|--------|------|
| admin | admin123 |

> ⚠️ **安全提醒**: 首次登录后请立即修改默认密码！

## 脚本说明

### 部署流程

`deploy.sh` 脚本按以下步骤自动完成部署：

```
Step 1: 检查 Docker 环境           → 检测并自动安装 Docker
Step 2: 创建数据持久化目录         → 创建 config/library/books 目录
Step 3: 拉取 Docker 镜像           → 拉取 johngong/calibre-web:latest
Step 4: 清理旧容器                 → 停止并删除同名容器（如有）
Step 5: 启动新容器                 → 配置端口映射、目录挂载、时区
Step 6: 验证容器运行状态           → 确认容器正常启动
Step 7: 配置开机自启               → 设置 Docker 及容器自启策略
```

### 配置项说明

脚本顶部的配置区可按需修改：

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `CALIBRE_WEB_PORT` | `8083` | Web 访问端口 |
| `CALIBRE_WEB_BASE_DIR` | `/opt/calibre-web` | 数据持久化根目录 |
| `CALIBRE_WEB_CONFIG_DIR` | `{BASE_DIR}/config` | 配置文件目录 |
| `CALIBRE_WEB_LIBRARY_DIR` | `{BASE_DIR}/library` | 书库数据目录 |
| `CALIBRE_WEB_BOOKS_DIR` | `{BASE_DIR}/books` | 书籍导入目录 |
| `CALIBRE_WEB_CONTAINER_NAME` | `calibre-web` | Docker 容器名称 |
| `CALIBRE_WEB_IMAGE` | `johngong/calibre-web:latest` | Docker 镜像 |

### 自定义部署示例

如需修改配置，直接编辑 `deploy.sh` 顶部的配置区：

```bash
# 例如修改端口为 8080，数据目录改为 /data/calibre
CALIBRE_WEB_PORT=8080
CALIBRE_WEB_BASE_DIR="/data/calibre-web"
```

然后重新执行 `sudo ./deploy.sh` 即可。

## 手动部署

如果想手动部署，可执行以下命令：

```bash
# 1. 拉取镜像
docker pull johngong/calibre-web:latest

# 2. 创建数据目录
sudo mkdir -p /opt/calibre-web/{config,library,books}

# 3. 启动容器
docker run -d \
    --name calibre-web \
    --hostname calibre-web \
    -p 8083:8083 \
    -v /opt/calibre-web/config:/config \
    -v /opt/calibre-web/library:/library \
    -v /opt/calibre-web/books:/books \
    -e TZ=Asia/Shanghai \
    -e PUID=$(id -u) \
    -e PGID=$(id -g) \
    --restart unless-stopped \
    johngong/calibre-web:latest
```

## 配置详解

### 目录结构

```
/opt/calibre-web/
├── config/          # 配置文件（calibre-web 配置、数据库等）
├── library/         # 书库目录（Calibre metadata.db 所在目录）
└── books/           # 书籍导入目录（将电子书放入此目录，然后在后台导入）
```

### 容器参数

| 参数 | 说明 |
|------|------|
| `--restart unless-stopped` | 容器退出时自动重启（除非手动停止） |
| `-e TZ=Asia/Shanghai` | 设置时区为东八区 |
| `-e PUID/PGID` | 设置容器内用户 UID/GID，与宿主机一致 |
| `-v` 目录映射 | 将容器内目录持久化到宿主机 |

### 端口映射

| 宿主机端口 | 容器端口 | 说明 |
|-----------|---------|------|
| 8083 | 8083 | calibre-web Web 管理界面 |

> **提示**: 如需修改端口，编辑脚本中的 `CALIBRE_WEB_PORT` 变量，或直接在手动部署命令中修改 `-p` 参数（例如 `-p 8888:8083`）。

## 常见问题

### Q: 如何查看日志？

```bash
docker logs -f calibre-web
```

### Q: 如何更新到最新版本？

```bash
# 重新执行部署脚本即可（会自动拉取最新镜像）
sudo ./deploy.sh

# 或手动更新
docker stop calibre-web
docker rm calibre-web
docker pull johngong/calibre-web:latest
docker run -d \
    --name calibre-web \
    --hostname calibre-web \
    -p 8083:8083 \
    -v /opt/calibre-web/config:/config \
    -v /opt/calibre-web/library:/library \
    -v /opt/calibre-web/books:/books \
    -e TZ=Asia/Shanghai \
    -e PUID=$(id -u) \
    -e PGID=$(id -g) \
    --restart unless-stopped \
    johngong/calibre-web:latest
```

### Q: 容器启动失败怎么办？

```bash
# 1. 查看详细日志
docker logs calibre-web

# 2. 确认端口是否被占用
sudo lsof -i :8083

# 3. 确认目录权限
ls -la /opt/calibre-web/
```

### Q: 如何备份数据？

```bash
# 备份整个数据目录
sudo tar -czf calibre-web-backup-$(date +%Y%m%d).tar.gz /opt/calibre-web/

# 恢复备份
sudo tar -xzf calibre-web-backup-20240101.tar.gz -C /
```

### Q: 如何修改默认管理员密码？

登录 calibre-web 后，点击右上角用户头像 → **设置** → **用户配置** 中进行修改。

### Q: 如何导入电子书？

1. 将电子书（epub、mobi、pdf 等格式）放入导入目录 `\`/opt/calibre-web/books/\``
2. 登录 calibre-web 后台
3. 点击右上角 **书籍上传** 图标或进入 **设置 → 导入书籍**
4. 选择要导入的书籍文件

## 常用命令

### Docker 容器管理

```bash
# 查看容器状态
docker ps -a | grep calibre-web

# 启动容器
docker start calibre-web

# 停止容器
docker stop calibre-web

# 重启容器
docker restart calibre-web

# 查看实时日志
docker logs -f calibre-web

# 进入容器内部
docker exec -it calibre-web /bin/sh
```

### 系统维护

```bash
# 查看运行中的容器
docker ps

# 查看所有容器
docker ps -a

# 查看 Docker 磁盘使用
docker system df

# 清理未使用的 Docker 资源
docker system prune -f
```

---

## 📝 许可证

本项目仅供学习和参考使用。

## 更新日志

### v1.0.0 (2024-01)

- 初始版本发布
- 实现 calibre-web Docker 一键部署
- 支持数据持久化
- 支持开机自启