前言

有声书和播客文件保存到NAS以后，虽然解决了存储问题，但平时收听仍然不够方便。音频分散在不同文件夹中，封面、作者和章节信息不统一，更换设备后也很难快速找到上次听到的位置。

Audiobookshelf是一套面向有声书和播客的开源媒体管理工具。它可以扫描指定的音频目录，在浏览器中建立书架，并整理封面、作者、章节和播放进度等信息。

本文将在极空间中创建Audiobookshelf所需的数据目录，通过Docker Compose启动服务，再建立一个有声书媒体库，完成音频上传、信息编辑和网页播放测试。

完成局域网访问后，还会使用cpolar为13378端口建立公网入口，让手机或其他网络中的电脑也能打开个人书库。具体的离线下载、播客订阅和移动端同步能力，应以所使用客户端及当前版本的实际表现为准。

1.在极空间部署Audiobookshelf

1.1ssh远程连接到极空间

• 开启【SSH 服务】
• 使用终端（Windows PowerShell / Mac Terminal）登录：

sshroot@IP

没有ssh的小伙伴可以去cpolar官网参考**《极空间别再吃灰了！开启SSH，秒变全能服务器！ 》**这篇文章：

1.2验证docker是否开启

使用命令：

docker-vsystemctl status-v

没有docker的小伙伴可以去cpolar官网参考这篇文章：《极空间开箱实录：从拆箱到远程访问保姆级教程，30分钟上手！》

1.3安装Audiobookshelf

首先创建存放目录：

1. docker目录下创建audiobooksshelf
2. audiobooksshelf目录（新建好的）依次创建：audiobooks、podcasts、config、metadata

请将下面的内容保存为docker-compose.yml文件:

version:"3.7"services: audiobookshelf: image: gcr.io/advp lyr/audio bookshelf:latest container_name: audiobookshelf ports: -"13378:80"volumes: - ./audiobooks:/audiobooks - ./podcasts:/podcasts - ./config:/config - ./metadata:/metadata restart: unless-stopped

执行下列命令：

docker-composeup-d

部署完成后，在浏览器中输入http://极空间IP:13378就能看到登录界面：

1.4简单使用Audiobookshelf

设置登录密码：

登录：

登录进来了：

设置成中文：

创建媒体库：

• 媒体类型：图书
• 媒体库（自定义）
• 文件夹选择（audiobooks）

网页端上传本地资源（单独上传）

填写基本信息:

上传完后，就可以在书架看见啦：

编辑：

可以更改基本信息：

下载完成，开始播放啦！

为了实现随时随地访问本地部署的 Audiobookshelf 有声书服务，可以通过内网穿透工具 cpolar 将其暴露至公网。用户可在手机、平板或远程设备上无缝访问个人有声书库，实现跨网络、跨设备的书签同步与连续播放，轻松打造属于自己的私有云听书平台。

2.安装cpolar实现随时随地听书

cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。

❤️以下是安装cpolar步骤：

使用一键脚本安装命令：

sudocurlhttps://get.cpolar.sh|sh

安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）

sudosystemctl status cpolar

Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：

打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。

3.配置公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

• 隧道名称：可自定义，本例使用了:audio，注意不要与已有的隧道名称重复
• 协议：http
• 本地地址：13378
• 域名类型：随机域名
• 地区：选择China Top

创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地）上，使用地址访问。

访问成功。

4.保留固定公网地址

使用cpolar为其配置二级子域名，该地址为固定地址，不会随机变化。

点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是audio，大家可以自定义。填写备注信息，点击保留。

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名
• Sub Domain：填写保留成功的二级子域名
• 地区: China Top

点击更新

更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。

最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问极空间的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。

这样我们就可以，随时随地听小说啦!

总结

完成以上配置后，Audiobookshelf已经可以在极空间中运行。登录后台后，可以创建有声书媒体库，将音频文件导入对应目录，并继续补充书名、作者、封面和章节等信息。

通过浏览器打开极空间IP和13378端口后，可以直接进入个人书架并播放音频。后续继续添加文件时，也可以将大量资源复制到挂载的audiobooks目录，再通过媒体库扫描功能统一识别，通常比逐个网页上传更适合批量整理。

通过cpolar为13378端口建立公网隧道后，原本只能在家庭局域网中访问的有声书库，也可以在通勤、出差或其他网络环境中打开。继续配置固定二级子域名后，可以保存一个相对稳定的访问地址。

需要注意的是，Docker Compose中的Audiobookshelf镜像地址存在异常空格，正式部署前应先核对并修正。镜像目前也使用了latest标签，长期运行时建议记录已经验证可用的版本，升级前备份config和metadata目录。

公网播放体验会受到家庭宽带上行速度和音频码率影响。多人同时播放时，NAS和网络负载也会相应增加。若希望在没有网络时继续收听，还需要使用支持离线下载的客户端提前缓存内容，网页公网访问本身不能替代离线功能。

Audiobookshelf后台包含媒体文件、播放记录和用户信息，固定地址不应随意公开。建议使用高强度密码，为家庭成员分别创建普通账号，并限制不必要的管理权限。不需要远程收听时，也可以暂时关闭公网隧道。

metadata`目录。

公网播放体验会受到家庭宽带上行速度和音频码率影响。多人同时播放时，NAS和网络负载也会相应增加。若希望在没有网络时继续收听，还需要使用支持离线下载的客户端提前缓存内容，网页公网访问本身不能替代离线功能。

Audiobookshelf后台包含媒体文件、播放记录和用户信息，固定地址不应随意公开。建议使用高强度密码，为家庭成员分别创建普通账号，并限制不必要的管理权限。不需要远程收听时，也可以暂时关闭公网隧道。

有声书、播客和其他音频文件仍然受到版权保护。自建媒体库更适合管理个人合法持有的内容，不应将固定公网地址作为公开分享或传播受版权保护资源的入口。