脚本如何检测FTP服务是否正常

wen 实用脚本 2026-07-08 1

脚本如何检测FTP服务是否正常：自动化监控与故障排查实战指南

目录导读

为什么需要脚本检测FTP服务？ – 解析常见FTP故障场景与自动化价值
核心检测逻辑 – 连接测试、文件传输验证与响应时间监控
脚本实现方案 – Shell、Python、PowerShell三种语言完整代码
进阶检测技巧 – 被动模式适配、超时处理与日志记录
常见问题问答 – 解决“连接成功但上传失败”“防火墙拦截”等痛点

为什么需要脚本检测FTP服务？

FTP（文件传输协议）虽老，但仍是企业内网、设备备份、老旧系统集成的常用协议，FTP服务常因以下原因变得“不正常”：

脚本如何检测FTP服务是否正常

服务进程崩溃或端口被占用（默认21端口）
防火墙规则变更导致连接超时
被动模式（PASV）端口范围被封锁
磁盘空间满或权限错误导致写入失败
认证用户密码过期或账户锁定

人工检测的痛点：每次输入ftp命令、手动输入用户名密码、查看返回信息，耗费时间且无法24小时执行，而脚本可做到：

定时执行（cron/任务计划）
失败时发送邮件/短信告警
生成历史性能报告（如响应时间趋势）

脚本检测目标：验证FTP服务的“可用性”与“功能性”,而非仅端口是否开放。

核心检测逻辑

一个完善的FTP检测脚本需覆盖以下三层验证：

第一层：网络层可达性

测试主机是否在线（ping可做辅助，但非必须）
检查21端口是否开放（使用nc或socket）

第二层：服务登录层

使用合法账户登录（建议单独创建监控账号）
捕获登录返回状态码（230代表登录成功）
处理常见错误：530（认证失败）、421（服务不可用）

第三层：业务功能层（关键）

文件上传测试：上传一个临时文件（如health_check.txt），检查是否返回226（传输完成）
文件下载测试：下载并校验文件内容，确保读写无损坏
删除测试：清理临时文件，避免堆积
响应时间检测：记录命令从发送到接收的时间差，超过阈值告警

逻辑伪代码示例：

if 端口连接失败:  
    告警 “FTP服务未监听”  
else:  
    if 登录失败:  
        告警 “认证错误或账户失效”  
    else:  
        if 上传失败:  
            告警 “写入权限或磁盘空间异常”  
        else:  
            记录上传响应时间  
            删除临时文件  
            标记服务正常

脚本实现方案

方案A：Shell脚本（适合Linux/Unix环境）

#!/bin/bash
# FTP健康检查脚本
FTP_HOST="example.com"
FTP_USER="monitor_user"
FTP_PASS="secure_password"
REMOTE_FILE="/tmp/health_$(date +%s).txt"
LOCAL_FILE="/tmp/ftp_health_test.txt"
# 测试端口连通性（使用nc）
nc -zv $FTP_HOST 21 > /dev/null 2>&1
if [ $? -ne 0 ]; then
    echo "FAIL: 端口21连接失败"
    exit 1
fi
# 通过expect自动交互检测FTP操作
expect << EOF > /tmp/ftp_test.log
spawn ftp $FTP_HOST
expect "Name"
send "$FTP_USER\r"
expect "Password"
send "$FTP_PASS\r"
expect "ftp>" 
send "put $LOCAL_FILE $REMOTE_FILE\r"
expect {
    "226" { puts "Upload OK" }
    default { puts "Upload FAIL"; exit 1 }
}
send "delete $REMOTE_FILE\r"
expect "250"
send "quit\r"
EOF
if grep -q "Upload OK" /tmp/ftp_test.log; then
    echo "SUCCESS: FTP服务正常"
    exit 0
else
    echo "FAIL: 文件上传失败"
    exit 2
fi

方案B：Python脚本（跨平台且功能丰富）

import ftplib
import os
import time
def check_ftp_health(host, user, pwd, timeout=10):
    try:
        ftp = ftplib.FTP(host=host, user=user, passwd=pwd, timeout=timeout)
        # 测试上传
        test_file = "/tmp/ftp_health_test.txt"
        with open(test_file, "w") as f:
            f.write("health check at " + time.ctime())
        start = time.time()
        with open(test_file, "rb") as f:
            ftp.storbinary("STOR health_check_file.txt", f)
        upload_time = time.time() - start
        # 测试下载
        ftp.retrbinary("RETR health_check_file.txt", lambda x: None)
        # 清理
        ftp.delete("health_check_file.txt")
        ftp.quit()
        os.remove(test_file)
        return {"status": "OK", "response_time_ms": round(upload_time*1000, 2)}
    except ftplib.all_errors as e:
        return {"status": "FAIL", "error": str(e)}
result = check_ftp_health("example.com", "monitor", "pass123")
print(result)

方案C：PowerShell（适用Windows环境）

$hostname = "example.com"
$user = "monitor"
$pass = "pass123"
$uri = "ftp://$hostname/health_test.txt"
try {
    $request = [System.Net.FtpWebRequest]::Create($uri)
    $request.Credentials = New-Object System.Net.NetworkCredential($user, $pass)
    $request.Method = [System.Net.WebRequestMethods+Ftp]::UploadFile
    $fileBytes = [System.Text.Encoding]::ASCII.GetBytes("Health check content")
    $request.ContentLength = $fileBytes.Length
    $stream = $request.GetRequestStream()
    $stream.Write($fileBytes, 0, $fileBytes.Length)
    $stream.Close()
    Write-Output "SUCCESS: FTP上传正常"
} catch {
    Write-Output "FAIL: $($_.Exception.Message)"
}