对 SFTP 连接器问题进行故障排除 - Amazon Transfer Family
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

对 SFTP 连接器问题进行故障排除

本节介绍了 SFTP 连接器问题的可能解决方案。

为您的 SFTP 连接器添加可信主机密钥进行故障排除

描述

创建或编辑 SFTP 连接器并添加可信主机密钥时,您会收到以下错误:Failed to edit connector details (Invalid host key format.)

原因

如果您粘贴了正确的公钥,则问题可能是您包含了密钥的comment部分。 Amazon Transfer Family 目前不接受密钥的注释部分。

解决方案

将密钥的注释部分粘贴到文本字段中时,将其删除。例如,假设您的密钥可能如下所示:

ssh-rsa AAAA...== marymajor@dev-dsk-marymajor-1d-c1234567.us-east-1.amazon.com

删除 == 字符后面的文本,然后仅粘贴密钥中直至并包括 == 的部分。

ssh-rsa AAAA...==

密钥协商失败

描述

您会收到密钥交换协商失败的错误。例如:

Key exchange negotiation failed due to incompatible host key algorithms. Client offered: [ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521, rsa-sha2-512, rsa-sha2-256] Server offered: [ssh-rsa]

原因

出现此错误是因为服务器支持的主机密钥算法与连接器支持的主机密钥算法之间没有重叠。

解决方案

确保远程服务器支持错误消息中列出的至少一种客户端主机密钥算法。有关支持的算法列表,请参阅 Amazon Transfer Family SFTP 连接器的安全策略

SFTP 连接器限制

描述

使用 SFTP 连接器进行文件传输时,您会遇到以下错误:

{"type":"ExecutionThrottled","details":{},"connectorId":"c-1234567890abcdef0"}

或者,您会注意到在大容量操作期间,文件传输会间歇性延迟或失败。

原因

SFTP 连接器的服务配额限制了并发文件传输和 API 操作的数量。当超过这些限制时,会进行限制以保护服务并确保所有客户的公平使用。

解决方案

要解决 SFTP 连接器问题,请尝试以下解决方案:

  1. 在应用程序中实现指数退避和重试逻辑。例如,创建一个函数,该函数会自动重试失败的操作,并且两次尝试之间的等待时间会增加。

  2. 在您的应用程序中实施速率限制:

    • 限制并发传输的数量。

    • 添加传输批次之间的延迟。

  3. 根据服务配额监控您的使用情况:

    • 使用 CloudWatch 指标来跟踪 API 使用情况。

    • 设置警报,以便在接近配额限制时通知您。

  4. 有关扩展 SFTP 连接器的选项,请参阅扩展您的 SFTP 连接器

  5. 如果限制仍然存在并影响您的业务运营,请通过 Service Quotas 控制台申请增加配额。

优化 SFTP 连接器性能

描述

您的 SFTP 连接器传输速度比预期的慢,或者性能不稳定。

原因

SFTP 连接器的性能可能会受到各种因素的影响,包括网络状况、文件大小、远程服务器配置和并发传输限制。

解决方案

要优化 SFTP 连接器性能,请:

  • 配置您的远程 SFTP 服务器以获得最佳性能:

    • 增加每个会话的最大会话数和传输次数

    • 为高延迟连接优化 TCP 窗口大小

    • 如果两端都支持,则使用压缩

  • 考虑网络优化,将 Transfer Family 连接器放在靠近远程 SFTP 服务器的区域。

  • 实施监控策略以识别性能瓶颈:

    • 监控网络吞吐量和延迟

    • 分析日志以了解慢速传输中的模式

其他 SFTP 连接器问题

描述

运行后您会收到错误StartFileTransfer,但不知道问题的原因,并且在 API 调用后只返回连接器 ID。

原因

此错误可能有多种原因。要排除故障,我们建议您测试连接器并搜索 CloudWatch 日志。

解决方案

  • 测试您的连接器:请参阅测试 SFTP 连接器。如果测试失败,系统会根据测试失败的原因提供错误消息。该部分介绍如何通过控制台或使用控制台测试连接器 TestConnectionAPI 命令。

  • 查看您的连接器的 CloudWatch 日志:请参阅SFTP 连接器的日志条目示例。本主题提供了 SFTP 连接器日志条目的示例,以及命名惯例,以帮助您找到相应的日志。