ceramicwhite/audiobookshelf

Audiobookshelf Docker镜像文档

镜像概述

本镜像为Audiobookshelf的容器化部署版本，基于LinuxServer Alpine基础镜像构建，集成FFmpeg（含AAC编码支持）、Tone音频处理工具等核心组件。通过多阶段构建优化，预打包客户端与服务器代码，提供开箱即用的有声书管理与播放解决方案。

核心功能与特性

• LinuxServer优化：基于ghcr.io/linuxserver/baseimage-alpine:3.15构建，遵循容器最佳实践，支持PUID/PGID权限控制
• 多媒体工具集成：
  • 集成ceramicwhite/static-ffmpeg提供的FFmpeg与FFprobe，支持音频转码与格式处理
  • 包含sandreas/tone:v0.1.5音频工具，增强音频处理能力
• 预构建组件：客户端通过Node.js环境预编译为静态文件，服务器代码直接部署，减少容器启动时间
• 跨平台支持：支持多架构构建（依赖BUILDPLATFORM/TARGETPLATFORM参数），适配不同硬件环境
• 灵活配置：通过环境变量自定义端口、时区、用户权限等运行参数

使用场景

• 个人/家庭有声书库管理与流媒体播放
• 音频文件格式转换与编码处理（AAC等格式）
• 轻量级音频媒体服务器部署
• 容器化环境下的有声内容管理系统

使用方法

基础部署（Docker Run）

bash
docker run -d \
  --name=audiobookshelf \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e PORT=80 \
  -p 8080:80 \
  -v /path/to/data:/config \
  -v /path/to/audiobooks:/media \
  --restart unless-stopped \
  audiobookshelf-image

Docker Compose配置

yaml
version: "3.8"

services:
  audiobookshelf:
    image: audiobookshelf-image
    container_name: audiobookshelf
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - PORT=80
    ports:
      - "8080:80"
    volumes:
      - /path/to/data:/config  # 配置与数据库存储
      - /path/to/audiobooks:/media  # 有声书媒体文件
    restart: unless-stopped

配置参数

环境变量

数据卷挂载

暴露端口

• 80：Audiobookshelf Web服务端口（可通过PORT环境变量修改）

构建说明

镜像通过多阶段构建实现优化：

1. 依赖获取阶段：拉取Audiobookshelf源码并安装Node.js依赖
2. 构建阶段：编译客户端代码，集成FFmpeg/Tone工具，打包服务端文件
3. 运行阶段：基于LinuxServer基础镜像，配置运行环境并部署应用

核心工具版本：

• FFmpeg：来自ceramicwhite/static-ffmpeg:latest
• Tone：来自sandreas/tone:v0.1.5
• Node.js：16.20.2-r0（Alpine包管理版本）