phpStudy(小皮面板)內建的 FTP 服務基於 FileZilla Server 核心,提供圖形化管理介面,支援虛擬用戶、權限控制、IP 限制、SSL/TLS 加密傳輸。適合 Windows 開發/測試環境快速部署。
FTP 協定特性:主動模式由 Server 連 Client(常被防火牆阻擋),被動模式由 Client 連 Server 隨機端口。
| 客戶端 | 推薦模式 | 設定位置 |
|---|---|---|
| FileZilla Client | 被動模式(預設) | 站點管理器 → 傳輸設定 → 被動模式 |
| WinSCP | 被動模式 | 站點 → 進階 → 連線 → 被動模式 |
| CuteFTP | 被動模式 | 站點屬性 → 連線 → PASV 模式 |
| 命令行 ftp | 主動模式 | ftp> passive 切換被動 |
| PHP ftp_connect() | 被動模式 | ftp_pasv($conn, true) |
| 錯誤訊息 | 原因 | 解決 |
|---|---|---|
| 425 Can't open data connection | 被動模式端口未開放/防火牆阻擋 | 開放防火牆 50000-50100,設定外部 IP |
| 530 User cannot log in | 用戶名/密碼錯誤、用戶被禁用、權限不足 | 檢查用戶設置、密碼大小寫、根目錄權限 |
| 550 Permission denied | 目錄寫入權限不足 | 用戶設置勾選「寫入」、「建立目錄」、「刪除」 |
| 227 Entering Passive Mode (192,168,1,100,195,100) | 回傳內網 IP,公網客戶端無法連線 | 設定「使用自定義 IP」為公網 IP |
| 連接超時 / Socket Error | 控制連線 21 埠不通 | 檢查防火牆、安全組、服務是否啟動 |
若系統已安裝 IIS FTP 服務(佔用 21 埠),phpStudy FTP 無法啟動。解決:
# 用戶:dev_user
# 根目錄:D:\www\project_a
# 權限:讀、寫、列表、建立目錄、刪除(無執行權限)
# 用戶:backup_user
# 根目錄:D:\backup
# 權限:唯讀、列表(僅下載備份檔)
# 用戶:anonymous(匿名)
# 根目錄:D:\public
# 權限:唯讀、列表
# 啟用:FTP 設置 → 匿名用戶
phpStudy 內建版本更新較慢,生產環境建議獨立安裝 FileZilla Server 1.x(新版介面)或 0.9.60(經典版):
phpStudy FTP Server 適合Windows 開發/測試環境快速起步。核心配置點:被動模式端口範圍 + 防火牆/安全組開放 + 外部 IP 設定。生產環境建議遷移至獨立 FileZilla Server 或 Linux vsftpd/ProFTPD,獲得更穩定的效能、更豐富的模組(虛擬用戶映射系統用戶、LDAP 整合、配額管理)與安全更新。