relaxart/docker-vsftpd

relaxart/docker-vsftpd镜像说明

镜像概述

本镜像基于Centos7稳定基础镜像构建，集成vsftpd 3.0版本FTP服务器，具备虚拟用户管理、被动模式传输、日志灵活输出等核心特性，满足各类文件传输需求。

核心功能

• 基于Centos7基础镜像，稳定性高
• 支持虚拟用户认证，提升安全性
• 被动模式传输，适配不同网络环境
• 日志可输出到文件或STDOUT，便于监控
• 灵活的端口与卷配置，方便数据持久化

环境变量配置

运行容器时可通过以下环境变量自定义配置：

• FTP_USER：默认值admin，FTP账号名（避免空格和特殊字符）
• FTP_PASS：默认生成随机16位字符串（可通过容器日志查看），支持自定义密码
• PASV_ADDRESS：默认Docker主机IP，被动模式使用的公网/内网IP
• PASV_MIN_PORT：默认21100，被动模式端口范围下限
• PASV_MAX_PORT：默认21110，被动模式端口范围上限
• LOG_STDOUT：非空字符串启用日志输出到STDOUT，便于通过docker logs查看

暴露端口与卷

• 暴露端口：20（主动模式数据端口）、21（控制端口）
• 卷：/home/vsftpd（用户文件存储目录）、/var/log/vsftpd（日志目录）

  绑定/home/vsftpd到主机时，需确保主机目录所有者UID=14、GID=80（对应容器内ftp用户/组）

使用场景与部署示例

1. 临时测试容器

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. 手动添加新用户到现有容器

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