mirror of https://github.com/truewhile/MeBox.git synced 2026-09-29 11:36:36 +08:00

Files

T

ShukeBta 53135b444f docs: add cloud storage diagnostics and status report

- Add PowerShell diagnostic script for cloud storage issues
- Document all cloud storage features and capabilities
- Provide troubleshooting guide for common problems
- Include configuration examples and best practices

2026-06-11 12:56:15 +08:00

3.9 KiB

Raw Blame History

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. 存储管理

✅ 删除云盘时清理媒体库
✅ 停止相关扫描任务

可能的问题原因

第三方播放器无法播放

可能原因：

云盘未配置 - 检查是否添加了云盘存储配置
Cookie 过期 - 云盘 Cookie 需要定期更新
CORS 配置 - 生产环境需要配置 cors_origins
网络问题 - 云盘 CDN 网络不可达

诊断步骤： \\ash

1. 运行诊断脚本

./diagnose-cloud.ps1

2. 检查日志中的错误

docker logs mediastation-go 2>&1 | grep -i "cloud storage"

3. 检查 CORS 配置

编辑 config.toml，添加：

cors_origins = ["*"] # 或具体的播放器域名

云盘海报不显示

可能原因：

图片路径格式错误 - 应该是 /api/cloud/play/{type}?ref={path}
图片未缓存 - 首次加载可能较慢
云盘权限问题 - 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"

] \\

下一步建议

对于用户：

运行诊断脚本：./diagnose-cloud.ps1
检查是否配置了云盘存储
验证 Cookie 是否有效
配置 CORS（如果使用第三方播放器）

对于开发：

✅ 添加更详细的错误日志
✅ 启动时健康检查
🔄 优化扫描缓存机制
🔄 添加 Cookie 自动刷新
🔄 改进错误提示

参考项目对比

MoviePilot 云盘方案

使用 CloudDrive/Alist 作为统一桥接层
STRM 文件 + 302 重定向
支持本地缓存

Nowen-Video 云盘方案

直接集成各云盘 API
WebDAV 挂载
支持多种播放模式

MediaStationGo 优势

原生多云盘支持（无需额外桥接工具）
Emby API 完全兼容
轻量级架构
自动健康检查

更新时间： 2026-06-11 12:55:56 版本： main@7ef4af6

3.9 KiB Raw Blame History Unescape Escape