docs / linux / vsftpd

vsFTPd

linux updated 2025-06-20

apt update

apt install ftp vsftpd -y

systemctl status vsftpd

ls -ld /data /data/ftp

ls -la /data/ftp | head -n 20

useradd -d /data/ftp -s /usr/sbin/nologin uid0ftp

passwd uid0ftp

useradd -d /data/ftp -s /usr/sbin/nologin uid1ftp

passwd uid1ftp

groupadd ftpusers

usermod -aG ftpusers uid0ftp

usermod -aG ftpusers uid1ftp

mkdir -p /data/ftp/shared

chown root:ftpusers /data/ftp/shared

chmod 2770 /data/ftp/shared

grep -q ‘^/usr/sbin/nologin$’ /etc/shells || echo ‘/usr/sbin/nologin’ >> /etc/shells

cp /etc/vsftpd.conf /etc/vsftpd.conf.bak

textcopy
cat > /etc/vsftpd.conf << 'EOF'
listen=YES
listen_ipv6=NO

# Disable anonymous FTP
anonymous_enable=NO

# Enable local system users
local_enable=YES

# Allow uploads/changes
write_enable=YES
local_umask=022

# Show directory messages if present
dirmessage_enable=YES
use_localtime=YES

# Logging
xferlog_enable=YES
xferlog_std_format=NO
vsftpd_log_file=/var/log/vsftpd.log
dual_log_enable=YES

# Chroot all local users to their home directory
chroot_local_user=YES
# We keep /data/ftp non-writable, and only /data/ftp/shared is writable,
# so we DO NOT need allow_writeable_chroot here.

# Passive mode ports (match your firewall/NAT later)
pasv_enable=YES
pasv_min_port=30000
pasv_max_port=30100

# Only allow users in this explicit list
userlist_enable=YES
userlist_deny=NO
userlist_file=/etc/vsftpd.userlist

# Security / PAM
pam_service_name=vsftpd
secure_chroot_dir=/var/run/vsftpd/empty
connect_from_port_20=YES
EOF

printf “uid0ftp\nuid1ftp\n” > /etc/vsftpd.userlist

systemctl restart vsftpd

systemctl status vsftpd

mkdir -p /etc/ssl/private

mkdir -p /etc/ssl/certs

textcopy
openssl req -x509 -nodes -days 3650 -newkey rsa:4096 \
  -keyout /etc/ssl/private/vsftpd.key \
  -out /etc/ssl/certs/vsftpd.crt \
  -subj "/C=US/ST=Nevada/L=Las Vegas/O=Harley FTP/CN=harley"

chmod 600 /etc/ssl/private/vsftpd.key

chmod 644 /etc/ssl/certs/vsftpd.crt

textcopy
cat >> /etc/vsftpd.conf << 'EOF'

# ==== TLS/SSL settings ====
ssl_enable=YES

# Certificate and key
rsa_cert_file=/etc/ssl/certs/vsftpd.crt
rsa_private_key_file=/etc/ssl/private/vsftpd.key

# Require SSL for local users (no plaintext logins or data)
force_local_logins_ssl=YES
force_local_data_ssl=YES
allow_anon_ssl=NO

# Protocols: only modern TLS
ssl_tlsv1=NO
ssl_tlsv1_1=NO
ssl_tlsv1_2=YES
ssl_tlsv1_3=YES

# Ciphers and reuse
ssl_ciphers=HIGH
require_ssl_reuse=NO
EOF

systemctl restart vsftpd systemctl status vsftpd

sed -i ‘/^ssl_tlsv1_1=/d;/^ssl_tlsv1_2=/d’ /etc/vsftpd.conf

textcopy
cat >> /etc/vsftpd.conf << 'EOF'
ssl_sslv2=NO
ssl_sslv3=NO
EOF

sed -i ‘s/^ssl_tlsv1=NO/ssl_tlsv1=YES/’ /etc/vsftpd.conf

systemctl restart vsftpd systemctl status vsftpd

openssl s_client -crlf -connect localhost:21 -starttls ftp

QUIT – to exit