radektomasek/keboola-wr-ftp-ftps

Keboola FTP/FTPS写入器

镜像概述

这是Keboola Connect平台的FTP/FTPS写入器组件，用于将KBC存储中的数据通过FTP/FTPS协议传输至远程服务器。组件基于Node.js开发，支持Babel/ES6/ES7特性，提供灵活的配置选项以满足不同场景的数据传输需求。

核心功能

• 支持FTP与FTPS协议（含ftps_debug模式，兼容新旧库实现）
• 可通过GUI选择KBC存储中的输入表，支持列级筛选
• 自定义文件命名规则：附加时间戳、自定义占位符（需包含%%table%%和%%datetime%%）
• 配置项：连接重试次数、超时时间、详细日志输出、批量目录上传
• 凭据加密存储，确保数据传输安全

使用场景

• 定期将KBC存储数据同步至远程FTP/FTPS服务器进行备份
• 跨系统数据传输：将Keboola处理后的数据推送至第三方FTP服务
• 需要自定义文件命名格式的批量数据导出场景

配置说明

表格选择

通过Keboola的Table Input Mapping GUI选择输入表，支持列指定等高级功能。

FTP/FTPS设置

需配置以下核心参数：

• Remote host：FTP/FTPS服务器地址
• Username/Password：服务器认证凭据（自动加密）
• Protocol：协议类型（ftp/ftps/ftps_debug，默认ftp）
• Remote path：远程存储路径（默认/）
• Port：服务器端口（默认21）
• Append datetime：是否附加时间戳（默认false）
• Datetime format：时间戳格式（默认YYYYMMDD_HHmmss）
• Placeholder：文件名占位符（需包含%%table%%和%%datetime%%）
• Connection retries：连接重试次数（默认5）
• Verbose：是否开启详细日志（默认false）
• Timeout：连接超时时间（默认***ms）
• Upload directory：是否批量上传目录（不适用时间戳配置）

凭据要求

必须提供Remote host、Username、Password和Protocol，否则执行失败。

Docker部署示例

bash
docker run -d \
  --name keboola-ftp-writer \
  -e KBC_REMOTE_HOST="ftp.example.com" \
  -e KBC_USERNAME="your-ftp-username" \
  -e KBC_PASSWORD="your-ftp-password" \
  -e KBC_PROTOCOL="ftp" \
  -e KBC_REMOTE_PATH="/data/keboola-exports" \
  radektomasek/keboola-wr-ftp-ftps

注：实际使用需结合Keboola平台配置或挂载自定义配置文件，上述示例为基础环境变量配置参考。