常见问题
这里汇集了用户在使用 Ting Reader 过程中常见的问题与解答。
Q: 首次登录的默认账号密码是多少？
默认账号：admin
默认密码：admin123
请首次登录后务必及时修改密码。
Q: 如何刮削书籍元数据？
Ting Reader 集成了自动刮削功能。在添加书籍所在的存储库后，点击扫描，系统会自动根据文件名或目录名尝试匹配有声书的有声书信息。如果自动匹配失败，可以在书籍详情页手动编辑元数据或重新搜索匹配。
Q: 支持哪些音频格式？
目前支持 MP3, M4A, M4B, WAV, FLAC, OGG, OPUS, AAC等格式。
Q: 客户端无法播放音频或提示音频播放错误怎么办？
该项目是 Web 应用，音频播放依赖浏览器支持，如果浏览器不支持该音频格式则无法播放。您可以安装 Native Audio Support 插件实现服务器转码播放（如 WMA 等格式），同时 Native Audio Support 还支持多种格式的元数据写入与提取。
Q: 外网如何访问？
建议配合 Nginx Proxy Manager (NPM)、Lucky 或 Frp 等工具进行反向代理或内网穿透。为了获得最佳体验（尤其是移动端 PWA 功能），强烈建议配置 HTTPS 证书。
Q: 插件安装后没有显示？
1. 检查文件权限，确保容器有权读取插件文件。
2. 检查 plugins 目录映射是否正确。
3. 查看容器日志 (docker-compose logs)，搜索 “plugin” 关键字查看是否有加载错误。
Q: Native 插件加载失败？
通常是因为下载了错误的架构版本。请确认您的 NAS/服务器 CPU 架构（可以使用 uname -m 命令查看），然后重新下载对应的版本。
Q: 为什么我自己写的 Widget CSS 定位不起作用？
请检查您是把 CSS 写在哪里了。
- 控制 位置 (position/right/bottom) 的 CSS 必须写在您的 网站 HTML 中（包裹 iframe 的 div 上）。
- 控制 颜色/字体 的 CSS 必须写在 Ting Reader 的 “自定义 CSS 注入” 设置里。
Q: 为什么点击 Widget 封面不能全屏？
请检查您的
iframe 标签是否包含了 allow="fullscreen" 属性。这是浏览器安全策略要求的。Q: Widget 在手机上显示不全？
Widget 具有响应式设计。当宽度小于 380px 时，它会自动切换为垂直布局以适应窄屏。请确保 iframe 高度至少为
150px。