vsftpd配置文件详解 （扩展版）

 

经过一个月的资料查阅和大量的实验排查，加上周末两天的集中整理，根据自己的工作经验终于写出了这个比较完整的vsftpd参数扩展版。这一版本除了默认vsftp配置文件中有的还有一些vsftp配置文件中没有的语句参数。大家可以注意一下，文章中文字背景为深绿色的为默认配置文件中的语句，其他的为有效的扩展vsftp配置语句，希望大家可以在配置vsftp服务器的过程中加以灵活应用这些配置语句，以实现vsftp服务器更高的性能和效果。由于平时工作比较忙加上时间比较仓促和理解上的差别，在整理总结的过程中难免会出现bug，请大家发现后及时在留言中加以纠正！

一、vsftpd黑名单

vsftp服务文件 /etc/vsftpd.ftpusers中 记录的 用户 将 禁止登陆 vsftp服务器 。 此配置文件的详细情况请见： 《 RHEL4- FTP服务（六）vsftp服务对ftp用户的登录访问控制  》    
        

二、 配置文件格式 及意义说明 ： 

vsftpd. c onf 为vsftpd服务的主要配置文件，也可以成为核心配置文件。其 内容 和格式非常简单明了 ，每一行 语句 即为一项设定 ，即可控制服务的一项功能 。若是空白行或 着 是开头为 ‘ # ’号 的一行，将会被忽略 ，即不起任何作用 。内容的格式只有一种，

即‘语句选项=参数值’比如： option=value 。其中option为语句选项，value为参数值。 要注意的是等号两边不能加 空格 。

三、 匿名用户（anonymous） 设置相关语句：

匿名用户使用的登陆名为ftp或anonymous，口令为空；匿名用户不能离开匿名用户家目录/var/ftp,且只能下载不能上传 ，匿名用户的配置方法详见 《 RHEL4- FTP服务（三）配置匿名用户访问VSFTPD服务器  》 。

anonymous_enable=YES/NO

控制是否允许匿名用户登入，YES 为允许匿名登入，NO 为不允许。默认值为YES。

write_enable=YES/NO

是否允许登陆用户有写权限。属于全局设置，默认值为YES。

no_anon_password=YES/NO

若是启动这项功能，则使用匿名登入时，不会询问密码。默认值为NO。

ftp_username=ftp

定义匿名登入的使用者名称。默认值为ftp。

anon_root=/var/ftp

使用匿名登入时，所登入的目录。默认值为/var/ftp。注意ftp目录不能是777的权限属性，即匿名用户的家目录不能有777的权限。

anon_upload_enable=YES/NO

如果设为YES，则允许匿名登入者有上传文件（非目录）的权限，只有在write_enable=YES时，此项才有效。当然，匿名用户必须要有对上层目录的写入权。默认值为NO。

anon_world_readable_only=YES/NO

如果设为YES，则允许匿名登入者下载可阅读的档案（可以下载到本机阅读，不能直接在FTP服务器中打开阅读）。默认值为YES。

anon_mkdir_write_enable=YES/NO

如果设为YES，则允许匿名登入者有新增目录的权限，只有在write_enable=YES时，此项才有效。当然，匿名用户必须要有对上层目录的写入权。默认值为NO。

anon_other_write_enable=YES/NO

如果设为YES，则允许匿名登入者更多于上传或者建立目录之外的权限，譬如删除或者重命名。（如果 anon_upload_enable=NO，则匿名用户不能上传文件，但可以删除或者重命名已经存在的文件；如果 anon_mkdir_write_enable=NO，则匿名用户不能上传或者新建文件夹，但可以删除或者重命名已经存在的文件夹。）默认值为NO。

chown_uploads=YES/NO

设置是否改变匿名用户上传文件（非目录）的属主。默认值为NO。

chown_username=username

设置匿名用户上传文件（非目录）的属主名。建议不要设置为root。

anon_umask=077

