Ting Reader 🎧
Ting Reader 是一款为 飞牛 fnOS 深度优化的自托管有声书管理平台。它旨在为 NAS 用户提供一个轻量、美观且智能的个人音频图书馆，支持自动元数据刮削、多端进度同步及 WebDAV 远程存储。
🌐 官方网站：https://www.tingreader.cn
访问官网查看最新文档、下载客户端及在线演示。
🌟 核心特性
- 🐂 飞牛原生适配：支持
.fpk 格式一键安装，完美集成至飞牛应用中心，支持图形化配置。
- 📚 智能自动化：集成喜马拉雅元数据刮削，自动抓取书名、作者、演播者、简介及精美封面。
- 🎨 极致视觉：根据书籍封面自动提取主色调，界面随书而变，支持沉浸式播放体验。
- ☁️ 全能存储：完美支持本地目录挂载及 WebDAV 协议（如 Alist、PikPak），海量资源轻松接入。
- 🎵 格式兼容：支持多种音频格式，包括 MP3, M4A, M4B, WAV, FLAC, OGG, OPUS, AAC, WMA 以及喜马拉雅加密格式 XM。
- 📱 全平台覆盖：自适应移动端网页，支持倍速调节、睡眠定时及跨设备进度记忆。
- 🧩 外挂小窗 (Widget)：支持通过 Iframe 将播放小窗嵌入到其他网站，支持自定义 CSS 代码注入，实现高度个性化定制。
- 🌓 完美夜间模式：适配深色模式，保护视力，深夜听书更惬意。
📸 界面预览
| 🖥️ 桌面端首页 |
📱 移动端首页 |
 |
 |
Ting Reader 现在支持将播放器以小窗形式嵌入到您的个人博客、导航页或其他网站中。
功能亮点
- 灵活认证：支持 免登录（带 Token） 和 需登录（公开） 两种模式，满足私有仪表盘或公开博客的不同需求。
- 跨站引用：通过
<iframe> 轻松嵌入，小窗内集成独立登录界面。
- 专辑选择：小窗内内置搜索与专辑切换功能，无需跳转主站。
- CSS 注入：在“个性化设置”中编写 CSS 代码，实时改变小窗的外观（如透明背景、隐藏特定按钮等）。
使用方法
- 登录 Ting Reader，进入 个性化设置。
- 找到 外挂组件 (Widget) 区域。
- 选择 免登录 或 需登录 模式，复制对应的嵌入代码。
- 将代码粘贴到目标网页的 HTML 中。
🚀 快速部署 (飞牛 fnOS)
方法一：使用 FPK 安装包 (推荐)
- 下载安装包：前往 GitHub Releases 下载
ting-reader.fpk。
- 手动安装：打开飞牛 应用中心 -> 右上角 手动安装 -> 上传
.fpk 文件。
- 完成向导：根据提示配置端口和存储路径，点击完成即可。
💻 桌面客户端
为了提供更流畅的播放体验，我们推出了官方桌面客户端（Windows / macOS / Linux）：
- 无缝连接：完美支持飞牛 NAS 的内网穿透/DDNS 环境，自动处理 HTTPS 证书与重定向。
- 离线缓存：自动缓存已播放章节，断网也能听。
- 下载地址：点击下载最新版
方法二：使用 Docker Compose
在飞牛的 Docker 管理器中创建项目，并使用以下配置：
services:
ting-reader:
image: dqsq2e2/ting-reader:latest
container_name: ting-reader
ports:
- "3000:3000"
volumes:
- /path/to/data:/app/data
- /path/to/storage:/app/storage
- /path/to/cache:/app/cache
restart: always
environment:
- JWT_SECRET=change-this-to-a-secure-secret
- PORT=3000
- DB_PATH=/app/data/ting-reader.db
⚠️ 首次登录信息：
- 用户名：
admin
- 密码：
admin123
登录后请立即前往“个性化设置”修改默认密码。
💬 交流与反馈
如果您觉得本项目对您有帮助，欢迎在 GitHub 点个 ⭐️ Star！
2026-2-3 00:48:47
2026-2-3 10:46:12 楼主
