title: "一站式自建有声图书馆：Audiobookshelf服务器搭建与使用全攻略"
date: "2025-12-05"

Audiobookshelf是一款开源的自托管有声书与播客服务器，它致力于为用户提供高效便捷的有声内容管理、流媒体播放及多设备同步体验，让您轻松构建个人专属的音频图书馆。

核心功能一览

• 完全开源：项目及其安卓与iOS客户端（测试中）代码均开放。
• 广泛格式支持：支持实时流式传输几乎所有常见的音频格式。
• 智能播客管理：支持搜索、订阅播客并自动下载更新剧集。
• 多用户与权限：支持创建多个用户账号，并可进行精细的权限控制。
• 跨设备进度同步：为每个用户独立记录播放进度，并在不同设备间无缝同步。
• 智能库更新：能够自动检测到媒体库的变更，无需手动重新扫描。
• 便捷上传方式：支持通过拖放文件夹等方式批量上传有声书和播客内容。
• 元数据备份：提供元数据备份功能，并可设置每日自动备份。
• PWA应用：作为渐进式Web应用，可提供近乎原生App的体验。
• Chromecast支持：Web端与安卓客户端均支持投射到Chromecast设备。
• 丰富元数据源：可从Google Books等多个在线来源自动获取元数据和封面图。
• 章节管理：支持编辑音频章节，并能通过Audnexus API查询章节信息。
• 文件合并：可将多个音频文件合并为单个.m4b格式的有声书文件。
• 元数据嵌入：能够将获取到的元数据和封面图直接嵌入到音频文件中。
• 基础电子书支持： 支持Epub、PDF、CBR、CBZ格式。 可将电子书直接发送到兼容设备（如Kindle）。
• 开放订阅源：为你的播客和有声书库生成开放的RSS订阅源，便于其他应用订阅。

在线演示地址 (账号/密码: demo/demo)： https://audiobooks.dev

安装部署

推荐使用Docker Compose进行快速部署，只需一个配置文件即可完成。

Docker Compose 配置示例

services:
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    container_name: audiobookshelf
    ports:
      - 13378:80
    volumes:
      - ./audiobooks:/audiobooks
      - ./podcasts:/podcasts
      - ./metadata:/metadata
      - ./config:/config
    restart: unless-stopped

关键目录映射说明（更多参数请参考官方文档）

• /audiobooks：用于存放所有有声书文件的目录。
• /podcasts：用于存放播客订阅及下载内容的目录。
• /metadata：服务器元数据（如封面、描述信息）的存储目录。
• /config：Audiobookshelf应用程序的配置文件目录。

使用指南

1. 访问界面 在浏览器中输入 http://你的服务器IP:13378，即可访问Audiobookshelf的Web界面。

   

2. 初始化设置 首次访问需要设置初始管理员账号的密码。

   

   设置完成后，使用默认用户名admin和你刚设置的密码登录。

   

3. 语言设置 登录后，点击右上角进入“设置”，可以修改服务器界面语言为中文。

   

4. 创建媒体库 使用前需要先创建一个媒体库。点击侧边栏或主页的“添加媒体库”。

   

   • 选择类型：选择“图书”（即有声书）。
   • 命名库：为你的有声书库起一个名字。

   

5. 配置元数据与路径

   • 元数据提供方：默认选择“Google Books”即可（需要网络能够正常访问相关服务）。
   • 选择文件夹：点击“浏览文件夹”，选择之前Docker映射的/audiobooks目录。 提示：你可以在audiobooks目录下创建子文件夹（如“文学”、“科普”等）对有声书进行分类管理，Audiobookshelf会识别并展示文件夹结构。
   • 其他高级设置可暂时保持默认，点击“创建”完成媒体库设置。

6. 扫描与展示 系统会自动开始扫描媒体库中的文件。扫描完成后，返回首页即可看到你的有声书。 如果音频文件本身已包含元数据（如ID3标签），Audiobookshelf会自动识别并显示封面、作者、简介等信息。 整体展示效果清晰美观。

7. 元数据匹配（刮削） 对于没有元数据或信息不完整的书籍，可以手动匹配。点击书籍右下角的菜单按钮，选择“匹配”。 系统会通过Google Books等源进行搜索，选择正确的结果即可自动填充元数据和封面。 匹配成功后，书籍信息将变得完整。

8. 播放体验

   • 章节显示：播放界面会显示根据文件名自动识别的章节标题。
   • 特色进度条：播放进度条会显示整本书的总时长，上面的每一个刻度代表一个章节，直观清晰。
   • 移动端适配：Web界面针对移动设备做了良好优化，无需下载App即可获得不错的浏览和播放体验。
   • 官方客户端：如需更好的移动端体验，可从官网下载安卓或iOS客户端：https://audiobookshelf.org

9. 数据统计 在媒体库页面可以查看详细的统计数据，包括书籍数量、总时长、作者数量等，一目了然。

高级设置与技巧

1. 本地保存元数据： 在“设置”->“服务器设置”中，开启“将元数据保存到音频文件所在文件夹”选项。这样，当你匹配或修改元数据后，信息会以.json和封面图文件的形式保存在有声书文件夹内，便于备份和迁移。

2. 自动扫描与匹配： 对于新增的大量无元数据书籍，可以在“媒体库设置”中开启“在扫描时自动尝试匹配”功能，系统会在后台自动尝试查找元数据。

3. 书架视图： 在“媒体库设置”中开启“启用书架视图”，首页的书籍展示会从列表变为更直观的书架样式。

4. 多用户管理： 在“用户”设置中，可以创建和管理多个用户账号，并为他们分配不同的媒体库访问权限，适合家庭或小团队共享使用。

5. 自动备份： 系统支持定时自动备份元数据数据库，为你的媒体库信息增加一份保障。

总结

Audiobookshelf无疑是当下最受欢迎、体验最为出色的自托管有声书与播客服务器解决方案。它拥有美观的界面、全面的功能，支持自动元数据刮削、多用户管理与跨设备同步。其部署过程极其简单，尤其适合拥有NAS设备或希望搭建家庭媒体中心的用户。

或许有人会疑惑：听有声书用普通音乐播放器不行吗？实际体验后你会发现，专为有声书设计的Audiobookshelf在书籍管理、进度追踪、章节跳转和元数据展示上的体验，与通用音乐播放器有本质区别，就如同用文件管理器看电影与用Emby/Plex这类媒体服务器的差别一样巨大。

综合推荐指数：⭐⭐⭐⭐（开源免费，社区活跃，功能强大） 使用体验指数：⭐⭐⭐⭐（界面友好，操作直观，功能齐全） 部署难易指数：⭐⭐（非常简单，几乎一键完成）