前言

很多人购买极空间时最初的目标只是备份照片、存放电影、保存资料。使用一段时间后你会发现 NAS 的真正乐趣并不止于“存文件”。它可以把原本依赖第三方网站的服务搬回自己手里让数据真正掌握在自己手中。

听书和播客是最典型的痛点场景：

• 网站 App 内容虽多，却随时可能因为会员失效、广告干扰、推荐算法或版权变动而下架。
• 收藏已久的节目换设备后往往找不到，甚至连上次听到的位置都记不住。
• 每次打开 App 都被推送和广告淹没体验大打折扣。不过，

Audiobookshelf 是一款开源的有声书 & 播客管理工具。能够把本地音频整理成自己的书架，支持封面、分类、元数据、播放进度还有多设备续听。对喜欢通勤听书、睡前收听播客或已经拥有大量音频资源的使用者而言，它远比把文件随意丢进文件夹更实用。

将 Audiobookshelf 部署在极空间上尤为合适：极空间负责长期保存音频文件并保持服务运行，Audiobookshelf 则负责把这些内容呈现为可访问、可播放、可同步的媒体库。于是NAS 不再是一个沉默的硬盘盒，而是家庭私人的有声内容中心。

在极空间部署 Audiobookshelf

.1 SSH 远程连接到极空间

• 登录极空间管理面板，打开开关。
• 再看使用终端执行，

ssh root@

如果找不到 SSH 开关。可参考 cpolar 官方教程《极空间别再吃灰了！开启 SSH，秒变全能服务器！》操作，老实说，

.2 验证 Docker 是否已开启

在 SSH 会话中执行：

docker -v
systemctl status docker

