yacreader/yacreaderlibraryserver

YACReaderLibraryServer Docker镜像

官方YACReader Docker镜像，运行YACReaderLibraryServer无头服务。

YACReaderLibraryServer是YACReaderLibrary的无头（无GUI）版本，适用于无法运行带GUI的YACReaderLibrary的场景。它非常适合搭建24/7自建漫画服务器，供iOS和Android客户端访问，通常可部署在NAS设备中提供漫画库服务。

核心功能与特性

架构与标签支持

• 支持amd64和arm64两种架构
• develop标签：包含当前开发版本，可能不稳定。目前因YACReader 9.14.1存在影响Docker镜像功能的bug，暂为唯一可用标签；后续9.15.0发布后，latest标签将包含最新稳定版YACReaderLibraryServer

格式支持

• 采用7zip构建，支持7z、RAR、RAR5、ZIP等压缩格式
• 集成Poppler，支持PDF格式
• 包含多种图片格式支持

使用场景

• 自建漫画服务器，24/7持续运行
• 为iOS/Android客户端提供漫画库访问服务
• NAS设备部署，集中管理和共享漫画资源

安装与配置

拉取镜像

若latest标签可用（目前暂不可用），拉取最新稳定版；否则拉取develop开发版：

bash
docker pull yacreader/yacreaderlibraryserver:latest
docker pull yacreader/yacreaderlibraryserver:develop

运行容器

命令行方式

bash
docker run -d \
  --name=YACReaderLibraryServer \
  -e PUID=99 \
  -e PGID=100 \
  -e TZ=Europe/Madrid \
  -p 9999:8080 \
  -v '/path/to/config:/config' \
  -v '/path/to/comics:/comics' \
  --restart unless-stopped \
  yacreader/yacreaderlibraryserver:[develop|latest]

Docker Compose方式

yaml
version: "3"
services:
  yacreaderlibraryserver:
    container_name: YACReaderLibraryServer
    image: yacreader/yacreaderlibraryserver:[develop|latest]
    environment:
      - PUID=99
      - PGID=100
      - TZ=Europe/Madrid
    volumes:
      - /path/to/config:/config  # 映射配置文件目录
      - /path/to/comics:/comics  # 映射漫画库目录
    ports:
      - 9999:8080  # 宿主机端口:容器内端口（容器内默认8080）
    restart: unless-stopped

参数说明

• PUID/PGID：Unix/Linux系统中的用户ID和组ID，需确保该用户对漫画目录有读写权限
• -v '/path/to/config:/config'：将宿主机配置目录映射到容器内/config，用于持久化配置
• -v '/path/to/comics:/comics'：将宿主机漫画目录映射到容器内/comics，容器内通过/comics访问漫画资源
• -p 9999:8080：端口映射，宿主机端口9999映射到容器内服务端口8080

YACReaderLibraryServer命令使用

容器启动后，YACReaderLibraryServer自动后台运行，支持通过命令行管理漫画库。

命令格式

bash
YACReaderLibraryServer [选项] 命令

选项说明

• -?, -h, --help：显示帮助信息
• --help-all：显示包含Qt特定选项的完整帮助
• -v, --version：显示版本信息
• --loglevel <loglevel>：设置日志级别（可选值：trace, info, debug, warn, error）
• --port <port>：临时设置服务器端口（1-65535）
• --system-info：打印系统环境详细信息（OS版本、硬件规格、资源等）

常用命令

创建漫画库

若/comics目录中尚无漫画库，创建新库：

bash
YACReaderLibraryServer create-library MyComics /comics

添加现有漫画库

若/comics目录已包含YACReaderLibrary格式的漫画库，直接添加：

bash
YACReaderLibraryServer add-library MyComics /comics

其他命令

• start：启动服务器
• remove-library：删除库
• list-libraries：列出所有库
• update-library：更新库
• set-port：设置端口
• rescan-xml-info：重新扫描XML元数据

高级设置

配置文件路径：/path/to/config/.local/share/YACReader/YACReaderLibrary/YACReaderLibrary.ini（/path/to/config为宿主机映射的配置目录）

通过编辑该文件添加[libraryConfig] section，配置高级参数：

ini
[libraryConfig]
IMPORT_COMIC_INFO_XML_METADATA=true  # 导入XML元数据
UPDATE_LIBRARIES_PERIODICALLY=true   # 启用定期更新
UPDATE_LIBRARIES_PERIODICALLY_INTERVAL=6  # 定期更新间隔（单位：小时，可选值：0=30分钟,1=1小时,2=2小时,3=4小时,4=8小时,5=12小时,6=24小时）
UPDATE_LIBRARIES_AT_CERTAIN_TIME=true  # 启用特定时间更新
UPDATE_LIBRARIES_AT_CERTAIN_TIME_TIME=00:00  # 特定更新时间（24小时制）
UPDATE_LIBRARIES_AT_STARTUP=true  # 启动时更新库

故障排除

网络连接问题

• IP/端口错误：确保服务器IP为静态配置，端口未被其他服务占用
• 网络隔离：若使用多节点WiFi/AP，确保节点间设备可通信
• 防火墙拦截：检查服务器防火墙是否放行映射端口
• 客户端权限：iOS/Android客户端需授予本地网络访问权限
• 路由器隔离模式：关闭路由器设备隔离功能，允许局域网内设备通信

磁盘写入问题

服务器需在漫画目录创建.yacreaderlibrary文件夹（存储数据库和缓存封面），若写入失败：

• Samba挂载问题：通过Samba挂载网络共享目录时，需添加nobrl（或nolock）选项（Samba默认不允许创建锁文件，而数据库需锁文件写入）
• 权限不足：确保PUID/PGID对应的用户对漫画目录有读写权限。可通过在容器内尝试创建文件验证权限：

  bash
  docker exec -it YACReaderLibraryServer touch /comics/test.txt
  

注意：若通过YACReaderLibrary创建的库，即使无写入权限，容器仍可读取库和流式传输内容，但无法更新阅读进度。若客户端无法更新进度，需检查服务器对漫画目录的写权限。

贡献

YACReader为开源项目，代码仓库位于https://github.com/YACReader/yacreader%EF%BC%8CDocker%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%E6%96%87%E4%BB%B6%E4%BD%8D%E4%BA%8Ehttps://github.com/YACReader/yacreader/tree/develop/docker%E3%80%82%E6%AC%A2%E8%BF%8E%E6%8F%90%E4%BA%A4PR%E6%94%B9%E8%BF%9B%E9%95%9C%E5%83%8F%E5%8A%9F%E8%83%BD%E3%80%82