vsftp配置文件详解

Author：孤鸿
发布时间：June 20, 2016
2794 views
No comments
12971 words
Categories： Linux 其他

#### **Vsftpd**配置文件介绍

| **/etc/vsftpd/vsftpd.conf** | 主配置文件 |
| :-: | :- |
| **/usr/sbin/vsftpd** | **Vsftpd**的主程序 |
| **/etc/rc.d/init.d/vsftpd** | 启动脚本 |
| **/etc/pam.d/vsftpd** | **PAM**认证文件（此文件中file=/etc/vsftpd/ftpusers字段，指明阻止访问的用户来自/etc/vsftpd/ftpusers文件中的用户） |
| **/etc/vsftpd/ftpusers** | 禁止使用**vsftpd**的用户列表文件。记录不允许访问FTP服务器的用户名单，管理员可以把一些对系统安全有威胁的用户账号记录在此文件中，以免用户从FTP登录后获得大于上传下载操作的权利，而对系统造成损坏。（注意：**linux-4**中此文件在**/etc/**目录下） |
| **/etc/vsftpd/user_list** | 禁止或允许使用**vsftpd**的用户列表文件。这个文件中指定的用户缺省情况（即在**/etc/vsftpd/vsftpd.conf**中设置**userlist_deny=YES**）下也不能访问FTP服务器，在设置了**userlist_deny=NO**时,仅允许**user_list**中指定的用户访问**FTP**服务器。（注意：**linux-4**中此文件在**/etc/**目录下） |
| **/var/ftp** | 匿名用户主目录；本地用户主目录为：**/home/****用户主目录**，即登录后进入自己家目录 |
| **/var/ftp/pub** | 匿名用户的下载目录，此目录需赋权根**chmod 1777 pub**（**1**为特殊权限，使上载后无法删除） |
| **/etc/logrotate.d/vsftpd.log** | **Vsftpd**的日志文件 |

#### vsftpd.user_list详解

-**vsftpd.user_list**文件需要与vsftpd.conf文件中的配置项结合来实现对于vsftpd.user_list文件中指定用户账号的访问控制：

##### 1. 设置禁止登录的用户账号

当vsftpd.conf配置文件中包括以下设置时，vsftpd.user_list文件中的用户账号被禁止进行FTP登录：
`userlist_enable=YESuserlist_deny=YES``userlist_enable`设置项设置使用vsftpd.user_list文件，`userlist_deny`设置为YES表示vsftpd.user_list文件用于设置禁止的用户账号。

##### 2. 设置只允许登录的用户账号**

当vsftpd.conf配置文件中包括以下设置时，只有vsftpd.user_list文件中的用户账号能够进行FTP登录：
`userlist_enable=YESuserlist_deny=NO``userlist_enable`设置项设置使用vsftpd.user_list文件，`userlist _deny`设置为NO表示vsftpd.usre_list文件用于设置只允许登录的用户账号，文件中未包括的用户账号被禁止FTP登录。
`userlist_deny`和 `userlist_enable`选项限制用户登录FTP服务器*（使用 `userlist_deny`选项和 `user_list`文件一起能有效阻止**`root,apache,www`**等系统用户登录**FTP**服务器，从而保证**FTP**服务器的分级安全性）：

#### 匿名FTP设置方法：

- 通常在登录FTP服务器的用户不确定的情况下，应将FTP服务器设置为允许匿名账号登录的FTP服务器

##### 1. 启用匿名帐号

```bash
anonymous_enable=YES
local_enable=YES
write_enable=YES
listen=YES
```

- 设置完成后，重启vsftpd将允许匿名账号和本地账号登录FTP服务器，同时允许匿名用户具有对FTP服务器文件的写权限，并且只能下载文件而不能上传，不允许匿名账号创建文件夹，匿名用户的口令为一个E-mail地址。

##### 2. 允许匿名账号上传文件

```bash
anon_upload_enable=YES
anon_mkdir_write_enable=YES
```

