jbrunicardi/docker-vsftpd

By jbrunicardi

•Updated about 9 years ago

VSFTP form from million12/vsftpd

Image

1.1K

Overview Tags

jbrunicardi/docker-vsftpd repository overview

⁠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.

⁠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.

Tag summary

Recent tags

Content type

Image

Digest

Size

70.3 MB

Last updated

about 9 years ago

docker pull jbrunicardi/docker-vsftpd