使用 ftp_pasv 时，FTP 服务器需要怎么配置才不会出错？一文说明白

M66 2025-07-04

<span><span>--------------------------------------------------

使用 ftp_pasv 时，FTP 服务器需要怎么配置才不会出错？一文说明白

--------------------------------------------------

在 PHP 中使用 ftp_pasv 函数开启被动模式（Passive Mode）连接 FTP 服务器时，常常会遇到连接失败或数据传输中断的问题。这主要是由于 FTP 服务器的配置与网络环境不匹配，导致客户端无法正确建立数据通道。本文将详细说明使用 ftp_pasv 时，FTP 服务器需要如何配置，才能保证连接稳定、传输顺畅。

一、FTP 主动模式与被动模式简述  
FTP 连接由控制连接和数据连接组成。主动模式（Active Mode）中，客户端告诉服务器它的IP和端口，服务器主动连接客户端进行数据传输；被动模式（Passive Mode）则是服务器告诉客户端数据端口，客户端主动连接服务器。被动模式通常适合客户端处于防火墙或NAT环境时使用。

二、为什么使用 ftp_pasv？  
在现代网络环境中，客户端常常位于防火墙或路由器后，主动模式连接因被动防火墙阻挡而失败。开启 ftp_pasv 被动模式后，客户端能绕过这些限制，主动连接服务器指定的端口进行数据传输，从而提升成功率。

三、FTP 服务器需要怎样配置？  
</span><span><span class="hljs-number">1</span></span><span>. **配置被动模式端口范围**  
服务器必须设置一段专用的端口范围供被动模式使用，例如 </span><span><span class="hljs-number">50000</span></span><span>-</span><span><span class="hljs-number">51000</span></span><span>。  
- 在 vsftpd 中，配置文件通常是 `/etc/vsftpd/vsftpd.conf`，添加或修改：  
  ```conf
  pasv_min_port=</span><span><span class="hljs-number">50000</span></span><span>
  pasv_max_port=</span><span><span class="hljs-number">51000</span></span><span>
</span></span>

其他 FTP 服务器如 ProFTPD、Pure-FTPd 也有类似配置。

开放防火墙端口
被动模式数据端口范围（如上例的 50000-51000）必须在服务器防火墙中放行。否则客户端无法连接这些端口，导致传输失败。

例如使用 iptables，添加规则：

<span><span>iptables -I INPUT -p tcp --match multiport --dports 50000:51000 -j ACCEPT
</span></span>

如果使用 firewalld 或其他防火墙软件，也需相应配置。

设置服务器的公网 IP
服务器通常位于内网或使用 NAT，需要告诉客户端正确的公网 IP 地址。

在 vsftpd 中，配置：

<span>pasv_address=你的公网IP地址
</span>

否则客户端获取到的是内网 IP，无法连接数据端口。

配置连接超时与最大连接数
适当调整超时设置和最大连接数，避免连接被过早断开或服务器资源紧张。

四、PHP 代码示例
以下是开启被动模式并上传文件的简单示例：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$ftp_server</span></span><span> = </span><span><span class="hljs-string">"ftp.example.com"</span></span><span>;
</span><span><span class="hljs-variable">$ftp_user</span></span><span> = </span><span><span class="hljs-string">"username"</span></span><span>;
</span><span><span class="hljs-variable">$ftp_pass</span></span><span> = </span><span><span class="hljs-string">"password"</span></span><span>;
</span><span><span class="hljs-variable">$local_file</span></span><span> = </span><span><span class="hljs-string">"/path/to/local/file.txt"</span></span><span>;
</span><span><span class="hljs-variable">$remote_file</span></span><span> = </span><span><span class="hljs-string">"file.txt"</span></span><span>;

</span><span><span class="hljs-comment">// 连接 FTP</span></span><span>
</span><span><span class="hljs-variable">$conn_id</span></span><span> = </span><span><span class="hljs-title function_ invoke__">ftp_connect</span></span><span>(</span><span><span class="hljs-variable">$ftp_server</span></span><span>);
</span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-variable">$conn_id</span></span><span>) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"无法连接 FTP 服务器"</span></span><span>);
}

</span><span><span class="hljs-comment">// 登录</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-title function_ invoke__">ftp_login</span></span><span>(</span><span><span class="hljs-variable">$conn_id</span></span><span>, </span><span><span class="hljs-variable">$ftp_user</span></span><span>, </span><span><span class="hljs-variable">$ftp_pass</span></span><span>)) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"FTP 登录失败"</span></span><span>);
}

</span><span><span class="hljs-comment">// 开启被动模式</span></span><span>
</span><span><span class="hljs-title function_ invoke__">ftp_pasv</span></span><span>(</span><span><span class="hljs-variable">$conn_id</span></span><span>, </span><span><span class="hljs-literal">true</span></span><span>);

</span><span><span class="hljs-comment">// 上传文件</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">ftp_put</span></span><span>(</span><span><span class="hljs-variable">$conn_id</span></span><span>, </span><span><span class="hljs-variable">$remote_file</span></span><span>, </span><span><span class="hljs-variable">$local_file</span></span><span>, FTP_BINARY)) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"上传成功"</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"上传失败"</span></span><span>;
}

</span><span><span class="hljs-comment">// 关闭连接</span></span><span>
</span><span><span class="hljs-title function_ invoke__">ftp_close</span></span><span>(</span><span><span class="hljs-variable">$conn_id</span></span><span>);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

五、小结
使用 ftp_pasv 时，关键在于服务器端正确配置被动模式端口范围、防火墙规则以及公网 IP 地址。缺一不可，否则客户端无法正确建立数据连接。只要服务器配置合理，再结合正确的 PHP 代码，就能避免大多数 FTP 被动模式下的连接错误。

通过本文的讲解，相信你对 FTP 被动模式配置有了清晰认识，能够在实际项目中顺利使用 ftp_pasv，确保文件传输稳定高效。

<span></span>

ftp_pasv