- 将 `#`去掉即可，重启vsftpd将允许匿名账号上传文件，也就是具有在FTP服务器的本地目录中新建文件和文件夹的功能

##### 3. 仅允许匿名用户访问

```bash
#local_enable=YES
#write_enable=YES
#在前面加上#，即限制本地账号访问，仅允许匿名用户访问
```

##### 4. 禁止匿名访问，允许本地账号访问

```bash
anonymous_enable=NO
local_enable=YES
write_enable=YES
```

##<font color=red>以下是配置文件各个参数详细解释</font>

### 默认配置：

- 允许匿名用户和本地用户登陆。
  `anonymous_enable=YES local_enable=YES`
- 匿名用户使用的登陆名为ftp或anonymous，口令为空；匿名用户不能离开匿名用户家目录/var/ftp,且只能下载不能上传。
- 本地用户的登录名为本地用户名，口令为此本地用户的口令；本地用户可以在自 己家目录中进行读写操作；本地用户可以离开自家目录切换至有权限访问的其他目录，并在权限允许的情况下进行上传/下载。
  `write_enable=YES`
- 写在文件/etc/vsftpd.ftpusers中的本地用户禁止登陆。

### 配置文件格式：

vsftpd.conf 的内容非常单纯，每一行即为一项设定。若是空白行或是开头为#的一行，将会被忽略。内容的格式只有一种，如下所示
`option=value`
要注意的是，等号两边不能加空白。

### 匿名用户（anonymous）设置

```bash
anonymous_enable=YES/NO（YES）
#控制是否允许匿名用户登入，YES 为允许匿名登入，NO 为不允许。默认值为YES。
write_enable=YES/NO（YES）
#是否允许登陆用户有写权限。属于全局设置，默认值为YES。
no_anon_password=YES/NO（NO）
#若是启动这项功能，则使用匿名登入时，不会询问密码。默认值为NO。
ftp_username=ftp
#定义匿名登入的使用者名称。默认值为ftp。
anon_root=/var/ftp
#使用匿名登入时，所登入的目录。默认值为/var/ftp。注意ftp目录不能是777的权限属性，即匿名用户的家目录不能有777的权限。
anon_upload_enable=YES/NO（NO）
#如果设为YES，则允许匿名登入者有上传文件（非目录）的权限，只有在write_enable=YES时，此项才有效。当然，匿名用户必须要有对上层目录的写入权。默认值为NO。
anon_world_readable_only=YES/NO（YES）
#如果设为YES，则允许匿名登入者下载可阅读的档案（可以下载到本机阅读，不能直接在FTP服务器中打开阅读）。默认值为YES。
anon_mkdir_write_enable=YES/NO（NO）
#如果设为YES，则允许匿名登入者有新增目录的权限，只有在write_enable=YES时，此项才有效。当然，匿名用户必须要有对上层目录的写入权。默认值为NO。
anon_other_write_enable=YES/NO（NO）
#如果设为YES，则允许匿名登入者更多于上传或者建立目录之外的权限，譬如删除或者重命名。（如果anon_upload_enable=NO，则匿名用户不能上传文件，但可以删除或者重命名已经存在的文件；如果anon_mkdir_write_enable=NO，则匿名用户不能上传或者新建文件夹，但可以删除或者重命名已经存在的文件夹。）默认值为NO。
chown_uploads=YES/NO（NO）
#设置是否改变匿名用户上传文件（非目录）的属主。默认值为NO。
chown_username=username
#设置匿名用户上传文件（非目录）的属主名。建议不要设置为root。
anon_umask=077
#设置匿名登入者新增或上传档案时的umask 值。默认值为077，则新建档案的对应权限为700。
deny_email_enable=YES/NO（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 在此档案内，则不允许进入。
```

### 本地用户设置

