# 管理和阅读书籍


<!--more-->



## Calibre客户端使用指南

### txt文件乱码

{{< image src="/images/guides/管理和阅读书籍/1.png" caption="(`图1`)" >}}

{{< image src="/images/guides/管理和阅读书籍/2.png" caption="(`图2`)" >}}


### 转换书籍

{{< image src="/images/guides/管理和阅读书籍/3.png" caption="(`图3`)" >}}

{{< image src="/images/guides/管理和阅读书籍/4.png" caption="(`图4`)" >}}

{{< image src="/images/guides/管理和阅读书籍/5.png" caption="(`图5`)" >}}

{{< image src="/images/guides/管理和阅读书籍/6.png" caption="(`图6`)" >}}

{{< image src="/images/guides/管理和阅读书籍/7.png" caption="(`图7`)" >}}

{{< image src="/images/guides/管理和阅读书籍/8.png" caption="(`图8`)" >}}

{{< image src="/images/guides/管理和阅读书籍/9.png" caption="(`图9`)" >}}

{{< image src="/images/guides/管理和阅读书籍/10.png" caption="(`图10`)" >}}

<br>

``` css {data-open=false,title="少数派样式"}
/* Sspai Web Theme A theme to [sspai](ssp.ai) default theme. Developed by Codegass(wchweichenhao@gmail.com) & Yves(yves@sspai.com) Download Cuto on the App Store and Google Play! */

body {
    font-size: 15px;
    color: #333;
    background: #fff;
    font-family: Helvetica, Arial, "PingFang SC", "Microsoft YaHei", "WenQuanYi Micro Hei", Tahoma, sans-serif;
    margin: 0;
    padding: 10%;
}
h1 {
    font-size: 2.2em;
    font-weight: 700;
    line-height: 1.1;
    padding-top: 16px;
    margin-bottom: 4px;
}
h2, h3, h4, h5, h6 {
    line-height: 1.5em;
    margin-top: 2.2em;
    margin-bottom: 4px;
}
h2 {
    font-size: 1.4em;
    margin: 40px 10px 20px 0;
    padding-left: 9px;
    border-left: 6px solid #ff7e79;
    font-weight: 700;
    line-height: 1.4;
}
h3 {
    font-weight: 700;
    font-size: 1.2em;
    line-height: 1.4;
    margin: 10px 0 5px;
    padding-top: 10px;
}
h4 {
    font-weight: 700;
    text-transform: uppercase;
    font-size: 1.1em;
    line-height: 1.4;
    margin: 10px 0 5px;
    padding-top: 10px;
}
h5, h6 {
    font-size: .9em;
}
h5 {
    font-weight: bold;
    text-transform: uppercase;
}
h6 {
    font-weight: normal;
    color: #AAA;
}
img {
    width: 100%;
    border-radius: 5px;
    display: block;
    margin-bottom: 15px;
    height: auto;
}
dl, ol, ul {
    margin-top: 12px;
    margin-bottom: 20px;
    padding-left: 5%;
    line-height: 1.8;
}
p {
    margin: 0 0 20px;
    padding: 0;
    line-height: 1.8;
}
a {
    color: #f22f27;
    text-decoration: none;
}
a:hover {
    color: #f55852;
    text-decoration: underline;
}
a:focus {
    outline-offset: -2px;
}
blockquote {
    font-size: 1em;
    font-style: normal;
    padding: 30px 38px;
    margin: 0 0 15px;
    position: relative;
    line-height: 1.8;
    text-indent: 0;
    border: none;
    color: #888;
}
blockquote:before {
    content: "“";
    left: 12px;
    top: 0;
    color: #E0E0E0;
    font-size: 4em;
    font-family: Arial, serif;
    line-height: 1em;
    font-weight: 700;
    position: absolute;
}
blockquote:after {
    content: "”";
    right: 12px;
    bottom: -31px;
    color: #E0E0E0;
    font-size: 4em;
    font-family: Arial, serif;
    line-height: 1em;
    font-weight: 700;
    position: absolute;
}
strong, dfn {
    font-weight: 700;
}
em, dfn {
    font-style: italic;
    font-weight: 400;
}
del {
    text-decoration: line-through;
}
pre {
    margin: 0 0 10px;
    font-size: 13px;
    line-height: 1.42857;
    word-break: break-all;
    word-wrap: break-word;
    border-radius: 4px;
    white-space: pre-wrap;
    display: block;
    background: #f8f8f8;
    padding: 10px 20px;
    border: none;
    margin-bottom: 25px;
    color: #666;
    font-family: Courier, sans-serif;
}
code {
    color: #c7254e;
    background-color: #f9f2f4;
    border-radius: 4px;
    font-family: Menlo, Monaco, Consolas, "Courier New", monospace;
    padding: 2px 4px;
    font-size: 90%;
}
p>code {
    color: #c7264e;
    background-color: #f9f2f4;
    font-size: .95em;
    border-radius: 3px;
}
figure {
    margin: 1em 0;
}
figcaption {
    font-size: 0.75em;
    padding: 0.5em 2em;
    margin-bottom: 2em;
}
figure img {
    margin-bottom: 0px;
}
hr {
    margin-top: 20px;
    margin-bottom: 20px;
    border: 0;
    border-top: 1px solid #eee;
}
ol p, ul p {
    margin-bottom: 0px;
}
li {
    margin-bottom: 0.75em;
    margin-top: 0.75em;
}
ol#footnotes {
    font-size: 0.95em;
    padding-top: 1em;
    margin-top: 1em;
    margin-left: 0;
    border-top: 1px solid #eaeaea;
    counter-reset: footer-counter;
    list-style: none;
    color: #555;
    padding-left: 5%;
    margin: 20px 0;
}
ol#footnotes li {
    margin-bottom: 10px;
    margin-left: 16px;
    font-weight: 400;
    line-height: 2;
    list-style-type: none;
}
ol#footnotes li:before {
    content: counter(footer-counter) ". ";
    counter-increment: footer-counter;
    font-weight: 800;
    font-size: .95em;
}
@keyframes highfade {
    0% {
        background-color: none;
    }
    20% {
        background-color: yellow;
    }
    100% {
        background-color: none;
    }
}
a:target, ol#footnotes li:target, sup a:target {
    animation-name: highfade;
    animation-duration: 2s;
    animation-iteration-count: 1;
    animation-timing-function: ease-in-out;
}
a:target {
    border: 0;
    outline: 0;
}
```

