ZhoubaWiki:Vsftpd

From ZhoubaWiki
Jump to: navigation, search

Sample production config

<syntaxhighlight>

  1. Example config file /etc/vsftpd.conf
  2. The default compiled in settings are fairly paranoid. This sample file
  3. loosens things up a bit, to make the ftp daemon more usable.
  4. Please see vsftpd.conf.5 for all compiled in defaults.
  5. READ THIS: This example file is NOT an exhaustive list of vsftpd options.
  6. Please read the vsftpd.conf.5 manual page to get a full idea of vsftpd's
  7. capabilities.
  8. Run standalone? vsftpd can run either from an inetd or as a standalone
  9. daemon started from an initscript.

listen=YES

  1. Run standalone with IPv6?
  2. Like the listen parameter, except vsftpd will listen on an IPv6 socket
  3. instead of an IPv4 one. This parameter and the listen parameter are mutually
  4. exclusive.
  5. listen_ipv6=YES
  6. Allow anonymous FTP? (Disabled by default)

anonymous_enable=NO

  1. Uncomment this to allow local users to log in.

local_enable=YES

  1. Uncomment this to enable any form of FTP write command.

write_enable=YES

  1. Default umask for local users is 077. You may wish to change this to 022,
  2. if your users expect that (022 is used by most other ftpd's)
  3. local_umask=022
  4. Uncomment this to allow the anonymous FTP user to upload files. This only
  5. has an effect if the above global write enable is activated. Also, you will
  6. obviously need to create a directory writable by the FTP user.
  7. anon_upload_enable=YES
  8. Uncomment this if you want the anonymous FTP user to be able to create
  9. new directories.
  10. anon_mkdir_write_enable=YES
  11. Activate directory messages - messages given to remote users when they
  12. go into a certain directory.

dirmessage_enable=YES

  1. If enabled, vsftpd will display directory listings with the time
  2. in your local time zone. The default is to display GMT. The
  3. times returned by the MDTM FTP command are also affected by this
  4. option.

use_localtime=YES

  1. Activate logging of uploads/downloads.

xferlog_enable=YES

  1. Make sure PORT transfer connections originate from port 20 (ftp-data).

connect_from_port_20=YES

  1. If you want, you can arrange for uploaded anonymous files to be owned by
  2. a different user. Note! Using "root" for uploaded files is not
  3. recommended!
  4. chown_uploads=YES
  5. chown_username=whoever
  6. You may override where the log file goes if you like. The default is shown
  7. below.
  8. xferlog_file=/var/log/vsftpd.log
  9. If you want, you can have your log file in standard ftpd xferlog format.
  10. Note that the default log file location is /var/log/xferlog in this case.
  11. xferlog_std_format=YES
  12. You may change the default value for timing out an idle session.
  13. idle_session_timeout=600
  14. You may change the default value for timing out a data connection.
  15. data_connection_timeout=120
  16. It is recommended that you define on your system a unique user which the
  17. ftp server can use as a totally isolated and unprivileged user.
  18. nopriv_user=ftpsecure
  19. Enable this and the server will recognise asynchronous ABOR requests. Not
  20. recommended for security (the code is non-trivial). Not enabling it,
  21. however, may confuse older FTP clients.
  22. async_abor_enable=YES
  23. By default the server will pretend to allow ASCII mode but in fact ignore
  24. the request. Turn on the below options to have the server actually do ASCII
  25. mangling on files when in ASCII mode.
  26. Beware that on some FTP servers, ASCII support allows a denial of service
  27. attack (DoS) via the command "SIZE /big/file" in ASCII mode. vsftpd
  28. predicted this attack and has always been safe, reporting the size of the
  29. raw file.
  30. ASCII mangling is a horrible feature of the protocol.
  31. ascii_upload_enable=YES
  32. ascii_download_enable=YES
  33. You may fully customise the login banner string:
  34. ftpd_banner=Welcome to blah FTP service.
  35. You may specify a file of disallowed anonymous e-mail addresses. Apparently
  36. useful for combatting certain DoS attacks.
  37. deny_email_enable=YES
  38. (default follows)
  39. banned_email_file=/etc/vsftpd.banned_emails
  40. You may restrict local users to their home directories. See the FAQ for
  41. the possible risks in this before using chroot_local_user or
  42. chroot_list_enable below.

chroot_local_user=YES

  1. You may specify an explicit list of local users to chroot() to their home
  2. directory. If chroot_local_user is YES, then this list becomes a list of
  3. users to NOT chroot().
  4. (Warning! chroot'ing can be very dangerous. If using chroot, make sure that
  5. the user does not have write access to the top level directory within the
  6. chroot)
  7. chroot_local_user=YES
  8. chroot_list_enable=YES
  9. (default follows)
  10. chroot_list_file=/etc/vsftpd.chroot_list
  11. You may activate the "-R" option to the builtin ls. This is disabled by
  12. default to avoid remote users being able to cause excessive I/O on large
  13. sites. However, some broken FTP clients such as "ncftp" and "mirror" assume
  14. the presence of the "-R" option, so there is a strong case for enabling it.
  15. ls_recurse_enable=YES
  16. Customization
  17. Some of vsftpd's settings don't fit the filesystem layout by
  18. default.
  19. This option should be the name of a directory which is empty. Also, the
  20. directory should not be writable by the ftp user. This directory is used
  21. as a secure chroot() jail at times vsftpd does not require filesystem
  22. access.

secure_chroot_dir=/var/run/vsftpd/empty

  1. This string is the name of the PAM service vsftpd will use.

pam_service_name=vsftpd

  1. This option specifies the location of the RSA certificate to use for SSL
  2. encrypted connections.
  3. rsa_cert_file=/etc/ssl/certs/ssl-cert-snakeoil.pem
  4. rsa_cert_file=/etc/ssl/private/vsftpd.pem

rsa_cert_file=/etc/ssl/certs/example_com.crt

  1. This option specifies the location of the RSA key to use for SSL
  2. encrypted connections.
  3. rsa_private_key_file=/etc/ssl/private/ssl-cert-snakeoil.key
  4. rsa_private_key_file=/etc/ssl/private/vsftpd.pem

rsa_private_key_file=/etc/ssl/private/example_com.key

pasv_enable=YES pasv_min_port=40000 pasv_max_port=40100

ssl_enable=YES allow_anon_ssl=NO force_local_data_ssl=NO force_local_logins_ssl=NO

ssl_tlsv1=YES ssl_sslv2=NO ssl_sslv3=NO

require_ssl_reuse=NO ssl_ciphers=HIGH allow_writeable_chroot=YES

seccomp_sandbox=no </syntaxhighlight>