From 45e45d10439e02087df4f09de0ddc0ee806d3e31 Mon Sep 17 00:00:00 2001 From: Shuke <272197458+ShukeBta@users.noreply.github.com> Date: Sat, 13 Jun 2026 14:45:46 +0800 Subject: [PATCH] Delete CLOUD_STATUS.md Signed-off-by: Shuke <272197458+ShukeBta@users.noreply.github.com> --- CLOUD_STATUS.md | 169 ------------------------------------------------ 1 file changed, 169 deletions(-) delete mode 100644 CLOUD_STATUS.md diff --git a/CLOUD_STATUS.md b/CLOUD_STATUS.md deleted file mode 100644 index 97c3f15..0000000 --- a/CLOUD_STATUS.md +++ /dev/null @@ -1,169 +0,0 @@ -# MediaStationGo 云盘功能状态报告 - -## 已实现的功能 - -### 1. 云盘存储支持 -- ✅ 支持的云盘类型: - - Quark (夸克网盘) - - 115 (115网盘) - - CloudDrive2 (桥接网盘) - - OpenList/AList (兼容网盘) - -### 2. 播放机制 -- ✅ HTTP 302 重定向播放(直连云盘CDN) -- ✅ STRM 文件支持 -- ✅ Emby 协议兼容(标记 IsRemote=true) -- ✅ Token 认证传递 - -### 3. CORS 支持 -- ✅ 支持的 Header: - - Authorization - - Content-Type - - X-Requested-With - - X-Emby-Token - - X-MediaBrowser-Token - - X-Emby-Authorization - -### 4. 图片代理 -- ✅ 云盘图片缓存 -- ✅ Emby API 图片端点:/Items/{id}/Images/Primary -- ✅ 直接图片输出(避免 token 401) - -### 5. 启动健康检查 -- ✅ 云盘配置验证 -- ✅ Ping 测试连通性 -- ✅ 自动扫描云盘媒体库 - -### 6. 存储管理 -- ✅ 删除云盘时清理媒体库 -- ✅ 停止相关扫描任务 - -## 可能的问题原因 - -### 第三方播放器无法播放 - -**可能原因:** -1. **云盘未配置** - 检查是否添加了云盘存储配置 -2. **Cookie 过期** - 云盘 Cookie 需要定期更新 -3. **CORS 配置** - 生产环境需要配置 cors_origins -4. **网络问题** - 云盘 CDN 网络不可达 - -**诊断步骤:** -\\\ash -# 1. 运行诊断脚本 -./diagnose-cloud.ps1 - -# 2. 检查日志中的错误 -docker logs mediastation-go 2>&1 | grep -i "cloud storage" - -# 3. 检查 CORS 配置 -# 编辑 config.toml,添加: -# cors_origins = ["*"] # 或具体的播放器域名 -\\\ - -### 云盘海报不显示 - -**可能原因:** -1. **图片路径格式错误** - 应该是 /api/cloud/play/{type}?ref={path} -2. **图片未缓存** - 首次加载可能较慢 -3. **云盘权限问题** - Cookie 权限不足 - -**检查方法:** -\\\ash -# 查看图片代理日志 -docker logs mediastation-go 2>&1 | grep -i "image" - -# 测试图片 URL(需要替换 token) -curl -H "X-Emby-Token: YOUR_TOKEN" http://localhost:8080/Items/MEDIA_ID/Images/Primary -\\\ - -### 媒体库重复扫描 - -**说明:** -- 每个用户首次访问会触发扫描 -- 云盘媒体库在启动时自动扫描 -- 扫描结果对所有用户共享 - -**优化建议:** -- 使用调度任务定期扫描 -- 避免手动触发多次扫描 - -## 配置示例 - -### 1. 添加云盘存储 - -通过 Web UI 的"外部存储"页面添加: -- 选择云盘类型(Quark/115/CloudDrive2) -- 输入 Cookie(从浏览器开发者工具获取) -- 测试连接 -- 启用存储 - -### 2. 创建云盘媒体库 - -媒体库路径格式: -\\\ -cloud://{provider}:{scan_dir}:{display_dir} -\\\ - -示例: -\\\ -cloud://quark:/电影:/Movies -cloud://cloud115:/剧集:/TV Shows -\\\ - -### 3. CORS 配置(针对第三方播放器) - -编辑 config.toml: -\\\ oml -[app] -cors_origins = [ - "*", # 允许所有来源(开发环境) - # 或指定具体域名(生产环境): - # "https://app.emby.media", - # "app://infuse" -] -\\\ - -## 最新改进(本次提交) - -1. **存储删除功能** - 删除云盘时自动清理关联的媒体库和媒体项 -2. **健康检查** - 启动时验证所有云盘配置,及早发现问题 -3. **扫描验证** - 扫描前检查存储配置是否存在,避免无效扫描 - -## 下一步建议 - -### 对于用户: -1. 运行诊断脚本:./diagnose-cloud.ps1 -2. 检查是否配置了云盘存储 -3. 验证 Cookie 是否有效 -4. 配置 CORS(如果使用第三方播放器) - -### 对于开发: -1. ✅ 添加更详细的错误日志 -2. ✅ 启动时健康检查 -3. 🔄 优化扫描缓存机制 -4. 🔄 添加 Cookie 自动刷新 -5. 🔄 改进错误提示 - -## 参考项目对比 - -### MoviePilot 云盘方案 -- 使用 CloudDrive/Alist 作为统一桥接层 -- STRM 文件 + 302 重定向 -- 支持本地缓存 - -### Nowen-Video 云盘方案 -- 直接集成各云盘 API -- WebDAV 挂载 -- 支持多种播放模式 - -### MediaStationGo 优势 -- 原生多云盘支持(无需额外桥接工具) -- Emby API 完全兼容 -- 轻量级架构 -- 自动健康检查 - ---- - -**更新时间:** 2026-06-11 12:55:56 -**版本:** main@7ef4af6