Setting up an FTP server with vsftpd

Setting up an FTP server with vsftpd

By devin, 6 March, 2014

vsftpd is a simple and secure FTP server, I hear. I've used it to set up an FTP server quickly. Rather than fighting with TLS and FTP, I just use SFTP now - it's much simpler.

You'll need to download and install vsftpd and openssh-server at least. Also, I usually use AllowUsers in my /etc/ssh/sshd_config to whitelist  which users are allowed to ssh in like so:

 

AllowUsers alice bob carly

 

Now another quick step: set up an SSL certificate for your FTP server. This command will ask you some identifying information about where and who you are. Filling that information in is left as an exercise to the reader. If you modify this command to use a different directory than the /etc/ssl/private directory then you'll need to also update the /etc/vsftpd.conf file below. Anyways, here's the command:

 

openssl req -x509 -nodes -sha256 -days 730 -newkey rsa:2048 -keyout /etc/ssl/private/vsftpd.pem -out /etc/ssl/private/vsftpd.pem

 

Now that you've got ssh set up, the only step left is to modify /etc/vsftpd.conf. The default config file is great; back it up first. Then here is the condensed version of my config file:

 

# Example config file /etc/vsftpd.conf
	#
	# The default compiled in settings are fairly paranoid. This sample file
	# loosens things up a bit, to make the ftp daemon more usable.
	# Please see vsftpd.conf.5 for all compiled in defaults.
	#
	# READ THIS: This example file is NOT an exhaustive list of vsftpd options.
	# Please read the vsftpd.conf.5 manual page to get a full idea of vsftpd's
	# capabilities.
	#
	#
	# Run standalone?  vsftpd can run either from an inetd or as a standalone
	# daemon started from an initscript.
	listen=YES
	#
	# Run standalone with IPv6?
	# Like the listen parameter, except vsftpd will listen on an IPv6 socket
	# instead of an IPv4 one. This parameter and the listen parameter are mutually
	# exclusive.
	#listen_ipv6=YES
	#
	# Allow anonymous FTP? (Beware - allowed by default if you comment this out).
	anonymous_enable=NO
	#
	# Uncomment this to allow local users to log in.
	local_enable=YES
	# Uncomment this to enable any form of FTP write command.
	write_enable=YES
	# Default umask for local users is 077. You may wish to change this to 022,
	# if your users expect that (022 is used by most other ftpd's)
	local_umask=022
	#
	# Uncomment this to allow the anonymous FTP user to upload files. This only
	# has an effect if the above global write enable is activated. Also, you will
	# obviously need to create a directory writable by the FTP user.
	#anon_upload_enable=YES
	#
	# Uncomment this if you want the anonymous FTP user to be able to create
	# new directories.
	#anon_mkdir_write_enable=YES
	#
	# Activate directory messages - messages given to remote users when they
	# go into a certain directory.
	dirmessage_enable=YES
	#
	# If enabled, vsftpd will display directory listings with the time
	# in  your  local  time  zone.  The default is to display GMT. The
	# times returned by the MDTM FTP command are also affected by this
	# option.
	use_localtime=YES
	#
	# Activate logging of uploads/downloads.
	xferlog_enable=YES
	#
	# Make sure PORT transfer connections originate from port 20 (ftp-data).
	connect_from_port_20=YES
	#
	# If you want, you can arrange for uploaded anonymous files to be owned by
	# a different user. Note! Using "root" for uploaded files is not
	# recommended!
	#chown_uploads=YES
	#chown_username=whoever
	#
	# You may override where the log file goes if you like. The default is shown
	# below.
	#xferlog_file=/var/log/vsftpd.log
	#
	# If you want, you can have your log file in standard ftpd xferlog format.
	# Note that the default log file location is /var/log/xferlog in this case.
	#xferlog_std_format=YES
	#
	# You may change the default value for timing out an idle session.
	#idle_session_timeout=600
	#
	# You may change the default value for timing out a data connection.
	#data_connection_timeout=120
	#
	# It is recommended that you define on your system a unique user which the
	# ftp server can use as a totally isolated and unprivileged user.
	#nopriv_user=ftpsecure
	#
	# Enable this and the server will recognise asynchronous ABOR requests. Not
	# recommended for security (the code is non-trivial). Not enabling it,
	# however, may confuse older FTP clients.
	#async_abor_enable=YES
	#
	# By default the server will pretend to allow ASCII mode but in fact ignore
	# the request. Turn on the below options to have the server actually do ASCII
	# mangling on files when in ASCII mode.
	# Beware that on some FTP servers, ASCII support allows a denial of service
	# attack (DoS) via the command "SIZE /big/file" in ASCII mode. vsftpd
	# predicted this attack and has always been safe, reporting the size of the
	# raw file.
	# ASCII mangling is a horrible feature of the protocol.
	#ascii_upload_enable=YES
	#ascii_download_enable=YES
	#
	# You may fully customise the login banner string:
	#ftpd_banner=Welcome to blah FTP service.
	#
	# You may specify a file of disallowed anonymous e-mail addresses. Apparently
	# useful for combatting certain DoS attacks.
	#deny_email_enable=YES
	# (default follows)
	#banned_email_file=/etc/vsftpd.banned_emails
	#
	# You may restrict local users to their home directories.  See the FAQ for
	# the possible risks in this before using chroot_local_user or
	# chroot_list_enable below.
	#chroot_local_user=YES
	#
	# You may specify an explicit list of local users to chroot() to their home
	# directory. If chroot_local_user is YES, then this list becomes a list of
	# users to NOT chroot().
	# (Warning! chroot'ing can be very dangerous. If using chroot, make sure that
	# the user does not have write access to the top level directory within the
	# chroot)
	chroot_local_user=YES
	chroot_list_enable=NO
	# (default follows)
	#chroot_list_file=/etc/vsftpd.chroot_list
	#
	# You may activate the "-R" option to the builtin ls. This is disabled by
	# default to avoid remote users being able to cause excessive I/O on large
	# sites. However, some broken FTP clients such as "ncftp" and "mirror" assume
	# the presence of the "-R" option, so there is a strong case for enabling it.
	#ls_recurse_enable=YES
	#
	# Customization
	#
	# Some of vsftpd's settings don't fit the filesystem layout by
	# default.
	#
	# This option should be the name of a directory which is empty.  Also, the
	# directory should not be writable by the ftp user. This directory is used
	# as a secure chroot() jail at times vsftpd does not require filesystem
	# access.
	secure_chroot_dir=/var/run/vsftpd/empty
	#
	# This string is the name of the PAM service vsftpd will use.
	pam_service_name=vsftpd
	#
	# This option specifies the location of the RSA certificate to use for SSL
	# encrypted connections.
	rsa_cert_file=/etc/ssl/private/vsftpd.pem
	#ssl - added by devinh
	ssl_enable=YES
	allow_anon_ssl=NO
	force_local_data_ssl=YES
	force_local_logins_ssl=YES
	ssl_sslv2=NO
	ssl_sslv3=YES
	ssl_tlsv1=YES
	# Show hidden files and the "." and ".." folders.
	# Useful to not write over hidden files:
	force_dot_files=YES
	# Hide the info about the owner (user and group) of the files.
	hide_ids=YES
	# Connection limit for each IP:
	max_per_ip=2
	# Maximum number of clients:
	max_clients=4

 

Now to connect with, say, Filezilla, I'd use the following settings:

Host: sftp://example.com

Username: devin

Password: password1

Assuming, of course, that I have great passwords like password1 and I somehow lucked out and got the example.com domain.

Plain text

  • No HTML tags allowed.
  • Web page addresses and email addresses turn into links automatically.
  • Lines and paragraphs break automatically.