# Very Secure FTP Daemon (简体中文)

翻译状态： 本文是英文页面 Very Secure FTP Daemon 的翻译，最后翻译时间：2017-04-08，点击这里可以查看翻译后英文页面的改动。

vsftpd (Very Secure FTP Daemon) 是一个为UNIX类系统开发的轻量,稳定和安全的FTP服务器端.

## 安装

安装 vsftpd.

启动/启用 `vsftpd.service` 守护程序。

有关通过 xinetd 使用 vsftpd 的过程，请参阅 #使用 xinetd。

## 配置

vsftpd 的大多数配置都可以通过编辑 `/etc/vsftpd.conf` 文件实现。 该文件本身自带大量注释说明，所以这一章节只就一些重要的配置予以说明。 有关所有可用选项和文档，请参阅 vsftpd.conf(5) 或 在线查看 手册页。默认情况下，由 `/srv/ftp` 提供文件。

允许的连接 `/etc/hosts.allow`：

    # 允许所有连接
    vsftpd: ALL
    # IP地址范围
    vsftpd: 10.0.0.0/255.255.255.0

### 允许上传

需要将 `/etc/vsftpd.conf` 中的 `write_enable` 值设为YES，以便允许修改文件系统（如上传）:

    write_enable=YES

### 本地用户登录

需要修改 `/etc/vsftpd.conf` 中的如下值，以便允许 `/etc/passwd` 中的用户登录:

    local_enable=YES

### 匿名用户登录

以下行控制匿名用户是否可以登录。默认情况下，匿名登录只能从 `/srv/ftp` 下载：

    /etc/vsftpd.conf

    ...
    # 允许匿名FTP？ （当心 - 默认情况下允许除非您将其注释）。
    anonymous_enable=YES
    ...
    # 取消注释以允许匿名FTP用户上传文件。
    # 只有上述全局写入被激活，才会有效果。
    # 另外，你显然需要创建FTP用户有写权限的目录。
    # anon_upload_enable=YES
    #
    # 如果您希望匿名FTP用户能够创建新目录，请取消注释。
    # anon_mkdir_write_enable=YES
    ...

您也可以添加以下选项（详见 `man vsftpd.conf`）：

    /etc/vsftpd.conf

    # 匿名登录不需要密码
    no_anon_password=YES

    # 匿名客户端的最大传输速率（以 Bytes/秒 为单位）
    anon_max_rate=30000

    # 用于匿名登录的目录
    anon_root=/example/directory/

### Chroot 限制

为了阻止用户离开家目录，可以设置 chroot 环境。要启用此功能，请在 `/etc/vsftpd.conf` 中添加以下行：

    chroot_list_enable=YES
    chroot_list_file=/etc/vsftpd.chroot_list

`chroot_list_file` 定义了被 chroot 限制的用户列表。

对于更严格的环境，请指定以下行：

    chroot_local_user=YES

这将默认为所有用户启用 chroot 环境。 在这种情况下，`chroot_list_file` 定义了不受 chroot 限制的用户列表。

### 限制用户登录

可以通过在 `/etc/vsftpd.conf` 中添加以下两行来阻止特定用户登录FTP服务器：

    userlist_enable=YES
    userlist_file=/etc/vsftpd.user_list

`userlist_file` 文件列出不允许登录的用户。

如果您只想允许特定的用户登录，请添加以下行：

    userlist_deny=NO

此时 `userlist_file` 文件指定允许登录的用户。

### 限制连接数

可以通过在 `/etc/vsftpd.conf` 中添加如下信息来限制本地用户的数据传输速率：

    local_max_rate=1000000 # 最大数据传输速率（单位: Bytes/秒）
    max_clients=50 # 可以同时连接的最大客户端数
    max_per_ip=2 # 每个 IP 允许的最大连接数

### 使用 xinetd

Xinetd提供增强的监控和控制连接功能。对于基本的可以工作的 vsftpd-server 是不必要的

安装 vsftpd 将会添加必要的服务文件 `/etc/xinetd.d/vsftpd`， 默认情况下，服务被禁用。

启用ftp服务：

    service ftp
    {
            socket_type             = stream
            wait                    = no
            user                    = root
            server                  = /usr/sbin/vsftpd
            log_on_success  += HOST DURATION
            log_on_failure  += HOST
            disable                 = no
    }

如果您将vsftpd守护程序设置为以独立模式运行，而不是启动 vsftpd 守护程序和 enable `xinetd.service`，请在 `/etc/vsftpd.conf` 中进行以下更改：

    listen=NO

否则连接将失败：

    500 OOPS: could not bind listening IPv4 socket

### 使用 SSL 使 FTP 安全

