亿动网
用天翼云盘保存影视资源，但每次播放都得下载客户端、复制链接、手动整理，实在太麻烦了。有没有办法直接在浏览器或媒体库里访问这些资源？答案是：有！最近我发现了一个超实用的开源项目 —— cloudpan189-share，它可以直接解析天翼云盘分享链接，生成清晰的目录结构，还支持 WebDAV、在线播放、STRM 映射等功能。
这篇文章就来教你如何通过 Docker 快速部署 cloudpan189-share，打造一个真正"免客户端"的影视资源中心。
----------------------------------------
详细介绍
CloudPan189 Share 是什么？
CloudPan189 Share[1] 是一款专为天翼云盘设计的智能文件分享管理工具。该系统能够将天翼云盘的分享链接转换为标准的目录结构，并通过 WebDAV 协议提供统一的文件访问接口。
✨ 核心功能
• • 🔄 智能链接转换：解析天翼云盘分享链接，转换为标准目录树结构，支持多层级文件夹映射，保持原有组织架构
• • 🌐 WebDAV 统一接口：提供标准 WebDAV 协议支持，兼容主流客户端，统一文件访问入口，简化多链接管理流程，具备文件锁定机制确保并发安全
• • 💻 全功能网页端：现代化文件浏览器界面，支持文件夹导航、在线下载与搜索，内置媒体播放器支持视频、音频在线预览
• • ⚡ 高性能流媒体：多线程并发传输提升访问速度，流式播放技术实现视频无缓冲播放，智能带宽适配确保流畅体验
• • 📁 媒体目录映射：将云盘文件通过 STRM 映射到本地 media_dir 目录，兼容 Emby、Jellyfin、Plex 等媒体服务器，支持格式自定义、一键重建与批量管理
----------------------------------------
部署指南
单容器部署
$(pwd)：当前终端所在目录，例如现在终端在 /home/it 这里的 $(pwd) 就代表这个目录 。
容器编排部署
docker-compose.yml
----------------------------------------
• 1. 在飞牛主页面找到 Docker 打开后，切换菜单 Compose -> 新增项目。
• 2. 创建项目页面根据实际情况定义 项目名称、选择 路径，选中 创建 docker-compose.yml 后，把上面 yml 文件粘贴到文本框中。检查无误后点击 确定 按钮进行部署。
• 3. 等待部署完成，在容器管理中查看运行状态。
----------------------------------------
使用
1. 在浏览器输入：http://<NASIP>:12395进行初始化
2. 初始化完成后会跳转到登录页面
3. 仪表盘页面
4. 令牌管理
扫码登录
密码登录
5. 存储管理
• • 存储名称：自定义存储名称，便于识别
• • 存储类型：选择"订阅类型"或"分享类型"
• • 关联令牌：选择之前添加的令牌
订阅类型配置
以天翼云盘官方订阅号为例：
配置信息：-订阅用户ID：从订阅链接中提取的UUID（如上例中的 fb90a24ff0be16c92948fb1851b323df）
分享类型配置
分享链接格式示例:
解析分享链接：
• • 分享码：fieiyq6bErum（链接中 /t/ 后面的部分）
• • 访问码：zfr5（括号中的访问码，如果没有则留空）
配置步骤:
• 1. 存储类型：选择"分享类型"
• 2. 分享码：填入从链接中提取的分享码（如：fieiyq6bErum）
• 3. 访问码：填入访问码（如：zfr5），如果分享链接没有访问码则留空
• 4. 关联令牌：选择之前添加的令牌
常见分享链接格式：
⚠️ 注意事项：
• • 分享码是必填项，从分享链接中的 /t/ 后面提取
• • 访问码是可选项，只有当分享链接设置了访问码时才需要填写
• • 如果分享链接已失效或访问码错误，将无法正常获取文件列表
6. 文件管理
后记
现在已经完整的部署好并能够正常使用，如果有进阶需求可以参考 CloudPan189 Share 快速开始文档[2]
----------------------------------------
常见问题
1. 扫码授权失败
问题现象：扫码后提示授权失败或令牌无效
解决方案：
• • 确保使用最新版本的天翼云盘APP
• • 检查网络连接是否正常
• • 重新生成二维码进行扫码
• • 确认在APP中完成了授权操作
2. 文件列表为空
问题现象：添加存储后文件浏览页面显示为空
解决方案：
• • 订阅类型：检查订阅用户ID是否正确
• • 分享类型：检查分享码和访问码是否正确，确认分享链接未失效
• • 确认令牌是否有效且未过期
• • 验证存储配置是否正确
• • 检查网络连接和服务状态
3. 分享链接无法访问
问题现象：分享类型存储显示"无法获取文件列表"或"分享已失效"
解决方案：
• • 检查分享链接是否仍然有效（在浏览器中直接访问测试）
• • 确认分享码提取是否正确
• • 如果有访问码，确认访问码是否正确
• • 检查分享链接是否已过期或被删除
• • 尝试重新获取最新的分享链接
4. 令牌过期处理
问题现象：提示令牌已过期，无法获取文件
解决方案：
• • 进入令牌管理页面
• • 找到过期的令牌
• • 重新扫码更新令牌
• • 或删除旧令牌，添加新令牌
5. 容器启动失败
问题现象：Docker容器无法正常启动
解决方案：
6. 端口冲突
问题现象：提示端口12395已被占用
解决方案：方式1：更换端口方式2：查找占用端口的进程并停止
7. 视频播放问题
问题现象：视频无法正常播放或加载缓慢
解决方案：
• • 检查网络连接速度
• • 尝试刷新页面重新加载
• • 确认浏览器支持视频格式
• • 检查令牌是否有效
• • 如果是大文件，请耐心等待缓冲
8. 配置文件问题
问题现象：Linux 部署时程序无法启动或配置不生效
解决方案：
• • 检查 etc/config.yaml 文件是否存在
• • 确认配置文件格式正确（YAML 格式对缩进敏感）
• • 检查数据目录和日志目录是否存在
• • 确认程序有读写相关目录的权限
9. 媒体目录映射相关问题
问题现象：媒体文件无法映射到media_dir目录或媒体服务器无法识别
解决方案：
• • 确认在系统设置中已开启"媒体目录映射"功能
• • 检查视频文件格式是否在支持列表中
• • 验证WebDAV挂载路径是否正确
• • 确认媒体服务器有读取media_dir目录的权限
• • 尝试使用"重建映射"功能重新生成
问题现象：媒体服务器访问映射文件时提示无法访问
解决方案：
• • 检查媒体服务器网络是否能访问CloudPan189 Share服务
• • 确认系统设置中的"基础URL"配置正确
• • 验证天翼云盘令牌是否有效
• • 检查防火墙是否阻止了媒体服务器的访问
10. 多线程流式下载问题
问题现象：视频播放仍然缓慢或卡顿
解决方案：
• • 确认已开启"多线程流式下载"功能
• • 适当调整线程数，过多的线程可能导致性能下降
• • 调整块大小，较大的块可能提升性能但增加内存使用
• • 检查网络带宽和服务器性能
• • 确认天翼云盘令牌有效且未被限速
问题现象：开启多线程后系统资源占用过高
解决方案：
• • 降低多线程流线程数设置
• • 减小块大小以降低内存使用
• • 监控服务器CPU和内存使用情况
• • 考虑在服务器性能较低时关闭此功能
