[vsftpd] ubuntu14.04 ansible剧本安装vsftpd流程及报错排查

需求：

在ubuntu14.04机器上搭建ftp服务，ftp账号通过winscp软件登录后，仅可增删改/data/wwwroot目录。

一、安装步骤

1、apt 安装vsftpd

apt-get install vsftpd

2、设置ftp账号密码

passwd ftp -s "ftp passwd"

3、按需求更改/etc/vsftpd.conf

listen=YES  #被动模式

anonymous_enable=NO　#不允许匿名用户登录FTP

local_enable=YES　　

write_enable=YES

local_umask=022

dirmessage_enable=YES

use_localtime=YES

xferlog_enable=YES

connect_from_port_20=YES

xferlog_file=/var/log/vsftpd.log

ftpd_banner=Welcome to blah FTP service.

chroot_local_user=YES

local_root=/data/wwwroot

chroot_list_file=/etc/vsftpd.chroot_list

secure_chroot_dir=/var/run/vsftpd/empty

pam_service_name=vsftpd

userlist_enable=YES

userlist_file=/etc/vsftpd.userlist　　＃仅供文件内的用户登录

userlist_deny=NO

pasv_enable=YES

pasv_min_port=40000  #最小端口

pasv_max_port=40050 　＃最大端口

port_enable=YES

#pasv_address=x.x.x.x

#pasv_addr_resolve=NO

allow_writeable_chroot=YES

4、设置开放目录的权限和属主

chown -R ftp:ftp /data/wwwroot

chmod 755 /data/wwwroot

5、重启vsftpd

service vsftpd start

6、本机测试

如果报错则根据报错信息进行检测

7、设置机器防火墙

开放端口： 21、20、pasv_min_port - pasv_max_port

8、winscp测试

二、组织目录结构

三、写ansible yaml剧本

tasks/main.yaml

---

 - name: Apt-get vsftpd

   apt:

    name: vsftpd

    update_cache: yes

 - name: Change name of vsftpd.conf orignal

   shell: cp vsftpd.conf vsftpd.conf.orig -f

   args:

     chdir: /etc

     warn: no

 - name: Modify pam check mod

   shell: sed -i "s@pam_shells.so@pam_nologin.so@g" /etc/pam.d/vsftpd    #fix 503  Login incorrect

 - name: Copy configs

   copy: src=config/ dest=/etc/ owner=root group=root mode=644

 - name: Set ftp passwd

   user: name=ftp password={{ftp_pass | password_hash('sha512')}} update_password=always

 - name: Set dir mode

   file: path=/data/wwwroot/PapaSG2/  owner=ftp  group=ftp  mode='0644'

 - name: Start vsftpd

   service: name=vsftpd  state=started

　　vsftpd.userlist

ftp

四、报错和解决方案

1、无法登录

1）检查账号、密码、防火墙、主目录

防火墙需要将 21，asv_min_port - pasv_max_port 端口都开放

主目录的权限需要设为755

2、530 Login incorrect

1）/etc/vsftpd.conf文件将pam_service_name=vsftpd 修改为 pam_service_name=ftp

绕过了PAM，其实并不对，同理是将/etc/pam.d/vdstpd重命名

2）/etc/pam.d/vsftpd分析

# Standard behaviour for ftpd(8).

auth   required        pam_listfile.so item=user sense=deny file=/etc/ftpusers   @1

onerr=succeed

# Note: vsftpd handles anonymous logins on its own. Do not enable pam_ftp.so.

# Standard pam includes

@include common-account

@include common-session

@include common-auth

auth   required        pam_shells.so  @2

　　@1：/etc/ftpusers 中的用户禁止登陆，如果文件不存在在默认所有用户均允许登录. 所以确保用户没在这个文件内

@2：仅允许用户的shell为 /etc/shells 文件内的shell命令时，才能够成功。而创建ftp用户时，为了禁止ssh登录，一般多为/bin/false 、/usr/sbin/nologin 等，显然不是一个有效的bash，也就无法登录了。

解决方案：

确认ftp不在/etc/ftpusers， sed -i "s@pam_shells.so@pam_nologin.so@g" /etc/pam.d/vsftpd，重启vsftpd

3、vsftpd respawning too fast, stopped

环境： ubuntu 12.04 vsftpd v2.3.5

>service vsftpd start

vsftpd start/pre-start, process 19503 #启动失败

>tail /var/log/syslog -n 10

>vsftpd #不能启动的时候可以直接启动，方便定位原因

500 OOPS: unrecognised variable in config file: allow_writeable_chroot
>grep allow_writeable_chroot /etc/vsftpd.conf

allow_writeable_chroot=YES

>sed -i "@allow_writeable_chroot=YES@#allow_writeable_chroot=YES@g" /etc/vsftpd.conf

>service vsftpd start

vsftpd start/running, process 19652

4、500 OOPS: child died

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

前者是默认报错，后者是更具体的报错，意思是不能使用chroot限制可写的根目录

环境： ubuntu 12.04 vsftpd v2.3.5

>ftp localhost

Connected to localhost.
220 Welcome to blah FTP service.
Name (localhost:root):

本来以为这样就Ok了，然后使用winscp去连接，却报错：500 OOPS: child died

1）有的解决方案是说关闭selinux，或者是开启ftp_home_dir 或者 tftpd_disable_trans

但是我使用的是云主机，本身selinux就是关闭的，基础项check过都是ok的

2）vsftpd从v2.3.5版本开始，取消了根目录的可写权限

看了下vsftpd的更新日志:

Add stronger checks for the configuration error of running with a writeable　root directory inside a chroot(). This may bite people who carelessly turned　on chroot_local_user but such is life.

解决方案A： > chmod a - w /$local_root

解决方案B：> echo "allow_writeable_chroot=YES" >> /etc/vsftpd.conf

A方案可行，可以将根目录包一层，不影响具体的业务使用

local_root设置为test， nginx root 设为t， t目录权限设为可写

B方案，vsftpd启动失败，会报3号错。

但是网上也有说以下方案是ok的，也许是我这里安装vsftpd的问题。因为当前只需要可读就成了，就没往下测试。有兴趣的可以尝试下。

$ apt-get install python-software-properties

$ sudo add-apt-repository ppa:thefrontiergroup/vsftpd

$ sudo apt-get update

$ sudo apt-get install vsftpd

$ vim /etc/vsftpd.conf and add the following

  chroot_local_user=YES

  allow_writeable_chroot=YES

$ sudo service vsftpd restart

参考文档：

https://www.jianshu.com/p/91c7d4a115e0