首先确定自己是不是最新版，如果不是，则 升级到最新版，然后看看问题是否已解决。
以及多看看群置顶的消息，有点动手能力，排查能力。
遇到报错请 直接贴 详细的日志截图 和 相关配置 以及 版本号，光看 Tg 推送报错 是算不了命的 ！！！
- 比如我要映射
/volume1/media文件夹，- 就直接映射为
/volume1/media:/volume1/media即可，否则纯粹是自己给自己找麻烦。
cd2 本质是通过 fuse 挂载到本地文件夹的，当 cd2 发生掉盘重新挂载后，容器内部无法重新获取挂载文件夹的最新状态，因此目录映射的时候需要加个 rslave 选项。
对于 cd2 的目录映射，推荐的方式是把 cd2 网盘文件夹挂载到 /.../CloudNAS/CloudDrive下。
比如把115网盘挂载到
/.../CloudNAS/CloudDrive/115，就直接映射为
/.../CloudNAS:/.../CloudNAS:rslave即可。
注意，只能映射到 CloudNAS，否则会出问题。
关于 cd2 的网盘挂载，cd2 的网盘挂载，推荐直接将整个网盘挂载下来，不推荐挂载某个文件夹。
原因如上，单独挂载某个文件夹，在后续拼接路径上容易出问题。
volume1 为你 NAS 的硬盘主目录。
/volume1 下新建 CloudNAS，文件夹权限添加 Everyone 为读写权限。/volume1/CloudNAS:/CloudNAS:shared。/CloudNAS/CloudDrive/115，挂载仅限设为 777。/volume1/CloudNAS:/CloudNAS:rslave。/CloudNAS/CloudDrive。群晖、绿联等可以直接设置 Everyone 权限的地方并不是那么可靠，如果发现不生效，建议进入 ssh，对该目录执行命令。
chmod 777 /volume1
/mnt/addons 下新建 CloudNAS，设置好文件夹权限。/mnt/addons/CloudNAS:/CloudNAS:shared。/CloudNAS/CloudDrive/115，挂载权限设为 777。/mnt/addons/CloudNAS:/CloudNAS:rslave。/CloudNAS/CloudDrive。/volume1 下新建 CloudNAS，设置好文件夹权限。/volume1/CloudNAS:/CloudNAS:shared。/CloudNAS/CloudDrive/115，挂载仅限设为 777。/volume1/CloudNAS:/CloudNAS:rslave。/CloudNAS/CloudDrive。/vol1/1000 下新建 CloudNAS，设置好文件夹权限。/vol1/1000/CloudNAS:/CloudNAS:shared。/CloudNAS/CloudDrive/115，挂载权限设为 777。/vol1/1000/CloudNAS:/CloudNAS:rslave。/CloudNAS/CloudDrive。/vol1/1000/CloudNAS，/vol1/1000/CloudNAS:/vol1/1000/CloudNAS:rslave 冒号右边和左边完全一样。docker: Error response from daemon: path /volumel/CloudNAS is mounted on / but it is not a shared or slave mount
mount --make-shared /volume1/
systemctl daemon-reload
`Client error '403 Forbidden' for url 'http://webapi.115.com/files/getid?path=******`
or
`目录树导出失败：HTTPSConnectionPool(host='webapi.115.com', port=443): Read timed out. (read timeout =10)`
ping 一下 webapi.115.com，你会发现不是 47 开头的 IP。$ ping webapi.115.com
PING d6imgsc9ypxzwynfbqwus5pc1g47eatw.yundunwaf1.com (47.113.23.100): 56 data bytes
64 bytes from 163.181.35.231: icmp_seq=0 ttl=52 time=20.806 ms
64 bytes from 163.181.35.231: icmp_seq=1 ttl=52 time=24.867 ms
64 bytes from 163.181.35.231: icmp_seq=2 ttl=52 time=21.072 ms
ping 一下 webapi.115.com。$ ping webapi.115.com
PING d6imgsc9ypxzwynfbqwus5pc1g47eatw.yundunwaf1.com (47.113.23.100): 56 data bytes
64 bytes from 47.113.23.100: icmp_seq=0 ttl=52 time=20.806 ms
64 bytes from 47.113.23.100: icmp_seq=1 ttl=52 time=24.867 ms
64 bytes from 47.113.23.100: icmp_seq=2 ttl=52 time=21.072 ms
# 进入 hosts 文件
vi /etc/hosts
# 进入插入模式
i
ping 之后获取到的 IP 保存到海外（VPS）的 hosts 中。127.0.0.1 localhost
# The following lines are esirable for IPv6 capable hosts
::1 ip6-localhost ip6-loopback
fe00::0 ip6-localnet
fe00::0 ip6-mcastprefix
fe00::0 ip6-allnodes
fe00::0 ip6-allrouters
fe00::0 ip6-allhosts
# 115 国内 IP
47.113.23.100 webapi.115.com
ping 一下 webapi.115.com。如果不是 47 开头的 IP，说明你前边的 Sa 网络没使用到 VPS 的网络模式，自行排查机子的 docker 网络问题。vi 编辑器操作 Tip：
- 保存并退出：
- 按下
Esc键，确保你不在插入模式。- 输入
:wq（代表“写入并退出”），然后按Enter。
- 只保存（不退出）：
- 按下
Esc键。- 输入
:w，然后按Enter。这将保存文件，但不会退出vi。
- 退出而不保存：
- 按下
Esc键。- 输入
:q!（表示强制退出，不保存更改），然后按Enter。
【ERROR】2025-06-05 02:33:29,472 - FileCreator 处理文件时发生错误: [Errno 2] No such file or directory: '/CloudNAS/CloudDrive/115/......'
可以排查同步链接配置中的 「链接文件大小」 设置，默认为 0。
如果你开启了大小，则每个文件都会去访问大小，短时间内会造成大量调用 Api。
没事千万别开这个设置，不然你就容易 boom。
CloudDrive2助手 刷新目录 /115/xxx 失败。
115 正在审核中。
cloud_drive_client.makedirs("/116/abc")
File "/Users/shenxian/PycharmProjects/Symedia/Symedia/apps/CloudDrive2/client.py", line 434, in makedirs
raise Exception(f"创建目录时出错: {str(e)}")
Exception: 创建目录时出错: <_InactiveRpcError of RPC that terminated with:
status = StatusCode.UNIMPLEMENTED
details = "create_folder is not supported"
debug_error_string = "UNKNOWN:Error received from peer {grpc_message:"create_folder is not supported", grpc_status:12, created_time:"2025-05-28T10:25:00.370823+08:00"}"
>
根路径填错。
status = StatusCode.UNAUTHENTICATED
details = "Invalid auth token"
debug_error_string = "UNKNOWN:Error received from peer {created_time:"2025-05-28T11:01:18.270034994+08:00", grpc_status:16, grpc_message:"Invalid auth token"}"
>
v1.0.39.3 之后，重新填写后，只需点击刷新令牌即可。
CloudDrive2助手 获取令牌失败:<_InactiveRpcError of RPC that terminated with:
status = StatusCode.UNAVAILABLE
details = "failed to connect to all addresseslast error: UNKNOWN: ipv4:127.0.0.1:19798: Failed to connect to remote host: connect: Connection refused(111)"
debug_error_string = "UNKNOWN:Error received from peer {grpc_message:"failed to connect to all addresses; last error: UNKNOWN: ipv4:127.0.0.1:19798: Failed to connect to remote host: connect: Connection refused (111)", grpc_status:14, created_time:“2025-01-01T01:01:01.60`408426+08:00”}"
>
IP 地址填错，不要填 127.0.0.1。
/volume1/CloudNAS:/CloudNAS:rslave
将上面的映射也添加的 Emby 容器映射中：
/volume1/CloudNAS:/CloudNAS:rslave
0777。 environment:
- UID=0 # 设置容器内部的用户 ID 为 root 用户
- GID=0 # 设置容器内部的组 ID 为 root 组
- GIDLIST=0 # 可选：设置其他需要的组 ID 列表（此处为 root 组）
- PUID=0 # 设置容器内的用户 ID 为 root 用户
- PGID=0 # 设置容器内的组 ID 为 root 组
http://172.17.0.1:8096
172.17.0.1。大部分 docker 默认都是这个网关，如若不是，请进入 Sa 容器中自行查看网络。NO_PROXY=172.17.0.1,127.0.0.1,localhost
http://你的Emby的公网地址
environment:
- ALL_PROXY=http://192.168.9.5:7890
- HTTP_PROXY=http://192.168.9.5:7890
- NO_PROXY=172.17.0.1,127.0.0.1,localhost
http://192.168.9.5:7890 改成你自己的 http 代理。/CloudNAS/115 的时候，哪怕你做了 :/CloudNAS:rslave 的映射，当你的 cd2 掉盘后恢复，或者重启，这时候在其他容器中，是无法访问到挂载目录的，只能重启。
/CloudNAS/CloudDrive/115。