Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.
Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement…
Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
{{tag>Logiciel}}

====== /etc/vsftpd.conf : Le fichier de configuration de vsftpd ======

====== Fichier fourni à l'installation ======

Voici le fichier exemple **/etc/vsftpd.conf** livré à l'installation :<code - /etc/vsftpd.conf.dist>
# 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=NO
#
# 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
#
# 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=whoever
#
# 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
</code>


====== Valeurs du fichier fourni ======

^ listen=NO                                                    | Mode autonome                                                                                                                                                                         |
^ listen_ipv6=YES                                              | écoute sur les sockets IPv6                                                                                                                                                           |
^ anonymous_enable=NO                                          | pas de connexion anonyme                                                                                                                                                              |
^ local_enable=YES                                             | connexion autorisée pour les utilisateurs locaux                                                                                                                                      |
^ dirmessage_enable=YES                                        | messages envoyés aux utilisateurs distants\\ quand ils pénètrent dans un répertoire                                                                                                   |
^ use_localtime=YES                                            | fuseau horaire local                                                                                                                                                                  |
^ xferlog_enable=YES                                           | journalisation des envois/téléchargements                                                                                                                                             |
^ connect_from_port_20=YES                                     | S'assurer que les transferts proviennent du port 20 (ftp-data)                                                                                                                        |
^ secure_chroot_dir=/var/run/vsftpd/empty                      | répertoire vide inaccessible en écriture par l'utilisateur ftp.\\ Ce répertoire sert de prison chroot sécurisée quand vsftpd ne demande pas d'accès au système de fichiers            |
^ pam_service_name=vsftpd                                      | nom du service PAM que vsftpd utilisera                                                                                                                                               |
^ rsa_cert_file=/etc/ssl/certs/ssl-cert-snakeoil.pem           | certificat RSA à utiliser pour les connexions cryptées SSL                                                                                                                            |
^ rsa_private_key_file=/etc/ssl/private/ssl-cert-snakeoil.key  | clé privée RSA à utiliser pour les connexions cryptées SSL.\\ Si cette option n'est pas définie, la clé privée est dans le même fichier que le certificat.                            |
^ ssl_enable=NO                                                | avec OpenSSL, vsftpd prendra en charge les connexions via SSL.\\ N'activez cette option que si vous en avez besoin.\\ vsftpd ne peut garantir la sécurité des bibliothèques OpenSSL.  |

