Stump Docker部署教程：简单几步搭建个人图书服务器

【免费下载链接】stump A free and open source comics, manga and digital book server with OPDS support (WIP) 项目地址: https://gitcode.com/gh_mirrors/st/stump

Stump是一款免费开源的漫画、 manga 和数字图书服务器，支持OPDS协议，让你轻松管理和访问个人数字图书馆。本教程将详细介绍如何通过Docker快速部署Stump，即使是新手也能在几分钟内完成搭建。

📋 准备工作

在开始部署前，请确保你的系统已安装以下工具：

• Docker Engine（20.10+）
• Docker Compose（v2+）

如果尚未安装Docker，可以参考官方文档进行安装。对于Ubuntu系统，可通过以下命令快速安装：

sudo apt update && sudo apt install -y docker.io docker-compose

🔄 获取Stump项目代码

首先需要将Stump项目代码克隆到本地：

git clone https://gitcode.com/gh_mirrors/st/stump
cd stump

🐳 Docker部署步骤

1. 构建Docker镜像

Stump提供了完整的Docker构建配置，位于项目的docker目录中。执行以下命令构建Docker镜像：

docker build -t stump -f docker/Dockerfile .

2. 创建Docker Compose配置

在项目根目录创建docker-compose.yml文件，添加以下内容：

version: '3.8'

services:
  stump:
    image: stump
    container_name: stump
    restart: unless-stopped
    ports:
      - "10801:10801"
    volumes:
      - ./stump_data:/data
      - ./stump_config:/config
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai

3. 启动Stump服务

使用以下命令启动Stump服务：

docker-compose up -d

4. 验证服务状态

检查容器是否正常运行：

docker ps | grep stump

如果看到状态为Up，说明Stump服务已成功启动。

🌐 访问Stump服务器

打开浏览器，访问以下地址进入Stump Web界面：

http://localhost:10801

首次访问时，你需要创建管理员账户。按照界面提示完成注册后，即可开始使用Stump管理你的数字图书。

Stump图书服务器界面展示 - 支持漫画、manga和数字图书管理

⚙️ 基本配置

添加图书库

1. 登录Stump管理界面
2. 点击左侧导航栏的"图书馆"
3. 点击"添加图书馆"按钮
4. 设置图书馆名称和路径（容器内路径为/data/books，对应宿主机的./stump_data/books）
5. 点击"创建"完成添加

配置OPDS服务

Stump默认启用OPDS服务，你可以在设置中找到OPDS地址，用于在阅读器应用中访问你的图书库。

Stump提供强大的智能列表过滤功能，帮助你快速找到想要的图书

📱 移动设备访问

Stump提供了移动应用支持，你可以通过以下方式在手机或平板上访问：

1. 在移动设备浏览器中访问Stump服务器地址
2. 或者使用支持OPDS的阅读应用（如Moon+ Reader、KyBook等）

Stump移动应用界面 - 随时随地访问你的数字图书馆

🛠️ 常见问题解决

端口冲突

如果10801端口已被占用，可以修改docker-compose.yml中的端口映射：

ports:
  - "自定义端口:10801"

权限问题

如果遇到文件权限问题，可以调整环境变量中的PUID和PGID为你的用户ID和组ID：

environment:
  - PUID=你的用户ID
  - PGID=你的组ID

可以通过以下命令查看你的用户ID和组ID：

id -u  # 查看用户ID
id -g  # 查看组ID

数据备份

Stump的数据保存在宿主机的./stump_data和./stump_config目录中，定期备份这两个目录即可。

📚 更多资源

• 官方文档：docs/
• Docker配置文件：docker/Dockerfile
• 启动脚本：docker/entrypoint.sh

通过以上步骤，你已经成功搭建了自己的Stump图书服务器。开始上传你的漫画和数字图书，享受便捷的个人图书馆管理体验吧！

【免费下载链接】stump A free and open source comics, manga and digital book server with OPDS support (WIP) 项目地址: https://gitcode.com/gh_mirrors/st/stump