FTP，全称 File Transfer Protocol，一种被广泛使用的文件传输协议。而 vsftpd (全称 Very Secure FTP Daemon) 则是一个轻量级的高效、安全的且免费开源的 FTP 服务器实现，配置灵活，适合于各种场景。

本文介绍使用 docker 方式安装 vsftpd，能够显著简化安装和配置流程，还能利用容器的隔离性提升系统的安全性与灵活性。

前面文章介绍了 docker 的基础知识和基本使用，不太了解的可以先看看，以便能无缝衔接，我已经做成了一个合集，方便大家查阅。

一、拉取镜像

先用 docker 搜 vsftpd，可以查看不同版本的信息，使用命令 docker search vsftpd：

这次选择使用第一个，这个是社区常用的镜像，使用命令 docker pull fauria/vsftpd 拉取：

二、启动容器

使用如下命令来启动容器：

docker run -d -p 20:20 -p 21:21 -p 21100-21110:21100-21110 -v /home/ftp:/home/vsftpd -e FTP_USER=ftpu1 -e FTP_PASS=1234567a -e PASV_ADDRESS=192.168.1.200 -e PASV_MIN_PORT=21100 -e PASV_MAX_PORT=21110 --name vsftpd --restart=always fauria/vsftpd

然后进入容器，执行命令 docker exec -it
ada6120eb98df341445333a4303f3eefe46a9bca13595361ad7594ee50276f6a /bin/bash

下面是全过程：

各参数详解：

• -d：在后台运行容器。
• -p 20:20：将容器中的端口 20 映射到主机的端口 20。
• -p 21:21：将容器中的端口 21 映射到主机的端口 21。
• -p 21100-21110:21100-21110：将容器中的端口 21100 到 21110 映射到主机的端口 21100 到 21110。
• -v /home/ftp:/home/vsftpd：将主机的 /home/ftp 目录挂载到容器的 /home/vsftpd 目录。
• -e FTP_USER=ftpu1：设置环境变量 FTP_USER 为 ftpu1。
• -e FTP_PASS=1234567a：设置环境变量 FTP_PASS 为 1234567a。
• -e PASV_ADDRESS=192.168.1.200：设置环境变量 PASV_ADDRESS 为 192.168.1.200。
• -e PASV_MIN_PORT=21100：设置环境变量 PASV_MIN_PORT 为 21100。
• -e PASV_MAX_PORT=21110：设置环境变量 PASV_MAX_PORT 为 21110。
• --name vsftpd：为容器指定名称 vsftpd。
• --restart=always：设置容器总是在意外终止后重启。
• fauria/vsftpd：指定要运行的镜像。

查看 vsftpd 的初始配置，在文件中 /etc/vsftpd/vsftpd.conf ：

配置如下：

# Run in the foreground to keep the container running:
background=NO

# Allow anonymous FTP? (Beware - allowed by default if you comment this out).
anonymous_enable=NO

# Uncomment this to allow local users to log in.
local_enable=YES

## Enable virtual users
guest_enable=YES

## Virtual users will use the same permissions as anonymous
virtual_use_local_privs=YES

# Uncomment this to enable any form of FTP write command.
write_enable=YES

## PAM file name
pam_service_name=vsftpd_virtual

## Home Directory for virtual users
user_sub_token=$USER
local_root=/home/vsftpd/$USER

# You may specify an explicit list of local users to chroot() to their home
# directory. If chroot_local_user is YES, then this list becomes a list of
# users to NOT chroot().
chroot_local_user=YES

# Workaround chroot check.
# See https://www.benscobie.com/fixing-500-oops-vsftpd-refusing-to-run-with-writable-root-inside-chroot/
# and http://serverfault.com/questions/362619/why-is-the-chroot-local-user-of-vsftpd-insecure
allow_writeable_chroot=YES

## Hide ids from user
hide_ids=YES

## Enable logging
xferlog_enable=YES
xferlog_file=/var/log/vsftpd/vsftpd.log

## Enable active mode
port_enable=YES
connect_from_port_20=YES
ftp_data_port=20

