lhauspie/vsftpd-alpine

vsftpd-alpine Docker镜像文档

镜像概述和主要用途

该Docker镜像融合了三个现有vsftpd镜像的功能，提供一个集成化的vsftpd服务器解决方案。基于Alpine 3.9.4基础镜像构建，包含vsftpd 3.0.3，支持多种FTP连接模式和灵活的被动模式配置，适用于需要轻量级、安全且功能丰富的FTP服务场景。

核心功能和特性

• 基础环境：Alpine 3.9.4基础镜像，vsftpd 3.0.3版本
• 连接模式：
  • 被动模式（可通过环境变量禁用）
  • FTPS显式（基于ftp/ftpes协议，端口21）
  • FTPS隐式（基于ftps协议，端口990）
  • FTPS TLS（使用强协议/加密套件）
• 网络配置：支持基于网络接口动态配置pasv_address
• 即将推出功能：SFTP（基于SSH的FTP，端口22）、虚拟用户、日志输出到STDOUT或文件、本地文件夹挂载到容器卷

使用场景和适用范围

• 开发环境中的临时文件传输服务
• 小型团队的文件共享服务器
• 需要支持多种FTP安全模式的应用场景
• 对镜像体积有要求的轻量级部署环境

构建方法

通过源码构建镜像非常简单，使用项目中的Makefile执行以下命令：

bash
$ make build

使用方法

摘要

运行容器

bash
$ docker run --rm -it --name vsftpd -p 20-22:20-22 -p 21100-21110:21100-21110 -p 990:990 lhauspie/vsftpd-alpine

从主机连接FTP服务器

bash
$ ftp -p localhost 21

从其他容器连接FTP服务器

bash
$ docker run -it --rm --link vsftpd centos:7 bash
$ yum install ftp
$ ftp -p vsftpd 21

环境变量

所有环境变量需通过Docker的-e参数指定，例如：

bash
docker run -e ENV_VAR=env_val lhauspie/vsftpd-alpine

更多信息请参考Docker环境变量文档。

FTP_USER

默认FTP账户的用户名。

• 默认值：user
• 接受值：任何字符串，避免空格和特殊字符

FTP_PASS

默认FTP账户的密码。

• 默认值：pass
• 接受值：任何字符串，避免空格和特殊字符

FTP_MODE

选择FTP配置模式。

• 默认值：ftp
• 接受值：ftp | ftps | ftps_implicit | ftps_tls

注意：使用ftps_implicit模式时必须暴露990端口，需通过docker -p参数进行端口映射。

PASV_ENABLE

启用/禁用FTP服务器的被动模式。

• 默认值：YES
• 接受值：NO | YES

PASV_ADDRESS

被动模式连接时FTP服务器发送给客户端的地址。若设置为主机名，需确保容器能解析该主机名。

• 默认值：<空字符串>
• 接受值：任何IPv4地址或主机名（见PASV_ADDR_RESOLVE）

PASV_ADDRESS_INTERFACE

通过网络接口的IP地址动态设置PASV_ADDRESS，适用于从主机或其他容器连接FTP服务器的场景。

• 默认值：eth0
• 接受值：任何有效的网络接口名

PASV_ADDRESS被设置时，PASV_ADDRESS_INTERFACE将失效。

示例：使用容器的eth0接口IP设置pasv_address

bash
$ docker run --rm -it --name vsftpd -e PASV_ADDRESS_INTERFACE=eth0 -p 21:21 -p 21100-21110:21100-21110 lhauspie/vsftpd-alpine

示例：直接设置pasv_address为"foobar"

bash
$ docker run --rm -it --name vsftpd -e PASV_ADDRESS=foobar -e PASV_ADDRESS_INTERFACE=eth0 -p 21:21 -p 21100-21110:21100-21110 lhauspie/vsftpd-alpine

PASV_ADDR_RESOLVE

当PASV_ADDRESS设置为主机名时，设为YES以解析主机名。

• 默认值：NO
• 接受值：NO | YES

使用时需通过--hostname参数设置容器主机名，与PASV_ADDRESS值一致：

bash
$ docker run --rm -it --hostname vsftpd --name vsftpd -e PASV_ADDRESS=vsftpd -e PASV_ADDR_RESOLVE=YES -p 21:21 -p 21100-21110:21100-21110 lhauspie/vsftpd-alpine

PASV_MIN_PORT

被动模式端口范围的下限。需通过docker -p参数暴露端口。

• 默认值：21100
• 接受值：任何有效的端口号

PASV_MAX_PORT

被动模式端口范围的上限。需通过docker -p参数暴露端口。

• 默认值：21110
• 接受值：任何有效的端口号