Audiobookshelf

关于

Audiobookshelf是一个自托管的有声书和播客服务器。

特性

• 完全开源，包括Android和iOS应用（测试版）
• 实时流式传输所有音频格式
• 搜索并添加播客以下载剧集，支持自动下载
• 多用户支持，带自定义权限
• 为每个用户保存进度并跨设备同步
• 自动检测库更新，无需重新扫描
• 上传书籍和播客，支持拖放文件夹批量上传
• 备份元数据及自动每日备份
• 渐进式Web应用（PWA）
• Web应用和Android应用支持Chromecast
• 从多个来源获取元数据和封面图
• 章节编辑器和章节查找（使用Audnexus API）
• 将音频文件合并为单个m4b文件
• 将元数据和封面图嵌入音频文件（使用Tone）
• 基本电子书支持和电子书阅读器（实验性）

如有需要的功能，可提出建议。

加入我们的***或Matrix社区。

移动应用

Android应用（测试版）

可在Google Play商店试用。

iOS应用（测试版）

通过Test Flight获取：[***] - 参与讨论

开发工具与客户端

查看API文档构建自定义工具和客户端。

!图书馆截图

有声书组织

目录结构和文件夹名称对Audiobookshelf至关重要！

有关支持的目录结构、文件夹命名约定和音频文件元数据使用方法，请参见文档。

安装

Docker部署示例

bash
docker run -d \
  --name audiobookshelf \
  -p 8080:80 \
  -v /path/to/audiobooks:/books \
  -v /path/to/podcasts:/podcasts \
  -v /path/to/config:/config \
  -v /path/to/metadata:/metadata \
  --restart unless-stopped \
  advplyr/audiobookshelf

参数说明：

• -p 8080:80：端口映射，主机8080端口映射到容器80端口
• -v /path/to/audiobooks:/books：挂载有声书存储目录
• -v /path/to/podcasts:/podcasts：挂载播客存储目录
• -v /path/to/config:/config：挂载配置文件目录
• -v /path/to/metadata:/metadata：挂载元数据存储目录
• --restart unless-stopped：容器退出时自动重启（除非手动停止）

更多安装方式参见安装文档。

反向代理设置

重要提示！Audiobookshelf需要WebSocket连接。

注意：尚不支持子文件夹路径（如/audiobooks）。参见问题。

NGINX Proxy Manager

启用WebSocket支持。

!NGINX WebSocket

NGINX反向代理

修改nginx服务器站点配置文件，替换尖括号中的相关部分并插入证书路径：

bash
server {
    listen 443 ssl;
    server_name <sub>.<domain>.<tld>;

    access_log /var/log/nginx/audiobookshelf.access.log;
    error_log /var/log/nginx/audiobookshelf.error.log;

    ssl_certificate      /path/to/certificate;
    ssl_certificate_key  /path/to/key;

    location / {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Host $host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_http_version 1.1;

        proxy_pass http://<URL_to_forward_to>;
        proxy_redirect http:// [***]
    }
}

Apache反向代理

修改Apache服务器站点配置文件，替换尖括号中的相关部分并插入证书路径。

需启用以下模块：ssl、proxy_module、proxy_wstunnel_module、rewrite_module（使用a2enmod命令）。

bash
<IfModule mod_ssl.c>
<VirtualHost *:443>
    ServerName <sub>.<domain>.<tld>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

    ProxyPreserveHost On
    ProxyPass / http://localhost:<audiobookshelf_port>/
    RewriteEngine on
    RewriteCond %{HTTP:Upgrade} websocket [NC]
    RewriteCond %{HTTP:Connection} upgrade [NC]
    RewriteRule ^/?(.*) "ws://localhost:<audiobookshelf_port>/$1" [P,L]

    # 证书通常由Let's Encrypt的certbot等工具生成
    SSLCertificateFile /path/to/cert/file
    SSLCertificateKeyFile /path/to/key/file
</VirtualHost>
</IfModule>

SWAG反向代理

参见解决方案

Synology反向代理

1. 打开控制面板 > 应用门户
2. 切换到反向代理选项卡
3. 选择要启用WebSocket的代理规则并点击编辑
4. 切换到“自定义标头”选项卡
5. 点击创建 > WebSocket
6. 点击保存

（来自@silentArtifact）

Traefik反向代理

与CORS相关的中间件会导致应用登录时报告“未知错误”。为避免此问题，请勿将以下标头应用于此站点的路由器：

• accessControlAllowMethods
• accessControlAllowOriginList
• accessControlMaxAge

Caddy反向代理示例Caddyfile

subdomain.domain.com {
    encode gzip zstd
    reverse_proxy <LOCAL_IP>:<PORT>
}

从源码运行

参见讨论

贡献/支持方式

参见“支持方式”页面