Linux ftptop 命令详解：实时监控 ProFTPD 服务器连接状态

ftptop 是 ProFTPD FTP 服务器套件自带的连接状态监视工具，其交互界面与系统性能监控命令 top 一脉相承，可以实时展示当前连入 FTP 服务器的会话概况。本文基于本仓库 command/ftptop.md 的原始说明展开，结合仓库内 FTP 运维系列命令文档，为你讲清 ftptop 的语法、选项、适用场景以及与其他 ProFTPD 配套命令的协作方式，帮助你快速掌握 FTP 服务器在线状态的可视化监控方法。

ftptop 是什么

ftptop 命令 类似于 top 命令的显示风格，用于显示 ProFTPD 服务器的连接状态。它以全屏、周期性刷新的方式呈现 FTP 会话列表，让管理员无需登录 Web 管理界面，在终端里即可一眼看到当前有哪些用户正在连接、处于何种传输状态。

从仓库的命令分类看，README.md 将 ftpcount、ftpshut、ftpwho 与 ftp 一并归入「文件传输」类命令，而 command/ftpwho.md 中明确写明：ftpwho 是 FTP 服务器套件 proftpd 的工作指令。ftptop 与 ftpwho 同属 ProFTPD 套件，二者配合可以分别满足"看会话明细"与"盯实时状态"两类监控需求。

命令语法

ftptop 的使用形式非常简单，命令本身不接受文件参数，直接以选项方式调用：

ftptop(选项)

由于 ftptop 属于 ProFTPD 套件内置工具，使用前提是系统中已经安装并运行了 ProFTPD 服务器。若执行时提示找不到命令，通常说明套件未安装或二进制路径未加入 PATH，可通过包管理器安装 proftpd 后重试（例如基于 rpm 的发行版可使用 rpm -qa | grep proftpd 确认安装情况，卸载相关参考 command/rpm.md 中的软件包管理示例）。

选项详解

ftptop 的核心选项全部围绕"显示什么"与"多久刷新一次"两个维度展开：

选项	作用说明
-D	过滤正在下载的会话，只展示当前处于下载状态的连接，便于快速定位占带宽的用户
-S	仅显示指定虚拟主机的连接状态，适合单台服务器上运行多个虚拟 FTP 站点（VirtualHost）的场景
-d	指定屏幕刷新时间（单位为秒），控制界面数据更新的间隔，数值越小刷新越快、系统开销也越高

其中 -d 的默认刷新间隔在原文档中未明确给出，不同发行版打包的 ProFTPD 版本其默认值可能不同，实际使用时可先用 ftptop -h 或 man ftptop 查看当前版本的默认值，再结合服务器负载手动指定。

实战用法

基础实时监控

在 ProFTPD 运行中的服务器上直接执行，即可进入全屏会话监控界面：

ftptop

界面会周期性刷新，展示各 FTP 会话的客户端地址、登录用户、所处状态（如正在上传/下载）等信息，与 top 的体验一致，退出监控界面通常使用 q 或 Ctrl+C。

只看正在下载的会话

当怀疑有用户占用大量下行带宽时，用 -D 过滤出下载会话，集中观察传输速率与连接时长：

ftptop -D

监控指定虚拟主机

一台 ProFTPD 服务器往往通过 VirtualHost 配置多个站点，此时用 -S 限定目标虚拟主机，避免无关会话干扰判断：

ftptop -S ftp.example.com

自定义刷新频率

需要更高实时性时缩短刷新间隔，例如每 2 秒刷新一次：

ftptop -d 2

也可以把选项组合使用，例如每 3 秒刷新、只关注某个虚拟主机的下载会话：

ftptop -D -S ftp.example.com -d 3

在命令体系中的定位

从仓库索引数据 dist/data.json 可以看到，ftptop 的描述被收录为 "proftpd服务器的连接状态"，与 ftpwho（显示当前每个 ftp 会话信息）、ftpcount（显示目前已 FTP 登入的用户人数）、ftpshut（在指定的时间关闭 FTP 服务器）共同构成 ProFTPD 运维工具箱：

• 看人：ftpwho 逐个会话列出明细，适合排查"是谁在连"；
• 看量：ftpcount 统计登录人数与上限，适合判断是否接近连接配额；
• 看状态：ftptop 以 top 风格实时跟踪连接动态，适合持续盯防异常流量；
• 看停机：ftpshut 预约定时关闭服务器，适合配合维护窗口做计划内下线。

注意事项与限制

1. 依赖 ProFTPD 运行环境：ftptop 读取的是 ProFTPD 自身维护的连接信息，若服务器未运行或套件未安装，命令无法产出有效数据。
2. 交互式全屏界面：它在终端中动态刷新，适合 SSH 会话或本地终端使用，不适合在管道、重定向等非交互环境下运行。
3. 刷新频率与开销：-d 设置的刷新间隔越短，轮询开销越大，在连接数很高的生产服务器上应适度放宽刷新频率。
4. 虚拟主机参数：-S 指定的虚拟主机名称需要与 ProFTPD 配置中的 VirtualHost 定义一致，否则无法命中对应会话。
5. 与下载状态相关的选项：-D 仅过滤正在下载（服务器向客户端下行传输）的会话，上传会话默认不在过滤范围内。

相关命令

• command/ftpwho.md —— 显示当前每个 FTP 会话信息（ProFTPD 套件）
• command/ftpcount.md —— 显示当前 FTP 登入用户人数与上限
• command/ftpshut.md —— 在指定时间关闭 FTP 服务器并发送警告
• command/ftp.md —— FTP 客户端，用于连接与传输文件
• command/top.md —— ftptop 的界面风格所参考的系统进程监控命令