<br>

``` md {data-open=true,title="目录结构检测正则表达式"}
//*[re:test(., "^\s*[第卷][0123456789一二三四五六七八九十零〇百千两]*[章回幕部节集卷].*", "i")]
```


### 编辑元数据

``` html {title="html格式的目录"}
<div style="line-height: 1.4; margin: 0; padding: 0;">
  这是第一行简介内容<br>
  这是第二行简介内容<br>
  这是第三行简介内容<br>
  最后一行简介内容
</div>
```



## Docker部署Calibre Web

``` bash {data-open=true,title="目录结构"}
/data/calibre/
├── docker-compose.yml    # 配置文件
├── config/               # Calibre-Web配置目录
│   ├── app.db           # 应用数据库
│   ├── calibre-web.log  # 日志文件
│   ├── config.json      # 配置文件
│   └── metadata.db      # 数据库文件，这个文件必须存在
├── books/               # 图书库目录
│   └── [作者名]/[书名]    # 图书文件
└── upload/              # 上传目录
```

<br>

``` shell {data-open=true}
# 下载初始数据库文件
wget https://raw.githubusercontent.com/janeczku/calibre-web/master/library/metadata.db -O config/metadata.db
```

<br>

``` yml {data-open=true,title="docker-compose.yml"}
services:
  calibre-web:
    image: lscr.io/linuxserver/calibre-web:latest
    container_name: calibre-web
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - DOCKER_MODS=linuxserver/mods:universal-calibre # 启用Calibre工具集
      - OAUTHLIB_RELAX_TOKEN_SCOPE=1 # 解决部分OAuth登录问题
    volumes:
      - ./config:/config	# 配置文件目录
      - ./books:/books		# 图书库目录，存放所有图书和数据库
      - ./upload:/upload	# 上传目录，用于本地Calibre同步上传
    ports:
      - 8083:8083
    restart: unless-stopped
```

<br>

> 账号：admin
>
> 密码：admin123

<br>

