孙亮亮
返回 NAS 系统

NAS 系统

NAS 搭建 Audiobookshelf 有声书服务器:Docker 部署、刮削与手机断点续听实战

2026年11月17日

Audiobookshelf搭建有声书库,支持断点续听。

NASAudiobookshelf有声书播客服务器

NAS 搭建 Audiobookshelf 有声书服务器:Docker 部署与手机断点续听实战

摘要:把 Audible、喜马拉雅下载的有声书和自建播客统一管理,是很多 NAS 用户的真实需求。本文用群晖/飞牛 NAS 的 Docker 部署 Audiobookshelf,完整讲清目录规划、容器配置、元数据刮削、反代外网访问与手机断点续听,并给出权限、中文名乱码、反代 WebSocket 等常见坑的解决办法。

为什么选 Audiobookshelf 而不是 Jellyfin

Jellyfin、Plex 擅长视频,对有声书这种按章节、记进度、长时间播放的场景支持很弱:章节切分不准、播放进度不同步、没有播客订阅。Audiobookshelf 是专为音频书与播客设计的服务端,核心能力有三点。一是自动把 m4b、mp3 合集按文件切分成章节;二是为每个账号独立保存播放进度,手机、网页、车机切换设备能接着听;三是内置播客 RSS 订阅与自动下载。它的 Web 播放器支持三倍速、睡眠定时、跳过片头,体验接近商业应用。硬件开销很低,空闲内存两百兆左右,两台机械盘的入门 NAS 也能流畅运行。

目录规划与 Docker Compose 部署

先想清楚目录结构,Audiobookshelf 对命名敏感。建议在 NAS 共享文件夹下建三个目录:books 放有声书,podcasts 放播客,metadata 放刮削缓存与数据库。每本有声书单独一个文件夹,例如 books/三体/ 下放 001.mp3、002.mp3,文件夹名就是书名,刮削命中率最高。

用 Docker Compose 部署,关键是挂载要覆盖 config、audiobooks、podcasts 三个路径,并给容器正确的时间戳与用户权限:

version: "3.8"
services:
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    container_name: audiobookshelf
    ports:
      - "13378:80"
    volumes:
      - ./config:/config
      - ./metadata:/metadata
      - /volume1/media/books:/audiobooks
      - /volume1/media/podcasts:/podcasts
    environment:
      - TZ=Asia/Shanghai
      - PUID=1026
      - PGID=100
    restart: unless-stopped

PUID/PGID 一定要填 NAS 上媒体目录所属用户,群晖用 id 命令查,飞牛一般是 1000。填错会导致容器无法写入 config,表现为反复重启或刮削失败。部署完成后访问 NAS 的 13378 端口,用向导创建管理员账号即可。

添加媒体库与刮削元数据

登录后进入设置里的媒体库,分别添加有声书库和播客库,路径填容器内的 /audiobooks 与 /podcasts。添加后先别急着刮削,扫描一遍目录让它识别文件。识别完成后逐本检查匹配:默认用 Audible 和 Google Books 两个数据源,中文有声书命中率一般,英文书较高。

匹配不上的书,手动点编辑,用书名加作者重新搜索,或直接在文件夹里放一张 cover.jpg 和 metadata.nfo。实测一个技巧:把文件名里的"第01集"改成"01",章节号识别会准很多,否则播放器会把每张 mp3 当成一整章,拖动进度条时跳不准。刮削结果缓存在 metadata 目录,建议纳入 NAS 的快照计划,避免重装容器后要重新刮一遍。

反代外网访问与手机断点续听

外网访问建议走反向代理加 HTTPS,不要直接把 13378 端口映射到公网。用 Nginx Proxy Manager 或 NAS 自带的反代,把 audio.example.com 指到容器的 80 端口。播放器的进度推送依赖 WebSocket,反代配置里必须加上升级头,否则网页端进度不刷新:

