solomonxie/ftp

solomonxie/ftp（基于fauria/vsftpd）

镜像概述

本镜像基于CentOS 7系统构建，集成vsftpd 3.0 FTP服务器，提供稳定、安全的文件传输服务，支持虚拟用户管理、被动模式及灵活的日志配置。

核心功能

• 基于CentOS 7基础镜像，兼容性强
• 集成vsftpd 3.0版本，功能完善
• 支持虚拟用户认证，提升安全性
• 被动模式传输，适配不同网络环境
• 日志可输出至文件或STDOUT，便于监控

配置说明

环境变量

暴露端口与卷

• 暴露端口：20（数据传输）、21（控制连接）
• 卷：/home/vsftpd（用户主目录）、/var/log/vsftpd（日志存储）
• 注意：绑定主机目录到/home/vsftpd时，需确保主机目录所有者UID为14、GID为80（对应容器内ftp用户/组）

使用场景

1. 测试临时容器

bash
docker run --rm docker.xuanyuan.run/solomonxie/ftp

2. 活跃模式容器（绑定数据目录）

bash
docker run -d -p 21:21 -v /本地数据目录:/home/vsftpd --name vsftpd docker.xuanyuan.run/solomonxie/ftp
# 查看日志获取默认账号密码
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 docker.xuanyuan.run/solomonxie/ftp

4. 手动添加新用户到现有容器

bash
docker exec -it 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