xthursdayx/yacreaderlibrary-server-docker

YACReaderLibraryServer Docker

!Docker Builds !Docker Pulls !Docker Pulls

镜像概述和主要用途

YACReaderLibraryServer Docker是https://github.com/YACReader/yacreader/tree/develop/YACReaderLibraryServer%E7%9A%84%E6%97%A0%E5%A4%B4%E7%89%88%E6%9C%AC%EF%BC%8C%E5%9F%BA%E4%BA%8EUbuntu 22.04 LTS云镜像和https://github.com/just-containers/s6-overlay%E6%9E%84%E5%BB%BA%E3%80%82

YACReader是一款优秀的漫画阅读器和管理器，支持CBR、CBZ、ZIP、RAR等漫画文件格式。YACReaderLibraryServer可轻松搭建家庭漫画服务器，将漫画内容提供给任何运行YACReader客户端的设备，包括Windows、macOS、Linux以及iOS应用。

核心功能和特性

• 双压缩后端支持：提供基于7zip或https://github.com/selmf/unarr%E7%9A%84%E4%B8%A4%E4%B8%AA%E7%89%88%E6%9C%AC%EF%BC%8C%E6%BB%A1%E8%B6%B3%E4%B8%8D%E5%90%8C%E6%A0%BC%E5%BC%8F%E9%9C%80%E6%B1%82
• 多架构支持：支持x86-64（amd64）和arm64架构，适配多种硬件平台
• 简单部署：通过Docker CLI或docker-compose快速部署，配置参数清晰
• 持久化存储：配置文件和漫画库数据通过卷挂载持久化，确保数据安全
• 灵活管理：支持创建、添加、更新、列出和删除漫画库

支持的架构

该镜像通过Docker manifest支持多平台感知，具体支持的架构及对应标签如下：

注意：unarr版本默认支持大多数漫画格式（ZIP、RAR4），稳定性较好；7zip版本支持更多格式（如RAR5），可能在库创建速度上有优势，用户可根据需求选择。

使用方法和配置说明

Docker CLI部署

bash
docker run -d \
  --name=YACReaderLibraryServer \
  -e PUID=99 \
  -e PGID=100 \
  -e TZ=America/New_York \
  -p 8080:8080 \
  -v /path/to/config:/config \
  -v /path/to/comic:/comics \
  --restart unless-stopped \
  xthursdayx/yacreaderlibrary-server-docker:[tag]

docker-compose部署

yaml
---
version: "3"
services:
  yacreaderlibrary-server-docker:
    container_name: YACReaderLibraryServer
    image: xthursdayx/yacreaderlibrary-server-docker:[tag]
    environment:
      - PUID=99
      - PGID=100
      - TZ=America/New_York
    volumes:
      - /path/to/config:/config
      - /path/to/comics:/comics
    ports:
      - 8080:8080
    restart: unless-stopped

参数说明

用户/组标识符

使用卷挂载时，主机与容器可能出现权限问题，可通过指定PUID（用户ID）和PGID（组ID）解决。确保主机上的卷目录所有者与指定的PUID/PGID一致。

获取当前用户的PUID和PGID：

bash
id <username>  # 将<username>替换为实际用户名

库管理指令

创建新漫画库

bash
docker exec YACReaderLibraryServer YACReaderLibraryServer create-library <library-name> /comics

（将<library-name>替换为自定义库名称）

添加现有漫画库

bash
docker exec YACReaderLibraryServer YACReaderLibraryServer add-library <library-name> /comics

更新漫画库（添加新漫画后）

bash
docker exec YACReaderLibraryServer YACReaderLibraryServer update-library /comics

列出所有漫画库

bash
docker exec YACReaderLibraryServer YACReaderLibraryServer list-libraries

删除漫画库

bash
docker exec YACReaderLibraryServer YACReaderLibraryServer remove-library <library-name>

访问方法

通过YACReader客户端访问服务器：

• 地址格式：http://SERVERIP:8080（将SERVERIP替换为服务器实际IP）

安全注意：YACReaderLibraryServer默认无认证机制，不建议暴露在家庭网络之外。如需外部访问，建议使用反向代理（如NGINX）或***（如Open***）。

镜像更新

该镜像为静态版本，需通过更新镜像并重建容器来升级YACReaderLibraryServer。

通过Docker Compose更新

bash
# 更新所有镜像
docker-compose pull
# 或更新单个镜像
docker-compose pull YACReaderLibraryServer

# 重建容器
docker-compose up -d
# 或重建单个容器
docker-compose up -d YACReaderLibraryServer

# 清理旧镜像
docker image prune

通过Docker Run更新

bash
# 更新镜像
docker pull xthursdayx/yacreaderlibrary-server-docker:[tag]

# 停止并删除当前容器
docker stop YACReaderLibraryServer
docker rm YACReaderLibraryServer

# 使用相同参数重建容器（卷挂载正确时，配置和库数据会保留）
docker run -d [原参数] xthursdayx/yacreaderlibrary-server-docker:[tag]

# 清理旧镜像
docker image prune

镜像更新通知工具

可使用Diun接收镜像更新通知，不建议使用自动更新容器的工具。

版本历史

• 15.02.24：将aarch64镜像回滚到QT5以临时修复CI构建问题
• 15.02.24：更新YACReader至9.14.2，切换p7zip分支到7zip并将7zip镜像更新到QT6
• 06.02.24：更新YACReader至9.14.1，并将unarr镜像更新到QT6
• 28.07.23：更新YACReader至9.13.1，弃用32位Arm(hf)镜像
• 25.04.23：更新YACReader至9.12.0
• 04.04.23：更新YACReader至9.11.0，修复CI构建流程
• 02.12.22：更新YACReader至9.10.0，升级到s6v3
• 27.10.22：更新到YACReaderLibrary 9.9.2，基于Jammy重建
• 16.11.21：优化多架构支持和镜像推送流程
• 20.06.21：添加多架构支持
• 14.06.21：切换到包含unarr和p7zip版本的单体仓库
• 11.06.21：主p7zip分支的错误修复和补丁
• 10.06.21：完整重建和初始版本