woahbase/alpine-ubooquity

alpine-ubooquity

镜像概述和主要用途

alpine-ubooquity是一个多架构Docker镜像，基于Alpine Linux构建，集成S6进程管理、GNU LibC、OpenJDK17运行环境和Ubooquity电子书服务器。该镜像旨在提供轻量级、跨平台的电子书管理解决方案，支持个人或小型团队搭建私有的电子书库，实现书籍的存储、分类、检索与分享。

核心功能和特性

多架构支持

• 适配多种硬件架构：x86_64、aarch64、ppc64le、s390x等，满足不同设备部署需求

轻量级基础

• 基于Alpine Linux，镜像体积小，资源占用低，运行高效

完整运行环境

• 集成GNU LibC提供系统库支持
• 包含OpenJDK17，满足Ubooquity的Java运行依赖
• S6进程管理系统，确保服务稳定运行与进程监控

Ubooquity电子书服务

• 支持多种电子书格式管理（EPUB、MOBI、PDF等）
• Web界面操作，支持书籍元数据自动识别与编辑
• 用户权限控制，可配置公开/私有访问及分享权限

使用场景和适用范围

• 个人电子书库：管理个人电子书籍收藏，实现分类、标签与全文搜索
• 家庭共享：在家庭网络中搭建共享书库，支持多设备访问
• 小型团队文档库：用于团队内部技术文档、手册等资料的集中管理与分发
• 教育场景：教师或学生搭建课程资料库，分享学习资源

详细使用方法和配置说明

基本部署（docker run）

bash
docker run -d \
  --name=alpine-ubooquity \
  -p 8080:8080 \
  -p 2202:2202 \
  -v /本地路径/图书目录:/books \
  -v /本地路径/配置目录:/config \
  woahbase/alpine-ubooquity:x86_64

参数说明：

• -p 8080:8080：映射Ubooquity主Web界面端口（用户访问）
• -p 2202:2202：映射管理员界面端口（配置管理）
• -v /本地路径/图书目录:/books：挂载电子书存储目录（持久化书籍文件）
• -v /本地路径/配置目录:/config：挂载配置目录（保存服务器设置、用户数据、元数据等）
• woahbase/alpine-ubooquity:x86_64：镜像名称，根据架构替换标签（如aarch64、ppc64le等）

Docker Compose配置

yaml
version: '3'
services:
  ubooquity:
    image: woahbase/alpine-ubooquity:x86_64
    container_name: ubooquity
    ports:
      - "8080:8080"  # 用户访问端口
      - "2202:2202"  # 管理员端口
    volumes:
      - /path/to/local/books:/books     # 本地图书目录
      - /path/to/local/config:/config   # 本地配置目录
    restart: unless-stopped  # 自动重启策略

初始化与配置

1. 服务访问

   • 启动容器后，通过浏览器访问 http://<主机IP>:8080 进入用户界面
   • 访问 http://<主机IP>:2202 进入管理员界面（首次登录需设置管理员密码）

2. 基础配置

   • 在管理员界面中，设置图书扫描目录为 /books
   • 配置元数据存储路径（默认位于 /config 目录下）
   • 根据需求设置用户权限（如***访问、用户认证等）

3. 高级设置

   • 自定义Web界面主题与语言
   • 配置书籍封面显示、排序规则
   • 设置分享链接有效期与访问限制

维护与更新

• 镜像更新：通过 docker pull woahbase/alpine-ubooquity:<架构标签> 获取最新版本
• 数据备份：定期备份 /config 目录以保留配置和元数据
• 源代码与文档：维护方为WOAHBase，更多信息可访问 https://github.com/woahbase/alpine-ubooquity 或 官方文档