vsftp的可用配置参数说明1

vsftpd.conf 配置

Linux技术 2008-07-11 22:05:59 阅读131 评论0  字号：大中小 

名称

vsftpd.conf - vsftpd 的配置文件  

描述

vsftpd.conf 可以用于控制 vsftpd, 以实现各种各样的功能. vsftpd 缺省到 /etc/vsftpd.conf 处查找此文件. 当然, 您也可以通过命令行参数进行指定. 这个命令行参数就是指 vsftpd 的配置文件. 对于想使用高级 inetd 管理的用户, 例如, xinetd, 则这个功能非常有用. 可以使用不同的配置文件来启动基于虚拟主机的每个服务. 

格式

vsftpd.conf 的格式非常简单. 每行要么是注释, 要么是指令. 注释行以 # 开始, 将被忽略. 指令行格式如下: 

选项=值

应当注意的一点是如果在 选项, = 和 值 之间存在空格, 将会报错.(译者注: 即三者之间不允许存在空格)

每项设定都有默认值, 这可以通过配置文件来修改.

布尔选项

下边是布尔选项的列表. 一个布尔选项的值可以被设为 YES 或 NO 

allow_anon_ssl

只有在 ssl_enable 被激活时才有用. 如果设为 YES, 匿名用户将被允许使用安全的 SSL 联接. 

默认: NO

anon_mkdir_write_enable

如果设为 YES, 匿名用户将允许在某些情况下创建目录. 这需要激活 write_enable 选项, 并且匿名 ftp 用户需要对父目录有写权限. 

默认: NO

anon_other_write_enable

如果设为 YES, 匿名用户将拥有除 上载, 和创建目录 外更多的权限, 比如 删除和重命名. 通常不建议这么做, 但完整的配置文件是包括这一选项的. 

默认: NO

anon_upload_enable

如果设为 YES, 匿名用户在某些情况下允许上载文件. 这需要将 write_enable 选项激活, 并且匿名用户应当对对应目录有写权限. 

默认: NO

anon_world_readable_only

启用时, 将只允许匿名用户下载具有全球读权限的文件. 这将意味着 ftp 用户可以拥有自己的文件, 特别是前边提到的上载的文件. 

默认: YES

anonymous_enable

用于控制是否允许匿名用户登录. 如果激活, ftp 和 anonymous 都将被视为匿名用户登录. 

默认: YES

ascii_download_enable

如果被激活, 下载时将使用 ASCII 模式进行数据传输. 

默认: NO

ascii_upload_enable

如果被激活, 上载时将使用 ASCII 模式进行数据传输. 

默认: NO

async_abor_enable

如果被激活, 一个特别的 FTP 命令 "async ABOR" 将被激活. 只有某些 FTP 客户端需要使用这一特性. 另外, 这个特性并不是很好控制, 因此默认没有启用. 不幸的是, 如果没有启用这个特性, 某些 FTP 客户端在取消一个传输时就会挂起, 因此, 您可能希望启用它. 

默认: NO

background

如果被激活, 并且 vsftpd 以 "listen" 模式启动, vsftpd 将会background 监听进程. 即 control will immediately be returned to the shell which launched vsftpd. 

默认: NO

check_shell

注意! 这个选项只对构建时加入 non-PAM 参数的 vsftpd 有效. 如果令其失效, vsftpd 将不会检查有效用户的用于本地登录的 /etc/shells. 

默认: YES

chmod_enable

如果被激活, 将允许使用 SITE CHMOD 命令. 注意! 这只对本地用户有效. 匿名用户从不允许使用 SITE CHMOD. 

默认: YES

chown_uploads

如果被激活, 所有匿名上载的文件的宿主将会调整为 chown_username 中指定的用户. 这样就便于管理, 特别是从安全的角度考虑. 

默认: NO

chroot_list_enable

如果被激活, 您需要提供一个需要将其限制于其家目录中的本地用户列表. 如果将 chroot_local_user 设为 YES 则意义稍有不同. 在此情况下, 此列表变成不需将用户限制于其家目录的用户的列表. 默认情况下,这个列表文件是 /etc/vsftpd.chroot_list, 但可以通过 chroot_list_file 选项来设定. 

默认: NO

chroot_local_user

如果设为 YES, 本地用户, 在登录后将(默认)被限制在其家目录中. 警告: 此选项有安全隐患, 特别是在用户拥有上载权限, 或可以shell访问的时候. 如果您不清楚后果, 请不要启用它. 注意, 这些安全隐患并不是 vsftpd 所特有的. 所有的提供将本地用户进行目录限制的 FTP 守护进程有存在这种隐患. 

默认: NO

connect_from_port_20

用于控制在服务器端, 是否使用端口20(ftp-data)进行数据联接. 基于安全的考虑, 有些客户端需要这样做. 相反, 禁用这个选项, 可以使 vsftpd 以较少特权运行. 

默认: NO(但是在示例设置中启用了这个选项)

deny_email_enable

如果激活, 您应当提供一个禁止匿名用户用做密码的 e-mail 地址列表. 默认情况下, 这个列表文件为 /etc/vsftpd.banned_emails, 当然, 您可以通过 banned_email_file 选项指定. 

默认: NO

dirlist_enable

