AI摘要

用天翼云盘保存影视资源，但每次播放都得下载客户端、复制链接、手动整理，实在太麻烦了。有没有办法直接在浏览器或媒体库里访问这些资源？答案是：有！最近我发现了一个超实用的开源项目 —— cloudpan189-share，它可以直接解析天翼云盘分享链接，生成清晰的目录结构，还支持 WebDAV、在线播放、STRM 映射等功能。

这篇文章就来教你如何通过 Docker 快速部署 cloudpan189-share，打造一个真正“免客户端”的影视资源中心。

详细介绍

CloudPan189 Share 是什么？

CloudPan189 Share 是一款专为天翼云盘设计的智能文件分享管理工具。该系统能够将天翼云盘的分享链接转换为标准的目录结构，并通过 WebDAV 协议提供统一的文件访问接口。

✨ 核心功能

  • 🔄 智能链接转换：解析天翼云盘分享链接，转换为标准目录树结构，支持多层级文件夹映射，保持原有组织架构
  • 🌐 WebDAV 统一接口：提供标准 WebDAV 协议支持，兼容主流客户端，统一文件访问入口，简化多链接管理流程，具备文件锁定机制确保并发安全
  • 💻 全功能网页端：现代化文件浏览器界面，支持文件夹导航、在线下载与搜索，内置媒体播放器支持视频、音频在线预览
  • ⚡ 高性能流媒体：多线程并发传输提升访问速度，流式播放技术实现视频无缓冲播放，智能带宽适配确保流畅体验
  • 📁 媒体目录映射：将云盘文件通过 STRM 映射到本地 media_dir 目录，兼容 Emby、Jellyfin、Plex 等媒体服务器，支持格式自定义、一键重建与批量管理

部署指南

单容器部署

docker run -d \
  --name cloudpan189-share \
  -p 12395:12395 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/media_dir:/app/media_dir \
  --restart unless-stopped \
  xxcheng123/cloudpan189-share:latest

$(pwd)：当前终端所在目录，例如现在终端在 /home/it 这里的 $(pwd) 就代表这个目录 。

容器编排部署

docker-compose.yml

services:
  cloudpan189-share:
    image: xxcheng123/cloudpan189-share:latest
    container_name: cloudpan189-share
    ports:
      - "12395:12395"
    volumes:
      - ./data:/app/data
      - ./media_dir:/app/media_dir
    restart: unless-stopped
  1. 在飞牛主页面找到 Docker 打开后，切换菜单 Compose -> 新增项目。
  2. 创建项目页面根据实际情况定义 项目名称、选择 路径，选中 创建 docker-compose.yml 后，把上面 yml 文件粘贴到文本框中。检查无误后点击 确定 按钮进行部署。
  3. 等待部署完成，在容器管理中查看运行状态。

使用

1. 在浏览器输入：http://<NASIP>:12395进行初始化

2. 初始化完成后会跳转到登录页面


输入刚才设置的管理员账号密码进行登录。

3. 仪表盘页面


仪表盘显示系统运行状态和统计信息。

4. 令牌管理

扫码登录




密码登录


5. 存储管理

  • 存储名称：自定义存储名称，便于识别
  • 存储类型：选择"订阅类型"或"分享类型"
  • 关联令牌：选择之前添加的令牌

订阅类型配置

以天翼云盘官方订阅号为例：

订阅链接：https://content.21cn.com/h5/subscrip/index.html#/pages/own-home/index?uuid=fb90a24ff0be16c92948fb1851b323df

订阅用户ID：fb90a24ff0be16c92948fb1851b323df

配置信息：
-订阅用户ID：从订阅链接中提取的UUID（如上例中的 fb90a24ff0be16c92948fb1851b323df）


分享类型配置

分享链接格式示例:

https://cloud.189.cn/t/fieiyq6bErum（访问码：zfr5）

解析分享链接：

  • 分享码：fieiyq6bErum（链接中 /t/ 后面的部分）
  • 访问码：zfr5（括号中的访问码，如果没有则留空）
配置步骤:

  1. 存储类型：选择"分享类型"
  2. 分享码：填入从链接中提取的分享码（如：fieiyq6bErum）
  3. 访问码：填入访问码（如：zfr5），如果分享链接没有访问码则留空
  4. 关联令牌：选择之前添加的令牌

常见分享链接格式：

链接格式分享码提取访问码提取
https://cloud.189.cn/t/ABC123ABC123无
https://cloud.189.cn/t/ABC123（访问码：1234）ABC1231234