{{< image src="/images/guides/管理和阅读书籍/11.png" caption="(`图11`)" >}}

{{< image src="/images/guides/管理和阅读书籍/12.png" caption="(`图12`)" >}}

{{< image src="/images/guides/管理和阅读书籍/13.png" caption="(`图13`)" >}}

{{< image src="/images/guides/管理和阅读书籍/14.png" caption="(`图14`)" >}}



## Docker部署BookLore

``` shell {data-open=true,title="创建目录"}
mkdir -p ./booklore/config/mariadb
mkdir -p ./booklore/data
mkdir -p ./booklore/books
mkdir -p ./booklore/bookdrop

# 导航到您的 Booklore 目录并创建配置文件：
cd ~/booklore
nano docker-compose.yml
```

<br>

| 目录 | 目的 | 重要提示 |
| :----: | :----: | :----: |
| `config/mariadb` | 数据库配置和数据文件 | 切勿删除 - 包含所有元数据 |
| `data` | 应用程序数据、缓存、日志 | 存储设置和临时处理文件 |
| `books` | 主要图书馆存储空间 | 在此添加书籍或通过 Bookdrop 导 |
| `bookdrop` | 自动导入文件夹 | 将文件拖放至此处，即可进行免提导入 |

<br>

> **备份重要目录**
>
> 经常备份 `config/mariadb` 和 `books` 防止数据丢失。

<br>

> **专业提示**
>
> 在生产环境中，请使用绝对路径来存储卷。相对路径可能会导致容器重启出现问题。


### 使用Docker数据库

``` yml {data-open=true,titile="docker-compose.yml"}
services:
  booklore:
    image: booklore/booklore-app:latest
    container_name: booklore
    environment:
      - PUID=501
      - PGID=20
      - TZ=Asia/Shanghai
      - DATABASE_URL=jdbc:mariadb://mariadb:3306/booklore
      - DATABASE_USERNAME=booklore
      - DATABASE_PASSWORD=your_secure_password
      - SWAGGER_ENABLED=false
    depends_on:
      mariadb:
        condition: service_healthy
    ports:
      - "6060:6060"
    volumes:
      - /your/local/path/to/booklore/data:/app/data
      - /your/local/path/to/booklore/books:/books
      - /your/local/path/to/booklore/bookdrop:/bookdrop
    restart: unless-stopped

  mariadb:
    image: lscr.io/linuxserver/mariadb:11.4.5
    container_name: mariadb
    environment:
      - PUID=501
      - PGID=20
      - TZ=Asia/Shanghai
      - MYSQL_ROOT_PASSWORD=super_secure_password
      - MYSQL_DATABASE=booklore
      - MYSQL_USER=booklore
      - MYSQL_PASSWORD=your_secure_password
    volumes:
      - /your/local/path/to/mariadb/config:/config
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "mariadb-admin", "ping", "-h", "localhost"]
      interval: 5s
      timeout: 5s
      retries: 10
```

<br>

**环境变量**

PUID & PGID（用户 ID 与组 ID）：
- 需将其设置为与你的系统用户 ID 一致，以确保文件权限正常。
- 可通过以下命令查看你的 ID：`id -u`（查看 PUID）和 `id -g`（查看 PGID）。

<br>

时区（TZ）：
- 设置为你的本地时区（例如：America/New_York 纽约、Europe/London 伦敦）。
- 确保时间戳和定时任务的准确性。
- 查看可用时区的命令：`timedatectl list-timezones`。

<br>

DATABASE_PASSWORD（数据库密码）：
- 在 `booklore` 和 `mariadb` 两个服务中必须完全相同。
- 使用强密码，且该密码需唯一（不与其他服务复用）。
- 避免使用可能需要转义的特殊字符（如 `$`、`&` 等）。

<br>

MYSQL_ROOT_PASSWORD（MySQL 根密码）：
- 与 `DATABASE_PASSWORD` 需区分开（不可相同）。
- 用于数据库管理操作（如创建用户、修改配置等）。
- 务必将此密码设置得极其安全。

<br>

SWAGGER_ENABLED（Swagger 功能开关）：
- 生产环境中需设为 `false`，以保障安全性（避免 API 文档暴露）。
- 开发阶段可设为 `true`，用于查看和测试 API 文档。

<hr>

