akue/vsftpd

akue/vsftpd

基于fauria/vsftpd

!https://raw.githubusercontent.com/artjomsk/docker-vsftpd/master/docker_139x115.png

该Docker容器实现了一个vsftpd服务器，具有以下特性：

• Centos 7基础镜像
• vsftpd 3.0版本
• 支持虚拟用户
• 被动模式
• SSL加密支持
• 日志输出到文件或STDOUT

从Docker Registry Hub安装

您可以通过以下命令下载镜像：

bash
docker pull akue/vsftpd

环境变量

该镜像使用环境变量在运行时配置参数：

• 变量名：FTP_USER
  默认值：admin
  接受值：任意字符串（避免空格和特殊字符）
  描述：默认FTP账户的用户名。若未通过FTP_USER指定，将默认使用admin。

• 变量名：FTP_PASS
  默认值：随机字符串
  接受值：任意字符串
  描述：若未通过FTP_PASS指定默认账户密码，将自动生成16位随机字符串，可通过容器日志查看。

• 变量名：PASV_ADDRESS_ENABLE
  默认值：NO
  接受值：NO|YES
  描述：启用/禁用被动模式。

• 变量名：PASV_ADDRESS_RESOLVE
  默认值：YES
  接受值：NO|YES
  描述：若希望在PASV_ADDRESS选项中使用主机名（而非IP地址），设置为YES。

• 变量名：PASV_ADDRESS
  默认值：Docker主机IP/主机名
  接受值：任意IPv4地址或主机名（参考PASV_ADDRESS_RESOLVE）
  描述：若未指定被动模式使用的IP地址，将使用Docker主机的路由IP地址（可能为本地地址）。

• 变量名：PASV_ADDR_RESOLVE
  默认值：NO
  接受值：YES或NO
  描述：若希望在PASV_ADDRESS选项中使用主机名（而非IP地址），设置为YES。

• 变量名：PASV_ENABLE
  默认值：YES
  接受值：YES或NO
  描述：设置为NO可禁止使用PASV方法建立数据连接。

• 变量名：PASV_MIN_PORT
  默认值：21100
  接受值：任意有效端口号
  描述：被动模式端口范围的下限，需通过docker -p参数发布端口。

• 变量名：PASV_MAX_PORT
  默认值：21110
  接受值：任意有效端口号
  描述：被动模式端口范围的上限，发布大量端口会延长容器启动时间。

• 变量名：XFERLOG_STD_FORMAT
  默认值：NO
  接受值：YES或NO
  描述：设置为YES可将传输日志以标准xferlog格式写入。

• 变量名：LOG_STDOUT
  默认值：空字符串
  接受值：任意字符串（启用），空或未定义（禁用）
  描述：将vsftpd日志输出到STDOUT，可通过容器日志查看。

• 变量名：FILE_OPEN_MODE
  默认值：0666
  接受值：文件系统权限
  描述：上传文件的创建权限，会应用umask。若需上传文件可执行，可改为0777。

• 变量名：LOCAL_UMASK
  默认值：077
  接受值：文件系统权限
  描述：本地用户创建文件的umask值。注意：若指定八进制值需加"0"前缀，否则视为十进制整数。

• 变量名：SSL_ENABLE
  默认值：NO
  接受值：YES或NO
  描述：设置为YES启用SSL加密，成为FTPS服务器。

• 变量名：TLS_CERT
  默认值：cert.pem
  接受值：任意带扩展名的文件名
  描述：证书文件名，需位于容器的/etc/vsftpd/cert/目录。

• 变量名：TLS_KEY
  默认值：key.pem
  接受值：任意带扩展名的文件名
  描述：密钥文件名，需位于容器的/etc/vsftpd/cert/目录。

• 变量名：REQUIRE_CERT
  默认值：NO
  接受值：YES或NO
  描述：设置为YES要求客户端提供并验证认证证书。

• 变量名：CA_CERTS_FILE
  默认值：cacerts.pem
  接受值：任意带扩展名的文件名
  描述：信任存储文件名，需位于容器的/etc/vsftpd/cert/目录。

暴露端口与卷

镜像暴露端口20和21，并导出三个卷：

• /home/vsftpd：用户主目录
• /var/log/vsftpd：日志存储目录
• /etc/vsftpd/cert：SSL证书目录

当主机与容器共享/home/vsftpd目录时，所有者用户ID和组ID应分别为14和80（对应容器内的ftp用户和组）。

使用场景

1. 创建临时测试容器：

bash
docker run --rm akue/vsftpd

2. 创建主动模式容器，使用默认账户并绑定数据目录：

bash
docker run -d -p 21:21 -v /my/data/directory:/home/vsftpd --name vsftpd akue/vsftpd
# 查看日志获取凭据：
docker logs vsftpd

3. 创建生产环境容器，自定义账户、启用SSL、绑定数据目录并支持主动/被动模式：

bash
docker run -d -v /my/data/directory:/home/vsftpd \
-p 20:20 -p 21:21 -p 21100-21110:21100-21110 \
-e FTP_USER=myuser -e FTP_PASS=mypass \
-e SSL_ENABLE=YES -e TLS_CERT=ftps_localhost.crt -e TLS_KEY=ftps_localhost.key \
-e PASV_ADDRESS=127.0.0.1 -e PASV_MIN_PORT=21100 -e PASV_MAX_PORT=21110 \
--name vsftpd --restart=always akue/vsftpd

4. 向现有容器手动添加新FTP用户：

bash
docker exec -i -t vsftpd bash
mkdir /home/vsftpd/myuser
echo -e "myuser\nmypass" >> /etc/vsftpd/virtual_users.txt
/usr/bin/db_load -T -t hash -f /etc/vsftpd/virtual_users.txt /etc/vsftpd/virtual_users.db
exit
docker restart vsftpd