极空间部署Audiobookshelf:搭建私人有声书库与远程访问

发布时间:2026/8/4 19:15:11
极空间部署Audiobookshelf:搭建私人有声书库与远程访问 前言有声书和播客文件保存到NAS以后虽然解决了存储问题但平时收听仍然不够方便。音频分散在不同文件夹中封面、作者和章节信息不统一更换设备后也很难快速找到上次听到的位置。Audiobookshelf是一套面向有声书和播客的开源媒体管理工具。它可以扫描指定的音频目录在浏览器中建立书架并整理封面、作者、章节和播放进度等信息。本文将在极空间中创建Audiobookshelf所需的数据目录通过Docker Compose启动服务再建立一个有声书媒体库完成音频上传、信息编辑和网页播放测试。完成局域网访问后还会使用cpolar为13378端口建立公网入口让手机或其他网络中的电脑也能打开个人书库。具体的离线下载、播客订阅和移动端同步能力应以所使用客户端及当前版本的实际表现为准。1.在极空间部署Audiobookshelf1.1ssh远程连接到极空间开启【SSH 服务】使用终端Windows PowerShell / Mac Terminal登录sshrootIP没有ssh的小伙伴可以去cpolar官网参考**《极空间别再吃灰了开启SSH秒变全能服务器 》**这篇文章1.2验证docker是否开启使用命令docker-vsystemctl status-v没有docker的小伙伴可以去cpolar官网参考这篇文章《极空间开箱实录从拆箱到远程访问保姆级教程30分钟上手》1.3安装Audiobookshelf首先创建存放目录docker目录下创建audiobooksshelfaudiobooksshelf目录新建好的依次创建audiobooks、podcasts、config、metadata请将下面的内容保存为docker-compose.yml文件:version:3.7services: audiobookshelf: image: gcr.io/advp lyr/audio bookshelf:latest container_name: audiobookshelf ports: -13378:80volumes: - ./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 cpolarCpolar安装和成功启动服务后在浏览器上输入虚拟机主机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后台包含媒体文件、播放记录和用户信息固定地址不应随意公开。建议使用高强度密码为家庭成员分别创建普通账号并限制不必要的管理权限。不需要远程收听时也可以暂时关闭公网隧道。有声书、播客和其他音频文件仍然受到版权保护。自建媒体库更适合管理个人合法持有的内容不应将固定公网地址作为公开分享或传播受版权保护资源的入口。