使用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 也有類似配置。

開放防火牆端口<br> 被動模式數據端口範圍（如上例的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，無法連接數據端口。

配置連接超時與最大連接數<br> 適當調整超時設置和最大連接數，避免連接被過早斷開或服務器資源緊張

四、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