location / {
    proxy_pass http://127.0.0.1:13378;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

手机端安装官方应用,服务器地址填反代域名,登录后会自动同步网页端的进度。断点续听的粒度可以在书籍设置里调,默认三十秒保存一次。通勤路上用手机听,到家切到智能音箱或车机,进度是连续的,这是自建音频库相比网盘最实用的地方。

常见坑与优化

一是中文名乱码:刮削出来如果是问号,多半是文件名编码问题,Linux 下用 convmv 工具批量转成 UTF-8 即可。二是播客下载占空间:在播客设置里限制保留集数,比如只留最近十期,否则订阅多了几天就吃掉几十 GB。三是内存增长:metadata 里存了封面缩略图,书多了会变大,定期清理未使用的封面。四是备份,config 目录里是账号和进度数据,务必单独备份,媒体文件丢了可以重新刮,进度丢了没法恢复。

小结

Audiobookshelf 把散落在各平台的有声书和播客收拢到一个自建服务里,部署半小时,长期收益是设备无关的连续收听体验。搭建时把目录规划和 PUID/PGID 两件事做对,就避开了八成的坑;反代记得带 WebSocket 头,手机端才能实时同步进度。配合 NAS 的快照与备份,这套音频库可以稳稳用上几年。

本模块其他文章

NAS 影视库元数据整理实战:用 TinyMediaManager 规范命名让 Jellyfin/Plex 精准刮削NAS 零信任远程访问实战:用 Cloudflare Tunnel 安全暴露内网服务NAS 虚拟机实战:用群晖 VMM 与飞牛虚拟机跑软路由、Home Assistant 与隔离测试环境NAS 媒体库自动整理与批量转码实战:用 Tdarr + ffmpeg 规范命名、转 H.265 省 40% 空间NAS 做全家终端备份中枢:macOS 时间机器、Windows 文件历史与手机整机备份实战NAS 存储池与 RAID 选型实战:SHR、RAID 5/6/10 容量算法、掉盘容忍与在线扩容避坑飞牛/群晖 NAS SSD 缓存加速实战:NVMe 读写缓存、命中率观测与掉电保护取舍群晖/飞牛 NAS 快照与误删秒级恢复实战:Btrfs 子卷快照、快照计划与勒索病毒防护NAS 接 UPS 断电自动保护实战:USB 通讯、NUT 网络供电监控与停电安全关机家庭与小企业 NAS 文件共享实战:SMB 多用户挂载、权限隔离与 Windows/Mac 访问指南NAS 容器化应用纳管实战:用 Docker Compose + Watchtower 编排多服务并自动安全更新NAS 硬盘健康监控实战:用 smartmontools + Scrutiny 提前发现坏盘与温度预警NAS 用 Syncthing 搭建多设备实时文件同步:手机电脑 NAS 自动互备实战NAS 数据备份 3-2-1 策略实战:rsync 本地快照 + rclone 加密同步对象存储NAS 搭建 Nginx Proxy Manager 反向代理中枢:统一证书、域名分发与内网服务安全暴露飞牛/群晖 NAS 搭建家庭下载中心:qBittorrent + Aria2 + Transmission 容器化部署实战飞牛/群晖 NAS 自建家庭音乐中心:Navidrome 部署、歌词刮削与多端无损串流NAS 搭建家庭电子书与文档中心:Calibre-Web 部署、Kindle 推送与全文检索飞牛/群晖 NAS 自建 Vaultwarden 密码库:容器部署、HTTPS 反代与加密备份实战飞牛群晖 NAS 搭建家庭监控系统:Frigate 接管 RTSP 摄像头做本地录像与智能回放飞牛/群晖 NAS 部署 Jellyfin 媒体中心:影片刮削、硬件转码与手机远程播放用 NAS 搭建家庭私有云相册:Immich 部署、手机备份与多端同步群晖/飞牛 NAS 远程访问实战:Tailscale 组网与反向代理安全配置NAS 快照实战:用 Btrfs 子卷快照挡住误删和勒索,5 分钟回滚NAS 异地访问怎么选:Tailscale 零配置组网与 WireGuard 自建隧道的实战对比用 Immich 把全家照片搬回 NAS:自建家庭相册的部署、备份与避坑在 NAS 上用 Docker 跑自建服务NAS 阵列与 3-2-1 备份策略
NAS 搭建 Audiobookshelf 有声书服务器:Docker 部署、刮削与手机断点续听实战 · 孙亮亮