生成一个SSL证书，如这样：

    # cd /etc/ssl/certs
    # openssl req -x509 -nodes -days 7300 -newkey rsa:2048 -keyout /etc/ssl/certs/vsftpd.pem -out /etc/ssl/certs/vsftpd.pem
    # chmod 600 /etc/ssl/certs/vsftpd.pem

您将被询问有关您公司等的许多问题，如果您的证书是不需要信任的，那么您填写的内容并不重要。但是您将使用这些内容加密！如果您计划在使用此功能方面取得信任，则可以从 CA 如 thawte,verisign 获得一个。

编辑您的配置 `/etc/vsftpd.conf`

    #这个很重要
    ssl_enable=YES

    #选择你想要的
    # 如果你接受 anon-connections 你可能要启用这个
    # allow_anon_ssl=NO

    #选择你想要的
    # 我猜这是一个性能上的问题
    # force_local_data_ssl=NO

    #选择你想要的
    force_local_logins_ssl=YES

    #你至少应该启用这个如果你启用 ssl...
    ssl_tlsv1=YES
    #选择你想要的
    ssl_sslv2=YES
    #选择你想要的
    ssl_sslv3=YES
    #给出您当前生成的 *.pem 文件的正确路径
    rsa_cert_file=/etc/ssl/certs/vsftpd.pem
    # *.pem 文件包含密钥和证书
    rsa_private_key_file=/etc/ssl/certs/vsftpd.pem

### 动态 DNS

确保在 `/etc/vsftpd.conf` 中放入以下两行：

    pasv_addr_resolve=YES
    pasv_address=yourdomain.noip.info

定期更新 pasv_address 并重新启动服务器的脚本是不必要的，因为它可以在别处被找到！

注意: 您将无法通过 LAN 连接到被动模式。尝试在局域网 PC 的 FTP 客户端上的活动模式。

### 端口配置

特别是对于暴露于 Web 的私有 FTP 服务器，建议将监听端口更改为标准端口 21 以外的其他服务器。可以使用 `/etc/vsftpd.conf` 中的以下行来完成此操作：

    listen_port=2211

此外，定制的端口范围可以由以下行给出：

    pasv_min_port=49152
    pasv_max_port=65534

### 配置 iptables

通常，运行FTP守护进程的服务器受 Iptables (简体中文) 防火墙的保护。要允许访问FTP服务器，需要打开相应的端口，如：

    # iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 21 -j ACCEPT

本文不会提供有关如何设置iptables的任何说明，但这里是一个例子：Simple stateful firewall (简体中文)。

有一些内核模块需要在这里引用的 iptables 正确的处理 FTP 连接。 其中特别是 nf_conntrack_ftp。这是需要的，因为FTP使用给定的 listen_port（默认为21） 仅用于命令; 所有的数据传输都是通过不同的端口完成的。 这些端口由FTP守护程序为每个会话随机选择（也取决于是使用主动还是被动模式）。要告诉 iptables 应该接受端口上的数据包，需要 nf_conntrack_ftp。要在启动时自动加载，请在 `/etc/modules-load.d` 中创建新文件，例如：

    # echo nf_conntrack_ftp > /etc/modules-load.d/nf_conntrack_ftp.conf

如果内核 >= 4.7，您需要通过 sysctl 设置 net.netfilter.nf_conntrack_helper = 1，如：

    # echo net.netfilter.nf_conntrack_helper=1 > /etc/sysctl.d/70-conntrack.conf

或使用

    # iptables -A PREROUTING -t raw -p tcp --dport 21 -j CT --helper ftp

## 小技巧

### 虚拟用户的PAM认证

由于 PAM (简体中文) 不再提供 `pam_userdb.so` 另一个简单的方法是使用 libpam_pwdfileAUR。对于具有许多用户的环境，另一个选项可能是 pam_mysqlAUR [broken link: archived in aur-mirror]。但是，本节仅限于解释如何通过 `pam_pwdfile.so` 配置chroot环境和身份验证。

在此示例中，我们创建目录 `vsftpd`：

    # mkdir /etc/vsftpd

创建和存储用户名和密码的一个选择是使用 Apache 的生成器 htpasswd：

    # htpasswd -c /etc/vsftpd/.passwd

上述命令的一个问题是 vsftpd 可能无法读取生成的 MD5 散列密码。如果使用 -d 开关运行相同的命令，则使用 crypt() 加密，vsftpd 的密码变得可读，但其缺点是安全性较低，密码限制为8个字符。 Openssl 可用于使用算法1生成基于 MD5 的 BSD 密码：

    # openssl passwd -1

无论那个解决方案 `/etc/vsftpd/.passwd` 应该如下所示：

    username1:hashed_password1
    username2:hashed_password2
    ...

