跳到主要内容

FTP 图像导出

本页提供配置 OV20i 相机自动将拍摄图像发送到远程 FTP 服务器以进行归档、分析或与外部系统集成的分步说明。

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

先决条件​

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

  • FTP 服务器信息 — 主机地址、凭据及文件夹路径
  • 网络连接 — 相机与 FTP 服务器处于同一网络或可路由路径
  • 足够存储空间 — FTP 服务器有足够空间存储图像文件
  • 防火墙配置 — 开放端口 20-21 以支持 FTP 通信

分步配置​

1. 访问 FTP 配置​

  • 进入相机的网页界面
  • 进入 Settings → FTP 菜单
  • 点击 Configure FTP 打开配置窗口

2. 启用 FTP 通信​

切换 FTP 状态：

  • Enable — 开启 FTP 通信
  • Disable — 关闭 FTP 通信（默认）
提示

初始设置时保持关闭，测试配置成功后再启用。

3. 配置服务器连接​

服务器主机设置：

字段       说明                    示例
Server Host  FTP 服务器的网络地址  192.168.1.100 或 ftp.company.com
FTP Remote Path  服务器上存放图像的子文件夹  /inspection_images/line_1/

示例配置：

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

4. 设置认证凭据​

登录信息：

字段        必填   说明
FTP User   ✅ 是  FTP 服务器访问用户名
FTP Password ✅ 是  FTP 认证密码
备注

安全提示： 凭据存储于相机本地。请使用权限受限的专用 FTP 账户。

5. 配置输出选项​

文件名自定义：

选项               目的                      示例结果
Add Trigger ID to Filename  用于库搜索的唯一标识符  image_T001234.jpg
Add Timestamp to Filename   日期时间信息             image_20250620_143052.jpg
Both Options               最大追溯性               image_T001234_20250620_143052.jpg

推荐设置：

  • Add Trigger ID — 追踪特定检测必选
  • Add Timestamp — 便于按时间排序

6. 配置防火墙设置​

被动模式选择：

模式            适用场景               防火墙兼容性
Passive Mode ON  相机位于防火墙后方     兼容性更好
Passive Mode OFF  直接网络连接           可能需端口配置

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

测试配置​

1. 测试图像采集​

  • 手动触发： 使用相机界面拍摄测试图像
  • 数字触发： 若使用外部触发，发送触发信号
  • 确认采集： 确认图像已保存于相机本地存储

2. 验证 FTP 传输​

检查 FTP 服务器：

  • 进入配置的 FTP Remote Path
  • 查找最近传输的图像文件
  • 确认文件名包含配置的选项（Trigger ID、Timestamp）

预期文件名格式：


image_T001234_20250620_143052.jpg
└─────┘ └────┘ └──────────────┘
  基础   触发器 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（基于 SSL 的 FTP）实现加密传输

高级配置​

自定义文件处理​

Node-RED 集成：

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

参见：Node-RED Basics

备份策略​

冗余存储：

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

🔗 另见​