资源概览
Audiobookshelf 是一套自托管的有声书与播客服务器,前端 Vue、后端 Node.js,数据落在本地 SQLite,仓库为 advplyr/audiobookshelf,许可证 GPL-3.0,约 1.5 万颗 star。最新版本 v2.38.0 发布于 2026 年 11 月 17 日,更新节奏基本保持在每月一到两次。
它的定位是把「一堆按文件夹堆放的有声书音频」变成「能记住你听到第几分钟的书架」。服务端负责扫描、识别、转码与鉴权,客户端有网页版、Android 与 iOS 应用(后者仍标注 beta),三端共用一套进度。官方的 Docker 镜像发布在 ghcr.io/advplyr/audiobookshelf,内置 Node 运行时与 ffmpeg,镜像体积在数百 MB 量级;主机侧只需要一块能放下音频的磁盘。
默认端口是 13378,容器内监听 80,映射关系为 13378:80。持久化依赖四个目录:/config 存数据库与密钥,/metadata 存封面、章节缓存与备份,/audiobooks 与 /podcasts 是媒体根目录。前两个必须可写,媒体目录按需只读挂载。
核心功能亮点
多用户与跨端进度同步
支持建多个账号并逐项分配权限:能否下载、能否上传、能否删除、能看哪些库。播放进度按用户分别记录,网页端听到 12:30 关掉,手机端打开直接续播。同步走 WebSocket,两端同时在线时进度条会实时跳动,不需要手动刷新。
元数据与封面的多来源匹配
扫描到一本书后,可以按书名或 ASIN 去 Audible 各区站点、Google Books、Open Library、iTunes 查询,拉回作者、系列、出版年、简介、时长与封面。匹配结果逐项可改,也能一次给整批书套用同一套命名规则。中文书在 Google Books 上命中率更高,英文书则 Audible 数据最全。
章节编辑与 m4b 合并
章节编辑器能读入音频内嵌的章节标记,也能按固定时长自动切分,再手工调整标题与起止时间;支持按文件名里的序号排序。内置的工具可以把一个文件夹里的多个 mp3/m4a 合并成单个 m4b,并把元数据与章节写进文件,方便在只认单文件的播放器上使用。转换由镜像内的 ffmpeg 完成,不需要额外安装。
播客订阅与自动下载
在播客库中粘贴 RSS 地址即可订阅,服务端按设定的检查周期拉取新单集,可选择只保留最近 N 集、是否自动下载、下载后是否转码。每个播客和每个书库都能生成对外 RSS 源,把自建库接进任意播客客户端,等于给自己搭了一个私有播客服务。
电子书阅读与推送
除音频外还能挂 epub、pdf、cbr、cbz,网页端有内置阅读器,可调字号与背景;也能把书推送到 Kindle 邮箱。对「听一半想翻原书」的场景,音频与电子书可以放在同一书目下。
适用场景
适合有声书收藏已经上百小时、又被商业平台的区域限制和删库风险困扰的人。把文件放在 NAS 或家用服务器上,家人各建账号,手机离线下载,出门不用流量。也适合播客重度用户:把几十个节目收进一个自建服务,统一管理已听未听,换客户端不用重新订阅。
它替代的是 Plex 加有声书插件的组合,以及各类在线有声书平台的个人库功能。相比通用媒体服务器,Audiobookshelf 的进度记忆、章节处理、m4b 合并是围绕「书」设计的,不是把音频当视频的附属品。
不适合的场合:需要版权方授权的商业分发、需要 DRM 解密保护的音频(例如加密的 aax),以及希望零运维、直接开账号就听的用户。
下载与安装
官方站点 https://www.audiobookshelf.org/ ,源码与发布包在 https://github.com/advplyr/audiobookshelf ,镜像标签页为 https://github.com/advplyr/audiobookshelf/pkgs/container/audiobookshelf 。移动端安装包在 https://github.com/advplyr/audiobookshelf-app/releases 提供 APK,iOS 走 TestFlight。
推荐 Docker 部署。新建目录放 docker-compose.yml,内容取自官方示例:
services: audiobookshelf: image: ghcr.io/advplyr/audiobookshelf:latest ports: - 13378:80 volumes: - ./audiobooks:/audiobooks - ./podcasts:/podcasts - ./metadata:/metadata - ./config:/config restart: unless-stopped
在同目录执行 docker compose up -d,浏览器打开 http://服务器IP:13378,首次访问会要求创建管理员账号。若宿主机启用了用户命名空间,可在服务里加 user: "1000:1000" 让容器以普通用户写入卷。
不用 Docker 时从源码构建,需要 Node.js 24:
git clone https://github.com/advplyr/audiobookshelf.git cd audiobookshelf cd client && npm ci && npm run generate && cd .. npm ci --include=dev --ignore-scripts npm run build NODE_ENV=production node index.js
Windows 与 macOS 也可用官方安装包,装完以服务方式常驻,配置目录默认在用户目录下的 config。
快速上手
建库前先把目录整理成「作者/书名/音频文件」的结构,扫描器据此推断归属。下面是一条最小可用的准备与启动流程,包含媒体目录布局与一次容器启动。
mkdir -p /srv/abs/{audiobooks,podcasts,config,metadata}
mkdir -p "/srv/abs/audiobooks/刘慈欣/三体"
cp ~/Downloads/santi-*.m4b "/srv/abs/audiobooks/刘慈欣/三体/"
cd /srv/abs && docker compose up -d
docker logs -f audiobookshelf进入网页后依次操作:设置 → 媒体库 → 添加库,类型选「Books」,文件夹选 /audiobooks。扫描完成后逐本点「匹配」,输入书名查询,选中正确条目应用。播放页可切章节、调倍速(0.5× 到 3.5×)、设睡眠定时;手机上打开同一账号,进度会自动对上。
需要脚本化管理时用 API:在用户设置里生成 API Token,然后
curl -H "Authorization: Bearer" http://127.0.0.1:13378/api/libraries
返回 JSON 里含库 ID、媒体类型与文件夹路径,可据此批量触发扫描。反向代理下记得放行 Upgrade 与 Connection 头,否则播放进度不会实时同步。
同类资源对比
| 项目 | 授权协议 | 部署体积 | 有声书能力 | 适合谁 |
|---|---|---|---|---|
| Audiobookshelf 2.38.0 | GPL-3.0 | 镜像数百 MB,含 ffmpeg | 章节编辑、m4b 合并、播客订阅、进度同步 | 以有声书和播客为主的自建库 |
| Navidrome | GPL-3.0 | 单二进制,几十 MB | 以音乐为主,有声书仅按专辑处理 | 音乐为主、顺带听书 |
| Jellyfin | GPL-2.0 | 数百 MB,依赖 .NET | 通用媒体库,有声书靠插件,章节弱 | 已有影音库、想合并管理 |
| Plex | 闭源免费 | 数百 MB | 有声书需插件或付费功能 | 接受闭源、看重客户端生态 |
注意事项
GPL-3.0 允许自用与修改,但对外分发修改后的程序必须提供源码;把它作为家庭内部服务运行不触发任何分发义务。注意它是 GPL 而非 AGPL,不因「通过网络提供服务」而强制开源你的改动,这一点与部分自托管项目不同。
版权方面,服务只做本地文件的组织与播放,不提供任何内容,也不处理 DRM 加密音频。往库里放的书应当是自有合法副本或本身无版权保护的公版录音,例如 LibriVox 的公共领域有声书;把商业平台的加密文件放进来自建库不在支持范围。
技术限制:数据库是 SQLite,单机写入,几十个用户没问题,上百并发读写会成瓶颈。反代必须支持 WebSocket,否则进度不同步、上传卡住。媒体目录建议只读挂载,避免误删;config 与 metadata 要纳入备份,换机器时两者一起迁走,库结构与进度才不会丢。移动端仍标注 beta,离线下载偶尔需要重进应用才会刷新列表。