常见问题

管理令牌由部署者通过环境变量 ADMIN_API_TOKEN 设置。首次登录使用当前部署配置中的值。请设置足够长的随机值；不要把令牌提交到代码仓库或发到聊天中。

在主机上安全修改部署环境文件中的令牌，再重启 Shinemby。保留好数据卷和驱动加密密钥。不要通过清空数据库来重置登录。

先检查容器状态、日志、端口映射和数据卷权限；确认 Shinemby 与 drive-bridge 服务都已启动，再查看管理台诊断。反向代理应保留所需请求方法、Range 和 WebSocket（若部署功能使用）。

不一定。授权方式由所选 OpenList 驱动决定。115 可使用网页端 Cookie，也可使用驱动提供的 Open 授权令牌方式；其他网盘按授权页显示的 Refresh Token、应用凭据或验证码流程操作。

不包含。项目复用锁定版本的 OpenList 驱动接入代码，通过内部驱动桥处理认证、目录读取和取链；Shinemby 提供自己的管理台、索引和媒体接口。

授权成功需要先通过根目录读取验证。之后还需添加来源、选择正确媒体子目录、指定媒体类型并启动扫描。文件可能因格式不支持、目录权限、未完成扫描或识别失败而未显示。

表单默认隐藏敏感值，来源凭据由驱动桥加密保存。管理令牌、Cookie、Refresh Token 都应视为密码；不要公开日志或向不可信反向代理提交凭据。部署者仍需限制主机和管理台访问权限。

检查网盘账号状态、驱动提示和来源权限，降低后台扫描频率，等待冷却后重试或按页面指引重新授权。不要通过账号轮换或绕过平台限制解决。

不会。扫描读取目录并写入 Shinemby 自己的数据卷，不会重命名、移动、删除或改写来源文件。清理缺失记录只会清理 Shinemby 索引。

文件名可能缺少年份、使用别名或包含复杂的季集信息。低置信度结果会保留待确认状态；管理员可选择候选或手动搜索后应用。

剧集手动匹配和自动重识别按剧集目录范围处理，避免将同名作品全库一起改绑。应用结果后仍建议检查作品年份和季集。

链接返回并不等于播放成功。网盘签发链接可能短时有效，并要求特定请求头；播放器还必须能访问该链接并支持 Range、跳播和实际媒体编码。请在目标客户端测试首帧、连续播放和 seek。

当前设计以来源直链重定向为主，不代理影视和音频内容。少数不支持所需请求头的来源会明确返回错误；书籍或漫画的小文件才可能进入受限中继。

WebDAV 使用 Emby 连接码或独立的 WEBDAV_PASSWORD。Subsonic 需要另外设置独立的 SUBSONIC_PASSWORD。OPDS 使用管理台说明中显示的凭据。管理令牌不能替代这些协议密码。

浏览器阅读器支持 EPUB 与 PDF；漫画目录可通过兼容协议浏览，但实际解压格式、封面、目录与设备支持需要逐个来源和客户端确认。

扫描时只读下载并解析 `metadata.db`，阅读进度保存在 Shinemby，不会写回网盘。无有效 ISBN 的书籍可按同格式和大小进行限量内容哈希去重；设置 `CALIBRE_HASH_DEDUP=false` 可关闭。

EPUB 与 PDF 可通过 SMTP 邮件发送；MOBI 与 AZW3 在 Shinemby 运行环境安装 Calibre ebook-convert 后会先转换为 EPUB。单本不超过 50 MiB，每小时最多 25 次。请先把发件地址加入 Amazon 的已批准个人文档邮箱。Docker 部署可启用内网隔离的 kindle-conversion profile；默认不启动转换容器。

默认会使用上游请求头检查网盘直链；若链接过期且驱动能重新取链，Shinemby 会再取一次。影视和音频仍只返回 302，不会在链接失败时代理整段媒体。

当前形态是单管理员 Docker 自托管，不包含 SaaS 多租户、注册登录、会员、支付或合作方服务。

使用管理台的数据库备份功能，并将备份保存到独立位置。恢复时还需要对应驱动加密密钥；先在隔离环境验证备份和凭据解密，再替换正式数据。

默认每 24 小时创建并校验一份 SQLite 备份，只保留最近 7 份自动备份；可通过 BACKUP_INTERVAL_HOURS 和 BACKUP_RETENTION_COUNT 调整。恢复用的回滚快照不会被自动清理。备份仍应复制到与主机独立的位置。

提供 Shinemby 版本、部署方式、相关协议、脱敏后的错误类别与复现步骤。提交前请删除管理令牌、Cookie、Refresh Token、网盘分享链接和私人媒体路径。