aaronleopold/stump Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Stump 镜像文档

镜像概述

Stump 是一个免费开源的漫画、manga 和数字图书服务器，支持 OPDS（开放出版物分发系统）。项目仍在开发阶段（WIP），可能存在功能不稳定或 bug，建议避免使用 experimental 标签，优先选择稳定版本或 nightly 标签。采用 MIT 许可证，提供 *** 社区支持，可通过 Docker 便捷部署。

核心功能与特性

• 多类型内容支持：管理漫画、manga 及各类数字图书文件
• OPDS 协议兼容：支持开放出版物分发系统，允许阅读客户端发现和获取内容
• 免费开源：代码完全开源，基于 MIT 许可证，可自由使用和修改
• Docker 化部署：提供官方 Docker 镜像，支持跨平台快速部署和运行

使用场景与适用范围

• 个人用户搭建私有漫画/数字图书库
• 小型团队共享漫画及电子阅读资源
• 需要通过 OPDS 协议与阅读客户端（如电子书应用）集成的场景

使用方法与配置说明

前提条件

• 已安装 Docker 或 Docker Compose
• 宿主机需具备漫画/图书文件存储目录及适当权限

Docker CLI 部署

bash
# 创建容器（将源路径替换为您的实际路径）
docker create \
  --name=stump \
  -e "PUID=1000" \
  -e "PGID=1000" \
  -p ***:*** \
  --mount type=bind,source=/path/to/your/.stump,target=/config \
  --mount type=bind,source=/path/to/your/books,target=/data \
  --restart unless-stopped \
  aaronleopold/stump

# 启动容器
docker start stump

Docker Compose 部署

创建 docker-compose.yml 文件：

yaml
version: '3.3'
services:
  stump:
    image: aaronleopold/stump
    container_name: stump
    volumes:
      - /path/to/your/.stump:/config  # 配置文件持久化目录
      - /path/to/your/books:/data     # 图书数据存储目录
    ports:
      - ***:***  # 服务端口映射
    environment:
      - PUID=1000    # 用户ID（用于权限控制）
      - PGID=1000    # 组ID（用于权限控制）
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

端口映射

• ***:***：Stump 服务默认端口，主机端口可根据需求修改

数据卷挂载

注意事项

• 挂载目录前需确保宿主机路径已存在，且权限与 PUID/PGID 匹配
• 项目开发中可能存在兼容性问题，生产环境使用前建议进行功能测试
• 如需获取最新功能可使用 nightly 标签，但稳定性可能低于正式版本

参考链接

• 官方文档
• GitHub 项目
• Docker Hub 镜像
• *** 社区