同步客户端常见问题
同步相关
目录删除后重新创建 (2018-04 已经修复)
一般来说是因为客户端有临时文件没有删除,通过命令行可以列出隐藏的临时文件。 比如 `.~lock.Seafile网盘存储系统报价.xlsx#` 这样的隐藏文件。
删除掉的文件会被某一个客户端反复添加回去
这是因为在这个客户端上这个文件删除失败 (比如权限问题,某一个应用正在打开这个问题) 。解决方法是在这个客户端上手工删除这个文件。
MS Office 在打开一个文件的时候,客户端会检测到这个文件被锁定,会暂停资料库的同步。如果某些应用不锁定文件,就会出现上面的问题。
一个目录被重命名后,又重新出现,并且里面包含了少量的文件
这个一般是由于并发修改导致的。比如以下序列:
- 用户 A 在关闭了同步端的情况下,修改了一个目录 C 下面的一个文件 test.xlsx
- 用户 B 在服务器上或者客户端上把这个目录重命名为 D
- 用户 A 再次打开同步端,此时 A 的修改就会被上传到服务器上,服务器合并 A 和 B 的修改,最终结果就是出现一个 C 目录,下面只包含 A 修改过的那个文件 test.xlsx
资料库同步了几天始终无法同步完成,有下载速度,但是没有进度
因为进度条是同步一个文件之后更新,所以遇到比较大的文件时 (几个 G),进度条会卡很长时间不会更新。因为现在进度条反映的是文件数量,而不是总的要同步的文件大小。如果下载过程中遇到网络错误,会重新同步并下载该文件(有断点续传),但是进度会暂时变成 0%。
文件要过较长的时间才能同步
分两种情况,同步上传慢和同步下载慢
同步上传慢
- 现在客户端检查到文件修改后是立即上传的,如果同步慢,很可能是网络问题。
- 有可能本地打开了一个 office 文件,而其他用户在服务器上移动或者删除这个文件所在的文件夹,此时本地的同步就会停止,直到 office 文件被关闭。本地的修改不会上传,服务器上的修改也不会更新到本地。这个时候客户端主界面会提示文件、文件夹被应用程序锁住。
同步下载慢
- 现在客户端每隔 30s 检查服务器上是否有改动。同步慢,可能是网络问题。
- 也可能是客户端打开着一个 office 文件,同时服务器上有其他人对这个 office 文件做了改动,导致本地的 office 文件无法被更新使得同步暂停。这个时候客户端会提示 xxx 文件被锁定。
- 在 Mac 上有时会出现 office 文件关闭后,~$ 开头的临时文件没有删除的情况,这回导致同步客户端认为 office 文件还打开着。因此这个 office 文件的内容会一直得不到服务器上的更新。
[Mac] 一个 Office 文件一直不同步服务器上的更新
有可能是这个 office 文件上次被关闭时临时文件没有被自动删除,需要检查所在目录下面有没有 ~$ 开头的 office 临时文件,并将其删除。(可能需要在命令行下操作,因为 finder 默认不显示隐藏文件)
同步文件夹出错,文件夹下某个文件被其他应用锁定
本地打开某文件时,服务器上对该文件所在文件夹进行重命名、删除等操作后,本地会报此错误
本地关闭应用,等待文件夹同步及文件完成同步即可
专业版中 Office 文件自动锁定不能工作,或者锁定状态没有同步到其他客户端
可以从几个方面来排查:
- 首先确定是否使用了最新版本的同步端和挂载盘,有些旧的版本在锁处理上有 bug
- 挂载盘在 win 10 + office 2016 的情况下,可能无法自动对 word 文件(doc, docx),xls 文件进行自动锁定。
- 文件的锁定状态同步到其他客户端有10秒左右的时间间隔,在状态同步之前,如果其他客户端很快就打开了这个 office 文件,则还可以修改文件内容,从而可能产生冲突文件。这个一般实际使用中少见,测试过程中经常出现。
同步的时候出现权限错误
这里有几种可能性:
- 有用户没有意识到的权限设置错误。让用户现在网页端进行操作,看有没有权限。
- 某些文件在服务器上被锁定,导致无法上传。
- 可能是程序存在 bug,这个可能性不大。
排查的方式:
- 首先在网页上进行类似的操作,看有没有权限。确定是否权限设置没问题。
- 在同步客户端的系统托盘图标右键菜单中,选择“查看文件同步错误”,会有详细的权限错误原因。
- 如果1、2均无法确定问题,需要查看客户端的 seafile.log,管理员还可以在服务器管理界面 “设备” -> “错误” 中查找相应用户的同步错误。
客户端无法同步一个文件, 日志中是 CDC, index文件错误
错误日志
[11/24/17 08:52:45] cdc.c(237): CDC: failed to open C:/Users/ellrich/Documents/Seafile\Meine Bibliothek/TH-BINGEN/Vorlesungen/SKT-MW&THz/Skript/SKT-THz_V19.pptx.
[11/24/17 08:52:45] ../common/fs-mgr.c(697): Failed to chunk file with CDC.
[11/24/17 08:52:45] repo-mgr.c(1224): Failed to index file C:/Users/ellrich/Documents/Seafile\Meine Bibliothek/TH-BINGEN/Vorlesungen/SKT-MW&THz/Skript/SKT-THz_V19.pptx.
原因是因为应用程序或者杀毒软件 (比如 Sophos Antivirus) 锁定了该文件。
资料库一直显示在等待同步状态,点击立即同步显示非法的请求
应该是退出登录重新登录之后,重新获取资料库的同步用的 token 没有成功导致的。
资料库上右键,然后点“重新同步”能解决
文件名过长不能被同步
文件名过长在本地无法被同步,没有任何提示,也没有相关的文件状态。超过 256 个字节的文件名会被忽略,中文的文件名超过 100 字符很可能有问题。注意是文件名,不是整个路径的长度。
在云端浏览器中无法被上传,提示上传失败
客户端提示“资料库同步失败,本地磁盘不足”
日志中提示
[01/28/19 11:06:50] ../common/block-backend-fs.c(177): [block bend] failed to commit block 78bbfba3-386b-4378-a24e-c9ff8b538412:f7a39424eb20156428cf9cdfb6172ad1527796b9: Input/output error
一般是杀毒软件正在扫描这个块导致块不能保存成功。关闭 windows defender 的实时防护就可以了。
客户端界面上突然所有资料库图标都变成了“云”
这种情况一般是客户端同步的后台进程崩溃了,需要查看客户端的 seafile.log,还需要看 logs/dumps 目录下面有没有 dump 文件,用于调试问题
拖拽上传只传了个空的文件夹,之后同步也还会有客户端异常的提示
文件名乱码导致
同步资料库时与系统路径冲突(需要改进描述)
工作目录包含seafile的工作目录
“不能处理服务器的 HTTP 重定向。请检查服务器配置“
服务器地址写成了http
应用启动相关
[Windows] 应用启动的时候报告有另外一个进程在运行,分析日志看 ccnet.exe 没有启动
是因为360杀毒软件把 ccnet.exe 删掉了。卸载重装后能解决这个问题。
[Windows] 应用启动的时候报告有另外一个进程在运行,分析日志看 ccnet.exe 无法连接
这是 6.2 版本前存在的一个问题。新版中已经没有 ccnet.exe 进程了。关闭防火墙。
[Mac] 应用启动的时候报告有另外一个进程在运行,分析日志看 seaf-daemon 没有启动 (已修复崩溃的问题)
是因为seaf-daemon 崩溃了,可以用console 收集下崩溃日志。
客户端初始化时出错
一般是目录权限的问题
解决办法:把 Seafile/seafile-data目录删掉,然后重新启动,比如 Mac 上把 Seafile 目录选择在了移动硬盘。
云端文件浏览器相关
重命名文件后修改文件内容服务器上看不到新的文件内容
因为重命名之前就打开了该文件,比如用Word 打开了一个docx文件,通过云端浏览器重命名后,如果继续在Word中修改该文件,修改会保存到旧文件中去。
通过云端浏览器打开文件,看到的是文件的旧版本
可能有两个原因
同步操作是有延迟的
同步之前就打开了该文件,Window下会导致该文件锁定,无法被更新。Mac文件虽然打开了,但是应用一直会显示旧文件,需要关闭应用程序,再重新打开。
文件本地上传上一直有一个loading的状态,打开文件修改时还是橙色圈不是绿色对勾,点击保存会提示上传失败,文件不存在。
服务器上的文件被移动/web端文件被重命名
扩展相关
Mac 下 Finder 没有扩展图标
在 系统设置 -> 扩展 中看一下 Seafile Client 扩展有没有被勾选。可以试试取消勾选再勾选上,重复几次后看看扩展图标是不是显示了。
Windows 下文件管理器(Explorer)没有扩展图标
首先要确定安装完成后是否已经重启电脑,一般这个图标是需要重启之后生效的。
如果已经重启过,那么一般是由于受到 Explorer 的扩展图标个数只有15个的限制,多种云盘软件都会抢占这有限的资源。
- 如果是 win 10,那么很可能是由于 OneDrive 默认占用了很多图标,这是一般还是能出来几个比较主要的图标的,比如已同步、正在同步、锁定
- 如果是 win 7,那么可能是安装了其他云盘的同步端,把他们卸载了就好
然后使用客户端的“修复扩展图标”菜单项来修复。
安装相关
因无法将值 xxx 写入注册表项,请确保您有足够的权限访问该注册表项,或者与技术支持人员联系权限的问题。
可能是系统权限或者是 360 安全管家拦截了我们的安装程序。
使用命令行进行安装进行解决,msiexec /package
安装同步客户端时报错提示:“安装目录必须位于本地硬盘驱动器上”
解决方式:
bbs解决办法:https://bbs.seafile.com/t/topic/1442
GitHub解决办法:https://github.com/haiwen/seafile-client/issues/96
使用管理员权限运行安装程序,如果鼠标右键没有看到该提示时,可以使用Windows ProwerShell命令行安装。如图:
安装同步客户端时报错提示“Windows Installer 程序包有问题,此安装需要的程序不能运行。请与您的支持人员或程序包开发商联系”
解决方法: https://blog.csdn.net/yngsuag/article/details/54862900
Mac 如何彻底卸载
除了删除应用外,还需要把 Seafile 目录下的 .seafile-data
这个隐藏目录删除掉。
其他问题记录
windows找不到XXX文件,(。。。已损坏,且无法。。。)
把seafile-data里相应父目录删掉
更新错误!
无法更新,因为它运行于一个只读卷宗如磁盘映像或光盘。。。
Mac系统限制,按照标准方法安装应用
Last modified by Daniel Pan, 2019-08-19
同步相关
目录删除后重新创建 (2018-04 已经修复)
删除掉的文件会被某一个客户端反复添加回去
一个目录被重命名后,又重新出现,并且里面包含了少量的文件
资料库同步了几天始终无法同步完成,有下载速度,但是没有进度
文件要过较长的时间才能同步
[Mac] 一个 Office 文件一直不同步服务器上的更新
同步文件夹出错,文件夹下某个文件被其他应用锁定
专业版中 Office 文件自动锁定不能工作,或者锁定状态没有同步到其他客户端
同步的时候出现权限错误
客户端无法同步一个文件, 日志中是 CDC, index文件错误
资料库一直显示在等待同步状态,点击立即同步显示非法的请求
文件名过长不能被同步
客户端提示“资料库同步失败,本地磁盘不足”
客户端界面上突然所有资料库图标都变成了“云”
拖拽上传只传了个空的文件夹,之后同步也还会有客户端异常的提示
同步资料库时与系统路径冲突(需要改进描述)
“不能处理服务器的 HTTP 重定向。请检查服务器配置“
应用启动相关
[Windows] 应用启动的时候报告有另外一个进程在运行,分析日志看 ccnet.exe 没有启动
[Windows] 应用启动的时候报告有另外一个进程在运行,分析日志看 ccnet.exe 无法连接
[Mac] 应用启动的时候报告有另外一个进程在运行,分析日志看 seaf-daemon 没有启动 (已修复崩溃的问题)
客户端初始化时出错
云端文件浏览器相关
重命名文件后修改文件内容服务器上看不到新的文件内容
通过云端浏览器打开文件,看到的是文件的旧版本
文件本地上传上一直有一个loading的状态,打开文件修改时还是橙色圈不是绿色对勾,点击保存会提示上传失败,文件不存在。
扩展相关
Mac 下 Finder 没有扩展图标
Windows 下文件管理器(Explorer)没有扩展图标
安装相关
因无法将值 xxx 写入注册表项,请确保您有足够的权限访问该注册表项,或者与技术支持人员联系权限的问题。
安装同步客户端时报错提示:“安装目录必须位于本地硬盘驱动器上”
安装同步客户端时报错提示“Windows Installer 程序包有问题,此安装需要的程序不能运行。请与您的支持人员或程序包开发商联系”
Mac 如何彻底卸载
其他问题记录
windows找不到XXX文件,(。。。已损坏,且无法。。。)
更新错误!