Les autres réglages ont leurs valeurs par défaut.
====== Valeurs par défaut ======

  ? anonymous_enable=
  : YES
  ? anon_mkdir_write_enable=
  : NO
  ? anon_other_write_enable=
  : NO
  ? anon_umask=
  : 077
  ? anon_upload_enable=
  : NO
  ? chown_uploads=
  : NO
  ? chown_username=
  : root
  ? connect_from_port_20=
  : NO
  ? chroot_list_enable=
  : NO
  ? chroot_list_file=
  : /etc/vsftpd.chroot_list
  ? chroot_local_user=
  : NO
  ? data_connection_timeout=
  : 300
  ? dirmessage_enable=
  : NO
  ? ftpd_banner=
  : (aucune -> bannière par défaut
  ? guest_enable=
  : NO
  ? guest_username=
  : ftp
  ? idle_session_timeout=
  : 300
  ? listen=
  : YES
  ? listen_ipv6=
  : NO
  ? local_enable=
  : NO
  ? local_umask=
  : 077
  ? max_clients=
  : 0 (illimité)
  ? max_per_ip=
  : 0 (illimité)
  ? nopriv_user=
  : nobody
  ? pam_service_name=
  : ftp
  ? rsa_cert_file=
  : /usr/share/ssl/certs/vsftpd.pem
  ? rsa_private_key_file=
  : (aucun)
  ? secure_chroot_dir=
  : /usr/share/empty
  ? ssl_enable=
  : NO
  ? use_localtime=
  : NO
  ? user_config_dir=
  : (aucun)
  ? write_enable=
  : NO
  ? xferlog_enable=
  : NO
  ? xferlog_file=
  : /var/log/xferlog
  ? xferlog_std_format=
  : NO
  ? allow_writeable_chroot=
  : YES

====== Exemple de fichier ======

<code - /etc/vsftpd.conf>
# On désactive les connexions anonymes
# et on active les non-anonymes
# (c'est le cas des utilisateurs virtuels)
anonymous_enable=NO
local_enable=YES

# Pour des raisons de sécurité, on interdit toute action d'écriture :
#write_enable=NO
#anon_upload_enable=NO
#anon_mkdir_write_enable=NO
#anon_other_write_enable=NO

# "guest_enable" active les utilisateurs virtuels
# "guest_username" fait correspondre
# tous les utilisateurs virtuels
# à l'utilisateur d'Apache 2
guest_enable=YES
guest_username=www-data

nopriv_user=www-data

# On définit les droits par défaut
# des fichiers uploadés
anon_umask=022
local_umask=022

dirmessage_enable=YES

use_localtime=YES

xferlog_enable=YES
xferlog_file=/var/log/vsftpd.log
xferlog_std_format=YES

connect_from_port_20=YES

chown_uploads=YES
chown_username=www-data

idle_session_timeout=600
data_connection_timeout=120

ftpd_banner=Bienvenue sur le serveur FTP de ... !

# On enferme les utilisateurs virtuels dans leur dossier
chroot_local_user=YES
chroot_list_enable=YES
chroot_list_file=/etc/vsftpd.chroot_list
allow_writeable_chroot=YES

# On définit le nombre maximum de sessions à 100
# On définit le nombre maximum de sessions par IP à 5
max_clients=100
max_per_ip=5

####################################
# Debian customization             #
# (ou adoptons la Debian attitude) #
####################################
secure_chroot_dir=/var/run/vsftpd

# Utilisation de PAM pour l'authentification
pam_service_name=vsftpd

rsa_cert_file=/etc/ssl/certs/vsftpd.pem
rsa_private_key_file=/etc/ssl/private/vsftpd.key
#ssl_enable=NO

# Configuration par utilisateur
user_config_dir=/etc/vsftpd/users.conf
</code>

  ? ftp_username
  : Nom de l'utilisateur utilisé pour traiter les FTP anonymes.
  : Le répertoire personnel de cet utilisateur est la racine du FTP anonyme.
  : Par défaut : **ftp**

====== Les options ======

===== Options du démon =====

  ? listen (défaut = NO)
  : mode standalone ?<code>listen=YES</code>
  ? listen_ipv6 (défaut = NO)
  : Support IPv6 ?<code>#listen_ipv6=NO</code>
  ? listen_port (défaut = 21)
  : Port pour le canal de contrôle<code>#listen_port=21</code>
  ? ftp_data_port (défaut = 20)
  : Port pour le canal de données<code>#ftp_data_port=20</code>
  ? max_clients (défaut = 0 -> pas de limite)
  : Nombre maximum de clients connectés simultanément<code>max_clients=4</code>
  ? max_per_ip (défaut = 0 -> pas de limite)
  : Nombre de connexions par clients<code>max_per_ip=1</code>
  ? nopriv_user
  : Exécuter vsftpd en tant qu'utilisateur "ftpsecure"<code>nopriv_user=ftpsecure</code>
  ?  background (défaut : NO)
  : Si activé, et que vsftpd est démarré en mode standalone, vsftpd metra le processus d'écoute. en arrière-plan, c'est-à-dire que le contrôle sera rendu immédiatement au shell qui a lancé vsftpd.<code>#background=NO</code>
  ? check_shell (défaut : YES)
  : Uniquement pour les installations sans utiliser PAM ! Si désactivé, vsftpd ne cherche pas dans /etc/shells un shell utilisateur valide pour les connexions locales.<code>#check_shell=YES</code>
  ? connect_from_port_20 (défaut : NO, mais le fichier exemple le met à YES)
  : Contrôle si les connexions de données, utilisent le port 20 (ftp-data) sur le serveur. Pour des raisons de sécurité, certains clients peuvent insister pour que ce soit le cas. Inversement, la désactivation de cette option permet à vsftpd de tourner avec un peu moins privilèges.<code>#connect_from_port_20=NO</code>
  ? one_process_model (défaut : NO)
  : Si vous avez un noyau Linux 2.4, il est possible d'utiliser un modèle de sécurité qui utilise un seul processus par connexion. C'est un modèle de sécurité moins sûr, mais on gagne en performance. A n'activer que si on sait ce que l'on fait.<code> #one_process_model=NO</code>
  ? run_as_launching_user (défaut : NO)
  : Mettre YES pour tourner en tant que l'utilisateur qui a lancé vsftpd. Utile quand lorsque l'accès root n'est pas disponible. <WRAP center round important 60%>
 A n'activer que si on sait ce que l'on fait. Peut créer des grands problèmes de sécurité. En particulier, cela empêche d'utiliser chroot pour limiter les accès
</WRAP><code>#run_as_launching_user=NO</code>
  ? tcp_wrappers (défaut : NO)
  : Si activé, et que vsftpd a été compilé avec le support des tcp_wrappers, les connexions entrantes seront alimentés par le contrôle d'accès tcp_wrappers. En outre, il existe un mécanisme de base de configuration par IP. Si tcp_wrappers définit la variable d'environnement VSFTPD_LOAD_CONF, la session vsftpd va charger le fichier de configuration de vsftpd spécifié dans cette variable.<code>#tcp_wrappers=NO</code>
  ? listen_address (défaut : vide)
  : En mode autonome, l'adresse d'écoute par défaut (de toutes les interfaces locales) peut être remplacée par ce paramètre. Fournir une adresse IP numérique.<code> #listen_address=</code>
  ? listen_address6 (défaut : vide)
  : Comme listen_address, mais adresse IPv6 au format d'adresse IPv6 standard.<code>#listen_address6=</code>

===== Options de connexion =====

==== Mode PASV ====

  ? pasv_enable (défaut = YES)
  :  Utilisation du mode PASV ?
  : <code>#pasv_enable=YES</code>
  ? pasv_max_port (défaut = 0 => pas de limite)
  : port maxi
  : <code>pasv_max_port=2020</code>
  ? pasv_min_port (défaut = 0 => pas de limite)
  : port mini
  : <code>pasv_min_port=2020</code>
  ? pasv_address (défaut = "")
  : adresse IP
  : <code>pasv_address=217.217.36.25</code>
  ? pasv_promiscuous (défaut = NO)
  : pasv_promiscuous
  : <code>#pasv_promiscuous=NO</code>
  ? accept_timeout (défaut = 60)
  : accept_timeout
  : <code>#accept_timeout=60</code>

==== Mode PORT ====

  ? port_enable (défaut = YES)
  : Utilisation du mode PORT ?
  : <code>port_enable=NO</code>
  ? ftp_data_port (défaut = 20)
  :: port de données
  : <code>ftp_data_port=2020</code>
  ? connect_from_port_20 (défaut = NO)
  : port 20 ?
  : <code>#connect_from_port_20=NO</code>
  ? port_promiscuous (défaut = NO)
  : promiscuous ?
  : <code>#port_promiscuous=NO</code>
  ? connect_timeout (défaut = 60)
  : délai de connexion
  : <code>#connect_timeout=60</code>

==== Autres options ====

  ? data_connect_timeout (défaut = 300)
  : <code>#data_connect_timeout=300</code>


===== Cryptage des connexions =====

Cette option spécifie l'emplacement du certificat RSA à utiliser pour les connexions cryptées SSL.

  ? ssl_enable
  : <code>ssl_enable=YES</code>
  ? ssl_tlsv1
  : <code>ssl_tlsv1=YES</code>
  ? ssl_sslv2
  : <code>ssl_sslv2=NO</code>
  ? ssl_sslv3
  : <code>ssl_sslv3=NO</code>
  ? ssl_ciphers
  : <code>ssl_ciphers=DES-CBC3-SHA</code>
  ? dsa_cert_file
  : <code>dsa_cert_file=/etc/ssl/certs/vsftpd.pem</code>
  ? rsa_cert_file
  : <code>rsa_cert_file=/etc/ssl/certs/vsftpd.pem</code>
  ? force_local_data_ssl
  : <code>force_local_data_ssl=YES</code>
  ? force_local_logins_ssl
  : <code>force_local_logins_ssl=YES</code>

===== Gestion des logs =====

  ? dual_log_enable (défaut = NO)
  : Utilisation de 2 fichiers de logs ?
  : <code>dual_log_enable=YES</code>
  ? vsftpd_log_file (défaut = /var/log/vsftpd.log)
  : Fichier de logs de vsftpd
  : <code>#vsftpd_log_file=/var/log/vsftpd.log</code>
  ? syslog_enable (défaut = NO)
  : Utiliser syslog plutôt que le fichier de logs de vsftpd ?
  : <code>#syslog_enable=NO</code>

==== xferlog ====

  ? xferlog_enable ? (défaut = NO)
  : Utilisation de xferlog
  : <code>xferlog_enable=YES</code>
  ? xferlog_file (défaut = /var/log/xferlog)
  : fichier xferlog
  : <code>#xferlog_file=/var/log/xferlog</code>
  ? xferlog_std_format (défaut =NO)
  : format std ?
  : <code>xferlog_std_format=YES</code>
  ? log_ftp_protocol (défaut = NO)
  : Logguer toutes les requêtes et réponses ?
  : <code>#log_ftp_protocol=NO</code>

==== Options non définies ====

  ? no_log_lock
  : #no_log_lock

===== Utilisateurs anonymes =====

  ? anonymous_enable (défaut = YES)
  : Autoriser le FTP anonyme ?
  : <code>anonymous_enable=NO</code>
  ? allow_anon_ssl
  : Autoriser les connections anonymes non sécurisées ? (ssl_enable doit être actif)
  : <code>allow_anon_ssl=NO</code>
  ? no_anon_password (défaut = NO)
  : Ne pas demander de mots de passe pour les utilisateurs anonymes ?
  : <code>no_anon_password=YES</code>
  ? deny_email_enable (défaut = NO)
  : Utilisation d'une liste d'adresses e-mail interdites ?
  : <code>#deny_email_enable=NO</code>
  ? banned_email_file (défaut = /etc/vsftpd.banned_emails)
  : laquelle ?
  : <code>#banned_email_file=/etc/vsftpd.banned_emails</code>
  ? secure_email_list_enable
  : Utilisation d'une liste d'adresses e-mail de confiance ?
  : <code>secure_email_list_enable=NO</code>
  ? email_password_file
  : email_password_file
  : <code>#email_password_file=/etc/vsftpd.email_passwords</code>
  ? anon_root (pas de valeur par défaut)
  : Se connecter dans le répertoire suivant
  : <code>anon_root=/var/ftp</code>
  ? ftp_username (défaut = ftp)
  : en tant qu'utilisateur X ?
  : <code>#ftp_username=ftp</code>
  ?  (défaut = NO)
  : Autoriser la création de nouveaux répertoires ? (write_enable doit être actif)
  : <code>#anon_mkdir_write_enable=NO</code>
  ? anon_other_write_enable
  : Autoriser la suppression et le renommage des fichiers ?
  : <code>anon_other_write_enable=NO</code>
  ? anon_upload_enable (défaut = NO)
  : Autoriser le téléversement ? (write_enable doit être actif)
  : <code>#anon_upload_enable=NO</code> !!
  ? chown_uploads (défaut = NO)
  : Faut-il changer le propriétaire du fichier téléversé ?
  : <code>chown_uploads=YES</code>
  ? chown_username (défaut = root)
  : Si oui, lequel ?
  : <code>chown_username=ftp</code>
  ? anon_world_readable_only (défaut = YES)
  : Seuls les fichiers en lecture pour tout le monde peuvent être téléchargés
  : <code>#=YES</code>

===== Utilisateurs locaux =====

  ? local_enable (défaut = YES)
  : Autoriser les utilisateurs locaux ?
  : <code>local_enable=YES</code>
  ? local_root (pas de valeur par défaut)
  : Répertoire des utilisateurs locaux
  : <code>local_root=/var/ftp</code>
  ? local_umask (défaut = 022)
  : Masque des utilisateurs locaux
  : <code>local_umask=007</code>
  ? local_max_rate (défaut : 0=illimité) 
  : Taux de transfert maximum
  : <code>local_max_rate=0</code>

===== Options FTP =====

====== Voir aussi ======

  * **(en)** [[http://vsftpd.beasts.org/vsftpd_conf.html|Page de man]]
  * **(fr)** ma page [[logiciel:internet:ftp:vsftpd:vsftpd_conf:start1]] (d'après le man)
    * [[logiciel:internet:ftp:vsftpd:vsftpd_conf:start2]]

----
//Basé sur << [[http://Article|Article]] >> par Auteur.//
Piste : • Pluxml pour les nuls • Mdadm : Superviser un RAID logiciel • Prophétie de saint Malachie • @!PAGE@ • Portail communications • DWservice : un TeamViewer like, voire mieux • vsftpd FAQ (traduction de questions fréquemment posées) • custombuttons : ajout de boutons personnalisés à la barre d'outils • Astuces pour Linux • Dolibarr : module Proposition commerciale (Devis)
Documentation du Dr FRAPPE

Recherche

Navigation

Imprimer/exporter

Outils
