VSFTPD Server in a Docker

This vsftpd docker image is based on official CentOS 7 image and comes with following features:

• Virtual users
• Passive mode (ports 21100-21110)
• Logging to a file or STDOUT
• Anonymous account access (defined by user on docker run true/false)

### Environmental Variables

FTP_USER
Default:	FTP_USER=admin
Accepted values:	Any string. Avoid whitespaces and special chars.
Description:	Username for the default FTP account. If you don't specify it through the FTP_USER environment variable at run time, admin will be used by default.

FTP_PASS
Default:	FTP_PASS=random
Accepted values:	Any string.
Description:	If you don't specify a password for the default FTP account through FTP_PASS, a 16 characters random string will be automatically generated. You can obtain this value through the container logs.

LOG_STDOUT
Default:	LOG_STDOUT=false
Accepted values:	true or false
Description:	Output vsftpd log through STDOUT, so that it can be accessed through the container logs.

ANONYMOUS_ACCESS
Default:	ANONYMOUS_ACCESS=false
Accepted values:	true or false
Description:	Grants access to user anonymous need to have access to files in /var/ftp/pub directory.

UPLOADED_FILES_WORLD_READABLE
Default:	UPLOADED_FILES_WORLD_READABLE=false
Accepted values:	true or false
Description:	Changes the permmissions of uploaded files to rw- r-- r--. This makes files readable by other users.

CUSTOM_PASSIVE_ADDRESS
Default:	CUSTOM_PASSIVE_ADDRESS=false
Accepted values:	ip address or false
Description:	Passive Address that gets advertised by vsftpd when responding to PASV command. This is useul when running behind a proxy, or with docker swarm.

Basic usage

docker run \
  --name vsftpd \
  -d \
  million12/vsftp

example output of docker logs vsftpd

[VSFTPD 11:00:46] Created home directory for user: admin
[VSFTPD 11:00:46] Updated /etc/vsftpd/virtual_users.txt
[VSFTPD 11:00:46] Updated vsftpd database
[VSFTPD 11:00:46] Fixed permissions for newly created user: admin
       	SERVER SETTINGS
       	---------------
       	· FTP User: admin
       	· FTP Password: Al5HpyJtUp3fQiEe
       	· Log file: /var/log/vsftpd/vsftpd.log
[VSFTPD 11:00:46] VSFTPD daemon starting

Custom usage

docker run \
  --name vsftpd \
  -d \
  -e FTP_USER=www \
  -e FTP_PASS=my-password \
  -e ANONYMOUS_ACCESS=true \
  -p 20-21:20-21 \
  -p 21100-21110:21100-21110 \
  million12/vsftpd

example output of docker logs vsftpd

[VSFTPD 11:04:43] Enabled access for anonymous user.
[VSFTPD 11:04:43] Created home directory for user: www
[VSFTPD 11:04:43] Updated /etc/vsftpd/virtual_users.txt
[VSFTPD 11:04:43] Updated vsftpd database
[VSFTPD 11:04:43] Fixed permissions for newly created user: www
       	SERVER SETTINGS
       	---------------
       	· FTP User: www
       	· FTP Password: my-password
       	· Log file: /var/log/vsftpd/vsftpd.log
[VSFTPD 11:04:43] VSFTPD daemon starting

since docker version 1.5 ports can be exported in range

Docker troubleshooting

Use docker command to see if all required containers are up and running:

$ docker ps

Check logs of docker container:

$ docker logs vsftpd

Sometimes you might just want to review how things are deployed inside a running container, you can do this by executing a bash shell through docker's exec command:

docker exec -ti vsftpd /bin/bash

History of an image and size of layers:

docker history --no-trunc=true million12/vsftpd | tr -s ' ' | tail -n+2 | awk -F " ago " '{print $2}'

Author

Author: Przemyslaw Ozgo ([email protected])
This work is also inspired by fauria's work. Many thanks!

---

Sponsored by Prototype Brewery - the new prototyping tool for building highly-interactive prototypes of your website or web app. Built on top of Neos CMS and Zurb Foundation framework.