**卷路径**

> **重要提示：**
>
> 请将 /your/local/path/to/... 替换为第一步中你实际的目录路径。

<br>

Linux/macOS 系统示例：

``` yml
volumes:
  - /home/username/booklore/data:/app/data
  - /home/username/booklore/books:/books
  - /home/username/booklore/bookdrop:/bookdrop
```

<br>

Windows 系统（WSL2 环境）示例：

``` yml
volumes:
  - /mnt/c/Users/YourName/booklore/data:/app/data
  - /mnt/c/Users/YourName/booklore/books:/books
  - /mnt/c/Users/YourName/booklore/bookdrop:/bookdrop
```

<hr>

**镜像版本**

最新标签（默认值）：

``` yml
image: booklore/booklore-app:latest
```

<br>

特定版本（生产环境推荐）：

``` yml
image: booklore/booklore-app:v1.2.3
```

<br>

> **最佳实践**
>
> 生产环境中应固定镜像的具体版本，以避免意外更新（如自动拉取的新版本包含未兼容变更）。


### 使用本地数据库

**brew安装mariadb**

步骤 1：确保本地 MariaDB 已安装并运行

通过 brew 安装并启动 MariaDB（若已安装可跳过安装步骤）：

``` bash
# 安装 MariaDB
brew install mariadb

# 启动 MariaDB 服务
brew services start mariadb
```

<br>

初始化数据库

``` bash {data-open=true}
# 执行 MariaDB 安全安装脚本
sudo mysql_secure_installation

# [步骤1] 提示输入当前 root 密码（新安装时直接回车）
Enter current password for root (enter for none): # 直接回车（新安装尚未设置密码）

# [步骤2] 是否切换到 Unix socket 认证？
# 选择 n 保留密码验证（允许远程连接和传统登录方式）
Switch to unix_socket authentication [Y/n] # 输入 n 并回车

# [步骤3] 是否更改 root 密码？（强烈建议设置强密码）
Change the root password? [Y/n] # 输入 y 并回车
# 需要重复输入确认新密码

# [步骤4] 是否移除匿名用户？（强烈建议移除以增强安全）
Remove anonymous users? [Y/n] # 输入 y 并回车
# 移除默认创建的匿名账户，防止无凭证访问

# [步骤5] 是否禁止 root 远程登录？（生产环境必选）
Disallow root login remotely? [Y/n] # 输入 y 并回车
# 仅允许 root 从本地登录，大幅降低被暴力破解风险

# [步骤6] 是否移除测试数据库？（建议移除）
Remove test database and access to it? [Y/n] # 输入 y 并回车
# 删除默认的 test 数据库，减少潜在攻击面

# [步骤7] 是否立即重载权限表？（必须选择）
Reload privilege tables now? [Y/n] # 输入 y 并回车
# 使所有安全设置立即生效（无需重启服务）
# 成功后会显示 "All done!" 提示
```

<br>

``` yml {data-open=true,title="docker-compose.yml"}
services:
  booklore:
    image: booklore/booklore-app:latest
    container_name: booklore
    environment:
      - PUID=501
      - PGID=20
      - TZ=Asia/Shanghai
      # 使用 host.docker.internal 指向宿主机（macOS）
      - DATABASE_URL=jdbc:mariadb://host.docker.internal:3306/booklore
      # 使用您本地的账号
      - DATABASE_USERNAME=xxx
      - DATABASE_PASSWORD=xxx
      # Disable Swagger UI in production
      - SWAGGER_ENABLED=false
    ports:
      - "6060:6060"
    volumes:
      - /your/local/path/to/booklore/data:/app/data
      - /your/local/path/to/booklore/books:/books
      - /your/local/path/to/booklore/bookdrop:/bookdrop
    restart: unless-stopped

```



### 启动

在包含 `docker-compose.yml` 的目录执行 `docker compose up -d`

容器启动后，打开您的网页浏览器并导航到：`http://127.0.0.1:6060/setup`











---
{.awesome-hr}

---

> 作者: [piliqiu](https://piliqiu.com/)  
> URL: https://piliqiu.com/guides/%E7%AE%A1%E7%90%86%E5%92%8C%E9%98%85%E8%AF%BB%E4%B9%A6%E7%B1%8D/