CloudDrive2 助手

CloudDrive2 助手用于配置 CD2 连接、监听目录和刷新参数。它主要服务于文件整理、转存离线完成后的目录刷新，以及 CD2 Webhook / PushMessage 相关联动。

注意：如果填写令牌时，cd2 权限要给满，文件操作权限，如果不知道是哪些直接全选即可，并且目录要从根目录开始也就是/不要设置任何网盘子目录，如果使用账号密码登录则无需在意

适合做什么

场景	说明
转存完成后刷新	115 / 123 转存离线完成后刷新对应 CD2 目录
文件整理监控	对监听目录进行汇总和刷新，减少重复触发
多目录监听	同时监听多个网盘挂载目录
目录映射排查	通过 CD2 名称确认 NanShare 操作的是哪个挂载

配置字段

字段	说明
开启 CloudDrive2 监控	总开关
CD2 地址	CD2 Web 地址，例如 http://172.17.0.1:19798
汇总秒数	多次变更合并触发，避免连续刷新
用户名 / 密码	CD2 登录凭据
API Token	如果使用 Token，可填写此项
监听目录	推荐为空，多个目录用逗号分隔

监听目录示例

/115open/媒体库
/123云盘/电影
/123云盘/电视剧

多个目录可以写成：

/115open/媒体库,/123云盘/电影,/123云盘/电视剧

使用流程

1. 确认 NanShare 容器能访问 CD2 地址。
2. 进入 NanShare Web -> 工具箱 -> CloudDrive2 助手。
3. 开启 CD2 监控。
4. 填写 CD2 地址、用户名密码或 API Token。
5. 填写需要监听或刷新的目录。
6. 保存后在转存、文件整理或 HDHive 解析页面填写对应的 CD2 挂载名称。

和转存离线的关系

115 转存离线、123 转存离线、HDHive 解析转存完成后，可以按配置刷新 CD2 目录。此时需要注意两个名字：

名称	说明
CD2 地址	CloudDrive2 服务地址
CD2 中的网盘挂载名称	例如 115open、123云盘，用于拼接刷新目录

常见问题

转存完成后没有刷新

检查转存页面是否开启“完成后刷新 CD2 目录”，并确认 CD2 中的网盘挂载名称 与 CD2 内实际显示一致。

地址应该写宿主机还是容器地址

写 NanShare 容器可以访问到的地址。host 网络通常可以写局域网 IP 或宿主机地址；bridge 网络需要确认容器间网络。

汇总秒数怎么设置

如果一个任务会连续创建很多文件，建议设置几秒到几十秒，让刷新合并执行。太短可能频繁刷新，太长会延迟入库。