SFTP - 配置指南
目录
主机与身份验证
我们会为您单独分配一个 SFTP 文件夹，并在专属的 SFTP 服务器（基于 AWS）上进行托管。每位客户都会有独立的账户，只能访问自己专属的 SFTP 文件夹。我们支持 密钥认证，因此，您需要先生成一对公私钥，并在 公钥 字段中填写公钥， 格式要求为 openSSH RSA 。如需生成密钥，请参考下方 如何为 SFTP 服务器生成公钥 的说明。
配置
请将您生成的公钥填写到 公钥 字段中。您也可以根据需要修改 用户名 字段。 用户名 需以字母、数字或下划线开头，长度为 3 到 100 个字符。用户名可包含字母、数字、下划线、@、点（.）和短横线（-）。
请将 用户名、 Spotnana 域名地址和 端口号 等信息妥善保存，方便后续您公司内部负责配置文件上传的同事使用。
注意： SFTP 文件夹配置完成后，这些信息可以在 管理页面再次查看。如需接收文件上传报告，请在 SFTP 邮件通知 字段填写您的邮箱地址。详细说明请见下方 报告与错误处理 部分。
点击 连接按钮。
添加公钥后，初始状态会显示为 未验证。在文件夹收到实际文件前，OBT 页面会一直显示“未验证”。您可以上传任意测试文件，也可以上传正式的 HR 数据或自定义字段文件（仅支持指定格式的文件）。如果后续更新了公钥，状态也会重新变为 未验证 ，直到下次接收到文件为止。
如需删除 SFTP 文件夹，请点击 断开连接。这样会移除您的 SFTP 文件夹。如需重新配置，需从头填写上述所有信息。
上传频率与计划
文件上传的频率和时间由您自行决定。我们会在检测到新文件上传到 SFTP 文件夹后，立即启动文件处理流程。也就是说，您只要把文件上传到 SFTP 文件夹，我们的系统就会自动开始处理。
如果需要针对不同数据类型（如用户、自定义字段、法人实体等）的上传频率建议，请参考每种数据类型的 上传频率与计划 SFTP 配置说明。
报告与错误处理
我们会收集您的文件上传数据，并在每次上传后生成内部报告，发送到您在 SFTP 邮件通知 字段填写的邮箱。每个文件的报告内容包括：
文件上传失败的原因（如格式错误、缺少列名等）。
文件中某一行上传失败的具体原因。我们不支持部分更新，如果某行某列有错误或必填项缺失，则该行会整体上传失败。
上传状态（待处理、成功、失败）。
您可以根据报告内容排查并修正错误。如无法自行解决，请联系技术支持。
相关常见问题
我们是否支持只包含需新增或更新记录的增量文件？
支持
无论通过 SFTP 还是手动上传，文件是否必须包含所有可选列（即使这些列未被使用）？
不需要
如何为 SFTP 服务器生成公钥
请按照以下步骤生成 SSH 公钥，并提供给我们。
格式
类型：字符串
长度限制：最长 2048 字符。
格式要求
^ssh-rsa\s+[A-Za-z0-9+/]+[=]{0,3}(\s+.+)?\s*$
生成 SSH 密钥
在 Windows 命令行或 macOS、Linux、UNIX 终端中运行以下命令即可生成 SSH 密钥：
ssh-keygen -t rsa -b 4096 -f key_name
其中
-t 代表加密类型
-b 代表密钥长度（位数）
-f 代表密钥文件名
密钥示例
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDDJB9oBRPrBegMDPEQo+HmNDb/jKUJL6q2kQpNNMDjNps9mhhwJ1dP/lOavMitBPAndeXlwaNEm2XbGaSrZtD/tbQTX1HQjP6pacy+Alf8kYBm5QFfl/Z6lGC8qHys10fpRXgYE7UhdSv6VyRqt1gELGFQwVBZ2kJJuBGJF1IRywwvG/h68B8iWU1+6KEWYQoUcT45r3j3otnx4NhhzpTiNgDbMk0ix+kar4/IstobRLcb7rt7FoUerTLNrVDi69DqbsGY5LN+NM8jVx0sPQLRC/ruil8pTHP3k4rDCc7a80+sH4sUTW+mHc7MTqbi/CcyyFAD8h7p6WqxEydOaJjMnvqAbE17BOj0TSxv3HMohTf3skzE7PbzVcjIfHTpFPGxmJkghAYAMi5l9VvAs91IpVylxjqPss3xQQJIZEmQdG2k7zk/UpsUFlmaOj6lCHRicFKCixKekzzm3nFuJvDEklurtydOQjZ8WkPzTSJfZBdKMuMUi0SQ9m9ZAw99t0=
各类数据类型的操作说明
如需了解通过 SFTP 上传不同类型数据的详细说明，请参考以下内容：
这篇文章有帮助吗？
很好！
感谢您的反馈。
抱歉我们没能带来帮助
感谢您的反馈。
反馈已发送
感谢，我们将试着改善此文档。