robertlordhood/chaptarr

Chaptarr Docker镜像文档

镜像概述

Chaptarr是基于已停用的Readarr项目开发的分支版本，专注于在单一应用实例中提供有声书和电子书的统一管理功能。它继承了Readarr的核心架构，针对音频和电子书籍的特性进行了优化，为用户提供一站式的数字阅读资源管理解决方案。

核心功能与特性

• 双媒体类型支持：同时管理有声书和电子书，无需分别部署多个应用
• 元数据自动获取：自动从网络数据源拉取书籍元信息（标题、作者、封面、描述等）
• 内容组织：支持按作者、系列、类型等维度对媒体文件进行分类管理
• 下载集成：可与主流下载工具（如qBittorrent、Deluge等）集成，实现内容自动下载
• Web管理界面：提供直观的网页管理界面，支持通过浏览器进行配置和操作
• 跨平台兼容：基于Docker容器化部署，可在多种操作系统环境中运行

使用场景

• 个人数字图书馆：为个人用户提供有声书和电子书的集中管理方案
• 家庭媒体中心：作为家庭服务器的一部分，供家庭成员共享阅读资源
• 内容创作者：帮助作者或内容创作者管理自己的数字出版物
• 教育机构：小型教育机构用于管理教学用电子和有声教材

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name=chaptarr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -p 8787:8787 \
  -v /path/to/chaptarr/config:/config \
  -v /path/to/ebooks:/books \
  -v /path/to/audiobooks:/audiobooks \
  --restart unless-stopped \
  chaptarr/chaptarr:latest

Docker Compose配置

yaml
version: '3.8'

services:
  chaptarr:
    image: chaptarr/chaptarr:latest
    container_name: chaptarr
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    ports:
      - "8787:8787"
    volumes:
      - /path/to/chaptarr/config:/config
      - /path/to/ebooks:/books
      - /path/to/audiobooks:/audiobooks
    restart: unless-stopped

环境变量说明

数据卷说明

访问与配置

1. 部署完成后，通过 http://<服务器IP>:8787 访问Chaptarr Web界面
2. 首次使用需完成初始设置向导，包括语言选择、媒体库配置和下载客户端集成
3. 在"设置"中可配置元数据来源、文件命名规则、通知等高级选项

注意事项

• 确保宿主机上的挂载目录具有正确的读写权限（与PUID/PGID匹配）
• 建议定期备份 /config 目录以防止配置丢失
• 如需通过互联网访问，建议配合反向代理（如Nginx）并启用HTTPS加密
• 保持镜像更新以获取最新功能和安全修复