mirror of
https://github.com/truewhile/MeBox.git
synced 2026-09-29 03:26:37 +08:00
Delete CLOUD_STATUS.md
Signed-off-by: Shuke <272197458+ShukeBta@users.noreply.github.com>
This commit is contained in:
Shuke
-169
@@ -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
|
||||
Reference in New Issue
Block a user