README
1This example shows how to run vsftpd in "standalone" mode - i.e. without
2needing to run an inetd of some kind (inetd, xinetd, tcpserver etc).
3
4vsftpd has supported standalone mode since v1.1.0.
5
6With the release of v1.1.3, the feature list of standalone mode has grown so
7that large internet sites no longer need to use an inetd.
8Previously, large internet sites were forced to use xinetd for the important
9feature of "limit number of concurrent connections from a single IP address".
10Unfortunately, there seem to be xinetd stability issues - various larger
11sites are reporting that xinetd's session counting can go wrong and incorrectly
12kick off users because it thinks the FTP site is full when it is not.
13
14vsftpd now natively handles maximum session counts and maximum session per IP
15counts. It can also do native access control via tcp_wrappers integration and
16even per-connect-IP configurability.
17
18To use this example config:
19
201) Copy the vsftpd.conf file in this directory to /etc/vsftpd.conf.
21
222) Start up vsftpd, e.g.
23vsftpd &
24
253) That should be it!
26
27The example vsftpd.conf is based on the vsftpd.conf from the INTERNET_SITE
28example. Let's look at the differences (at the top):
29
30# Standalone mode
31listen=YES
32
33This tells vsftpd to run in standalone mode. Do NOT try and run vsftpd from
34an inetd with this option set - it won't work, you may well get 500 OOPS:
35could not bind listening socket.
36
37max_clients=200
38max_per_ip=4
39
40The maximum number of session is 200 (new clients will get refused with a
41busy message). The maximum number of sessions from a single IP is 4 (the
425th connect will get refused with a suitable message).
43
44
45One further note on standalone mode, regarding virtual IPs. This is very
46easy - just run one copy of vsftpd per virtual IP (remembering to give each
47a separate config file on the command line).
48Distinguish which vsftpd is for which virtual IP with a setting like this
49in the vsftpd.conf:
50
51listen_address=192.168.1.2
52
53And launch vsftpd with a specific config file like this:
54vsftpd /etc/vsftpd.conf.site1 &
55
56