概述
SFTP（SSH File Transfer Protocol）是基于 SSH 的安全文件传输协议，提供加密传输能力，广泛用于企业间数据文件的安全交换。DataBuddy 数据接入支持将 SFTP 服务器作为来源端，读取其中的文件进行离线同步。本文介绍其连接配置、能力支持范围、前提条件与常见问题。
支持的版本
类型 | 支持版本 |
SFTP | 不显示版本 |
读取能力
能力 | 支持情况 | 说明 |
离线同步（读 / 写） | ✓ / - | 支持作为离线同步任务的源端读取数据；DataBuddy 数据源仅支持接入读取，不支持写入 |
使用限制
限制项 | 说明 |
认证方式 | 支持密码 / 密钥（SSH PrivateKey）认证 |
读取对象 | 以目录或文件为粒度读取 |
支持的文件格式
前提条件
在 SFTP 服务器上创建专用账号，并配置认证方式：
密码认证：设置登录密码。
密钥认证：将 DataBuddy 的公钥添加到目标账号的
authorized_keys 中，并准备对应的私钥。说明：
建议为同步任务创建专用账号，避免与业务账号混用。
创建数据源
操作步骤
1. 登录 DataBuddy 控制台。
2. 在顶部切换到目标地域和 Workspace。
3. 进入 数据集成 > 数据源管理（或 平台管理 > 数据源管理）。
4. 点击 添加数据源，选择 SFTP。
5. 填写连接配置与认证信息，详见 参数说明。
6. 点击 连通性测试（参见 数据源连通性测试）。
7. 测试通过后点击 保存 或 保存 & 创建任务。
参数说明
参数 | 说明 | 是否必填 | 默认值 |
数据源名称 | 数据源在工作空间内的唯一标识 | 是 | — |
主机地址 | SFTP 服务器地址 | 是 | — |
端口 | SFTP 服务端口 | 是 | 22 |
认证方式 | 密码 / 密钥 | 是 | 密码 |
用户名 | SFTP 登录账号 | 是 | — |
密码 | 密码认证下的登录密码（支持 SSM 凭证托管） | 认证方式为密码时必填 | — |
私钥 | 密钥认证下的私钥文件 | 认证方式为密钥时必填 | — |
在数据接入任务中使用
离线文件读取
配置项 | 说明 |
数据来源 | 已配置的 SFTP 数据源 |
读取路径 | 目标目录或文件路径，支持通配符 |
文件格式 | 选择 Text / CSV / JSON 等 |
最佳实践
实践 | 建议 |
认证安全 | 优先使用密钥认证，避免明文密码 |
目录规划 | 按日期分区组织目录，便于增量同步 |
网络打通 | 确保与 SFTP 服务器网络连通 |
常见问题
Q：连接超时或被拒绝？
A：检查主机地址、端口与网络连通性，确认认证信息正确。
Q：密钥认证失败？
A：确认目标账号
authorized_keys 中已添加对应公钥，且私钥格式正确。
