learningtopi/vsftpd

VSFTP Docker容器

源码：https://github.com/LearningToPi/vsftpd_docker
Docker Hub：https://hub.docker.com/r/learningtopi/vsftpd

概述

本容器镜像创建一个运行在容器中的vsftpd FTP服务器，支持IPv4和IPv6监听，可运行在主动或被动模式下。通过容器环境变量可控制服务参数，通过挂载"users.txt"文件可自动创建用户账户。

核心功能

• 支持FTP主动/被动模式切换
• 同时提供IPv4和IPv6监听能力
• 通过环境变量灵活配置服务参数
• 基于users.txt文件自动创建用户账户
• 支持数据持久化（卷或绑定挂载）
• 兼容Docker/Podman用户命名空间映射

使用场景

• 搭建个人或企业级FTP文件存储服务
• 需要IPv6支持的跨网络文件传输场景
• 容器化部署FTP服务的需求
• 需要灵活管理用户权限的文件共享场景

配置说明

容器环境变量

用户文件格式

用户文件为冒号(:)分隔的文本文件，每行包含3个字段：uid、用户名、密码。
示例：

1001:user1:pass1
1002:user2:pass2
1003:user3:pass3

部署示例

Docker Run命令

bash
docker run --name vsftpd -d \
  -v /data/ftp_users:/ftp \
  -v /data/users.txt:/users.txt:Z \
  -e ACTIVE_ENABLED=NO \
  -p 21:21/tcp \
  -p 10090-10100:10090-10100/tcp \
  -p [::]:21:21/tcp \
  -p [::]:10090-10100:10090-10100/tcp \
  learningtopi/vsftpd:latest

Docker Compose配置

yaml
version: '3'
services:
  vsftpd:
    image: learningtopi/vsftpd:latest
    container_name: vsftpd
    volumes:
      - ./ftp_data:/ftp
      - ./users.txt:/users.txt:Z
    environment:
      - ACTIVE_ENABLED=NO
      - PASV_MIN_PORT=10090
      - PASV_MAX_PORT=10100
    ports:
      - "21:21/tcp"
      - "10090-10100:10090-10100/tcp"
      - "[::]:21:21/tcp"
      - "[::]:10090-10100:10090-10100/tcp"
    restart: always

注意事项

• 启用IPv6时需确保Docker网络支持IPv6（默认bridge网络未启用）
• 使用SELinux系统时，绑定挂载需添加:Z标签
• 用户命名空间模式下需调整外部路径的所有权权限
• 被动模式需开放指定端口范围以支持数据传输
• 主动模式需确保防火墙允许服务器向客户端发起连接

故障排除

1. 被动端口未转发：
   错误提示：ftp: Can't connect to ...: Permission denied
   解决：添加对应端口转发规则（如***-***）

2. IPv6连接失败：
   错误提示：Can't connect to [IPv6地址]:21
   解决：创建支持IPv6的Docker网络并将容器加入该网络

3. 文件访问权限问题：
   错误提示：Permission denied
   解决：检查外部路径的所有权和SELinux标签设置