```bash
local_enable=YES/NO（YES）
#控制是否允许本地用户登入，YES 为允许本地用户登入，NO为不允许。默认值为YES。
local_root=/home/username
#当本地用户登入时，将被更换到定义的目录下。默认值为各用户的家目录。
write_enable=YES/NO（YES）
#是否允许登陆用户有写权限。属于全局设置，默认值为YES。
local_umask=022
#本地用户新增档案时的umask 值。默认值为077。
file_open_mode=0755
#本地用户上传档案后的档案权限，与chmod 所使用的数值相同。默认值为0666。
```

### 欢迎语设置

```bash
dirmessage_enable=YES/NO（YES）
#如果启动这个选项，那么使用者第一次进入一个目录时，会检查该目录下是否有.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（NO）`
设置是否启用chroot_list_file配置项指定的用户列表文件。默认值为NO。
`chroot_list_file=/etc/vsftpd.chroot_list`
用于指定用户列表文件，该文件用于控制哪些用户可以切换到用户家目录的上级目录。
`chroot_local_user=YES/NO（NO）`
用于指定用户列表文件中的用户是否允许切换到上级目录。默认值为NO。

> 通过搭配能实现以下几种效果：

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

### 数据传输模式设置

FTP在传输数据时，可以使用二进制方式，也可以使用ASCII模式来上传或下载数据。
`ascii_upload_enable=YES/NO（NO）`
设置是否启用ASCII 模式上传数据。默认值为NO。
`ascii_download_enable=YES/NO（NO）`
设置是否启用ASCII 模式下载数据。默认值为NO。

### 访问控制设置

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

- 控制主机访问：

`tcp_wrappers=YES/NO（YES）`
设置vsftpd是否与tcp wrapper相结合来进行主机的访问控制。默认值为YES。如果启用，则vsftpd服务器会检查/etc/hosts.allow 和/etc/hosts.deny 中的设置，来决定请求连接的主机，是否允许访问该FTP服务器。这两个文件可以起到简易的防火墙功能。
比如：若要仅允许192.168.0.1—192.168.0.254的用户可以连接FTP服务器，则在/etc/hosts.allow文件中添加以下内容：
vsftpd:192.168.0. :allow
all:all :deny

- 控制用户访问：

```bash
#对于用户的访问控制可以通过/etc目录下的vsftpd.user_list和ftpusers文件来实现。
userlist_file=/etc/vsftpd.user_list
#控制用户访问FTP的文件，里面写着用户名称。一个用户名称一行。
userlist_enable=YES/NO（NO）
#是否启用vsftpd.user_list文件。
userlist_deny=YES/NO（YES）
#决定vsftpd.user_list文件中的用户是否能够访问FTP服务器。若设置为YES，则vsftpd.user_list文件中的用户不允许访问FTP，若设置为NO，则只有vsftpd.user_list文件中的用户才能访问FTP。
/etc/vsftpd/ftpusers文件专门用于定义不允许访问FTP服务器的用户列表（注意:如果userlist_enable=YES,userlist_deny=NO,此时如果在vsftpd.user_list和ftpusers中都有某个用户时，那么这个用户是不能够访问FTP的，即ftpusers的优先级要高）。默认情况下vsftpd.user_list和ftpusers，这两个文件已经预设置了一些不允许访问FTP服务器的系统内部账户。如果系统没有这两个文件，那么新建这两个文件，将用户添加进去即可。
```

### 访问速率设置

```bash
anon_max_rate=0
#设置匿名登入者使用的最大传输速度，单位为B/s，0 表示不限制速度。默认值为0。
local_max_rate=0
#本地用户使用的最大传输速度，单位为B/s，0 表示不限制速度。预设值为0。
```

### 超时时间设置

```bash
accept_timeout=60
#设置建立FTP连接的超时时间，单位为秒。默认值为60。
connect_timeout=60
#PORT 方式下建立数据连接的超时时间，单位为秒。默认值为60。
data_connection_timeout=120
#设置建立FTP数据连接的超时时间，单位为秒。默认值为120。
idle_session_timeout=300
#设置多长时间不对FTP服务器进行任何操作，则断开该FTP连接，单位为秒。默认值为300 。
```

### 日志文件设置

