vsftpd Docker镜像

镜像概述和主要用途

本镜像为vsftpd（一款轻量级FTP服务器）的Docker封装，支持多种架构（amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x），可快速部署功能完善的FTP服务。主要用于搭建***或认证模式的文件传输服务，适用于个人文件共享、企业内部文件交换等场景，支持数据持久化存储和灵活的权限配置。

核心功能和特性

• 多架构支持：覆盖主流硬件架构，可在x86服务器、ARM开发板等多种设备上运行
• 灵活认证模式：支持***访问、本地用户认证和虚拟用户认证三种模式
• 环境变量配置：通过环境变量轻松配置FTP模式、用户信息、被动模式参数等
• 数据持久化：支持本地目录挂载至容器，确保文件数据持久化存储
• 被动模式支持：可配置被动模式地址和端口范围，适应不同网络环境

使用场景和适用范围

• 个人文件共享：通过***模式快速搭建临时文件下载服务
• 企业内部文件传输：通过用户认证模式实现部门间安全文件交换
• 多平台部署需求：在嵌入式设备（ARM架构）或服务器（x86架构）上统一部署FTP服务
• 开发测试环境：快速搭建临时FTP服务器用于应用测试

详细使用方法和配置说明

前提条件

• 已安装Docker引擎（版本需支持多架构镜像）
• 开放主机防火墙相应端口（21、20及被动模式端口范围）

部署示例

***模式

bash
docker run --restart=always -d \
  -e FTP_MODE=anonymous \
  -e FTP_ROOT_PASSWORD=*** \
  -e PASV_ADDRESS=192.168.1.1(server ip) \
  -p 21:21 -p 20:20 -p 20000-20010:20000-20010 \
  -v ./Downloads:/var/lib/ftp/Downloads \
  --name vsftpd snowdreamtech/vsftpd:latest

本地用户模式

bash
docker run --restart=always -d \
  -e FTP_MODE=user \
  -e FTP_USER=abcdef \
  -e FTP_PASS="&abcdef0&" \
  -e FTP_ROOT_PASSWORD=*** \
  -e PASV_ADDRESS=192.168.1.1(server ip) \
  -p 21:21 -p 20:20 -p 20000-20010:20000-20010 \
  -v ./Downloads:/root/Downloads \
  -v ./Downloads:/home/abcdef/Downloads \
  --name vsftpd snowdreamtech/vsftpd:latest

虚拟用户模式

bash
docker run --restart=always -d \
  -e FTP_MODE=virtual \
  -e FTP_USER=abcdef \
  -e FTP_PASS="&abcdef0&" \
  -e FTP_ROOT_PASSWORD=*** \
  -e PASV_ADDRESS=192.168.1.1(server ip) \
  -p 21:21 -p 20:20 -p 20000-20010:20000-20010 \
  -v ./Downloads:/home/virtual/abcdef/Downloads \
  --name vsftpd snowdreamtech/vsftpd:latest

环境变量说明

数据卷挂载说明

• ***模式：本地目录挂载至/var/lib/ftp/下，如./Downloads:/var/lib/ftp/Downloads
• 本地用户模式：需同时挂载至/root/（root用户目录）和/home/<用户名>/（用户家目录）
• 虚拟用户模式：本地目录挂载至/home/virtual/<用户名>/下

开发构建（多平台镜像）

bash
# 创建buildx构建实例
docker buildx create --use --name build --node build --driver-opt network=host

# 构建并推送多平台镜像
docker buildx build -t snowdreamtech/vsftpd \
  --platform=linux/386,linux/amd64,linux/arm/v6,linux/arm/v7,linux/arm64,linux/ppc64le,linux/riscv64,linux/s390x \
  . --push

参考资料

1. 使用 buildx 构建多平台 Docker 镜像
2. 如何使用 docker buildx 构建跨平台 Go 镜像
3. Building Multi-Arch Images for Arm and x86 with Docker Desktop
4. How to Rapidly Build Multi-Architecture Images with Buildx
5. Faster Multi-Platform Builds: Dockerfile Cross-Compilation Guide
6. docker/buildx

联系方式

• ---

• ---

• ---

• WeChat/***: sn0wdr1am

许可证

MIT