跳到主要内容

AI 驱动文档

您想了解什么？

FTP 图像导出

本页提供逐步指引，用于配置 OV10i 摄像头将捕获的图像自动发送到远程 FTP 服务器，以进行存档、分析或与外部系统的集成。

使用场景： FTP 导出非常适合将检查图像发送到网络存储、云服务，或支持 FTP 文件传输的第三方分析系统。

前提条件​

在配置 FTP 导出之前，请确保具备：

  • FTP 服务器详情 - 主机地址、凭据和文件夹路径
  • 网络连接性 - 摄像头与 FTP 服务器位于同一网络或可路由路径
  • 充足的存储空间 - FTP 服务器对图像文件有足够的空间
  • 防火墙配置 - FTP 通信所需端口 20-21 已放行

逐步配置​

1. 访问 FTP 配置​

  • 导航至摄像头的网页界面
  • 转到 Recipe Editor
  • 点击 Configure FTP 以打开配置模态框

2. 启用 FTP 通信​

切换 FTP 状态：

  • Enable - 启用 FTP 通信
  • Disable - 禁用 FTP 通信（默认）
提示

在初始设置阶段保持禁用，测试配置后再启用。

3. 配置服务器连接​

服务器主机设置：

FieldDescriptionExampleServer HostNetwork address of FTP server192.168.1.100 orftp.company.comFTP Remote PathSubfolder on server for images/inspection_images/line_1/

示例配置：

  • 本地 NAS： 192.168.1.50，路径 /camera_data/ov20i/
  • Cloud FTP： files.cloudprovider.com，路径 /production/quality/
  • 根目录： 将 FTP Remote Path 留空以保存到服务器根目录

4. 设置认证凭据​

登录信息：

FieldRequiredNotesFTP User✅ YesUsername for FTP server accessFTP Password✅ YesPassword for FTP authentication
备注

安全性： 凭据本地存储在摄像头上。请使用具有限权限的专用 FTP 账户。

5. 配置输出选项​

文件名自定义：

OptionPurposeExample ResultAdd Trigger ID to FilenameUnique identifier for Library searchimage_T001234.jpgAdd Timestamp to FilenameDate/time informationimage_20250620_143052.jpgBoth OptionsMaximum traceabilityimage_T001234_20250620_143052.jpg

推荐设置：

  • Add Trigger ID - 对跟踪特定检查至关重要
  • Add Timestamp - 有助于按时间顺序进行整理

6. 配置防火墙设置​

被动模式选择：

ModeWhen to UseFirewall CompatibilityPassive Mode ONCamera behind firewallBetter compatibilityPassive Mode OFFDirect network connectionMay require port configuration

默认建议： 除非有特定网络需求，否则请启用 Passive Mode。

测试您的配置​

1. 测试图像捕获​

  • Manual Trigger: 使用摄像头界面捕获测试图像
  • Digital Trigger: 如使用外部触发，请发送触发信号
  • Verify Capture: 确认图像已出现在摄像头的本地存储中

2. 验证 FTP 传输​

检查 FTP 服务器：

  • 导航至已配置的 FTP Remote Path
  • 查找最近传输的图像文件
  • 验证文件名是否包含已配置的选项（Trigger ID、Timestamp）

预期的文件名格式：


image_T001234_20250620_143052.jpg
└─────┘ └────┘ └──────────────┘
  Base  Trigger     Timestamp
        ID         (YYYYMMDD_HHMMSS)

3. 测试多次捕获​

  • 连续捕获多张图像
  • 验证所有图像是否成功传输
  • 检查是否存在文件命名冲突或覆盖

常见问题排除​

连接失败​

症状：

  • 图像已捕获但未出现在 FTP 服务器上
  • 相机日志中的错误信息

解决方案：

  1. 验证网络： 从相机网络 Ping FTP 服务器
  2. 检查凭据： 使用 FTP 客户端软件测试登录
  3. 防火墙设置： 如处于防火墙后，请启用 Passive Mode
  4. 服务器容量： 确保 FTP 服务器有可用存储空间

文件权限错误​

症状：

  • 连接成功但文件未保存
  • 错误日志中的 "Permission denied"

解决方案：

  1. 用户权限： 验证 FTP 用户是否对目标文件夹具有写权限
  2. 文件夹创建： 确保服务器上存在 FTP Remote Path 文件夹
  3. 磁盘空间： 检查 FTP 服务器上的可用存储空间

传输间歇性问题​

症状：

  • 部分图像已传输，其它未传输
  • 连接偶发问题

解决方案：

  1. 网络稳定性： 检查网络拥塞或连通性问题
  2. 服务器负载： 验证 FTP 服务器是否不过载
  3. 文件大小： 大尺寸图像在慢速连接上可能超时

FTP 导出最佳实践​

文件组织策略​

文件夹结构示例：


/inspection_data/
├── line_1/
│   ├── 2025/06/20/
│   └── defects/
├── line_2/
└── archive/

命名约定：

  • 在 FTP Remote Path 中包含 Recipe Name：/quality_control/pcb_inspection/
  • 使用 Trigger ID 以追踪到特定检验
  • 添加 Timestamp 以便按时间排序

性能优化​

网络考虑：

  • 图像质量： 在文件大小与检验要求之间取得平衡
  • 传输频率： 高速生产可能需要专用 FTP 服务器
  • 批处理： 考虑针对间歇性网络连接进行本地缓冲

安全建议​

FTP 账户设置：

  • 在 FTP 服务器上创建专用相机用户账户
  • 将权限限定在特定文件夹
  • 使用强且唯一的密码
  • 考虑 FTPS（FTP over SSL）用于加密传输

高级配置​

自定义文件处理​

Node-RED 集成：

  • 使用 Node-RED 流实现自定义文件名逻辑
  • 为传输的文件添加元数据
  • 根据检测结果实现有条件的 FTP 传输

请参阅：Node-RED Basics

备份策略​

冗余存储：

  • 配置多个 FTP 目标
  • 本地存储保留作为备份
  • 自动清理旧文件
自动生成 FTP 流

Integration Builder 可以根据简单的英文描述生成完整的 FTP export 流。从描述你的需求（例如“将失败的检验图像上传到带时间戳的文件名的 FTP 服务器”）开始 ，即可在几秒钟内获得可投入生产的 Node-RED flow。

🔗 相关链接​