⚠️ 注意事项：

  • 分享码是必填项，从分享链接中的 /t/ 后面提取
  • 访问码是可选项，只有当分享链接设置了访问码时才需要填写
  • 如果分享链接已失效或访问码错误，将无法正常获取文件列表

步骤4：确认添加
配置完成后点击"确认添加"按钮。

6. 文件管理

配置完成后，点击左侧菜单 "文件浏览" 即可查看和管理文件：



后记

如果要返回管理后台，点击页面底部的 管理 即可返回

现在已经完整的部署好并能够正常使用，如果有进阶需求可以参考 CloudPan189 Share 快速开始文档

常见问题

1. 扫码授权失败

问题现象：扫码后提示授权失败或令牌无效

解决方案：

  • 确保使用最新版本的天翼云盘APP
  • 检查网络连接是否正常
  • 重新生成二维码进行扫码
  • 确认在APP中完成了授权操作

2. 文件列表为空

问题现象：添加存储后文件浏览页面显示为空

解决方案：

  • 订阅类型：检查订阅用户ID是否正确
  • 分享类型：检查分享码和访问码是否正确，确认分享链接未失效
  • 确认令牌是否有效且未过期
  • 验证存储配置是否正确
  • 检查网络连接和服务状态

3. 分享链接无法访问

问题现象：分享类型存储显示"无法获取文件列表"或"分享已失效"

解决方案：

  • 检查分享链接是否仍然有效（在浏览器中直接访问测试）
  • 确认分享码提取是否正确
  • 如果有访问码，确认访问码是否正确
  • 检查分享链接是否已过期或被删除
  • 尝试重新获取最新的分享链接

4. 令牌过期处理

问题现象：提示令牌已过期，无法获取文件

解决方案：

  • 进入令牌管理页面
  • 找到过期的令牌
  • 重新扫码更新令牌
  • 或删除旧令牌，添加新令牌

5. 容器启动失败

问题现象：Docker容器无法正常启动

解决方案：

# 检查容器状态
docker ps -a | grep cloudpan189-share

# 查看详细日志
docker logs cloudpan189-share

# 重新启动容器
docker restart cloudpan189-share

# 如果问题持续，删除容器重新创建
docker rm -f cloudpan189-share
# 然后重新运行启动命令

6. 端口冲突

问题现象：提示端口12395已被占用

解决方案：
方式1：更换端口
方式2：查找占用端口的进程并停止

lsof -i :12395
kill -9 <PID>

7. 视频播放问题

问题现象：视频无法正常播放或加载缓慢

解决方案：

  • 检查网络连接速度
  • 尝试刷新页面重新加载
  • 确认浏览器支持视频格式
  • 检查令牌是否有效
  • 如果是大文件，请耐心等待缓冲

8. 配置文件问题

问题现象：Linux 部署时程序无法启动或配置不生效

解决方案：

  • 检查 etc/config.yaml 文件是否存在
  • 确认配置文件格式正确（YAML 格式对缩进敏感）
  • 检查数据目录和日志目录是否存在
  • 确认程序有读写相关目录的权限

9. 媒体目录映射相关问题

问题现象：媒体文件无法映射到media_dir目录或媒体服务器无法识别

解决方案：

  • 确认在系统设置中已开启"媒体目录映射"功能
  • 检查视频文件格式是否在支持列表中
  • 验证WebDAV挂载路径是否正确
  • 确认媒体服务器有读取media_dir目录的权限
  • 尝试使用"重建映射"功能重新生成

问题现象：媒体服务器访问映射文件时提示无法访问

解决方案：

  • 检查媒体服务器网络是否能访问CloudPan189 Share服务
  • 确认系统设置中的"基础URL"配置正确
  • 验证天翼云盘令牌是否有效
  • 检查防火墙是否阻止了媒体服务器的访问

10. 多线程流式下载问题

问题现象：视频播放仍然缓慢或卡顿

解决方案：

  • 确认已开启"多线程流式下载"功能
  • 适当调整线程数，过多的线程可能导致性能下降
  • 调整块大小，较大的块可能提升性能但增加内存使用
  • 检查网络带宽和服务器性能
  • 确认天翼云盘令牌有效且未被限速

问题现象：开启多线程后系统资源占用过高

解决方案：

  • 降低多线程流线程数设置
  • 减小块大小以降低内存使用
  • 监控服务器CPU和内存使用情况
  • 考虑在服务器性能较低时关闭此功能

结尾

  • 💬 有任何部署问题或使用心得，欢迎在评论区交流～
  • 🛠️ 如果你也在折腾 NAS 和开源工具，点个“在看”我们一起优化！