搬瓦工搭建 Audiobookshelf 有声书服务器完整教程

Audiobookshelf 是一款专为有声书和播客设计的自托管媒体服务器，支持多用户管理、播放进度同步、元数据自动刮削等功能。它提供了美观的 Web 界面和官方移动客户端（iOS/Android），让你随时随地收听自己的有声书收藏。本文将介绍如何在搬瓦工 VPS 上使用 Docker 部署 Audiobookshelf。

一、准备工作

1.1 系统要求

操作系统：Ubuntu 20.04+（推荐 Ubuntu 22.04）。
内存：512MB 即可运行，1GB 以上更佳。
磁盘空间：程序本身约 100MB，有声书文件按需准备。
Docker：需提前安装，参考 Docker 安装教程。

1.2 创建目录结构

mkdir -p /opt/audiobookshelf/config
mkdir -p /opt/audiobookshelf/metadata
mkdir -p /opt/audiobookshelf/audiobooks
mkdir -p /opt/audiobookshelf/podcasts

二、Docker Compose 部署

2.1 创建配置文件

cd /opt/audiobookshelf
cat > docker-compose.yml <<'EOF'
version: '3.8'

services:
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    container_name: audiobookshelf
    restart: unless-stopped
    ports:
      - "13378:80"
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./audiobooks:/audiobooks
      - ./podcasts:/podcasts
      - ./config:/config
      - ./metadata:/metadata
EOF

2.2 启动服务

docker compose up -d

2.3 验证运行

docker compose ps
docker compose logs -f audiobookshelf

启动完成后，浏览器访问 http://你的服务器IP:13378 进入初始设置。首次访问需要创建管理员用户名和密码。

三、初始配置

3.1 创建媒体库

登录管理面板后，需要添加媒体库：

点击「库」→「添加新库」。
有声书库：类型选择「有声书」，目录设为 /audiobooks。
播客库：类型选择「播客」，目录设为 /podcasts。

3.2 有声书文件组织

Audiobookshelf 对文件组织格式有一定要求，推荐以下结构：

单文件有声书：/audiobooks/作者/书名/书名.m4b
多文件有声书：/audiobooks/作者/书名/Chapter 01.mp3、Chapter 02.mp3...
支持格式：M4B、MP3、M4A、FLAC、OGG、WMA、AAC 等。

3.3 上传有声书

# 通过 SCP 上传
scp -r "有声书文件夹/" root@你的服务器IP:/opt/audiobookshelf/audiobooks/

# 通过 rsync 增量同步
rsync -avz --progress /本地有声书/ root@你的服务器IP:/opt/audiobookshelf/audiobooks/

上传完成后，在 Web 界面中点击「扫描」按钮，Audiobookshelf 会自动索引新增内容。

四、元数据管理

4.1 自动刮削

Audiobookshelf 支持从多个数据源自动获取有声书的封面、简介、作者信息等元数据。在「设置」→「元数据提供程序」中，可以配置以下数据源：

Google Books
Open Library
Audible（需要区域设置）

选中一本有声书后，点击「匹配」按钮即可搜索并应用元数据。也可以批量选择后进行批量匹配。

4.2 手动编辑

如果自动刮削结果不准确，可以手动编辑书籍信息，包括标题、作者、叙述者、系列、描述、封面图片等。

五、播客功能

Audiobookshelf 除了管理有声书，还支持播客订阅功能：

在播客库中点击「添加播客」，输入播客的 RSS Feed 地址。
可设置自动下载新节目的频率。
播客的播放进度同样会跨设备同步。

六、客户端使用

6.1 官方移动端

Audiobookshelf 提供官方的 iOS 和 Android 客户端，在应用商店搜索「Audiobookshelf」即可下载。连接配置：

服务器地址：http://你的服务器IP:13378
用户名和密码：使用在 Web 界面创建的账户。

6.2 离线收听

移动端支持下载有声书到本地，方便在没有网络的情况下收听。在客户端中长按书籍，选择「下载」即可。

七、多用户管理

进入「设置」→「用户」页面可以管理多个用户，每个用户可以配置：

访问哪些媒体库。
是否允许上传和删除内容。
是否可以访问管理面板。

每位用户拥有独立的播放进度、书签和收听统计。

八、Nginx 反向代理

server {
    listen 443 ssl http2;
    server_name books.example.com;

    ssl_certificate /etc/letsencrypt/live/books.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/books.example.com/privkey.pem;

    client_max_body_size 500M;

    location / {
        proxy_pass http://127.0.0.1:13378;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # WebSocket 支持（实时进度同步）
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

九、维护与更新

9.1 更新 Audiobookshelf

cd /opt/audiobookshelf
docker compose pull
docker compose up -d

9.2 备份数据

tar -czf audiobookshelf-backup.tar.gz -C /opt/audiobookshelf config/ metadata/

配置和元数据是最重要的备份对象，有声书文件建议单独备份到其他存储。

9.3 日志排查

docker compose logs --tail=200 audiobookshelf

总结

Audiobookshelf 是目前最优秀的开源有声书管理方案，界面美观、功能齐全，在搬瓦工 VPS 上部署后可以完美替代商业有声书平台的体验。如果你还需要管理电子书，可以参考 Calibre-Web 电子书管理教程。选购搬瓦工 VPS 请参考全部方案，购买时使用优惠码 NODESEEK2026 可享受 6.77% 的循环折扣。如遇问题，可前往搬瓦工官网提交工单。