FAQ
约 3113 字大约 10 分钟
2025-06-26
遇到报错请 直接贴 详细的日志截图 和 相关配置 以及 版本号,光看 Tg 推送报错 是算不了命的 !!!
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 的挂载,我的建议是:
通用
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:7890http://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。 - 推荐如此挂载都是心血经验,按照教程来,少走些弯路吧少年。