FAQ

约 3113 字大约 10 分钟

2025-06-26

Q: 标准映射

A: 对于 docker 容器的目录映射，我的建议是:

Symedia 的同步本质就是通过对路径进行替换 + 拼接来处理的。所以一般情况下，直接用绝对路径进行映射。
映射
- 比如我要映射 /volume1/media 文件夹，
- 就直接映射为 volume1/media:/volume1/media 即可，否则纯粹是自己给自己找麻烦。
- cd2 本质是通过 fuse 挂载到本地文件夹的，当 cd2 发生掉盘重新挂载后，容器内部无法重新获取挂载文件夹的最新状态，因此目录映射的时候需要加个 rslave 选项。
- 对于 cd2 的目录映射，推荐的方式是把 cd2 网盘文件夹挂载到 /.../CloudNAS/CloudDrive下。
挂载
- 比如把115网盘挂载到 /.../CloudNAS/CloudDrive/115，
- 就直接映射为 /.../CloudNAS:/.../CloudNAS:rslave 即可。
注意，只能映射到 CloudNAS，否则会出问题。
关于 cd2 的网盘挂载，cd2 的网盘挂载，推荐直接将整个网盘挂载下来，不推荐挂载某个文件夹。
原因如上，单独挂载某个文件夹，在后续拼接路径上容易出问题。

Q: 标准挂载

A: 对于 cd2 的挂载，我的建议是:

查看 CloudDrive2 标准挂载方式

通用

Q: 读取播放失败、路径替换失败【通用】

A: 基本是目录映射错误。

均先检查一下目录映射是否正确。其中 volume1 为你 NAS 的硬盘主目录。

/volume1 下新建 CloudNAS，文件夹权限添加 Everyone 为读写权限。
cd2 的映射路径为 /volume1/CloudNAS:/CloudNAS:shared。
cd2 里挂载 115 路径应该为 /CloudNAS/CloudDrive/115，挂载仅限设为 777。
SA 和 Emby 这边映射路径为：/volume1/CloudNAS:/CloudNAS:rslave。
SA 的挂载监测路径为 /CloudNAS/CloudDrive。
警告
群晖、绿联等可以直接设置 Everyone 权限的地方并不是那么可靠，如果发现不生效，建议进入 ssh，对该目录执行命令。
```
chmod 777 /volume1
```

容器创建

Q: 群晖无法创建/群晖挂载报错

A: 基本是无开机自启任务

出现如下报错:

docker: Error response from daemon: path /volumel/CloudNAS is mounted on / but it is not a shared or slave mount

在 Linux / 群晖的计划任务中，添加开启任务。

mount --make-shared /volume1/

systemctl daemon-reload

添加后手动运行一次，之后开机会自动运行。

Symedia

Q: Sa 无法登录

A: 基本上是验证服务器被走了代理。

有些用户点击登录后，会显示 502 错误，这时候，只需要重启容器，看一下容器日志，会有验证密钥出错的日志，这时候只需要把验证服务器的 IP 地址加入你代理软件的直连名单即可。

Q: Sa Webhook 失效

A: 基本上是原盘目录或文件夹名配置错误。

Sa 开启调试模式，然后往监控文件中移动一个视频，看看 debug 日志怎么说。

一般是会显示路径无法匹配上，这种情况一般是 云盘根目录 或者是 云盘文件夹名 配置错误。
如果开了还没有，说明 cd2 没有 Webhook 通知过来。
可以尝试，cd2 卸载掉挂载。再不行尝试 cd2 删除 115，重新授权后挂载。

Q: Sa 目录树获取失败（海外机）

A: 基本上是无法连上 115 问题。

报错如下之一:

`Client error '403 Forbidden' for url 'http://webapi.115.com/files/getid?path=******`

`目录树导出失败：HTTPSConnectionPool(host='webapi.115.com', port=443): Read timed out. (read timeout =10)`

查看海外机 115 IP

在海外的机子上 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

修改网络
将 Sa 网络更改为 host

获取实际 115 IP

使用国内设备 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
连接海外机的 SSH， hosts 改为国内 IP 即可。
```
# 进入 hosts 文件
vi /etc/hosts
 
# 进入插入模式
i
```

保存 hosts

将国内设备 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

重新查看海外及 115 IP
再次在海外的机子上 ping 一下 webapi.115.com。如果不是 47 开头的 IP，说明你前边的 Sa 网络没使用到 VPS 的网络模式，自行排查机子的 docker 网络问题。
结束

vi 编辑器操作 Tip

保存并退出:
- 按下 Esc 键，确保你不在插入模式。
- 输入 :wq（代表“写入并退出”），然后按 Enter。

只保存（不退出）:
- 按下 Esc 键。
- 输入 :w，然后按 Enter。这将保存文件，但不会退出 vi。

退出而不保存:
- 按下 Esc 键。
- 输入 :q!（表示强制退出，不保存更改），然后按 Enter。

Q: Sa 处理文件时发生错误

A: 一般是链接文件大小设置错误

如下报错:

【ERROR】2025-06-05 02:33:29,472 - FileCreator 处理文件时发生错误: [Errno 2] No such file or directory: '/CloudNAS/CloudDrive/115/......'

