wildscamp/vsftpd

本地开发环境FTP服务器

免责声明：此容器专为本地开发环境设计，因此安全性可能不高。

该Docker容器实现了一个vsftpd服务器，具有以下特性：

• 基于Debian:jesse基础镜像
• 支持虚拟用户，可指定主目录和系统用户ID
• 支持被动模式

该容器的已编译版本可在https://hub.docker.com/r/wildscamp/vsftpd/中找到。

环境变量

此镜像使用环境变量在运行时配置一些参数：

VSFTPD_USER_[0-9]+

• 接受值：格式为<用户名>:<密码>:<系统用户ID>:<FTP根目录>的字符串。其中<系统用户ID>和<FTP根目录>为可选参数，但分隔用的冒号必须存在。
• 描述：复合变量，允许添加任意数量的用户。

示例

• VSFTPD_USER_1=hello:world:: - 创建用户hello，密码world。系统用户UID与内置ftp账户相同（UID: 104），FTP用户根目录默认为/home/virtual/hello。
• VSFTPD_USER_1=user1:docker:33: - 创建用户user1，密码docker。系统用户UID为33，FTP用户根目录默认为/home/virtual/user1。如果已存在该UID的系统用户，vsftpd会将该用户与现有系统用户关联。
• VSFTPD_USER_1=mysql:mysql:999:/srv/ftp/mysql - 创建用户mysql，密码mysql。系统用户UID为999，FTP用户根目录设置为/srv/ftp/mysql。

注意事项

• vsftpd对名为ftp的用户有特殊处理，建议定义FTP用户时不要使用此名称。

PASV_ADDRESS

• 接受值：用于FTP连接到容器的DNS名称或IP地址。
• 描述：告知vsftpd向FTP客户端通告用于被动连接的地址。建议设置为IP地址，因为容器的DNS解析设置可能与Docker主机不同。
• 注意：如果未指定，FTP通信很可能无法正常工作，因为vsftpd会自动使用接收连接的接口IP，而该IP通常是容器内部IP。

常见值

PASV_MIN_PORT

• 默认值：30000
• 接受值：小于PASV_MAX_PORT的整数。
• 描述：被动连接使用的最小端口。

PASV_MAX_PORT

• 默认值：30009
• 接受值：大于PASV_MIN_PORT的整数。
• 描述：被动连接使用的最大端口。

端口

vsftpd配置为监听21端口。容器需要开放该端口以及被动端口范围（默认30000-30009）。

卷

默认情况下，用户的FTP主目录为/home/virtual/${username}。用户需要访问的任何卷都应挂载在用户主目录的子目录下。

注意事项

1. 卷不能直接挂载到用户主目录，而应挂载到主目录的子目录。原因是用户在其主目录根目录没有写权限。
2. 挂载的任何文件夹必须与FTP用户所使用的系统用户具有相同的权限。例如，如果定义VSFTPD_USER_1=user1:pass:33:，则挂载的文件夹必须由ID为33的用户拥有，FTP用户才能访问。

命名卷

直接从主机挂载的文件夹比命名卷慢得多。这是使用命名卷而非主机共享文件夹的主要原因之一。

命名卷与此容器配合良好。Docker支持将同一命名卷同时挂载到多个容器。因此，应用程序数据存储在命名卷中，同一卷可附加到此容器以提供对该数据的FTP访问。这是创建此容器的主要原因之一。

示例

bash
  # 创建卷
  docker volume create --name html-data
  
  # 启动连接到'html-data'卷的FTP守护进程
  docker run --rm -d --name vsftpd \
       -v html-data:/home/virtual/user1/html \
       -e "PASV_ADDRESS=10.0.75.1" \
       -e "VSFTPD_USER_1=hello:world::" \
       -p "21:21" -p "30000-30009:30000-30009" \
       -t docker.xuanyuan.run/wildscamp/vsftpd
  
  # 启动使用'html-data'卷的应用程序
  docker run --rm -i --name webapp \
       -v html-data:/var/www/html \
       -t docker.xuanyuan.run/debian:jesse /bin/bash

注意两个容器挂载了相同的命名卷，但挂载位置不同。如果一个容器修改了命名卷中的内容，另一个容器会反映此更改。

使用场景

1. 启动FTP服务器，创建用户hello（密码world），并在hello的FTP根目录下挂载命名卷：

bash
  docker run --rm --name vsftpd -i \
    -v docker-html:/home/virtual/hello/html \
    -e "PASV_ADDRESS=10.0.75.1" \
    -e "VSFTPD_USER_1=hello:world::" \
    -p "21:21" -p "30000-30009:30000-30009" \
    -t docker.xuanyuan.run/wildscamp/vsftpd

2. 创建多个用户，分别访问不同卷：

bash
  docker run --rm --name vsftpd -i \
    -v docker-html:/home/virtual/hello/html \
    -v docker-mysql:/home/virtual/mysql/mysql \
    -e "PASV_ADDRESS=10.0.75.1" \
    -e "VSFTPD_USER_1=hello:world:33:" \
    -e "VSFTPD_USER_2=mysql:mysql:999:" \
    -p "21:21" -p "30000-30009:30000-30009" \
    -t docker.xuanyuan.run/wildscamp/vsftpd

用户环境变量与Docker Compose

关于VSFTPD_USER_[0-9]+环境变量和Docker Compose有一个特殊注意事项：如果在用户配置变量中未指定根目录，变量将以:结尾，这在YAML文件中有特殊含义。此时，需要使用https://docs.docker.com/compose/compose-file/#/environment定义环境变量，如下所示：

yaml
  services:
    vsftpd:
      container_name: vsftpd
      image: wildscamp/vsftpd
      hostname: vsftpd
      ports:
        - "21:21"
        - "30000-30009:30000-30009"
      volumes:
        - docker-html:/home/virtual/www-data/html
        - docker-certificates:/home/virtual/certs/certs
        - docker-mysql:/home/virtual/mysql/mysql
      environment:
        PASV_ADDRESS: 10.0.75.1
        PASV_MIN_PORT: 30000
        PASV_MAX_PORT: 30009
        VSFTPD_USER_1: 'www-data:ftp:33:'
        VSFTPD_USER_2: 'mysql:mysql:999:'
        VSFTPD_USER_3: 'certs:certs:50:'