设置匿名登入者新增或上传档案时的umask 值。默认值为077，则新建档案的对应权限为700。

deny_email_enable=YES/NO

若是启动这项功能，则必须提供一个档案/etc/vsftpd/banner_emails，内容为email address。若是使用匿名登入，则会要求输入email address，若输入的email address 在此档案内，则不允许进入。默认值为NO。

banned_email_file=/etc/vsftpd/banner_emails

此文件用来输入email address，只有在deny_email_enable=YES时，才会使用到此档案。若是使用匿名登入，则会要求输入email address，若输入的email address 在此档案内，则不允许进入。

四、 本地用户 设置相关语句：

本地用户的登录名为本地 系统用户 ，口令为此本地 系统 用户的口令；本地 系统 用户可以在自己家目录中进行读写操作；本地用户可以离开自家目录切换至有权限访问的其他目录，并在权限允许的情况下进行上传/下载 ，本地用户的详细配置方法请见： 《 RHEL4- FTP服务（四）配置本地用户访问VSFTP服务器 》 。

local_enable=YES/NO

控制是否允许本地用户登入，YES 为允许本地用户登入，NO为不允许。默认值为YES。

local_root=/home/username

当本地用户登入时，将被更换到定义的目录下。默认值为各用户的家目录。

write_enable=YES/NO

是否允许登陆用户有写权限。属于全局设置，默认值为YES。

local_umask=022

本地用户新增档案时的umask 值。默认值为077。

file_open_mode=0755

本地用户上传档案后的档案权限，与chmod 所使用的数值相同。默认值为0666。

五、 虚拟用户 设置相关语句：

虚拟用户使用PAM认证方式。

pam_service_name=vsftpd

设置PAM使用的名称，默认值为/etc/pam.d/vsftpd。

check_shell=YES 

（注意： 仅在没有pam验证版本时有用,是否检查用户有一个有效的shell来登录  )

guest_enable= YES/NO

启用虚拟用户。默认值为NO。

guest_username=ftp

这里用来映射虚拟用户。默认值为ftp。

virtual_use_local_privs=YES/NO

当该参数激活（YES）时，虚拟用户使用与本地用户相同的权限。当此参数关闭（NO）时，虚拟用户使用与匿名用户相同的权限。默认情况下此参数是关闭的（NO）。

六、欢迎语设置相关语句：

dirmessage_enable=YES/NO

如果启动这个选项，那么使用者第一次进入一个目录时，会检查该目录下是否有.message这个档案，如果有，则会出现此档案的内容，通常这个档案会放置欢迎话语，或是对该目录的说明。默认值为开启。

message_file=.message

设置目录消息文件，可将要显示的信息写入该文件。默认值为.message。 banner_file=/etc/vsftpd/banner

当使用者登入时，会显示此设定所在的档案内容，通常为欢迎话语或是说明。默认值为无。如果欢迎信息较多，则使用该配置项。

ftpd_banner=Welcome to BOB's FTP server

这里用来定义欢迎话语的字符串，banner_file是档案的形式，而ftpd_banner 则是字符串的形式。预设为无。

七、控制用户是否允许切换到其他目录设置相关语句：

在默认配置下，本地用户登入FTP后可以使用cd命令切换到其他目录，这样会对系统带来安全隐患。可以通过以下三条配置文件来控制用户切换目录。

chroot_list_enable=YES/NO

设置是否启用chroot_list_file配置项指定的用户列表文件。 如果启动这项功能，则所有列在chroot_list_file之中的使用者不能更改根目录 . 默认值为 yes 。

chroot_list_file=/etc/vsftpd.chroot_list

指出被锁定在自家目录中的用户的列表文件。文件格式为一行一用户。通常该文件是/etc/vsftpd/chroot_list。此选项默认不设置。 。

chroot_local_user=YES/NO

用于指定用户列表文件中的用户是否允许切换到上级目录。默认值为NO。

