常见问题

按遇到的现象查找排查方法。详细操作与限制见使用指南。

连接失败，或看不到 Bucket

检查区域、AccessKey ID 与 Secret 是否匹配，以及 STS Token 是否过期。如果没有列举全部 Bucket 的权限，在高级选项指定 Bucket。确认 RAM 策略允许当前操作。内网和 PrivateLink 需要相应网络环境；CNAME 与 PrivateLink 还需指定 Bucket 和 HTTPS Endpoint。

搜索找不到文件

搜索匹配远程对象 Key 的前缀，不是文件名任意位置或文件内容。确认所在目录与前缀，并按需加载更多结果。排序只调整已经加载的行。

关闭应用后，传输没有继续

使用相同连接配置和 AccessKey ID 重新连接，在传输任务中手动重试恢复的记录，不会自动重启。有效检查点可继续使用；源文件变化时按恢复提示处理。复制、移动和删除队列仅在当前会话有效。取消会保留检查点与未完成的远程分片，不再需要的分片可通过 OSS 生命周期规则或控制台清理。

下载失败或磁盘空间不足

选择可写的本地目录，并为下载临时文件和最终落盘时的临时副本预留空间。保留名称、大小写冲突、符号链接子目录可能被拒绝，请查看失败项的具体原因。旧记录无法安全确定目的地时，应重新创建下载任务。

无法预览或编辑文件

文本编辑支持 5 MiB 以内的 UTF-8 文件，预览读取上限为 8 MiB，位图解码上限为 2000 万像素。文档、FLV 或不支持的编解码器提供外部打开／下载入口；无法预览时可下载后使用本地应用。

分享链接失效或无法打开

重新生成链接，并检查所选域名和有效期。签名链接有效期受已知 STS 到期时间限制，公开链接需要公开访问权限。不要为了排查私有链接而直接把对象改为公开。持有有效签名链接的人可以使用它授予的权限。

设置无法保存，或凭据库不可用

凭据默认只保存在内存中。保存凭据需要系统凭据库，可先解锁或启用对应服务，也可不保存凭据直接连接。无效设置文件会保留原样并阻止写入；先备份，再修复并重新加载。保存位置见设置。

如何反馈问题？

请提供“关于”页的应用版本、操作系统与架构、复现步骤、预期与实际结果，以及脱敏后的错误信息或截图。本地诊断日志需主动开启。移除 AccessKey、Token、授权码、SMTP 密码及签名链接后，在 GitHub 提交问题。