ddsderek/audiobookshelf

Audiobookshelf Docker镜像

镜像概述

本镜像为Audiobookshelf的优化版本，旨在帮助用户快速搭建私有有声书和播客管理系统，实现有声内容的存储、分类、搜索及播放功能，支持多设备访问与进度同步。

核心功能

• 管理有声书与播客资源，自动识别并整理元数据
• 提供Web界面播放功能，支持章节选择与进度记忆
• 支持自定义存储路径与权限配置（PUID/PGID）
• 内置健康检查机制，确保服务稳定运行

使用场景

• 个人用户搭建私有有声书库，随时收听喜爱内容
• 家庭共享有声资源，满足多成员学习娱乐需求
• 小型团队内部共享有声学习资料与培训内容

配置说明

环境变量

• PUID/PGID: 指定容器运行的用户ID和组ID，避免文件权限问题
• UMASK: 设置文件创建权限掩码，默认值022
• TZ: 设置时区，建议使用Asia/Shanghai确保时间同步

卷映射

• /config: 存储应用配置文件
• /metadata: 存储有声书和播客的元数据信息
• /audiobooks: 存储有声书文件
• /podcasts: 存储播客文件

部署示例

Docker Run命令

bash
docker run -d \
  -p 13378:80 \
  -v </path/to/config>:/config \
  -v </path/to/metadata>:/metadata \
  -v </path/to/audiobooks>:/audiobooks \
  -v </path/to/podcasts>:/podcasts \
  -e PUID=1000 \
  -e PGID=1000 \
  -e UMASK=022 \
  -e TZ=Asia/Shanghai \
  --health-cmd="curl -f http://127.0.0.1/healthcheck || exit 1" \
  --health-interval=30s \
  --health-timeout=3s \
  --health-start-period=10s \
  --name audiobookshelf \
  ddsderek/audiobookshelf:latest

Docker Compose配置

yaml
version: '3.3'
services:
    audiobookshelf:
        ports:
            - '***:80'
        volumes:
            - '</path/to/config>:/config'
            - '</path/to/metadata>:/metadata'
            - '</path/to/audiobooks>:/audiobooks'
            - '</path/to/podcasts>:/podcasts'
        environment:
            - PUID=1000
            - PGID=1000
            - UMASK=022
            - TZ=Asia/Shanghai
        healthcheck:
            test: ["CMD", "curl", "-f", "[***]"]
            interval: 30s
            timeout: 3s
            start_period: 10s
        container_name: audiobookshelf
        image: 'ddsderek/audiobookshelf:latest'