通过 与 chroot_list_enable=YES/NO 搭配能实现以下几种效果：

1、 当chroot_list_enable=YES，chroot_local_user=YES时，在/etc/vsftpd.chroot_list文件中列出的用户，可以切换到其他目录；未在文件中列出的用户，不能切换到其他目录。

2、 当chroot_list_enable=YES，chroot_local_user=NO时，在/etc/vsftpd.chroot_list文件中列出的用户，不能切换到其他目录；未在文件中列出的用户，可以切换到其他目录。

3、 当chroot_list_enable=NO，chroot_local_user=YES时，所有的用户均不能切换到其他目录。

4、 当chroot_list_enable=NO，chroot_local_user=NO时，所有的用户均可以切换到其他目录。

八、 数据传输模式 设置相关语句：

FTP在传输数据时，可以使用二进制方式，也可以使用ASCII模式来上传或下载数据。

ascii_upload_enable=YES/NO

设置是否启用ASCII 模式上传数据。默认值为NO。

ascii_download_enable=YES/NO

设置是否启用ASCII 模式下载数据。默认值为NO。

九、访问控制设置相关语句：

两种控制方式：一种控制主机访问，另一种控制用户访问。

1、 控制主机访问：

tcp_wrappers=YES/NO

设置vsftpd是否与tcp wrapper相结合来进行主机的访问控制。默认值为YES。如果启用，则vsftpd服务器会检查/etc/hosts.allow 和/etc/hosts.deny 中的设置，来决定请求连接的主机，是否允许访问该FTP服务器。这两个文件可以起到简易的防火墙功能。

比如：若要仅允许192.168. 10 .1—192.168. 1 0.254的用户可以连接FTP服务器，则在/etc/hosts.allow文件中添加以下内容：

vsftpd:192.168. 1 0. :allow

all:all :deny

2、 控制用户访问：

对于用户的访问控制可以通过/etc目录下的vsftpd.user_list和ftpusers文件来实现。

userlist_file=/etc/vsftpd.user_list

控制用户访问FTP的文件，里面写着用户名称。一个用户名称一行。

userlist_enable=YES/NO

是否启用vsftpd.user_list文件。

userlist_deny=YES/NO

决定vsftpd.user_list文件中的用户是否能够访问FTP服务器。若设置为YES，则vsftpd.user_list文件中的用户不允许访问FTP，若设置为NO，则只有vsftpd.user_list文件中的用户才能访问FTP。 此参数的详细配置使用情况请见： 《 RHEL4- FTP服务（六）vsftp服务对ftp用户的登录访问控制  》

secure_chroot_dir=/usr/share/empty 

这 个选项必须指定一个空的数据夹且任何登入 用户 都不能有写入的权限，当vsftpd 不需要file system  （ 访问文件系统 ） 的权限时， 这个目录将被作为一个安全的容器，用户将被限制在此目录中。 默认值为/usr/share/empty  。

十、 访问速率 设置相关语句：

anon_max_rate=0

设置匿名登入者使用的最大传输速度，单位为B/s，0 表示不限制速度。默认值为0。

local_max_rate=0

本地用户使用的最大传输速度，单位为B/s，0 表示不限制速度。预设值为0。

十一、超时时间设置相关语句：

accept_timeout=60

设置建立FTP连接的超时时间，单位为秒。默认值为60。

connect_timeout=60

PORT 方式下建立数据连接的超时时间，单位为秒。默认值为60。

data_connection_timeout=120

设置建立FTP数据连接的超时时间，单位为秒。默认值为120。

idle_session_timeout= 600

设置多长时间不对FTP服务器进行任何操作，则断开该FTP连接，单位为秒。默认值为300 。

十二、 日志文件 设置相关语句：

xferlog_enable= YES/NO

是否启用上传/下载日志记录。如果启用，则上传与下载的信息将被完整纪录在xferlog_file 所定义的档案中。预设为开启。

xferlog_file=/var/log/vsftpd.log

