Calibre-Web Docker 部署指南
Calibre-Web 是一个用于管理和共享电子书的网页应用程序,它可以让你方便地访问你的 Calibre 电子书库。使用 Docker 部署 Calibre-Web 可以让安装和管理变得更加简单。在本指南中,我们将介绍如何在 Docker 中部署 Calibre-Web。
准备工作
在开始部署之前,请确保你已经具备以下环境:
- 已安装 Docker 和 Docker Compose
- 了解基础的命令行操作
- 准备好一个存储 Calibre 库的目录
创建文件结构
首先,我们需要创建一个文件夹来存放 Docker Compose 文件和 Calibre 库。
mkdir -p ~/calibre-web/{data,config}
这里我们创建了一个名为 calibre-web
的文件夹,并在其中创建了 data
和 config
两个子目录。data
目录将用于存放电子书,config
目录用于存放配置文件。
创建 Docker Compose 文件
接下来,在 calibre-web
目录中创建一个名为 docker-compose.yml
的文件,并写入以下内容:
version: '3'
services:
app:
image: technosoft2000/calibre-web:latest
container_name: calibre-web
environment:
- CALIBRE_LIBRARY=/calibre/library
- SIGNUP_ENABLED=True
- USE_UNAUTHENTICATED_ACCESS=False
volumes:
- ./data:/calibre/library
- ./config:/calibre-web/config
ports:
- "8083:8083"
restart: always
在这个配置中:
- 我们指定了 Calibre-Web 的 Docker 镜像
technosoft2000/calibre-web:latest
。 - 设置了一些环境变量,如
CALIBRE_LIBRARY
(Calibre 电子书库路径)、SIGNUP_ENABLED
(是否允许注册)和USE_UNAUTHENTICATED_ACCESS
(是否允许没有身份验证的访问)。 - 将本地的
data
和config
目录映射到容器内相应的位置。 - 将容器的 8083 端口映射到主机的 8083 端口,这样你就可以通过
http://localhost:8083
访问 Calibre-Web。
启动服务
在 calibre-web
目录下运行以下命令来启动 Docker 服务:
docker-compose up -d
这个命令会在后台启动 Calibre-Web 容器。你可以通过运行 docker-compose ps
命令来查看容器的状态。
初始化 Calibre 库
访问 http://localhost:8083
,你应该可以看到 Calibre-Web 的欢迎页面。初次访问时,你需要添加 Calibre 电子书库。在页面中输入存放电子书的路径,通常是 /calibre/library
。
如果你已有一个现成的 Calibre 库,只需将其复制到 data
目录中;如果没有,可以直接在网页中上传电子书。
配置 Calibre-Web
在 Calibre-Web 中,你可以设置多个选项,以适应你的需求。可以更改书籍的封面、修改书籍信息等。访问设置菜单,调整所需的配置。
停止和重启服务
如果你需要停止 Calibre-Web 服务,可以使用以下命令:
docker-compose down
要重启服务,只需再次运行 docker-compose up -d
。
总结
通过以上步骤,你已经成功在 Docker 中部署了 Calibre-Web。这种部署方式不仅方便管理,还能在不同环境之间轻松迁移。希望这个指南能够帮助你建立自己的电子书管理系统。随着 Calibre-Web 功能的不断更新,程序的使用也会更加丰富多彩。