ansible-vsftpd's Introduction

ansible-vsftpd

Install FTP server - vsftpd.

Synopsis

Installs vsftpd
Allows use of virtual users (libpam-pwdfile)
Support TLS. Default is enabled i.e. only allow secure connections
Creates a test user (disabled by default):
- login: k0st1an
- password: 42

Tested

Debian Jessie
Ansible v1.9.1

Role Variables

See vars/main.yml for standard options:

# vsftpd settings
vsftpd_ftpd_banner: Welcome to FTP
vsftpd_max_per_ip: 100
vsftpd_pasv_min_port: 10000
vsftpd_pasv_max_port: 14000
vsftpd_xferlog_enable: 'YES'
vsftpd_local_root: /srv/ftp
vsftpd_ssl_enable: 'YES'
vsftpd_tls_only: 'YES'
vsftpd_user_config_dir: /etc/vsftpd.d
vsftpd_rsa_cert_file: /etc/ssl/certs/ssl-cert-snakeoil.pem
vsftpd_rsa_private_key_file: /etc/ssl/private/ssl-cert-snakeoil.key
vsftpd_write_enable: 'YES'
vsftpd_pasv_enable: 'YES'
# end vsftpd settings

vsftpd_pwd_file: /etc/vsftpd

vsftpd_test_user_is_enable: no
vsftpd_test_user: k0st1an
vsftpd_test_user_password: 42

Additionally you can optionally set:

vsftpd_pasv_address: 52.17.204.30
vsftpd_pasv_addr_resolve: NO

vsftpd documentation.

License

MIT

Author Information

GitHub: https://github.com/k0st1an

Author: Konstantin Kruglov

Contact: [email protected]

Cli command

There is a script vsftpd-users installed into /sbin/. It can add, delete, update, and display a list of users.

$ /sbin/vsftpd-user

Usage vsftpd-user:
  add     <user name> <password> [<path to db file>]  # Add new user
  upgrade <user name> <password> [<path to db file>]  # Upgrade password of the user
  del     <user name> [<path to db file>]             # Delete the user
  list    [<path to db file>]                         # Show users

Predefined variable:
  User DB: /etc/vsftpd
  Local root: /srv/ftp/    # Where will be create directory of the user

Recommend Projects