jusito/vsftpd-alpine repository overview

⁠FTP Server VSFTPD meets alpine

FTP Server image with: (http://vsftpd.beasts.org⁠) State: Working but could be improved here and there.

⁠Getting Started

Syntax: docker -d [Options] jusito/vsftpd-alpine:*TAG*

1. Which use case? Choose your Tag below.
2. Pick name & password. -e MY_NAME="docker" -e MY_PASSWORD="MySecurePW"
3. Which ID do the data have or should they keep? -e MY_USER_ID="124" -e MY_GROUP_ID="124"
4. Give me 12 ports (20, 21, 10090-10100 in the container): -p 10020:20 -p 10021:21 -p 10090-10100:10090-10100
5. Volume to access? -v VolumeToManage:/home/*USER*/

⁠Example:

• Only one user
• FTP Login docker, password MySecurePW
• Data uploaded should be owned by user 124 and group 124
• External ports are 10020, 10021, 10090-10100
• A volume with existing data or a new volume should be used

docker run -d \
 -e MY_NAME="docker" -e MY_PASSWORD="MySecurePW" \
 -e MY_USER_ID="10000" -e MY_GROUP_ID="10000" \
 -p 10020:20 -p 10021:21 -p 10090-10100:10090-10100 \
 -v VolumeToManage:/home/docker/ \
 jusito/vsftpd-alpine:simple

⁠Example for Windows-Network-Mount:

You need: -e pasv_address="YourHostIP(not domain)"

docker run -d \
 -e MY_NAME="docker" -e MY_PASSWORD="MySecurePW" \
 -e MY_USER_ID="10000" -e MY_GROUP_ID="10000" \
 -p 10020:20 -p 10021:21 -p 10090-10100:10090-10100 \
 -v VolumeToManage:/home/docker/ \
 -e pasv_address="YourHostIP(not domain)" \
 jusito/vsftpd-alpine:simple

⁠Tags

⁠simple

= one user
= for windows / linux / filezilla...
- no SSL
- no seccomp / ...

⁠base

Contains every (config variable with default)[http://vsftpd.beasts.org/vsftpd_conf.html⁠]:

⁠Environment Variables

(all variables from x, all default values)[http://vsftpd.beasts.org/vsftpd_conf.html⁠]:

⁠windows mount

pasv_address => set to ip for windows usage thanks to https://github.com/onjin/docker-alpine-vsftpd⁠

⁠free to change

⁠internal (please don't change)

⁠Additional Informations

⁠Bug Windows

pasv_address => set to ip for windows usage (thanks to onjin@git)[https://github.com/onjin/docker-alpine-vsftpd⁠] Example Mount: ftp://1.2.3.4:10021

⁠FAQ

• seccomp_sandbox=NO ? (500 OOPS: 500 OOPS: child died)[https://bugzilla.redhat.com/show_bug.cgi?id=845980⁠]
• anonymous_enable=YES ? Username: anonymous
• allow_writeable_chroot=NO & chroot_local_user=NO? 500 OOPS: vsftpd: refusing to run with writable root inside chroot
• pasv_enable=YES ? Data Connection
• write_enable=YES ? any FTP command allowed
• passwd_chroot_enable=YES ? jail is per user, derived from home path "."
• local_enable=YES ? Local Accounts can use ftp connections
• local_umask ? Permissions