dotkevinwong/vsftpd-arm

dotkevinwong/vsftpd-arm

从 https://github.com/fauria/docker-vsftpd 分叉

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

镜像概述和主要用途

该Docker容器实现了vsftpd服务器，专为ARM架构系统优化，适用于树莓派、Apple Silicon Mac等aarch平台，提供稳定的FTP服务。

核心功能和特性

• 基于arm64 CentOS 7基础镜像
• 集成vsftpd 3.0版本
• 支持虚拟用户认证
• 支持被动模式传输
• 日志可输出到文件或STDOUT
• 针对aarch系统优化性能

安装

可通过Docker Hub下载镜像：

bash
docker pull dotkevinwong/vsftpd-arm

环境变量

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

• 变量名: 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"前缀，否则将视为十进制整数。

• 变量名: REVERSE_LOOKUP_ENABLE
• 默认值: YES
• 接受值: <NO|YES>
• 描述: 设为NO可避免因DNS服务器不响应反向查找导致的性能问题。

• 变量名: PASV_PROMISCUOUS
• 默认值: NO
• 接受值: <NO|YES>
• 描述: 设为YES将禁用被动模式安全检查（确保数据连接与控制连接IP一致）。仅在了解风险时启用，合法用途包括安全隧道或FXP支持。

• 变量名: PORT_PROMISCUOUS
• 默认值: NO
• 接受值: <NO|YES>
• 描述: 设为YES将禁用主动模式安全检查（确保出站数据连接仅连接到客户端）。仅在了解风险时启用，合法用途包括FXP支持。

暴露的端口和卷

• 暴露端口: 20（数据端口）、21（控制端口）
• 卷:
  • /home/vsftpd: 用户主目录，存储FTP数据
  • /var/log/vsftpd: 日志存储目录

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

使用场景和示例

1) 临时测试容器

bash
docker run --rm dotkevinwong/vsftpd-arm

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

bash
docker run -d -p 21:21 -v /本地数据目录:/home/vsftpd --name vsftpd dotkevinwong/vsftpd-arm
# 查看日志获取默认凭据：
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=myuser -e FTP_PASS=mypass \
-e PASV_ADDRESS=127.0.0.1 -e PASV_MIN_PORT=21100 -e PASV_MAX_PORT=21110 \
--name vsftpd --restart=always dotkevinwong/vsftpd-arm

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