vsftpd (Very Secure FTP Daemon) 是 Linux 下最輕量、最安全的 FTP 伺服器。本文涵蓋從基礎安裝、匿名/本地/虛擬用戶三種認證模式、SSL/TLS 加密 (FTPS)、被動模式防火牆穿透、SELinux 布林值調整,到完整的錯誤碼對照排查表,助你建立生產級 FTP 服務。
# RHEL/CentOS/Rocky/AlmaLinux
sudo dnf install -y vsftpd ftp
sudo systemctl enable --now vsftpd
# Ubuntu/Debian
sudo apt update && sudo apt install -y vsftpd
sudo systemctl enable --now vsftpd
/etc/vsftpd/vsftpd.conf 詳細解析# === 基礎安全 ===
anonymous_enable=NO # 禁止匿名登入 (生產環境必關)
local_enable=YES # 允許本地系統用戶登入
write_enable=YES # 允許寫入操作
local_umask=022 # 上傳檔案權限 644 (目錄 755)
dirmessage_enable=YES # 目錄歡迎訊息 (.message 檔案)
xferlog_enable=YES # 傳輸日誌
xferlog_std_format=YES
xferlog_file=/var/log/vsftpd.log
log_ftp_protocol=YES # 記錄完整 FTP 指令 (除錯用)
# === 連接埠與被動模式 (關鍵) ===
listen=YES # IPv4 獨立監聽
listen_ipv6=NO
connect_from_port_20=YES # 主動模式資料埠 20
pasv_enable=YES # 啟用被動模式
pasv_min_port=40000 # 被動模式埠範圍 (需防火牆開放)
pasv_max_port=40100
pasv_address=YOUR_PUBLIC_IP # 公網 IP (NAT 環境必填)
# === 用戶限制與 chroot (安全核心) ===
chroot_local_user=YES # 所有本地用戶限制在家目錄
chroot_list_enable=YES
chroot_list_file=/etc/vsftpd/chroot_list # 例外用戶清單 (不限制)
allow_writeable_chroot=YES # 允許 chroot 目錄可寫 (需目錄權限 755 且非用戶擁有)
# === 效能與限制 ===
idle_session_timeout=600 # 閒置 10 分鐘斷線
data_connection_timeout=120
max_clients=200 # 最大並發連線
max_per_ip=10 # 單 IP 最大連線
local_max_rate=10485760 # 本地用戶限速 10 MB/s
anon_max_rate=1048576 # 匿名用戶限速 1 MB/s (若啟用)
# === 進階 ===
ls_recurse_enable=YES # 允許 ls -R
use_localtime=YES # 日誌使用本地時間
setproctitle_enable=YES # ps 顯示連線資訊
# 建立僅 FTP 用途的系統用戶 (無 Shell 登入)
sudo useradd -m -d /home/ftpuser -s /sbin/nologin ftpuser
sudo passwd ftpuser
# 目錄權限:家目錄 755,上層目錄不可寫 (chroot 要求)
sudo chmod 755 /home/ftpuser
# 1. 安裝 PAM 與 db 工具
sudo dnf install -y libdb-utils pam # 或 apt install libpam-pwdfile
# 2. 建立虛擬用戶密碼資料庫 (Berkeley DB)
echo -e "ftpuser1\npassword1\nftpuser2\npassword2" > /etc/vsftpd/virtual_users.txt
sudo db_load -T -t hash -f /etc/vsftpd/virtual_users.txt /etc/vsftpd/virtual_users.db
sudo chmod 600 /etc/vsftpd/virtual_users.db
# 3. 建立映射系統用戶 (僅做檔案擁有者)
sudo useradd -r -d /var/ftp/virtual -s /sbin/nologin virtual
sudo mkdir -p /var/ftp/virtual
sudo chown virtual:virtual /var/ftp/virtual
# 4. PAM 配置 /etc/pam.d/vsftpd.virtual
# 內容:
auth required pam_userdb.so db=/etc/vsftpd/virtual_users
account required pam_userdb.so db=/etc/vsftpd/virtual_users
# 5. vsftpd.conf 關鍵修改
guest_enable=YES
guest_username=virtual
pam_service_name=vsftpd.virtual
virtual_use_local_privs=YES
user_sub_token=$USER
local_root=/var/ftp/virtual/$USER # 每用戶獨立目錄
user_config_dir=/etc/vsftpd/user_conf # 個別配置目錄 (可選)
# 6. 為每用戶建立目錄
sudo mkdir -p /var/ftp/virtual/ftpuser1
sudo chown virtual:virtual /var/ftp/virtual/ftpuser1
anonymous_enable=YES
anon_root=/var/ftp/public
anon_upload_enable=NO
anon_mkdir_write_enable=NO
anon_other_write_enable=NO
anon_max_rate=1048576 # 1 MB/s
# 1. 產生自簽憑證 (生產環境請用 Let's Encrypt 或購買憑證)
sudo openssl req -x509 -nodes -days 3650 -newkey rsa:2048 \
-keyout /etc/vsftpd/vsftpd.key -out /etc/vsftpd/vsftpd.pem \
-subj "/C=TW/ST=Taipei/L=Taipei/O=MyOrg/CN=ftp.example.com"
# 2. vsftpd.conf 新增
ssl_enable=YES
rsa_cert_file=/etc/vsftpd/vsftpd.pem
rsa_private_key_file=/etc/vsftpd/vsftpd.key
ssl_sslv2=NO
ssl_sslv3=NO
ssl_tlsv1=YES
ssl_tlsv1_1=YES
ssl_tlsv1_2=YES
force_local_data_ssl=YES # 強制資料傳輸加密
force_local_logins_ssl=YES # 強制登入加密
require_ssl_reuse=NO # 相容舊客戶端
pasv_addr_resolve=YES
# firewalld
sudo firewall-cmd --permanent --add-service=ftp # 指令埠 21
sudo firewall-cmd --permanent --add-port=40000-40100/tcp # 被動模式埠範圍
sudo firewall-cmd --permanent --add-port=20/tcp # 主動模式資料埠 (可選)
sudo firewall-cmd --reload
# iptables (舊系統)
iptables -A INPUT -p tcp --dport 21 -j ACCEPT
iptables -A INPUT -p tcp --dport 20 -j ACCEPT
iptables -A INPUT -p tcp --dport 40000:40100 -j ACCEPT
# 關鍵:載入 ftp 連線追蹤模組 (自動處理主動模式 PORT 指令)
modprobe nf_conntrack_ftp
# /etc/modules-load.d/ftp.conf 內容:nf_conntrack_ftp
# 允許 FTP 讀取家目錄
sudo setsebool -P ftp_home_dir on
# 允許 FTP 完整寫入
sudo setsebool -P ftpd_full_access on
# 允許 FTPS (SSL)
sudo setsebool -P ftpd_use_ssl on
# 允許匿名寫入 (若啟用)
sudo setsebool -P allow_ftpd_anon_write on
# 檢查相關布林值
getsebool -a | grep ftp
| 錯誤碼/訊息 | 原因 | 解決方案 |
|---|---|---|
| 500 OOPS: cannot open user list file | 缺 /etc/vsftpd/user_list 或 userlist_enable=YES 但檔案不存在 | 建立檔案或設 userlist_enable=NO |
| 530 Permission denied / Login failed | 用戶不在允許清單、Shell 非法、PAM 失敗 | 檢查 /etc/shells、userlist_deny、PAM 設定 |
| 500 OOPS: cannot open chroot() user list file | chroot_list_enable=YES 但檔案不存在 | 建立 /etc/vsftpd/chroot_list (可空) |
| 500 OOPS: missing value in config file | 等號前有空格或缺值 | 修正格式:key=value 無前導空格 |
| 500 OOPS: bad bool value | 布林值非 YES/NO | 修正為 YES/NO |
| 500 OOPS: unrecognised variable | 參數名拼寫錯誤或前導空格 | 刪除空格、核對拼寫 |
| 553 Could not create file | SELinux 拒絕 / 目錄權限不足 / 磁碟滿 | setsebool -P ftpd_full_access on、檢查權限 755、擁有者 |
| 425 Can't open data connection | 被動模式埠未開放 / NAT 無 pasv_address | 防火牆開放範圍、設定 pasv_address |
| 421 Service not available | max_clients/max_per_ip 達上限 / 服務未啟動 | 調大限制、檢查服務狀態 |
systemctl status vsftpd 運行正常ftp localhost → 本地用戶登入成功、ls、put/get 正常lftp -u user ftp://server_ip → FTPS 加密連線 (驗證 PROT P)nmap -p 21,40000-40100 server_ip → 埠口開放正確ausearch -m avc -ts recent | grep ftpd → 無 SELinux 拒絕依循「虛擬用戶 + FTPS + 被動模式埠範圍 + SELinux 布林值 + chroot 隔離」這套標準化部署流程,即可建立安全、高效、易維護的企業級 FTP 服務。