Langue: en

Version: 301439 (debian - 07/07/09)

Section: 5 (Format de fichier)


ftpservers - ftpd virtual hosting configuration specification file


The ftpservers file is used to tell which set of virtual domain configuration files the ftpd(8) server should use. When compiled with VIRTUAL support, wu-ftpd has the ability to use separate configuration files for each virtual domain.

Currently, configuration files are placed into a separate virtual domain directory. The directory path and the IP address that is to use those configuration files is listed in the ftpservers file. The actual configuration files put into the virtual domain directory MUST be named:

    ftpaccess      - virtual domain's access file
    ftpusers       - restrict the accounts that can use the 
                     web server,
    ftpgroups      - SITE GROUP and SITE GPASS support,
    ftphosts       - allow or deny usernames access to that 
                     virtual server,
    ftpconversions - customize conversions available in the 
                     virtual domain.

You do not need to put every file in each of the virtual domain directories. If you want a set of domains to use the master copy of a file, for example, the ftpconversions file, then do not include that file in those virtual domain directories. In that case the default master copy will be used.
  NOTE!!!: The file names must match those listed above. If you misspell any of them or name them something else, the server WILL NOT find them and the master copy of them will be used instead.

ftpservers file format

There are two fields to each entry.

ipaddr/hostname directory-containing-configuration-files

For example:    /etc/ftpd/ftpaccess.somedomain/   /etc/ftpd/ftpaccess.someotherdomain/
    some.domain      INTERNAL

When an ftp client connects to the server, ftpd tries to match the IP address the ftp client connected to with one found in the ftpservers file.

If a match is found the path to the specified directory containing the configuration files for that specific domain is returned. The ftpd server uses any configuration files in that directory.

If a match is not found, or an invalid directory path is encountered, default paths to the configuration files are used. The use of INTERNAL in the example above fails the check for a specific directory and the master configuration files will be used.

Either the actual IP address or a specific hostname can be used to specify the virtual domain. It is better to specify the actual IP of the virtual domain as it reduces the need for a domain lookup and eliminates DNS security related naming issues.     /etc/ftpd/config/faqs.org/
    ftp.some.domain   /etc/ftpd/config/faqs.org/

As usual, comment lines are depicted with a # sign. Both comment lines and blanklines are ignored.

See Also

ftpd(8), ftpaccess(5) ftplog(5), ftpconversions(5), ftphosts(5)