Shinemby115 网盘
可使用网页端 Cookie；支持的驱动还提供 Open 授权令牌流程。按页面提示完成后，Shinemby 会验证根目录读取。
把自己的媒体接入 Shinemby
Shinemby 在你管理的 Docker 主机上运行。它连接你有权访问的网盘或 NAS，建立只读媒体索引，再通过 Emby 兼容接口及其他媒体协议提供访问。
凭据只在本机管理台输入。网盘 Cookie、令牌和连接码都属于敏感信息。不要把它们发到聊天、截图或公开工单中；部署对公网开放时请配置 HTTPS。
Docker 部署
- 准备 Docker Compose。在项目目录运行
./scripts/init-env.sh生成仅当前用户可读写的初始配置和随机管理令牌，然后使用项目提供的 Compose 配置启动服务并持久化 Shinemby 数据目录。 - 首次启动后查看管理令牌。从初始化命令的一次性输出或既有受保护配置中读取
ADMIN_API_TOKEN，使用管理页登录。令牌只保存在部署者的密码管理器和受保护的环境文件中。 - 设置访问地址。内网先通过主机地址和映射端口访问；公网部署前配置反向代理 HTTPS、可信代理及外部媒体地址。重启服务后在管理台运行诊断。
不要将数据库、密钥文件或包含网盘授权信息的环境文件放入公开目录。更换加密密钥前先按密钥轮换说明执行迁移并确认可以解密现有来源。
连接网盘或 NAS
进入管理台的“网盘来源”，按驱动页面显示的授权方式完成认证。Shinemby 内置所选 OpenList 驱动的接入部分，不包含 OpenList 管理站点。
百度网盘
按驱动要求提供 Refresh Token 和应用凭据。若选择由 OpenList 在线 API 代为刷新，提交前会显示外部传输提示并要求确认。
123 云盘与光鸭云盘
根据驱动提供应用凭据、Refresh Token 或短信验证码。不要连续重复发送短信；验证码有有效期和次数限制。
移动云盘
当前使用 139Yun 驱动，可提供 Authorization，或从 mail.10086.cn 获取 Mail Cookie。该驱动使用非官方接口，平台策略可能变化。
天翼云盘（PC）
使用 189CloudPC 账号密码授权。账号安全校验、验证码或区域限制可能影响首次连接；以根目录验证结果为准。
夸克网盘
Cookie 驱动仅允许选书籍/漫画目录。下载链接需要 Cookie、Referer 和固定 User-Agent；服务端小对象代理上限为 100 MiB。
NAS
按管理台提供的 NAS Agent 配对流程连接只读媒体目录，并确认 Agent 在线及允许访问的根路径。
添加来源的基本流程
- 选择网盘驱动并按页面说明授权。
- 确认根目录列表成功，再选择媒体目录。
- 选择媒体类型，设置来源目录与扫描范围。
- 查看驱动状态；遇到授权失败、限流或网络错误时，先依提示修复并再试。
授权验证成功只代表 Shinemby 能读取来源目录；真实文件扫描、生成播放链接和播放器播放还需要分别确认。驱动和网盘的能力可能不同，以当前授权页列出的方式为准。
选择媒体目录与扫描
- 选对根目录。分别为电影、剧集、音乐、有声书、电子书或漫画指定来源子目录。先从小目录试扫，检查识别结果后再扩展范围。
- 启动扫描并查看任务。扫描会读取目录信息并更新 Shinemby 数据库。它不会重命名、移动或删除网盘文件。
- 处理未识别与待确认项。可使用文件名规则、TMDB 候选和手动匹配。改绑后确认详情页的标题、年份和剧集归属。
- 核对来源状态。过期授权、上游限流或目录权限变化可能使扫描或取链失败；按来源卡片的错误提示更新授权或调整扫描节奏。
索引数据库、用户数据、元数据和缩略图保存在 Shinemby 数据卷。阅读进度、播放状态以及本地封面也由 Shinemby 管理。发现 Calibre `metadata.db` 时会只读导入书目；有效 ISBN 用于跨库去重，无 ISBN 时默认只对同格式、同大小的候选书做内容哈希。哈希每本不超过 32 MiB、每次扫描总读取不超过 256 MiB，可在 `.env` 将 `CALIBRE_HASH_DEDUP=false` 关闭。Shinemby 不会将阅读进度写回网盘书目库。
连接播放器与阅读器
Emby / Jellyfin 兼容客户端
在客户端添加 Shinemby 服务器地址，使用管理台显示的 Emby 连接码完成连接。支持范围依赖客户端调用的兼容接口。
WebDAV
地址为管理台显示的 WebDAV 路径。用户名为管理台展示的账号；密码使用 Emby 连接码或单独配置的 WebDAV 密码。
Subsonic
音频客户端需要部署者单独设置 SUBSONIC_PASSWORD。该密码与管理令牌、Emby 连接码相互独立。
OPDS / Audiobookshelf
在管理台读取各自显示的服务地址与连接说明。书籍目录、封面、章节和进度取决于格式和客户端支持。
影视和音频按来源能力直接重定向到媒体链接；书籍或漫画仅在受支持且大小限制内才可使用受限中继。播放兼容性请使用实际目标客户端检查首帧、持续播放、跳播和音轨。
Kindle 邮件发送
- 在 Amazon 的“管理您的内容和设备”中打开个人文档设置，将 Shinemby 的 SMTP 发件地址加入已批准的个人文档发送邮箱名单。
- 把 Kindle 设备或应用显示的 Send-to-Kindle 邮箱填入受保护的
KINDLE_EMAIL配置，并在管理台设置 SMTP 主机、端口、发件人和认证。 - EPUB/PDF 直接发送。MOBI/AZW3 会转成 EPUB。Docker 部署可在
.env设置KINDLE_CONVERTER_URL=http://kindle-converter:8090，再运行docker compose --profile kindle-conversion up -d --build；首次初始化已生成内部鉴权令牌，旧部署需自行设置至少 32 字符的随机KINDLE_CONVERTER_TOKEN。该 Calibre 转换容器只接入内部网络，不向公网开放端口。也可在 Shinemby 运行环境安装 Calibre 并设置KINDLE_CONVERTER_PATH。单本最大 50 MiB，每小时最多发起 25 次；先用小文件确认邮件与设备接收。
备份与维护
- 系统默认每 24 小时创建并校验一份数据库备份，自动保留最近 7 份。你也可以在管理台手动创建备份，并应把备份复制到独立、安全的位置。
- 妥善保管驱动桥加密密钥、管理令牌和环境配置；恢复备份时需要对应密钥才能读取已保存凭据。
- 更新前查看发行说明，保留可回滚镜像与数据备份；先在维护窗口升级，再检查健康状态与来源授权。
- 定期检查数据盘空间、扫描失败任务、驱动状态和日志。日志不应包含完整 Cookie 或访问令牌。
- 驱动源码包含 OpenList 项目组件；分发镜像或向网络用户提供服务时，应按对应许可证完成源码与声明义务。