【Linux命令大全】002.文件传输之ftpwho命令（实操篇）

✨ 本文为Linux系统文件传输命令的全面汇总与深度优化，结合图标、结构化排版与实用技巧，专为高级用户和系统管理员打造。

(关注不迷路哈！！！)

文章目录

【Linux命令大全】002.文件传输之ftpwho命令（实操篇）
- 一、功能与作用
- 二、基本用法
- - [1. 查看当前所有FTP会话](#1. 查看当前所有FTP会话)
  - [2. 查看详细信息](#2. 查看详细信息)
  - [3. 使用JSON格式输出](#3. 使用JSON格式输出)
  - [4. 指定虚拟主机](#4. 指定虚拟主机)
- 三、高级用法
- - [1. 指定scoreboard文件路径](#1. 指定scoreboard文件路径)
  - [2. 使用兼容格式输出](#2. 使用兼容格式输出)
  - [3. 使用单行输出格式](#3. 使用单行输出格式)
  - [4. 组合使用多个参数](#4. 组合使用多个参数)
- 四、实际应用场景
- - [1. 监控脚本中的应用](#1. 监控脚本中的应用)
  - [2. 生成FTP活动报告](#2. 生成FTP活动报告)
  - [3. 查找特定用户的连接](#3. 查找特定用户的连接)
  - [4. 监控长时间闲置的连接](#4. 监控长时间闲置的连接)
- 五、注意事项与最佳实践
- - [1. 命令可用性](#1. 命令可用性)
  - [2. scoreboard配置](#2. scoreboard配置)
  - [3. 权限要求](#3. 权限要求)
  - [4. 无输出情况](#4. 无输出情况)
  - [5. 实时监控](#5. 实时监控)
  - [6. 性能考虑](#6. 性能考虑)
- 六、常见错误与解决方案
- - [1. 命令未找到](#1. 命令未找到)
  - [2. 无法访问scoreboard文件](#2. 无法访问scoreboard文件)
  - [3. 输出信息不准确](#3. 输出信息不准确)
  - [4. JSON格式输出错误](#4. JSON格式输出错误)
  - [5. 虚拟主机信息不正确](#5. 虚拟主机信息不正确)
- 七、总结

一、功能与作用

ftpwho命令是一个用于显示当前所有FTP会话的进程信息及每个服务器的已连接用户数 的工具。它主要用于ProFTPD服务器的运维监控与审计，能够提供实时的FTP连接状态信息，包括登录用户、IP地址、登录时间、当前工作目录等详细信息。默认情况下，ftpwho命令适配ProFTPD的scoreboard机制，通过读取scoreboard文件来获取连接信息。

参数详解

参数	说明
`-h/--help`	显示帮助
`-f/--file file`	指定 scoreboard 文件路径
`-o/--outform format`	输出格式：compat/oneline/json
`-v/--verbose`	显示额外信息（如远程主机、当前工作目录）
`-S/--server name`	仅显示指定虚拟主机的会话

二、基本用法

1. 查看当前所有FTP会话

最基本的ftpwho命令用法是直接执行，查看当前所有的FTP会话信息：

bash 复制代码

# 查看当前所有FTP会话
ftpwho

执行结果可能类似于：

复制代码

ProFTPD up 0 days 04:23, 3 users current (24 maximum)

PID     USER     FROM             LOGIN TIME       IDLE TIME   COMMAND
30542   user1    192.168.1.100    10:15           00:02:30    STOR document.pdf
30545   user2    192.168.1.101    10:20           00:00:45    CWD /downloads
30550   user3    192.168.1.102    10:25           00:00:10    LIST

2. 查看详细信息

使用-v参数可以显示更详细的FTP会话信息：

bash 复制代码

# 详细模式
ftpwho -v

输出会包含更多信息，如远程主机名、当前工作目录、传输状态等。

3. 使用JSON格式输出

使用-o json参数可以以JSON格式输出会话信息，便于程序处理：

bash 复制代码

# JSON格式
ftpwho -o json

输出示例：

json 复制代码

{
  "proftpd": {
    "uptime": "0 days 04:23",
    "current_users": 3,
    "max_users": 24,
    "sessions": [
      {
        "pid": 30542,
        "user": "user1",
        "from": "192.168.1.100",
        "login_time": "10:15",
        "idle_time": "00:02:30",
        "command": "STOR document.pdf"
      },
      {
        "pid": 30545,
        "user": "user2",
        "from": "192.168.1.101",
        "login_time": "10:20",
        "idle_time": "00:00:45",
        "command": "CWD /downloads"
      },
      {
        "pid": 30550,
        "user": "user3",
        "from": "192.168.1.102",
        "login_time": "10:25",
        "idle_time": "00:00:10",
        "command": "LIST"
      }
    ]
  }
}

4. 指定虚拟主机

如果FTP服务器配置了多个虚拟主机，可以使用-S参数仅显示特定虚拟主机的会话信息：

bash 复制代码

# 指定虚拟主机
ftpwho -S vh1.example.com

三、高级用法

1. 指定scoreboard文件路径

如果ProFTPD的scoreboard文件位于非默认位置，可以使用-f参数指定其路径：

bash 复制代码

# 指定scoreboard文件路径
ftpwho -f /var/proftpd/scoreboard

2. 使用兼容格式输出

对于需要与旧版系统兼容的情况，可以使用-o compat参数输出兼容格式：

bash 复制代码

# 使用兼容格式输出
ftpwho -o compat

3. 使用单行输出格式

当需要在脚本中处理输出时，单行输出格式可能更为方便：

bash 复制代码

# 单行输出格式
ftpwho -o oneline

输出示例：

复制代码

30542:user1:192.168.1.100:10:15:00:02:30:STOR document.pdf
30545:user2:192.168.1.101:10:20:00:00:45:CWD /downloads
30550:user3:192.168.1.102:10:25:00:00:10:LIST

4. 组合使用多个参数

可以根据需要组合使用多个参数，获取更精确的信息：

bash 复制代码

# 组合使用多个参数
ftpwho -v -S ftp.example.com

这个命令会以详细模式显示ftp.example.com虚拟主机的所有FTP会话信息。

四、实际应用场景

1. 监控脚本中的应用

ftpwho命令非常适合集成到系统监控脚本中，定期检查FTP连接情况：

bash 复制代码

#!/bin/bash
# FTP活动监控脚本
LOG_FILE="/var/log/ftp_activity.log"
TIMESTAMP=$(date "%Y-%m-%d %H:%M:%S")

# 获取活动用户数
ACTIVE_USERS=$(ftpwho -o oneline | wc -l)

# 记录活动用户数
echo "[$TIMESTAMP] Active FTP users: $ACTIVE_USERS" >> $LOG_FILE

# 如果活动用户数超过阈值，发送警告
if [ $ACTIVE_USERS -gt 10 ]; then
  echo "High FTP activity: $ACTIVE_USERS users connected" | mail -s "FTP Activity Alert" admin@example.com
fi

可以通过cron定时运行这个脚本：

bash 复制代码

# 每10分钟检查一次FTP活动
*/10 * * * * /usr/local/bin/ftp_activity_monitor.sh

2. 生成FTP活动报告

可以使用ftpwho命令生成定期的FTP活动报告：

bash 复制代码

#!/bin/bash
# 生成FTP每日活动报告
REPORT_FILE="/var/log/ftp_daily_report_$(date +%Y%m%d).log"

# 创建报告标题
echo "=== FTP Daily Activity Report $(date +%Y-%m-%d) ===" > $REPORT_FILE
echo "Report generated at: $(date)" >> $REPORT_FILE
echo "" >> $REPORT_FILE

# 获取当前活动会话信息
echo "Current Active Sessions:" >> $REPORT_FILE
echo "-----------------------" >> $REPORT_FILE
ftpwho -v >> $REPORT_FILE
echo "" >> $REPORT_FILE

# 获取登录用户统计
echo "User Login Statistics:" >> $REPORT_FILE
echo "---------------------" >> $REPORT_FILE
ftpwho -o oneline | cut -d: -f2 | sort | uniq -c | sort -rn >> $REPORT_FILE
echo "" >> $REPORT_FILE

# 获取IP地址统计
echo "IP Address Statistics:" >> $REPORT_FILE
echo "---------------------" >> $REPORT_FILE
ftpwho -o oneline | cut -d: -f3 | sort | uniq -c | sort -rn >> $REPORT_FILE

# 发送报告到管理员邮箱
cat $REPORT_FILE | mail -s "FTP Daily Activity Report $(date +%Y-%m-%d)" admin@example.com

# 清理7天前的报告
find /var/log -name "ftp_daily_report_*.log" -mtime +7 -delete

3. 查找特定用户的连接

可以使用ftpwho命令结合grep查找特定用户的FTP连接：

bash 复制代码

#!/bin/bash
# 查找特定用户的FTP连接
USERNAME=$1

if [ -z "$USERNAME" ]; then
  echo "Usage: $0 <username>"
  exit 1
fi

# 查找用户连接
echo "Finding FTP connections for user: $USERNAME"
ftpwho -v | grep -A 1 "$USERNAME"

if [ $? -ne 0 ]; then
  echo "No active FTP connections found for user: $USERNAME"
fi

4. 监控长时间闲置的连接

可以使用ftpwho命令查找并处理长时间闲置的FTP连接：

bash 复制代码

#!/bin/bash
# 监控和清理长时间闲置的FTP连接
IDLE_THRESHOLD=3600  # 闲置超过1小时（秒）

# 查找长时间闲置的连接
LONG_IDLE_CONNECTIONS=$(ftpwho -o json | jq -r '.proftpd.sessions[] | select(.idle_time | split(":") | (.[0]|tonumber)*3600 + (.[1]|tonumber)*60 + (.[2]|tonumber) > '"$IDLE_THRESHOLD"') | .pid')

if [ -n "$LONG_IDLE_CONNECTIONS" ]; then
  echo "Found $(echo "$LONG_IDLE_CONNECTIONS" | wc -l) connections idle for more than $((IDLE_THRESHOLD/3600)) hours:"
  echo "$LONG_IDLE_CONNECTIONS"
  
  # 询问是否断开这些连接
  read -p "Do you want to disconnect these idle connections? (y/n): " CONFIRM
  if [ "$CONFIRM" = "y" ] || [ "$CONFIRM" = "Y" ]; then
    for PID in $LONG_IDLE_CONNECTIONS; do
      echo "Disconnecting session with PID: $PID"
      kill $PID
    done
    echo "Disconnected all idle connections."
  fi
else
  echo "No connections idle for more than $((IDLE_THRESHOLD/3600)) hours found."
fi

五、注意事项与最佳实践

1. 命令可用性

ftpwho命令通常是ProFTPD服务器的一部分，如果系统上未安装ProFTPD，这个命令可能不可用。在使用前，请确保已安装了相应的软件包。

2. scoreboard配置

ftpwho命令依赖于ProFTPD的scoreboard机制。如果命令无法显示正确的信息，请检查ProFTPD配置文件中是否正确配置了scoreboard：

bash 复制代码

# 检查ProFTPD配置中的scoreboard设置
grep -i "scoreboardfile" /etc/proftpd/proftpd.conf

确保配置中包含类似以下行：

复制代码

ScoreboardFile /var/run/proftpd/proftpd.scoreboard

3. 权限要求

ftpwho命令需要读取scoreboard文件的权限。确保当前用户有足够的权限访问该文件，或者使用sudo命令执行。

4. 无输出情况

如果ftpwho命令没有输出任何信息，可能的原因包括：

没有活动的FTP连接
scoreboard文件路径不正确
ProFTPD服务未运行

在这种情况下，可以先检查ProFTPD服务是否运行，并验证scoreboard文件是否存在：

bash 复制代码

# 检查ProFTPD服务状态
systemctl status proftpd

# 检查scoreboard文件是否存在
ls -l /var/run/proftpd/proftpd.scoreboard

5. 实时监控

结合watch命令，可以实现对FTP连接状态的实时监控：

bash 复制代码

# 每2秒刷新一次FTP会话信息
watch -n 2 ftpwho -v

6. 性能考虑

在高流量的FTP服务器上，频繁执行ftpwho命令可能会对服务器性能产生影响。建议在脚本中合理设置执行间隔，避免过于频繁地调用。

六、常见错误与解决方案

1. 命令未找到

问题现象 ：执行ftpwho命令时显示"command not found"错误。

解决方案：

确认是否安装了ProFTPD服务器软件包
检查命令是否在系统PATH中
尝试使用完整路径执行命令

bash 复制代码

# 查找ftpwho命令位置
which ftpwho
# 或
find / -name ftpwho 2>/dev/null

# 安装ProFTPD（如果尚未安装）
sudo apt-get install proftpd  # Debian/Ubuntu
sudo yum install proftpd      # CentOS/RHEL

2. 无法访问scoreboard文件

问题现象 ：执行ftpwho命令时显示"Cannot open scoreboard file"错误。

解决方案：

确认scoreboard文件的路径是否正确
检查当前用户是否有权限访问该文件
验证ProFTPD服务是否正在运行

bash 复制代码

# 使用sudo执行
sudo ftpwho

# 指定正确的scoreboard文件路径
ftpwho -f /var/run/proftpd/proftpd.scoreboard

3. 输出信息不准确

问题现象 ：ftpwho命令显示的信息与实际连接情况不符。

解决方案：

确认ProFTPD服务正在正常运行
检查scoreboard文件是否损坏
尝试重启ProFTPD服务以重新创建scoreboard文件

bash 复制代码

# 重启ProFTPD服务
sudo systemctl restart proftpd

# 等待片刻后再次检查
ftpwho

4. JSON格式输出错误

问题现象 ：使用-o json参数时，输出的JSON格式不正确或无法被其他程序解析。

解决方案：

确认使用的ProFTPD版本支持JSON输出格式
尝试使用较新版本的ProFTPD
如果需要JSON格式，可以考虑手动解析其他格式的输出并转换为JSON

bash 复制代码

# 使用其他工具将普通输出转换为JSON
ftpwho -o oneline | awk -F: 'BEGIN{print "{\"sessions\":[}"; first=1} 
  {if(!first) print ","; first=0; 
  print "{\"pid\":"\$1",\"user\":\""\$2"\",\"from\":\""\$3"\",\"login_time\":\""\$4"\",\"idle_time\":\""\$5"\",\"command\":\""\$6"\"}"} 
  END{print "]}"}'

5. 虚拟主机信息不正确

问题现象 ：使用-S参数指定虚拟主机时，没有显示正确的会话信息。

解决方案：

确认虚拟主机名称是否正确
检查ProFTPD的虚拟主机配置
验证是否有针对该虚拟主机的活动连接

bash 复制代码

# 检查ProFTPD虚拟主机配置
grep -A 10 "<VirtualHost" /etc/proftpd/proftpd.conf

七、总结

ftpwho命令是ProFTPD服务器管理中的重要工具，通过它可以方便地监控实时的FTP连接状态，包括用户信息、IP地址、操作命令等关键数据。这对于系统管理员进行性能监控、安全审计和问题排查非常有帮助。在使用过程中，需要注意命令的权限要求、scoreboard文件的配置以及输出格式的选择，以确保能够获取准确和有用的信息。通过合理利用ftpwho命令，可以大大提高FTP服务器的管理效率和可靠性。