萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux FTP 服務完整部署指南:vsftpd 安裝、虛擬用戶、SSL/TLS 加密、防火牆穿透、SELinux 策略與常見錯誤碼對照表

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

SSL/TLS 加密 (FTPS) —— 必須啟用

# 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

SELinux 布林值 (RHEL 系必調)

# 允許 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 filechroot_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 fileSELinux 拒絕 / 目錄權限不足 / 磁碟滿setsebool -P ftpd_full_access on、檢查權限 755、擁有者
425 Can't open data connection被動模式埠未開放 / NAT 無 pasv_address防火牆開放範圍、設定 pasv_address
421 Service not availablemax_clients/max_per_ip 達上限 / 服務未啟動調大限制、檢查服務狀態

驗證清單

  1. systemctl status vsftpd 運行正常
  2. ftp localhost → 本地用戶登入成功、ls、put/get 正常
  3. lftp -u user ftp://server_ip → FTPS 加密連線 (驗證 PROT P)
  4. nmap -p 21,40000-40100 server_ip → 埠口開放正確
  5. ausearch -m avc -ts recent | grep ftpd → 無 SELinux 拒絕

依循「虛擬用戶 + FTPS + 被動模式埠範圍 + SELinux 布林值 + chroot 隔離」這套標準化部署流程,即可建立安全、高效、易維護的企業級 FTP 服務。

copyright © 萬盛學電腦網 all rights reserved