TeslaUSB项目解决SMB音乐共享同步失败问题

问题背景

在使用TeslaUSB项目时，部分用户遇到了音乐文件无法从SMB共享同步到TeslaUSB设备的问题。具体表现为音乐共享目录保持为空状态，而系统日志显示存在"Stale file handle"错误。这种情况在使用FritzBox等特定NAS设备作为SMB服务器时尤为常见。

问题分析

通过诊断日志分析，可以观察到以下关键现象：

1. 系统能够成功挂载音乐共享目录
2. 文件权限检查显示所有音乐文件都具有可读权限(rwxrwxrwx)
3. 但在实际同步过程中，rsync报错"Stale file handle (116)"
4. 错误代码23表明文件属性传输失败

深入研究发现，这一问题通常与SMB协议版本不兼容有关。特别是当使用FritzBox等家用路由器内置的SMB服务时，默认配置可能导致文件句柄失效。

解决方案

针对这一问题，我们推荐两种可行的解决方案：

方案一：添加noserverino挂载选项

1. 编辑/etc/fstab文件
2. 在挂载SMB共享的配置行中添加"noserverino"选项
3. 该选项可以防止服务器端inode号变化导致的文件句柄失效

方案二：强制使用SMBv1.0协议

1. 在TeslaUSB配置文件中添加：export CIFS_VERSION=1.0
2. 对于FritzBox设备，需先在路由器设置中启用SMBv1支持
3. 重新运行TeslaUSB设置程序

实施建议

对于FritzBox用户，建议采用第二种方案，并注意以下要点：

1. SMBv1协议存在已知安全风险，仅在内部网络中使用
2. 完成配置后，应重新运行TeslaUSB的安装程序
3. 可通过SSH连接到设备，检查/tmp/rsyncmusiclog.txt确认同步状态

验证方法

用户可以通过以下命令验证问题是否解决：

1. 使用SSH登录TeslaUSB设备
2. 执行挂载命令：mount /mnt/musicarchive
3. 列出音乐文件：ls -lR /mnt/musicarchive
4. 检查同步日志：cat /tmp/rsyncmusiclog.txt

总结

通过调整SMB协议版本或挂载选项，可以有效解决TeslaUSB与特定NAS设备间的音乐同步问题。这一解决方案不仅适用于FritzBox设备，对于其他可能产生类似问题的SMB服务器也同样有效。用户在实施时应注意网络安全，特别是在启用旧版协议时，应确保设备处于可信网络环境中。