NAS 系统
NAS 搭建 Audiobookshelf 有声书服务器:Docker 部署、刮削与手机断点续听实战
2026年11月17日
Audiobookshelf搭建有声书库,支持断点续听。
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 的快照与备份,这套音频库可以稳稳用上几年。