若程序提示未安装 Docker。请参考《极空间开箱实录：从拆箱到远程访问详细教程，30 分钟上手！`》完成 Docker 环境的安装与启动。

.3 创建 Audiobookshelf 所需目录结构

1. 进入 Docker 工作目录（如 /volume1/docker) 并新建 audiobookshelf 文件夹。
2. 在该文件夹下依次创建四个子目录：
• audiobooks
• podcasts
• config
• metadata

.4 编写 docker-compose.yml 并启动容器

将下面内容保存为 audiobookshelf/docker-compose.yml

version: "3.8"
services:
audiobookshelf:
至于image。ghcr.io/advplyr/audiobookshelf:latest
container_name: audiobookshelf
从ports来看，- "13378:80" # 主机 13378 端口映射到容器 80 端口
volumes:
- ./audiobooks:/audiobooks
- ./podcasts:/podcasts
- ./config:/config
- ./metadata:/metadata
restart: unless-stopped
environment:
- TZ=Asia/Shanghai # 根据实际时区修改

在该目录执行这方面，

docker-compose up -d

容器启动后在浏览器访问 即可看到 Audiobookshelf 登录界面。

.5 初始使用与中文设置

• 设置管理员密码：首次登录会提示创建账户，填写邮箱与密码后完成注册。
• 登录后点击右上角头像 → “Settings” → “Language”，选择 “简体中文”。页面即时切换，
• • 类型：图书 或 播客根据实际需求选择。
• • 名称：自定义，例如 “我的有声书”。
• • 文件夹方法：指向之前创建的 audiobooks/podcasts.

.6 上传本地音频并开始播放

1. PODCAST / AUDIOBOOK 上传：

• • 在左侧导航栏选择对应媒体库 → “Upload”。

• • 输入标题、作者、封面图片，程序会自动抓取部分元数据。

• • 上传完成后即可在书架中看到条目；点击进入可查看章节列表、播放进度还有编辑详情。

• • 支持直接在浏览器内置播放器收听，也可以通过手机 APP扫描局域网二维码进行投屏。

安装 cpolar 实现随时随地听书

Cpolar 能够把本地 NAS 上的 Web 服务映射到公网。即使你身处公司或旅途中，也可以通过公网地址访问自己的 Audiobookshelf，实现跨网络、多设备续听。不过，

.1 一键安装 cpolar 客户端

sudo curl https://get.cpolar.sh | sh
sudo systemctl enable cpolar
sudo systemctl start cpolar
sudo systemctl status cpolar # 确认服务正常运行

.2 登录并打开 Web 管理界面

Audiocolar 安装成功后在浏览器访问。使用在 Cpolar 官网注册的账号密码登录，即可进入隧道管理后台。

配置公网地址

1. M​登陆 Cpolar UI 后在左侧导航栏选择 **“隧道管理” → “创建隧道”**。话说回来，

字段名称	填写示例 / 说明
隧道名称	audio
协议	http
本地地址	http://127.0.0.1:13378
域名类型	随机域名
地区	China Top

保留固定公网地址

Cpolar 同时提供二级子域名预留功能。可让你的 Audiob​​ooks​helf 地址保持不变，更适合长期使用。

li>登录 Cpolar UI，左侧菜单选择 “预留” → “保留二级子域名”。li>地区一样选 China Top。二级子域名自行命名，如 audio，提交预留。li>返回 “隧道管理” → “隧道列表”。找到刚才创建的 audio 隧道，点击 “编辑”。 li>修改 “域名类型” 为 “二级子域名”。填入刚预留好的 audio.cpurl.cn，保存更新。

bash cpolar edit --name audio --type subdomain --subdomain audio --region china_top

更新成功后你将在在线隧道列表中看到固定地址 https://audio.cpurl.cn。此地址即为永久入口，可分享给家人或自行添加到手机主屏幕。

至于完整体验，随时随地聆听你的私人有声图书馆

• 打开手机浏览器输入 https://audio.cpurl.cn即可直达已部署好的 Audiob​​ooks​helf 登录页；
• 输入 NAS 上设定的账号密码。即可继续阅读/收听之前未完结的章节，实现跨设备续听；
• 若想离线收听，可使用客户端 App 将单集下载至本地；
• 所有操作均受 NAS 本身存储安全保障，无需担心网站突然下架导致资源失联。/ ul>

& 常见问题排查

Audiob​​ooks​helf + 极空间 + Cpolar 的组合，把传统 NAS 从“仅存文件”的角色升级为“一站式个人有声图书馆”。按理说，主要价值体现在：

• 彻底摆脱网站会员失效、广告弹窗和版权突降带来的痛点；话说回来，
• 统一管理封面、分类和元数据。一键搜索定位所需内容，
• 自动记录播放进度。多设备同步，无论是通勤还是旅行，都能无缝继续；
• 通过 Cpolar 的固定二级子域名，实现随时随地安全远程访问；/ ul>

常见问题 & 排查教程

症状

检查/方法

无法通过 http://NAS_IP:13378 访问

确认 Docker 容器状态：docker ps | grep audiobookshelf；检查防火墙是否放行 13378 端口。

Cpolar 隧道显示在线但外部无法访问

确认 NAS 本机防火墙已开放 13378；重新生成隧道或检查 Cpolar 帐号额度是否耗尽。

登录后中文显示乱码

在容器环境变量中添加 LANG=zh_CN.UTF-8 并重启容器。说起来，

上传音频后没有自动识别章节

确认音频文件命名遵循 Book Title - Chapter xx.mp3 格式。或手动在媒体库中添加章节信息。

*安全提醒*的观点是，Audiob​​ooks​helf 更适合管理自己合法拥有或获得授权的音频内容。启用 Cpolar 公网入口时请务必使用强密码。并定期更换，以防止未授权访问。建议仅开放必要端口，不要暴露 SSH 给公网直接登录。

Audiob​​ooks​helf 将你的有声书和播客组织成专业媒体库。极空间提供可靠存储与全天候运行环境，而 Cpolar 则补足了远程入口。当这三者协同工作时你的 NAS 就不再是沉默的数据盒。而是一个「随时可听、进度永续」的私人有声图书馆，让阅读与聆听真正掌控在自己手中。

---