```bash
xferlog_enable= YES/NO（YES）
#是否启用上传/下载日志记录。如果启用，则上传与下载的信息将被完整纪录在xferlog_file 所定义的档案中。预设为开启。
xferlog_file=/var/log/vsftpd.log
#设置日志文件名和路径，默认值为/var/log/vsftpd.log。
xferlog_std_format=YES/NO（NO）
#如果启用，则日志文件将会写成xferlog的标准格式，如同wu-ftpd 一般。默认值为关闭。
log_ftp_protocol=YES|NO（NO） 
#如果启用此选项，所有的FTP请求和响应都会被记录到日志中，默认日志文件在/var/log/vsftpd.log。启用此选项时，xferlog_std_format不能被激活。这个选项有助于调试。默认值为NO。
```

### 定义用户配置文件

```bash
#在vsftpd中，可以通过定义用户配置文件来实现不同的用户使用不同的配置。
user_config_dir=/etc/vsftpd/userconf
#设置用户配置文件所在的目录。当设置了该配置项后，用户登陆服务器后，系统就会到/etc/vsftpd/userconf目录下，读取与当前用户名相同的文件，并根据文件中的配置命令，对当前用户进行更进一步的配置。
例如：定义user_config_dir=/etc/vsftpd/userconf，且主机上有使用者 test1,test2，那么我们就在user_config_dir 的目录新增文件名为test1和test2两个文件。若是test1 登入，则会读取user_config_dir 下的test1 这个档案内的设定。默认值为无。利用用户配置文件，可以实现对不同用户进行访问速度的控制，在各用户配置文件中定义local_max_rate=XX，即可。
```

### FTP的工作方式与端口设置

```bash
#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）
#若设置为YES，则使用PASV工作模式；若设置为NO，则使用PORT模式。默认值为YES，即使用PASV工作模式。
pasv_max_port=0
#在PASV工作模式下，数据连接可以使用的端口范围的最大端口，0 表示任意端口。默认值为0。
pasv_min_port=0
#在PASV工作模式下，数据连接可以使用的端口范围的最小端口，0 表示任意端口。默认值为0。
```

### 与连接相关的设置

```bash
listen=YES/NO（YES）
#设置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（NO）
#设置每个与FTP服务器的连接，是否以不同的进程表现出来。默认值为NO，此时使用ps aux |grep ftp只会有一个vsftpd的进程。若设置为YES，则每个连接都会有一个vsftpd的进程。
```

### 虚拟用户设置

```bash
#虚拟用户使用PAM认证方式。
pam_service_name=vsftpd
#设置PAM使用的名称，默认值为/etc/pam.d/vsftpd。
guest_enable= YES/NO（NO）
#启用虚拟用户。默认值为NO。
guest_username=ftp
#这里用来映射虚拟用户。默认值为ftp。
virtual_use_local_privs=YES/NO（NO）
#当该参数激活（YES）时，虚拟用户使用与本地用户相同的权限。当此参数关闭（NO）时，虚拟用户使用与匿名用户相同的权限。默认情况下此参数是关闭的（NO）。
```

### 其他设置

```bash
text_userdb_names= YES/NO（NO）
#设置在执行ls –la之类的命令时，是显示UID、GID还是显示出具体的用户名和组名。默认值为NO，即以UID和GID方式显示。若希望显示用户名和组名，则设置为YES。
ls_recurse_enable=YES/NO（NO）
#若是启用此功能，则允许登入者使用ls –R（可以查看当前目录下子目录中的文件）这个指令。默认值为NO。
hide_ids=YES/NO（NO）
#如果启用此功能，所有档案的拥有者与群组都为ftp，也就是使用者登入使用ls -al之类的指令，所看到的档案拥有者跟群组均为ftp。默认值为关闭。
download_enable=YES/NO（YES）
#如果设置为NO，所有的文件都不能下载到本地，文件夹不受影响。默认值为YES。
```

#### 常见FTP命令及其功能

#### 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** 未执行请求的的命令，名称不正确。

Last modification：August 3, 2020