apache ftp client 使用注意事项(FTP主被动模式选择)

现有如下需求：

收集用户信息，定时把新增的数据生成CSV文件，打包成ZIP加密并上传至FTP服务器。

很简单的一个需求却在最后一部出了问题，使用的是org.apache.commons.ftp包下的FTPClient。测试环境正常上传到FTP服务器，生产环境却一直没有上传。查看日志发现，生产环境中定时任务启动了，却没有结束，刚开始以为是线程的问题，可又到了执行的时间，没有数据不执行上传操作时却能正常执行完毕，因此怀疑是FTPClient工具的问题。

测试环境一切正常，生产却不可以，推断可能是环境差异性导致的，后来问了运维同学，测试环境没有开启防火墙，因此可以确定由于防火墙的问题导致无法正常上传文件。在网上查询得知，FTPClient会开启一个端口进行数据的传输，查看源码：

ServerSocket server = this._serverSocketFactory_.createServerSocket(0, 1, getLocalAddress());

................................

try {

socket = server.accept();

} finally {

server.close();

}

createServerSocket方法第一个参数即为端口号，实参为0则是所有空闲的端口进行连接，由于防火墙策略，服务器无法与客户端进行连接，因此客户端一直处于阻塞状态。

打算换shell脚本进行上传的时候，在网上又查询到FTP主动模式与被动模式以下为两种模式的简述(引用自网络)：

FTP是仅基于TCP的服务，不支持UDP。与众不同的是FTP使用2个端口，一个数据端口和一个命令端口（也可叫做控制端口）。通常来说这两个端口是21（命令端口）和20（数据端口）。但FTP工作方式的不同，数据端口并不总是20。这就是主动与被动FTP的最大不同之处。

（一）主动FTP

主动方式的FTP是这样的：客户端从一个任意的非特权端口N（N>1024）连接到FTP服务器的命令端口，也就是21端口。然后客户端开始监听端口N+1，并发送FTP命令“port N+1”到FTP服务器。接着服务器会从它自己的数据端口（20）连接到客户端指定的数据端口（N+1）。

针对FTP服务器前面的防火墙来说，必须允许以下通讯才能支持主动方式FTP：

1. 任何大于1024的端口到FTP服务器的21端口。（客户端初始化的连接）

2. FTP服务器的21端口到大于1024的端口。 （服务器响应客户端的控制端口）

3. FTP服务器的20端口到大于1024的端口。（服务器端初始化数据连接到客户端的数据端口）

4. 大于1024端口到FTP服务器的20端口（客户端发送ACK响应到服务器的数据端口）

（二）被动FTP

为了解决服务器发起到客户的连接的问题，人们开发了一种不同的FTP连接方式。这就是所谓的被动方式，或者叫做PASV，当客户端通知服务器它处于被动模式时才启用。

在被动方式FTP中，命令连接和数据连接都由客户端发起，这样就可以解决从服务器到客户端的数据端口的入方向连接被防火墙过滤掉的问题。

当开启一个 FTP连接时，客户端打开两个任意的非特权本地端口（N>1024和N+1）。第一个端口连接服务器的21端口，但与主动方式的FTP不同，客户端不会提交PORT命令并允许服务器来回连它的数据端口，而是提交 PASV命令。这样做的结果是服务器会开启一个任意的非特权端口（P > 1024），并发送PORT P命令给客户端。然后客户端发起从本地端口N+1到服务器的端口P的连接用来传送数据。

对于服务器端的防火墙来说，必须允许下面的通讯才能支持被动方式的FTP:

1. 从任何大于1024的端口到服务器的21端口（客户端初始化的连接）

2. 服务器的21端口到任何大于1024的端口（服务器响应到客户端的控制端口的连接）

3. 从任何大于1024端口到服务器的大于1024端口（客户端初始化数据连接到服务器指定的任意端口）

4. 服务器的大于1024端口到远程的大于1024的端口（服务器发送ACK响应和数据到客户端的数据端口）

以上关于主动和被动FTP的解释，可以简单概括为以下两点：

1、主动FTP：

命令连接：客户端 >1024端口 -> 服务器 21端口

数据连接：客户端 >1024端口 <- 服务器 20端口

2、被动FTP：

命令连接：客户端 >1024端口 -> 服务器 21端口

数据连接：客户端 >1024端口 -> 服务器 >1024端口

（三）主动与被动FTP优缺点：

主动FTP对FTP服务器的管理有利，但对客户端的管理不利。因为FTP服务器企图与客户端的高位随机端口建立连接，而这个端口很有可能被客户端的防火墙阻塞掉。被动FTP对FTP客户端的管理有利，但对服务器端的管理不利。因为客户端要与服务器端建立两个连接，其中一个连到一个高位随机端口，而这个端口很有可能被服务器端的防火墙阻塞掉。

由此可以确定，因FTPClient默认开启的是主动模式，以前建立数据通信的是任意空闲端口，客户端机开启了防火墙，使得远程服务器无法与客户端进行连接，FTPClient一直处于阻塞状态。而使用被动模式，客户端在通知服务器数据端口的情况下进行连接，如果服务端不屏蔽高位端口连接的情况下，客户端开启任意端口进行连接即可正常进行数据通信。

结论：在生产环境，linux开启了防火墙，再使用FTPClient连接时，使用被动模式连接。apache

的 FTPClient 使用enterLocalPassiveMode方法切换为被动模式。