设置日志文件名和路径，默认值为/var/log/vsftpd.log。

xferlog_std_format=YES/NO

如果启用，则日志文件将会写成xferlog的标准格式，如同wu-ftpd 一般。默认值为关闭。

log_ftp_protocol=YES \ NO


如果启用此选项，所有的FTP请求和响应都会被记录到日志中，默认日志文件在/var/log/vsftpd.log。启用此选项时，xferlog_std_format不能被激活。这个选项有助于调试。默认值为NO。

十三、自定义用户个性化 配置文件 设置相关语句：

在vsftpd中，可以通过定义用户配置文件来实现不同的用户使用不同的配置。

user_config_dir=/etc/vsftpd/userconf

设置用户配置文件所在的目录。当设置了该配置项后，用户登陆服务器后，系统就会到/etc/vsftpd/userconf目录下，读取与当前用户名相同的文件，并根据文件中的配置命令，对当前用户进行更进一步的配置。

例如：定义user_config_dir=/etc/vsftpd/userconf，且主机上有使用 者  ftp 1, ftp 2，那么我们就在user_config_dir 的目录新增文件名为 ftp 1和 ftp 2两个文件。若是 ftp 1 登入，则会读取user_config_dir 下的 ftp 1 这个档案内的设定。默认值为无。利用用户配置文件，可以实现对不同用户进行访问速度的控制 ，此文件的详细用法，参见： 《 RHEL4- FTP服务（四）配置本地用户访问VSFTP服务器  》；《 RHEL4-FTP服务（五）配置虚拟用户访问vsftp服务_（上） 》和《 RHEL4-FTP服务（五）配置虚拟用户访问vsftp服务器_(下)  》。

十四、 FTP的工作方式与端口设置 相关语句：

FTP有两种工作方式：PORT FTP（主动模式）和PASV FTP（被动模式）

listen_port=21

设置FTP服务器建立连接所监听的端口，默认值为21。

connect_from_port_20=YES/NO

指定FTP使用20端口进行数据传输，默认值为YES。

ftp_data_port=20

设置在PORT方式下，FTP数据连接使用的端口，默认值为20。

pasv_enable=YES/NO

若设置为YES，则使用PASV工作模式；若设置为NO，则使用PORT模式。默认值为YES，即使用PASV工作模式。

pasv_max_port=0

在PASV工作模式下，数据连接可以使用的端口范围的最大端口，0 表示任意端口。默认值为0。

pasv_min_port=0

在PASV工作模式下，数据连接可以使用的端口范围的最小端口，0 表示任意端口。默认值为0。

十五、 连接 控制设置相关语句：

listen=YES/NO

设置vsftpd服务器是否以standalone模式运行。以standalone模式运行是一种较好 的方式，此时listen必须设置为YES，此为默认值。建议不要更改，有很多与服务器运行相关的配置命令，需要在此模式下才有效。若设置为NO，则 vsftpd不是以独立的服务运行，要受到xinetd服务的管控，功能上会受到限制。

max_clients=0

设置vsftpd允许的最大连接数，默认值为0，表示不受限制。若设置为100时，则同时允许有100个连接，超出的将被拒绝。只有在standalone模式运行才有效。

max_per_ip=0

设置每个IP允许与FTP服务器同时建立连接的数目。默认值为0，表示不受限制。只有在standalone模式运行才有效。

listen_address=IP地址

设置FTP服务器在指定的IP地址上侦听用户的FTP请求。若不设置，则对服务器绑定的所有IP地址进行侦听。只有在standalone模式运行才有效。

setproctitle_enable=YES/NO

设置每个与FTP服务器的连接，是否以不同的进程表现出来。默认值为NO，此时使用

ps aux |grep ftp只会有一个vsftpd的进程。若设置为YES，则每个连接都会有一个vsftpd的进程。

one_process_model=yes  

是否使用单进程模式。

十六、其他设置相关语句：

