Installing & Configuring VSftpd
Applicable to Centos Versions:
- Centos 5.x
- Centos 6.x
Requirements
Explanation of requirements.
- Root access to your server
- Server running Centos 5.x or 6.x
Doing the Work
Basic description of what will be done and what is expected.
- Install VSftpd and add a user:
- Configure VSftpd:
- Add the bolded lines below as shown and restart iptables:
- Set VSftpd to start on boot and start it right now:
1 2 3 |
<strong>yum install vsftpd</strong> <strong>useradd ftpuser passwd ftpuser</strong> |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 |
<strong>vi /etc/vsftpd/vsftpd.conf</strong> <em>Change these options to your liking, when finished making any changes here, restart the vsftpd service so they take effect.</em> <br /># Example config file /etc/vsftpd/vsftpd.conf <br /># <br /># The default compiled in settings are fairly paranoid. This sample file <br /># loosens things up a bit, to make the ftp daemon more usable. <br /># Please see vsftpd.conf.5 for all compiled in defaults. <br />#<br /># READ THIS: This example file is NOT an exhaustive list of vsftpd options. <br /># Please read the vsftpd.conf.5 manual page to get a full idea of vsftpd's <br /># capabilities. <br /># <br /># Allow anonymous FTP? (Beware - allowed by default if you comment this out). <br />anonymous_enable=YES <br /># <br /># Uncomment this to allow local users to log in. <br />local_enable=YES <br /># <br /># Uncomment this to enable any form of FTP write command. <br />write_enable=YES <br /># <br /># Default umask for local users is 077. You may wish to change this to 022, <br /># if your users expect that (022 is used by most other ftpd's) <br />local_umask=022 <br /># <br /># Uncomment this to allow the anonymous FTP user to upload files. This only <br /># has an effect if the above global write enable is activated. Also, you will <br /># obviously need to create a directory writable by the FTP user. <br />#anon_upload_enable=YES <br /># <br /># Uncomment this if you want the anonymous FTP user to be able to create <br /># new directories. <br />#anon_mkdir_write_enable=YES <br /># <br /># Activate directory messages - messages given to remote users when they <br /># go into a certain directory. <br />dirmessage_enable=YES <br /># <br /># The target log file can be vsftpd_log_file or xferlog_file. <br /># This depends on setting xferlog_std_format parameter <br />xferlog_enable=YES <br /># <br /># Make sure PORT transfer connections originate from port 20 (ftp-data). <br />connect_from_port_20=YES <br /># <br /># If you want, you can arrange for uploaded anonymous files to be owned by <br /># a different user. Note! Using "root" for uploaded files is not <br /># recommended!<br />#chown_uploads=YES <br />#chown_username=whoever <br /># <br /># The name of log file when xferlog_enable=YES and xferlog_std_format=YES <br /># WARNING - changing this filename affects /etc/logrotate.d/vsftpd.log <br />#xferlog_file=/var/log/xferlog <br /># <br /># Switches between logging into vsftpd_log_file and xferlog_file files. <br /># NO writes to vsftpd_log_file, YES to xferlog_file <br />xferlog_std_format=YES <br /># <br /># You may change the default value for timing out an idle session. <br />#idle_session_timeout=600 <br /># <br /># You may change the default value for timing out a data connection. <br />#data_connection_timeout=120 <br /># <br /># It is recommended that you define on your system a unique user which the <br /># ftp server can use as a totally isolated and unprivileged user. <br />#nopriv_user=ftpsecure <br /># <br /># Enable this and the server will recognise asynchronous ABOR requests. Not <br /># recommended for security (the code is non-trivial). Not enabling it, <br /># however, may confuse older FTP clients. <br />#async_abor_enable=YES <br /># <br /># By default the server will pretend to allow ASCII mode but in fact ignore <br /># the request. Turn on the below options to have the server actually do ASCII <br /># mangling on files when in ASCII mode. <br /># Beware that on some FTP servers, ASCII support allows a denial of service <br /># attack (DoS) via the command "SIZE /big/file" in ASCII mode. vsftpd <br /># predicted this attack and has always been safe, reporting the size of the <br /># raw file. <br /># ASCII mangling is a horrible feature of the protocol. <br />#ascii_upload_enable=YES <br />#ascii_download_enable=YES <br /># <br /># You may fully customise the login banner string: <br />#ftpd_banner=Welcome to blah FTP service. <br /># <br /># You may specify a file of disallowed anonymous e-mail addresses. Apparently <br /># useful for combatting certain DoS attacks. <br />#deny_email_enable=YES <br /># (default follows) <br />#banned_email_file=/etc/vsftpd/banned_emails <br /># <br /># You may specify an explicit list of local users to chroot() to their home <br /># directory. If chroot_local_user is YES, then this list becomes a list of <br /># users to NOT chroot().<br />#chroot_list_enable=YES <br /># (default follows)<br />#chroot_list_file=/etc/vsftpd/chroot_list <br /># <br /># You may activate the "-R" option to the builtin ls. This is disabled by <br /># default to avoid remote users being able to cause excessive I/O on large <br /># sites. However, some broken FTP clients such as "ncftp" and "mirror" assume <br /># the presence of the "-R" option, so there is a strong case for enabling it. <br />#ls_recurse_enable=YES <br /># <br /># When "listen" directive is enabled, vsftpd runs in standalone mode and <br /># listens on IPv4 sockets. This directive cannot be used in conjunction <br /># with the listen_ipv6 directive. <br />listen=YES <br /># <br /># This directive enables listening on IPv6 sockets. To listen on IPv4 and IPv6 <br /># sockets, you must run two copies of vsftpd whith two configuration files. <br /># Make sure, that one of the listen options is commented !! <br />#listen_ipv6=YES pam_service_name=vsftpd userlist_enable=YES tcp_wrappers=YES |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
<strong>service iptables stop</strong> (<em>assumes your ftp server has an IP of: 192.168.0.1. If not, change this IP.</em>) <strong> iptables -A INPUT -p tcp -s 0/0 --sport 1024:65535 -d 192.168.0.1 --dport 21 -m state --state NEW,ESTABLISHED -j ACCEPT iptables -A OUTPUT -p tcp -s 192.168.0.1 --sport 21 -d 0/0 --dport 1024:65535 -m state --state ESTABLISHED -j ACCEPT iptables -A INPUT -p tcp -s 0/0 --sport 1024:65535 -d 192.168.0.1 --dport 1024:65535 -m state --state ESTABLISHED,RELATED -j ACCEPT iptables -A OUTPUT -p tcp -s 192.168.0.1 --sport 1024:65535 -d 0/0 --dport 1024:65535 -m state --state ESTABLISHED -j ACCEPT iptables -A OUTPUT -p tcp -s 192.168.0.1 --sport 20 -d 0/0 --dport 1024:65535 -m state --state ESTABLISHED,RELATED -j ACCEPT iptables -A INPUT -p tcp -s 0/0 --sport 1024:65535 -d 192.168.0.1 --dport 20 -m state --state ESTABLISHED -j ACCEPT </strong> <strong>vi /etc/sysconfig/iptables-config</strong> # Load additional iptables modules (nat helpers) # Default: -none- # Space separated list of nat helpers (e.g. 'ip_nat_ftp ip_nat_irc'), which # are loaded after the firewall rules are applied. Options for the helpers are # stored in /etc/modprobe.conf. IPTABLES_MODULES="ip_conntrack_netbios_ns" <strong>IPTABLES_MODULES="ip_conntrack_ftp"</strong> <strong>service iptables start</strong> |
1 |
<strong>chkconfig --level 23 vsftpd on && service vsftpd start</strong> |
Troubleshooting / How To Test
Explanation troubleshooting basics and expectations.
- Make sure VSftpd is set to start at boot time and is running:
- Check the firewall to make sure the required data and command ports are open and the correct modules are loading:
1 |
<strong>chkconfig --list | grep vsftpd; service vsftpd status</strong> |
1 |
<strong>service iptables status; grep ip_conntrack_ftp </strong><strong>/etc/sysconfig/iptables-config</strong> |
Common problems and fixes
Describe common problems here, include links to known common problems if on another site
More Information
Any additional information or notes.
Disclaimer
We test this stuff on our own machines, really we do. But you may run into problems, if you do, come to #centoshelp on irc.freenode.net
Added Reading
Last Modified: 22 Apr, 2020 at 16:43:34