From b31fcca8d6345019822371aee144e3f8ef208543 Mon Sep 17 00:00:00 2001 From: Marc Juul Date: Fri, 6 Jul 2018 03:02:16 -0700 Subject: [PATCH] added instructions on running an ftp server --- README.md | 81 ++++++++++++++++++++++++++ vsftpd.conf | 159 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 240 insertions(+) create mode 100644 vsftpd.conf diff --git a/README.md b/README.md index 219646c..2197b63 100644 --- a/README.md +++ b/README.md @@ -373,4 +373,85 @@ Then test it with: ifup -v wlp0s0 ``` +# Running an anonymous ftp server + +Install the vsftpd sever: + +``` +sudo apt install vsftpd +``` + +Use the `vsftpd.conf` from this git repo: + +``` +sudo cp ./vsftpd.conf /etc/ +``` + +The directory shared via ftp will be `/srv/ftp`. You can change this by altering the `ftp` users' home directory in `/etc/passwd`. + +If you want to share an external drive then first partition it, then format it and give it a unique label. Let's assume it's called `/dev/sdb`. + +__WARNING THE FOLLOWING WILL DELETE EVERYTHIN ON THE DRIVE__ + +To partition run `sudo fdisk /dev/sdb`, then hit `d` and enter again until there are no partitions left. Now hit `c` to create a partition and hit enter for each question to accept the defaults, then hit `w` to write the changes to disk. + +Now format the drive: + +``` +# WARNING THIS WILL DELETE EVERYTHINg ON THE DRIVE + +sudo mkfs.ext4 -L my-labeled-drive /dev/sdb1 +``` + +To make the drive automatically mount in the ftp directory on boot add the following line to `/etc/fstab`: + +``` +LABEL=my-labeled-drive /srv/ftp ext4 noatime,errors=remount-ro 0 2 +``` + +Now mount it to ensure that the fstab line works: + +``` +sudo mount /srv/ftp +``` + +While the drive is mounted, set the permissions: + +``` +sudo chown root.ftp /srv/ftp +sudo chmod 755 /srv/ftp +``` + +If you want users to be able to upload to an `uploads` directory then do: + +``` +sudo mkdir /srv/ftp/uploads +sudo chown ftp.ftp /srv/ftp/uploads +sudo chmod 755 /srv/ftp/uploads +``` + +by default no-one will be able to delete from the `uploads/` directory. To change this modify the line in `/etc/vsftpd.conf` saying `chown_uploads=YES` to `chown_uploads=NO`. Note that this will allow anyone to delete anything in the uploads directory. + +Now restart vsftpd to make it use the new configuration: + +``` +sudo /etc/init.d/vsftpd restart +``` + +Create a test file to download: + +``` +sudo echo "Welcome to my ftp server!" > /srv/ftp/README +``` + +Test that you can connect to the ftp server using e.g. `ncftp` from another computer and download and upload + +``` +sudo apt install ncftp +echo "TEST UPLOAD CONTENT" > test +ncftp +get README +cd uploads/ +put test +``` diff --git a/vsftpd.conf b/vsftpd.conf new file mode 100644 index 0000000..4089b93 --- /dev/null +++ b/vsftpd.conf @@ -0,0 +1,159 @@ +# 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=NO +# +# This directive enables listening on IPv6 sockets. By default, listening +# on the IPv6 "any" address (::) will accept connections from both IPv6 +# and IPv4 clients. It is not necessary to listen on *both* IPv4 and IPv6 +# sockets. If you want that (perhaps because you want to listen on specific +# addresses) then you must run two copies of vsftpd with two configuration +# files. +listen_ipv6=YES +# +# Allow anonymous FTP? (Disabled by default). +anonymous_enable=YES +# +# 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 + +anon_umask=022 +chown_upload_mode=0644 + +# +# 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=nobody +# +# 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=YES +# (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/certs/ssl-cert-snakeoil.pem +rsa_private_key_file=/etc/ssl/private/ssl-cert-snakeoil.key +ssl_enable=NO + +# +# Uncomment this to indicate that vsftpd use a utf8 filesystem. +#utf8_filesystem=YES