接下来，您需要使用 `pam_pwdfile.so` 和生成的 `/etc/vsftpd/.passwd` 文件创建PAM服务。在本例中，我们为 vsftpd 创建了一个PAM策略，其中包含以下内容：

    /etc/pam.d/vsftpd

    auth required pam_pwdfile.so pwdfile /etc/vsftpd/.passwd
    account required pam_permit.so

现在是为虚拟用户创建一个 home 的时候了。在示例中，决定用 `/srv/ftp` 为虚拟用户托管数据，这也反映了Arch的默认目录结构。首先创建 virtual 用户并使 `/srv/ftp` 成为它的 home：

    # useradd -d /srv/ftp virtual

让 virtual 成为所有者

    # chown virtual:virtual /srv/ftp

一个基本的没有私人文件夹配置的 /etc/vsftpd，默认的虚拟用户的 home 文件夹:

    # 指向正确的PAM服务文件
    pam_service_name=vsftpd
    write_enable=YES
    hide_ids=YES
    listen=YES
    connect_from_port_20=YES
    anonymous_enable=NO
    local_enable=YES
    dirmessage_enable=YES
    xferlog_enable=YES
    chroot_local_user=YES
    guest_enable=YES
    guest_username=virtual
    virtual_use_local_privs=YES

您自己的设置可能不需要一些参数。如果您希望chroot环境可写，您将需要将以下内容添加到配置文件中：

    allow_writeable_chroot = YES

否则 vsftpd 的默认安全设置会抱怨，如果它检测到chroot是可写的。

Start `vsftpd.service`。

您现在应该可以使用存储在 `/etc/vsftpd/.passwd` 中的任何用户和密码从FTP客户端登录。

#### 为虚拟用户创建私有目录

首先创建用户文件夹

    # mkdir /srv/ftp/user1
    # mkdir /srv/ftp/user2
    # chown virtual:virtual /srv/ftp/user?/

随后, 在`/etc/vsftpd.conf`增加如下行:

    local_root=/srv/ftp/$USER
    user_sub_token=$USER

## 问题解决

### vsftpd: no connection (Error 500) with recent kernels (3.5 and newer) and .service

将其添加到您的 `/etc/vsftpd.conf`：

    seccomp_sandbox=NO

### vsftpd: refusing to run with writable root inside chroot()

从 vsftpd 2.3.5 开始，用户被锁定的 chroot 目录不可写。这是为了防止安全漏洞。

允许上传的安全方法是保持 chroot 启用，并配置您的 FTP 目录。

    local_root=/srv/ftp/user

    # mkdir -p /srv/ftp/user/upload
    #
    # chmod 550 /srv/ftp/user
    # chmod 750 /srv/ftp/user/upload

如果你必须这么做：

您可以将其放入您的 `/etc/vsftpd.conf` 以解决此安全性增强（自vsftpd 3.0.0;从Fixing 500 OOPS: vsftpd: refusing to run with writable root inside chroot ())：

    allow_writeable_chroot=YES

或者：

安装 vsftpd-extAUR [broken link: archived in aur-mirror] 并在 conf 文件中设置

    allow_writable_chroot=YES

### FileZilla Client: GnuTLS error -8 -15 -110 when connecting via SSL

vsftpd 尝试在 SSL 会话中显示纯文本错误消息。 为了进行调试，暂时禁用加密，您将看到正确的错误消息。[1] [2]

### vsftpd.service fails to run on boot

如果您启用了vsftpd服务，并且无法在启动时运行，请确保它已在服务文件中设置为在 network.target 之后加载：

    /usr/lib/systemd/system/vsftpd.service

    [Unit]
    Description=vsftpd daemon
    After=network.target

### ipv6 only fails with: 500 OOPS: run two copies of vsftpd for IPv4 and IPv6

你很有可能已经注释了这一行

    # When "listen" directive is enabled, vsftpd runs in standalone mode and
    # listens on IPv4 sockets. This directive cannot be used in conjunction
    # with the listen_ipv6 directive.
    #listen=YES
    #
    # This directive enables listening on IPv6 sockets. To listen on IPv4 and IPv6
    # sockets, you must run two copies of vsftpd with two configuration files.
    # Make sure, that one of the listen options is commented !!
    listen_ipv6=YES

而不是设置

    # When "listen" directive is enabled, vsftpd runs in standalone mode and
    # listens on IPv4 sockets. This directive cannot be used in conjunction
    # with the listen_ipv6 directive.
    listen=NO

## 更多资源

- vsftpd official homepage
- vsftpd.conf man page

Category:

- File Transfer Protocol (简体中文)

Hidden category:

- Pages with broken package links