如果设为 NO, 所有的目录列取命令都将被禁止. 

默认: YES

dirmessage_enable

如果启用, 当用户首次进入一个新目录时, FTP 服务器将会显示欢迎信息. 默认情况下, 是扫描目录下的 .message 文件获取的, 当然, 您也可以通过 message_file 选项设定. 

默认: NO(但是在示例设置中启用了这个选项)

download_enable

如果设为 NO, 所有的下载请求都将被拒绝. 

默认: YES

dual_log_enable

如果启用, 将生成两个相似的日志文件, 默认在 /var/log/xferlog 和 /var/log/vsftpd.log 目录下. 前者是 wu-ftpd 类型的传输日志, 可以用于 标准工具分析. 后者是 vsftpd 自己类型的日志. 

默认: NO

force_dot_files

如果激活, 以 . 开始的文件和目录在目录列取的时候将会被显示, 即使客户端没有使用 "a" 标识. 这不包括 "." 和 ".." 目录 

默认: NO

force_local_data_ssl

只有在 ssl_enable 被激活时才能使用. 如果被激活, 则所有的非匿名用户 登录时都被强制使用安全 SSL 联接来传送接收数据. 

默认: YES

force_local_logins_ssl

只有在 ssl_enable 被激活时才能使用. 如果被激活, 则所有的非匿名用户 登录时都被强制使用安全 SSL 联接来传送密码. 

默认: YES

guest_enable

如果启用, 所有非匿名用户都将以 "guest" 身份登录. guest 通过 guest_username 设定, 来映射到一个指定用户. 

默认: NO

hide_ids

如果启用, 所有目录中的用户和组信息列取时都将显示为 "ftp". 

默认: NO

listen

如果启用, vsftpd 将以独立模式运行. 这就意味着 vsftpd 不能由类 inetd 来启动. vsftpd 应当直接执行. 由 vsftpd 自身监听和处理联接请求. 

默认: NO

listen_ipv6

如 listen 参数, 所不同的是, vsftpd 将对 IPv6 接口进行监听, 而不是 IPv4 接口. 此参数 和 listen 参数相互独立. 

默认: NO

local_enable

用于控制是否允许本地登录. 如果启用, /etc/passwd 中的普通帐号即可用于登录. 

默认: NO

log_ftp_protocol

如果启用, 假若选项 xferlog_std_format 没有启用, 所有的 FTP 请求和应答都会被记录. 此选项对将对调试很有用. 

默认: NO

ls_recurse_enable

如果启用, 此设置将允许用户使用 "ls -R". 这有点安全威胁, 因为在大型站点的根目录下进行 ls -R 将会消耗很多资源. 

默认: NO

no_anon_password

如果启用, 匿名用户登录将不再需要密码 - 可以直接登录. 

默认: NO

no_log_lock

如果启用, 在写日志文件时, 将会阻止 vsftpd 使用文件锁定. 这个选项通常不会启用. 它的存在是为了处理操作系统的一个bug, 如 Solaris / Veritas 文件系统组合某些情况下试图锁定日志文件的现象. 

默认: NO

one_process_model

如果你使用 Linux 2.4 内核, 您就可以使用一个不同的安全模式, 它只允许每个联接使用一个进程. 这有一点小小的安全问题, 但是提高了性能. 如果您不清楚后果, 或者您的站点要承受大量的并发用户联接时, 请不要启用此选项. 

默认: NO

passwd_chroot_enable

如果启用, 同 chroot_local_user 一起使用, 就会基于每个用户创建限制目录, 每个用户限制的目录源于 /etc/passwd 中的家目录. 当家目录路径中包含 /./ 时, enotes that the jail is at that particular location in the path.

pasv_enable

如果数据传输时, 您不允许使用 PASV 模式, 则将此选项设为 NO 

默认: YES

pasv_promiscuous

如果您要禁用 PASV 安全检查, 将此选项设置为 YES. 该检查用于确保数据传输联接与控制联接源于同一 IP 地址. 如果不清楚后果, 请不要启用此选项! 此选项只有在某些使用安全隧道的方案中才能正常使用, 或者需要 FXP 的支持. 

默认: NO

port_enable

如果您不允许使用端口模式获取数据联接, 将此选项设置为 NO. 

默认: YES

port_promiscuous

如果您想禁用端口安全检查, 将此选项设置为 YES. 此检查用于确认出站的数据只流向客户端. 搞清楚后果前,不要启用此选项! 

默认: NO

run_as_launching_user

如果您希望可以由用户来启动 vsftpd, 将此选项设置为 YES. 当不能使用root登录时, 这通常很有用. 严重警告: 搞清楚后果前,不要启用此选项, 随意的启用此选项将会导致非常严重的安全问题. 特别是 vsftpd 没有/不能使用目录限制技术来限制文件访问时(甚至vsftpd是由root启动的). 一个愚蠢的替代方法是将选项 deny_file 设为 {/*,*..*}, 但是其可靠性并不能和限制目录相比, 甚至不在一个等级上. 如果启用此选项, 应当限制其它选项的使用. 例如, 非匿名登录, 上载文件宿主转换, 使用源自端口20的联接和低于 1024 的端口不会工作. 其它一些选项也可能受到影响. 

默认值: NO