lsioarmhf/ubooquity

lsioarmhf/ubooquity

镜像概述

这是Linuxserver.io团队提供的基于ARMHF架构的Ubooquity容器镜像。Ubooquity是一款免费、轻量级的家庭服务器工具，用于集中管理漫画和电子书资源，支持从平板、电子书阅读器、手机、电脑等多种设备远程访问。

核心功能

• 统一管理本地漫画和电子书文件
• 跨设备访问数字资源（支持平板、阅读器、手机、电脑）
• 容器启动时自动扫描指定路径下的文件
• 可自定义分配最大内存（避免Java堆空间不足问题）
• 基于Alpine Linux构建，轻量高效且资源占用低

使用场景

• 家庭用户搭建个人数字图书馆，集中存储和管理漫画、电子书
• 随时随地通过多种设备访问自己的数字资源库
• 个人用户整理和分享本地数字阅读资源（非商业用途）

配置说明

Docker部署命令

bash
docker create \
  --name=ubooquity \
  -v <本地配置路径>:/config \
  -v <本地书籍路径>:/books \
  -v <本地漫画路径>:/comics \
  -v <本地原始文件路径>:/files \
  -e MAXMEM=<最大内存，默认512MB> \
  -e PGID=<用户组ID> -e PUID=<用户ID>  \
  -p 2202:2202 \
  -p 2203:2203 \
  lsioarmhf/ubooquity

参数解释

• 端口映射：
  • -p 2202: 图书馆页面访问端口
  • -p 2203: 管理员后台访问端口
• 数据卷：
  • /config: 存储Ubooquity的配置文件和数据库
  • /books: 本地书籍文件的挂载路径
  • /comics: 本地漫画文件的挂载路径
  • /files: 本地原始文件的挂载路径
• 环境变量：
  • MAXMEM: 设置应用允许使用的最大内存（需小于硬件物理内存，默认512MB）
  • PUID/PGID: 解决主机与容器间的权限冲突，可通过id <用户名>命令获取当前用户的ID值

应用设置步骤

1. 启动容器后，访问管理员后台：http://<你的IP>:2203/ubooquity/admin，设置管理员密码
2. 访问图书馆页面：http://<你的IP>:2202/ubooquity/，浏览和访问已挂载的数字资源
3. 容器启动时会自动扫描/books、/comics等路径下的文件，更新资源库

其他操作

• 进入容器Shell：docker exec -it ubooquity /bin/bash
• 实时查看日志：docker logs -f ubooquity
• 查看容器版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' ubooquity
• 查看镜像版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' lsioarmhf/ubooquity