ledermann/vsftpd

docker-vsftpd

镜像概述

docker-vsftpd是一个简单的vsftpd（Very Secure FTP Daemon）容器镜像，作为helderco/docker-vsftpd的克隆版本，主要目的是提供更新的镜像版本。该镜像专注于简化FTP服务部署，支持通过配置实现用户和密码的自定义，适用于需要快速搭建轻量级FTP服务的场景。

核心功能和特性

• 可配置用户认证：支持通过环境变量灵活设置FTP用户名和密码
• 轻量级设计：基于vsftpd构建，镜像体积小，运行时资源占用低
• 版本更新：作为克隆版本，提供比原镜像更及时的更新支持
• 部署简便：无需复杂配置，通过少量参数即可快速启动FTP服务

使用场景和适用范围

• 开发环境中的临时文件传输需求
• 小型团队或个人的文件共享服务
• 需要快速搭建FTP服务的测试环境
• 对资源占用要求严格的轻量级FTP应用场景

使用方法和配置说明

基本运行命令

通过以下命令可快速启动vsftpd容器：

bash
docker run -d -p 21:21 -e FTP_USER=myuser -e FTP_PASS=mypassword --name my-vsftpd docker.xuanyuan.run/helderco/docker-vsftpd

环境变量配置

端口映射说明

vsftpd默认使用21端口作为控制端口，PASV模式下需要映射额外的端口范围（默认21100-21110）以支持数据传输：

bash
docker run -d \
  -p 21:21 \
  -p 21100-21110:21100-21110 \
  -e FTP_USER=myuser \
  -e FTP_PASS=mypassword \
  --name my-vsftpd \
  docker.xuanyuan.run/helderco/docker-vsftpd

数据持久化配置

为避免容器重启导致数据丢失，可将本地目录挂载为FTP根目录：

bash
docker run -d \
  -p 21:21 \
  -p 21100-21110:21100-21110 \
  -v /path/to/local/directory:/home/vsftpd \
  -e FTP_USER=myuser \
  -e FTP_PASS=mypassword \
  --name my-vsftpd \
  docker.xuanyuan.run/helderco/docker-vsftpd

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  vsftpd:
    image: docker.xuanyuan.run/helderco/docker-vsftpd
    ports:
      - "21:21"
      - "21100-21110:21100-21110"
    environment:
      - FTP_USER=myuser
      - FTP_PASS=mypassword
      - PASV_ADDRESS=192.168.1.100  # 替换为实际服务器IP
    volumes:
      - ./ftp-data:/home/vsftpd
    restart: always

启动服务：

bash
docker-compose up -d