text_userdb_names= YES/NO

设置在执行ls –la之类的命令时，是显示UID、GID还是显示出具体的用户名和组名。默认值为NO，即以UID和GID方式显示。若希望显示用户名和组名，则设置为YES。

ls_recurse_enable=YES/NO

若是启用此功能，则允许登入者使用ls –R（可以查看当前目录下子目录中的文件）这个指令。默认值为NO。

hide_ids=YES/NO

如果启用此功能，所有档案的拥有者与群组都为ftp，也就是使用者登入使用ls -al之类的指令，所看到的档案拥有者跟群组均为ftp。默认值为关闭。

download_enable=YES/NO

如果设置为NO，所有的文件都不能下载到本地，文件夹不受影响。默认值为YES。

#nopriv_user=ftpsecure 

为FTP服务器指定一个完全孤立和无特权的用户，即在系统服务中指定一个独特的用户。 即 指定一个用户，当VSFTPD不想要什么权限时，使用此用户身份。这用户最好是一个专用的用户，而不是用户nobody。在大多数的机器上，nobody用户被用于大量重要的事情。默认值为nobody。

#async_abor_enable=YES 

启用时，一个特殊的FTP命令\"async ABOR”将容许使用，一般不用，容易出现问题。只有不正常的FTP客户端要使用这一点。而且，这个功能又难于操作，所以，默认是把它关闭了。但是，有些客户端在取消一个传送的时候会被挂死（daidong注：估计是客户端无响应了），那你只有启用这个功能才能避免这种情况。 默认值：yes。


==============================================================================

**************************************************************************** ***===============================================================================

（注：以下为网络原文转载）
附: FTP 数字代码的意义 
110 重新启动标记应答。 
120 服务在多久时间内ready。 
125 数据链路埠开启，准备传送。 
150 文件状态正常，开启数据连接端口。 
200 命令执行成功。 
202 命令执行失败。 
211 系统状态或是系统求助响应。 
212 目录的状态。 
213 文件的状态。 
214 求助的讯息。 
215 名称系统类型。 
220 新的联机服务ready。 
221 服务的控制连接埠关闭，可以注销。 
225 数据连结开启，但无传输动作。 
226 关闭数据连接端口，请求的文件操作成功。 
227 进入passive mode。 
230 使用者登入。 
250 请求的文件操作完成。 
257 显示目前的路径名称。 
331 用户名称正确，需要密码。 
332 登入时需要账号信息。 
350 请求的操作需要进一部的命令。 
421 无法提供服务，关闭控制连结。 
425 无法开启数据链路。 
426 关闭联机，终止传输。 
450 请求的操作未执行。 
451 命令终止：有本地的错误。 
452 未执行命令：磁盘空间不足。 
500 格式错误，无法识别命令。 
501 参数语法错误。 
502 命令执行失败。 
503 命令顺序错误。 
504 命令所接的参数不正确。 
530 未登入。 
532 储存文件需要账户登入。 
550 未执行请求的操作。 
551 请求的命令终止，类型未知。 
552 请求的文件终止，储存位溢出。 
553 未执行请求的的命令，名称不正确。

 

 

 
vsftpd配置文件详解（扩展版）.pdf下载

 

 

 

—————————————————————————————————

特别声明：--

一、本文为原创，著作权及使用权为（作者笔名：闪电cto）本人所有。 ­

二、本文首发于51cto个人博客（http://xudeqiang.blog.51cto.com）。  ­

三、本文只供互联网上的读者分享，不供共享范畴，希知。 ­

四、未经许可严禁对本文作修改、节选、断章性质的处理。 ­

五、可转载，但必须注明原文章首发的出处网址，及文章作者，严禁复制。 ­

六、如若转摘用于杂志网络媒体新闻，必须通知作者得到允许后方可，需收稿费。­

七、作者联系信息：QQ：306718122   邮箱levinboy@foxmail.com

——————————————————————————————