本文最后更新于 2025-10-23，文章内容可能已经过时。

用天翼云盘保存影视资源，但每次播放都得下载客户端、复制链接、手动整理，实在太麻烦了。有没有办法直接在浏览器或媒体库里访问这些资源？答案是：有！最近我发现了一个超实用的开源项目 —— 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. 创建项目页面根据实际情况定义 项目名称、选择 路径，选中 创建 把上面 yml 文件粘贴到文本框中。检查无误后点击 确定 按钮进行部署。

  3. 等待部署完成，在容器管理中查看运行状态。

使用

1. 在浏览器输入：http://<NAS. 初始化完成后会跳转到登录页面

输入刚才设表盘页面

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

4. 令牌管理

扫码登录

密码登录

5.

  • 存储名称：自定义存储名称，便于识别

  • 存储类型：选择

    关联令牌：选择之前添加的令牌

订阅类型翼

ID：从订阅链接中ff0be16c享链接格式示例:

htt

析分享链接：

  • 分享码：fieiyq6bErum（链接中 /t/ 后面的部分）

  • 访问码：zfr5（括号中的访问码，如果没有则留空）

配置步骤:

  1. 存储类型：选择"分享类型"

  2. 分享码：填入从链接中提取的分享码（如：fieiyq6bErum）

  3. 访问码：填入访问码（如：zfr5），如果分享链接没有访问码则留空

  4. 关联令牌：选择之前添加的令牌

常见分享链接格式：

链接格式

分享码提取

访问码提取

https://cloud.189.cn/t/ABC123

AB

无

https://cloud.189.cn/t/ABC123（访问码

  • 分享码是必填项，从分享链接中的 /t/ 后面提取

  • 访问码是可选项，只有当分享链接设置了访问码时才需要填写

  • 如果分享链接已失效或访问码错误，将无法正常获取文件列表

步骤4：确认添加 配置完成后点击"确认击左侧菜单 "文件浏览" 即可查看和管理文件：

后记

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

现在已经完整的部署好并能够正常使用，如果有进阶需求可以参考 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 和开源工具，点个“在看”我们一起优化！