1. 安裝與預設狀態
sudo apt-get update && sudo apt-get install vsftpd
- 安裝後自動建立
/home/ftp 匿名根目錄。
- 預設
anonymous_enable=NO,匿名登入被拒絕。
- 服務自動啟動並監聽 TCP 21。
2. 核心配置檔 /etc/vsftpd.conf 關鍵參數詳解
| 參數 | 預設值 | 建議值 | 說明 |
| anonymous_enable | NO | YES/NO | 允許/禁止匿名登入 |
| local_enable | YES | YES | 允許本地系統用戶登入 |
| write_enable | NO | YES | 開啟上傳/刪除/重命名等寫入操作 |
| local_umask | 077 | 022 | 本地用戶上傳檔案權限遮罩 |
| chroot_local_user | NO | YES | 限制本地用戶僅能存取自家目錄(chroot 監獄) |
| chroot_list_enable | NO | YES | 啟用例外名單,配合 chroot_list_file |
| userlist_enable | NO | YES | 啟用用戶存取控制名單 |
| userlist_deny | YES | NO | NO=白名單模式,YES=黑名單模式 |
| pasv_enable / pasv_min_port / pasv_max_port | YES/0/0 | YES/50000/60000 | 被動模式埠口範圍,便於防火牆放行 |
| max_clients / max_per_ip | 0/0 | 200/4 | 總連線數/單 IP 連線數限制 |
| idle_session_timeout / data_connection_timeout | 300/300 | 600/120 | 空閒逾時(秒) |
| ftpd_banner | (none) | Welcome to FTP Service | 歡迎橫幅 |
| listen / listen_ipv6 | YES/NO | YES/NO | 獨立守護進程模式(非 inetd) |
3. 常見部署場景配置範例
場景 A:純匿名下載站(唯讀)
anonymous_enable=YES
local_enable=NO
write_enable=NO
anon_world_readable_only=YES
場景 B:本地用戶讀寫 + chroot 隔離
anonymous_enable=NO
local_enable=YES
write_enable=YES
chroot_local_user=YES
allow_writeable_chroot=YES # 允許 chroot 目錄可寫(vsftpd 3.0+)
local_umask=022
場景 C:虛擬用戶(非系統帳號)+ 獨立權限
- 建立虛擬用戶資料庫:
cat > /etc/vsftpd/virt_users.txt <<'EOF'
alice
password1
bob
password2
EOF
db_load -T -t hash -f /etc/vsftpd/virt_users.txt /etc/vsftpd/virt_users.db
chmod 600 /etc/vsftpd/virt_users.db
- PAM 設定
/etc/pam.d/vsftpd.virtual:
auth required pam_userdb.so db=/etc/vsftpd/virt_users
account required pam_userdb.so db=/etc/vsftpd/virt_users
- vsftpd.conf 關鍵段:
anonymous_enable=NO
local_enable=YES
guest_enable=YES
guest_username=ftpsecure # 映射的系統用戶
pam_service_name=vsftpd.virtual
user_config_dir=/etc/vsftpd/user_conf
- 個別權限檔
/etc/vsftpd/user_conf/alice:
write_enable=YES
anon_upload_enable=YES
anon_mkdir_write_enable=YES
4. 防火牆與 SELinux/AppArmor
# ufw
sudo ufw allow 20,21,50000:60000/tcp
# firewalld
sudo firewall-cmd --permanent --add-service=ftp
sudo firewall-cmd --permanent --add-port=50000-60000/tcp
sudo firewall-cmd --reload
# SELinux
sudo setsebool -P ftpd_full_access on
sudo setsebool -P ftp_home_dir on
5. 啟動與驗證
sudo systemctl restart vsftpd
sudo systemctl status vsftpd
# 本機測試
ftp localhost
# 遠端測試
ftp your.server.ip
6. 日誌與除錯
- 傳輸日誌:
xferlog_enable=YES、xferlog_file=/var/log/vsftpd.log、xferlog_std_format=YES。
- 錯誤日誌:
syslog_enable=YES 送至 /var/log/secure 或 /var/log/messages。
- 除錯模式:
debug_ssl=YES、log_ftp_protocol=YES(僅除錯時開啟)。