可以排查同步链接配置中的 链接文件大小 设置，默认为 0。
如果你开启了大小，则每个文件都会去访问大小，短时间内会造成大量调用 Api。
没事千万别开这个设置，不然你就容易 boom。

Symedia 插件

Q: cd2 助手: 刷新目录失败

A: 基本上是资源还未审核通过。

报错如下:

CloudDrive2助手 刷新目录 /115/xxx 失败。

115 正在审核中。

Q: cd2 助手: 创建目录时出错

A: 一般是根路径填错

报错如下:

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"}"
>

根路径填错。查看 CloudDrive2 助手基本配置中的根目录注释。

Q: cd2 助手: 无效 token

A: 基本上是 token 未同步过来。

报错如下:

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 之后，重新填写后，只需点击刷新令牌即可。

Q: cd2 助手: 获取令牌失败

A: 一般是 IP 地址填错。

报错如下:

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。

Q: 115 助手: 失效

A: 检查 115 助手是否选中正确的配置，不行就先去设置里的 115 设置重新添加个，再去助手里选中。

Q: EmbyServer 测试失败

A: 基本是本地网络问题。

部分用户因为本地网络问题，直接填写本机 ip+端口会测试失败，从而 Emby 会没有通知，这时候可以做如下尝试:
填写 docker 网关地址+端口。

http://172.17.0.1:8096

此时如果还不行，说明 Emby 跟 Sa 不是不处在同一个网关环境下。可以直接给 Emby 指定跟 Sa 同一个网关。给 Emby 设置成跟 Sa 一样的网关环境变量，然后重启测试。
假设 Sa 的网关是 172.17.0.1。大部分 docker 默认都是这个网关，如若不是，请进入 Sa 容器中自行查看网络。

NO_PROXY=172.17.0.1,127.0.0.1,localhost

或者直接 填写 Emby 的公网地址。这时候你可以不去考虑前边的网关是否一致的问题。

https://你的Emby的公网地址

简单来说，直接给 Emby 添加这三条环境变量，你就可以直接填写 http://172.17.0.1:8096。

NO_PROXY=172.17.0.1,127.0.0.1,localhost
HTTP_PROXY=http://192.168.31.2:7890
ALL_PROXY=http://192.168.31.2:7890

http://192.168.31.2:7890 要修改成你自己的 http 代理地址。

FastEmby

Q: Fe 无法访问 3030 端口

A: 一般是你的 cookie 完蛋了。

正常来说，更换 cookie 即可。

Q: Fe 403 / 405 错误

A: 基本上是你的 IP 被 115 制裁了。

正常情况下，重新拨号即可。（不会重启，那你就拔掉光猫电源插头，然后重新插上）

Emby

Q: Emby 未兼容的流

A: 一般是 Sa 和 cd2 的文件夹没有给 Emby 也映射上。

当然，不要在网页播放视频显示为兼容的流，网页很多格式对浏览器来说，没法完全兼容。

当 Strm 为 local 模式时，Emby 如果无法播放，说明你需要将 Sa 的 cd2 文件夹和你本地媒体库文件夹的映射命令也映射给 Emby。

查看 cd2 在 Sa 中的映射路径
```
/volume1/CloudNAS:/CloudNAS:rslave
```
将上面的映射也添加的 Emby 容器映射中：
```
/volume1/CloudNAS:/CloudNAS:rslave
```
检查 cd2 挂载权限
如果不是 0777，请修改成 0777。
检查 cd2 检查进程
检查是否有屏蔽进程。
检查 CloudNAS 读写权限。
任何 NAS 系统，CloudNAS 文件夹都要给可读写权限。
结束

Q: Emby 在飞牛上，设置了权限后选不到文件夹添加 media 路径

A: 算是飞牛 bug 吧。

在 Emby 的 compose 中添加：

environment:
  - UID=0     # 设置容器内部的用户 ID 为 root 用户
  - GID=0     # 设置容器内部的组 ID 为 root 组
  - GIDLIST=0 # 可选：设置其他需要的组 ID 列表（此处为 root 组）
  - PUID=0    # 设置容器内的用户 ID 为 root 用户
  - PGID=0    # 设置容器内的组 ID 为 root 组

Q: Emby 没有通知

A: 参考

Q: Emby 代理

A: Emby 刮削需要科学环境，否则会因网络因素导致出现各种裂图等等。

参考，添加最后一步的三条环境变量。

CloudDrive2

Q: Sa 轮询监控不灵敏 / cd2 重启后需要重启 Sa 才能访问到挂载目录 / 单层目录的问题

A: 挂载不为标准目录导致的单层目录问题。

当你的 cd2 目录是 /CloudNAS/115 的时候，哪怕你做了 :/CloudNAS:rslave 的映射。当你的 cd2 掉盘后恢复，或者重启，这时候在其他容器中，是无法访问到挂载目录的，只能重启。
所以在挂载网盘到本地的时候，前面应该多一层目录，如 /CloudNAS/CloudDrive/115。
推荐如此挂载都是心血经验，按照教程来，少走些弯路吧少年。

版权所有

版权归属：Symedia

许可证：署名 4.0 国际 (CC-BY-4.0)