mrtenz/vsftpd

mrtenz/vsftpd

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

镜像概述和主要用途

该Docker容器实现了一个vsftpd服务器，基于Debian 12系统，集成vsftpd 3.0版本，支持虚拟用户、被动模式及日志管理，可用于快速搭建安全可控的FTP服务。

核心功能和特性

• 基于Debian 12基础镜像
• 集成vsftpd 3.0版本
• 支持虚拟用户认证
• 支持被动模式数据传输
• 日志可输出至文件或STDOUT
• 可配置SSL加密（FTPS）
• 灵活的文件权限控制（通过文件打开模式和umask）

环境变量配置

镜像通过环境变量在运行时配置参数，具体如下：

FTP_USER

• 默认值：admin
• 接受值：任意字符串，避免空格和特殊字符
• 描述：默认FTP账户的用户名，未指定时使用admin

FTP_PASS

• 默认值：随机字符串
• 接受值：任意字符串
• 描述：默认FTP账户的密码，未指定时自动生成16位随机字符串，可通过容器日志查看

PASV_ADDRESS

• 默认值：Docker主机IP/主机名
• 接受值：任意IPv4地址或主机名（需配合PASV_ADDR_RESOLVE使用）
• 描述：被动模式下使用的IP地址，未指定时使用Docker主机的路由IP

PASV_ADDR_RESOLVE

• 默认值：NO
• 接受值：NO|YES
• 描述：设为YES时允许PASV_ADDRESS使用主机名（而非IP地址）

PASV_ENABLE

• 默认值：YES
• 接受值：NO|YES
• 描述：设为NO时禁用被动模式数据连接

PASV_MIN_PORT

• 默认值：21100
• 接受值：任意有效端口号
• 描述：被动模式端口范围的下限，需通过docker -p参数映射端口

PASV_MAX_PORT

• 默认值：21110
• 接受值：任意有效端口号
• 描述：被动模式端口范围的上限，端口范围越大容器启动时间越长

XFERLOG_STD_FORMAT

• 默认值：NO
• 接受值：NO|YES
• 描述：设为YES时传输日志采用标准xferlog格式

LOG_STDOUT

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

FILE_OPEN_MODE

• 默认值：0666
• 接受值：文件系统权限
• 描述：上传文件的创建权限，会叠加umask值；若需上传文件可执行，可设为0777

LOCAL_UMASK

• 默认值：077
• 接受值：文件系统权限
• 描述：本地用户创建文件的umask值；指定八进制值时需加前缀0，否则视为十进制

PASV_PROMISCUOUS

• 默认值：NO
• 接受值：NO|YES
• 描述：设为YES时禁用被动模式安全检查（允许数据连接来自非控制连接IP），仅在安全隧道或FXP支持场景下使用

PORT_PROMISCUOUS

• 默认值：NO
• 接受值：NO|YES
• 描述：设为YES时禁用主动模式安全检查（允许外向数据连接至非客户端IP），仅在FXP支持场景下使用

SSL_ENABLE

• 默认值：NO
• 接受值：YES|NO
• 描述：设为YES时启用SSL加密，搭建FTPS服务器

TLS_CERT

• 默认值：cert.pem
• 接受值：带扩展名的文件名
• 描述：SSL证书文件名，需放置于容器内/etc/vsftpd/cert/目录

TLS_KEY

• 默认值：key.pem
• 接受值：带扩展名的文件名
• 描述：SSL密钥文件名，需放置于容器内/etc/vsftpd/cert/目录

暴露端口和卷

暴露端口

• 20：FTP数据端口
• 21：FTP控制端口

卷

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

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

使用场景和示例

1. 创建临时测试容器

bash
docker run --rm mrtenz/vsftpd

2. 创建主动模式容器（默认用户，绑定数据目录）

bash
docker run -d -p 21:21 -v /my/data/directory:/home/vsftpd --name vsftpd mrtenz/vsftpd
# 查看日志获取默认 credentials：
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 PASV_ADDRESS=127.0.0.1 -e PASV_MIN_PORT=21100 -e PASV_MAX_PORT=21110 \
-e SSL_ENABLE=YES -e TLS_CERT=ftps_localhost.crt -e TLS_KEY=ftps_localhost.key \
--name vsftpd --restart=always mrtenz/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