从零开始搭建Audiobookshelf：自托管有声书服务器完全指南

你是否曾为有声书管理混乱而烦恼？是否希望随时随地访问自己的有声书库？Audiobookshelf作为一款开源的自托管有声书和播客服务器，能帮你解决这些问题。本文将带你从零开始，通过"问题-方案-深化"的三段式架构，掌握Audiobookshelf的部署与应用，打造专属于你的个人有声书平台。

基础部署：快速搭建个人有声书服务器

Docker Compose一键部署

1. 📥 克隆仓库（获取最新代码）

   git clone https://gitcode.com/gh_mirrors/au/audiobookshelf
   

2. ⚙️ 配置环境变量（自定义服务参数） 编辑项目根目录下的docker-compose.yml文件，根据需求修改端口、数据卷等配置。

3. 🚀 启动服务（后台运行容器）

   docker-compose up -d
   

传统部署方式

1. 📦 安装依赖（配置项目运行环境）

   npm install
   

2. 🔨 构建客户端（生成前端静态文件）

   cd client && npm run build
   

3. ▶️ 启动服务器（运行后端服务）

   npm start
   

部署完成后，访问http://你的服务器IP:13378即可进入Audiobookshelf的主界面。首次使用需要创建管理员账户，然后添加媒体库路径。

Audiobookshelf媒体库界面展示了已添加的有声书封面和播放控制栏

定制化部署：打造个性化有声书服务

核心参数配置

Audiobookshelf的核心配置文件位于项目根目录，通过修改这些参数可以调整服务器行为：

• 端口设置：修改配置文件中的PORT参数，避免端口冲突
• 数据存储：配置媒体文件和数据库的存储路径，建议使用独立的数据卷
• 认证方式：支持本地账号、OAuth等多种认证方式，配置位于server/auth/目录

场景化配置示例

家庭网络部署（基础版）

适用于家庭局域网内使用，无需复杂配置：

1. 保持默认端口13378
2. 关闭外部访问权限
3. 配置本地存储路径

互联网访问配置（进阶版）

如需从互联网访问你的有声书服务器：

1. 修改默认端口为80或443
2. 配置反向代理（即通过中间服务器转发请求）
3. 启用HTTPS加密传输
4. 设置访问权限控制

# Nginx反向代理配置示例
location / {
    proxy_pass http://localhost:13378;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

实用技巧：优化你的Audiobookshelf体验

资源占用优化

Audiobookshelf默认配置可能占用较多系统资源，通过以下调整可以优化性能：

1. 扫描频率调整：修改server/scanner/LibraryScanner.js中的扫描间隔参数，减少资源占用
2. 缓存设置：调整缓存大小和过期时间，平衡性能和存储空间
3. 数据库优化：对于大型媒体库，建议切换到PostgreSQL数据库以提升性能

多设备同步

实现多设备间的播放进度同步：

1. 在各设备上登录同一账号
2. 启用"跨设备同步"选项
3. 播放进度会自动上传并同步到所有设备

自动化管理

设置定时任务实现媒体库自动更新：

1. 编辑server/managers/CronManager.js
2. 添加定期扫描任务
3. 配置新增媒体通知

Audiobookshelf流媒体播放界面展示了播放控制和书籍列表

进阶应用：拓展Audiobookshelf的可能性

家庭媒体中心整合

将Audiobookshelf与其他媒体服务整合，打造完整的家庭媒体中心：

1. 与Plex、Emby等媒体服务器联动
2. 共享媒体库资源
3. 实现统一的媒体管理界面

高级定制开发

对于有开发能力的用户，可以通过以下方式扩展Audiobookshelf功能：

1. 开发自定义元数据插件
2. 添加新的认证方式
3. 拓展媒体格式支持

相关工具推荐

• FFmpeg：用于音频格式转换和处理
• Nginx：作为反向代理服务器，提供HTTPS支持
• Portainer：Docker容器管理工具，方便管理Audiobookshelf容器
• Syncthing：用于多设备间的媒体文件同步

常见问题解答

Q: 为什么我的媒体文件无法被扫描到？
A: 请检查文件权限是否正确，确保Audiobookshelf有读取媒体文件的权限。同时确认文件格式是否被支持。

Q: 如何备份我的Audiobookshelf数据？
A: 定期备份数据库文件和媒体库目录。可以通过server/managers/BackupManager.js配置自动备份。

Q: 能否在低配置设备上运行Audiobookshelf？
A: 可以。通过降低扫描频率、关闭不必要的功能，可以在树莓派等低配置设备上运行。建议至少1GB内存和10GB存储空间。

通过本文的指南，你已经掌握了Audiobookshelf的部署和优化方法。无论是在家中还是在旅途中，都能随时享受你的有声书收藏。开始搭建属于你的自托管有声书服务器，开启全新的听书体验吧！