## Disable seccomp filter sanboxing
seccomp_sandbox=NO

### Variables set at container runtime
pasv_address=192.168.1.200
pasv_max_port=21110
pasv_min_port=21100
pasv_addr_resolve=NO
pasv_enable=YES
file_open_mode=0666
local_umask=077
xferlog_std_format=NO
reverse_lookup_enable=YES
pasv_promiscuous=NO
port_promiscuous=NO
[root@ada6120eb98d /]# 

端口范围是：21100~21110，太多，后改成：21100~21102。

常见的配置说明：

• anonymous_enable=NO 表示不启用匿名访问
• local_enable=YES 表示启用本地用户访问
• write_enable=YES 表示启用写入功能
• chroot_local_user=YES 表示启用本地用户的 chroot

三、其它设置：启用被动模式

docker cp vsftpd:/etc/vsftpd/vsftpd.conf /home/vsftpd/etc/vsftpd/vsftpd.conf

# 使用参数 -v 双向绑定
docker run -d -p 20:20 -p 21:21 -p 21100-21102:21100-21102 -v /home/ftp:/home/vsftpd -v /home/vsftpd/etc/vsftpd/vsftpd.conf:/etc/vsftpd/vsftpd.conf -e FTP_USER=ftpu1 -e FTP_PASS=1234567a -e PASV_ADDRESS=192.168.1.200 -e PASV_MIN_PORT=21100 -e PASV_MAX_PORT=21102 --name vsftpd --restart=always fauria/vsftpd

设置参数 pasv_promiscuous。

参数 "pasv_promiscuous" 是 vsftpd 服务器的一个配置选项，它用于控制 PASV 模式下的连接行为。

PASV 模式是 FTP 协议中用于数据传输的一种模式。在这种模式下，服务器会监听一个端口，客户端会连接到这个端口并进行数据传输。

当 "pasv_promiscuous" 参数设置为 YES 时，服务器会允许任何客户端连接到其监听的端口，而不仅仅是与其建立连接的客户端。这意味着，服务器会允许来自任意 IP 地址的客户端连接到其监听的端口。

如果 "pasv_promiscuous" 参数设置为 NO，则服务器仅会允许与其建立连接的客户端连接到其监听的端口。这意味着，服务器只会允许与其建立连接的客户端连接到其监听的端口。

通常情况下，建议将 "pasv_promiscuous" 参数设置为 NO，以保证服务器的安全性。

下面是包含设置 "pasv_promiscuous" 参数的示例：

# 设置其它参数 pasv_promiscuous=YES
docker run -d -p 20:20 -p 21:21 -p 21100-21102:21100-21102 -v /home/ftp:/home/vsftpd -v /home/vsftpd/etc/vsftpd/vsftpd.conf:/etc/vsftpd/vsftpd.conf -e FTP_USER=ftpu1 -e FTP_PASS=1234567a -e PASV_ADDRESS=192.168.1.200 -e PASV_MIN_PORT=21100 -e PASV_MAX_PORT=21102 -e pasv_promiscuous=YES --name vsftpd --restart=always fauria/vsftpd

手机端看的清楚：

四、测试外部连接

本地打开 ftp 客户端，如 FileZilla，连接服务器，也可以使用命令行工具，输入主机、用户名密码：

连接成功，上传文件也成功。

前面启动镜像配置的目录是，容器的FTP目录为 /home/vsftpd，宿主机的ftp目录为 /home/ftp，对应的目录都去查看。

容器内上传的目录：

宿主机上传的目录：

五、新增用户

先进入容器内容，然后可以查看现有用户：使用命令 cat
/etc/vsftpd/virtual_users.txt

有时候需要新增用户，先创建用户：

useradd -m newuser
passwd newuser

设置 FTP 用户目录权限：

mkdir -p /home/newuser/ftp
chown newuser:newuser /home/newuser/ftp
chmod 750 /home/newuser/ftp

然后重启服务即可生效。

六、内网穿透

为了在异地远程连接，可以进行内网穿透，可以关注我写的 frp 内网穿透相关文章。