mbjurstrom/docker-vsftpd

fauria/vsftpd

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

镜像概述

本镜像基于CentOS 7构建，集成vsftpd 3.0 FTP服务器，支持虚拟用户管理、被动模式配置及日志输出到文件或STDOUT，旨在帮助用户快速搭建安全、可配置的FTP服务。

核心功能

• 基于CentOS 7稳定基础镜像
• 集成vsftpd 3.0版本
• 支持虚拟用户认证
• 被动模式灵活配置
• 日志可输出到文件或容器STDOUT
• 自定义文件权限与umask设置

使用场景

1. 临时测试容器

快速启动一个临时FTP容器用于测试：

bash
docker run --rm fauria/vsftpd

2. 主动模式容器（绑定数据目录）

创建默认用户的主动模式容器，并绑定本地数据目录：

bash
docker run -d -p 21:21 -v /本地数据目录:/home/vsftpd --name vsftpd fauria/vsftpd
# 查看日志获取默认凭据：
docker logs vsftpd

3. 生产环境容器（自定义用户+被动模式）

创建带自定义用户、绑定数据目录并启用被动模式的生产级容器：

bash
docker run -d -v /本地数据目录:/home/vsftpd \
-p 20:20 -p 21:21 -p 21100-21110:21100-21110 \
-e FTP_USER=自定义用户名 -e FTP_PASS=自定义密码 \
-e PASV_ADDRESS=服务器IP -e PASV_MIN_PORT=21100 -e PASV_MAX_PORT=21110 \
--name vsftpd --restart=always fauria/vsftpd

4. 现有容器添加新用户

手动向运行中的容器添加新FTP用户：

bash
docker exec -i -t vsftpd bash
mkdir /home/vsftpd/新用户名
echo -e "新用户名\n新密码" >> /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

配置说明

环境变量

暴露端口与卷

• 暴露端口：20（数据端口）、21（控制端口）
• 卷：
  • /home/vsftpd：用户主目录（绑定本地目录时需确保宿主目录属主为14:80，对应容器内ftp用户/组）
  • /var/log/vsftpd：日志存储目录