audiobookshelf

Audiobookshelf Docker Image

ceramicwhite

基于LinuxServer优化的Audiobookshelf镜像,集成AAC库FFmpeg构建,用于有声书管理、播放及音频处理。

下载次数: 0状态:社区镜像维护者:ceramicwhite仓库类型:镜像最近更新:

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 \
  docker.xuanyuan.run/audiobookshelf-image

Docker Compose配置

yaml
version: "3.8"

services:
  audiobookshelf:
    image: docker.xuanyuan.run/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

配置参数

环境变量

变量名默认值说明
NODE_ENVproductionNode.js运行环境(production/development)
TZUTC容器时区(如Asia/Shanghai)
PORT80服务监听端口
PUID1000运行服务的用户ID(用于权限控制)
PGID1000运行服务的用户组ID(用于权限控制)

数据卷挂载

挂载路径说明
/config应用配置、数据库文件存储目录
/media有声书媒体文件存放目录(需映射宿主机媒体文件夹)

暴露端口

  • 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包管理版本)

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 audiobookshelf 镜像标签

docker pull docker.xuanyuan.run/ceramicwhite/audiobookshelf:<标签>

DockerHub 原生拉取命令

docker pull ceramicwhite/audiobookshelf:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告