Python笔记：利用ftplib标准库创建一个简单的FTP文件传输客户端

矫情吗；* 2022-10-02 10:41 1675阅读 0赞

### 文章目录 ###

*  ftplib内置标准库简介
 *  利用微软windows的IIS创建FTP服务器
 *   *  安装FTP服务器
     *  配置FTP服务器
 *  python代码

# ftplib内置标准库简介 #

ftplib是python的内置的一个标准模块，它提供了极强大的对FTP服务器的操作，通过它我们可以连接并操作FTP服务端。　  
当使用python语言开发FTP程序时，需要将相应的Python模块ftplib导入项目程序中，具体开发流程如下图所示:  
（1）连接到服务器  
（2）登录  
（3）发出服务请求（希望能得到响应）  
（4）退出  
在使用Python程序语言开发FTP程序时，首先导入ftplib模块，然后实例化一个ftplib.FTP类对象，所有的FTP操作（如登录，传输文件和注销等）都要使用这个对象完成。使用类FTP可以创建一个FTP连接对象。具体语法如下图所示：  
FTP(host,user,passwd,acct)

*  host:要连接的FTP服务器。可选参数
 *  user:登录FTP服务器所使用的用户名，可选参数
 *  passwd:登录FTP服务器所使用的的密码，可选参数
 *  acct:可选参数，默认为空

当实例化完一个FTP连接对象后，接着下表解释了FTP对象常用方法：

<table> 
 <thead> 
  <tr> 
   <th>方法</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>set_debuglevel(level)</td> 
   <td>设置调试级别。所需参数级别表示–&gt;0:无调试输出(默认)；1:打印命令和响应，但不打印正文等；2:在剥去CR/LF之前，还打印读取和发送的原始行</td> 
  </tr> 
  <tr> 
   <td>connect(host,port,timeout,source-address)</td> 
   <td>如果在创建FTP连接对象时没有使用参数host,则可以使用FTP对象中的方法connect()</td> 
  </tr> 
  <tr> 
   <td>login(user,passwd,acct)</td> 
   <td>user:登录用户FTP服务器所使用的用户名；passwd:登录FTP服务器所使用的的密码；acct:可选参数，默认为空</td> 
  </tr> 
  <tr> 
   <td>retrbinary(cmd, callback, blocksize, rest)</td> 
   <td>以二进制形式从FTP服务器下载文件。cmd:传输命令,由"RETR +文件名"组成(之间有空格)；callback:调用回调函数；blocksize设置每次传输的最大字节数，可选；rest:设置文件续传位置,可选参数</td> 
  </tr> 
  <tr> 
   <td>retrlines(cmd, callback)</td> 
   <td>以ASCII码形式从FTP服务器下载文件。cmd:传输命令,由"RETR +文件名"组成(之间有空格)；callback:调用回调函数</td> 
  </tr> 
  <tr> 
   <td>storbinary(cmd, fp, blocksize, callback, rest)</td> 
   <td>以二进制形式向FTP服务器上传文件。cmd:传输命令，由"STOR +文件名"组成(之间有空格)；fp:本地文件句柄；blocksize:每次读取文件的最大字节数，可选参数；callback:调用回调函数；rest:设置文件续传位置,可选参数</td> 
  </tr> 
  <tr> 
   <td>storlines(cmd, fp, callback)</td> 
   <td>以ASCII码形式向FTP服务器上传文件。cmd:传输命令；fp:本地文件句柄；callback:回调函数</td> 
  </tr> 
  <tr> 
   <td>dir(*args)</td> 
   <td>获取当前目录中的内容列表</td> 
  </tr> 
  <tr> 
   <td>rename(fromname, toname)</td> 
   <td>fromname:原来的文件名；toname:重命名后的文件名</td> 
  </tr> 
  <tr> 
   <td>delete(filename)</td> 
   <td>从FTP服务器上删除文件。filename为要删除的文件名</td> 
  </tr> 
  <tr> 
   <td>cwd(dirname)</td> 
   <td>可改变FTP服务器当前目录。dirname是要进入FTP服务器目录的路径</td> 
  </tr> 
  <tr> 
   <td>mkd(dirname)</td> 
   <td>在FTP服务器上创建目录。</td> 
  </tr> 
  <tr> 
   <td>pwd()</td> 
   <td>获取当前ftp服务器目录</td> 
  </tr> 
  <tr> 
   <td>rmd()</td> 
   <td>可以删除FTP服务器上的目录</td> 
  </tr> 
  <tr> 
   <td>size(filename)</td> 
   <td>可以获取FTP服务器上某个文件的大小。filename表示要获取文件大小的文件名</td> 
  </tr> 
 </tbody> 
</table>

# 利用微软windows的IIS创建FTP服务器 #

要编写一个客户端程序操作FTP服务器，首先要有一个FTP服务器，由于访问网站上已有的FTP服务器，需要非常大的编程量，且需要配置的东西非常多，出错概率大，所以作为测试，就在本地创建一个FTP服务器。FTP服务器是IIS的一个组件，配置和管理都非常简单，但功能非常强大。

## 安装FTP服务器 ##

![在这里插入图片描述][20190618102622268.png]  
![在这里插入图片描述][20190618102634618.png]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70]![在这里插入图片描述][20190618102809897.png]  
![在这里插入图片描述][20190618102835632.png]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 1]![在这里插入图片描述][20190618103019654.png]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 2]![在这里插入图片描述][20190618103052148.png]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 3]

## 配置FTP服务器 ##

FTP服务安装完成后，需要用户自己创建一个FTP站点，并设置相应的IP地址和端口号等。  
一般情况下，FTP服务器默认TCP端口为21.FTP客户端可以使用该FTP服务器中的任何IP地址以及默认端口对其进行访问。为了安全需要为FTP网站指定唯一的IP地址和端口。此处我使用默认的21号端口。  
![在这里插入图片描述][20190618103552383.png]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 4]  
![在这里插入图片描述][20190618103637862.png]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 5]  
![在这里插入图片描述][20190618103733965.png]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 6]  
此处我站点名称设置为ftpuser，站点路径设置为F:\\ftpuser，下一步

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 7]  
dos下ipconfig命令查看ipv4，由于我处于校园网内，我的ip为私有ip(而且是动态ip，所以每次开机ip地址都要改)，IP地址我设置为172.17.144.102，避免其他麻烦的东西，SSL证书设置为无，下一步  
![在这里插入图片描述][20190618104249179.png]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 8]  
匿名身份验证和基本身份验证目前不清楚其具体功能，我全勾上了，重点在授权框，两种情况：（1）所有用户允许访问，脚本中只需要输入正确的ftp站点ip就行，用户名和密码输入时回车直接跳过，传个空字符串给它。（2）指定用户允许访问，解锁了第二个文本框，此时需要在操作系统用户和组中创建一个操作系统用户，比如一个操作系统用户名为ftpuser，设置密码,若在浏览器输入"[ftp://172.17.144.102][ftp_172.17.144.102]"访问FTP服务器时需要输入验证信息，简单来说就是将FTP服务器的一个登陆账户映射到浏览器访问者，使其具有操作FTP服务器的权限。然后权限框必须勾上读取和写入,读取权限对应上面ftplib库类FTP对象的cwd()以及retrlines()等操作,写入权限对应上面的storbinary(),mkd()等函数权限，不然会提示deny access530还是550错误码的类似权限不足的错误

Win32 error:   Access is denied. 
     Error details: Authorization rules denied the access.
    530 End

# python代码 #

最后上代码：

from ftplib import FTP
    def Get(filename):#下载ftp文件服务器下的文件
        command='RETR '+filename
        ftp.retrbinary(command,open(filename,'wb').write,bufsize)
        print('下载成功')
    def Put(filename):#上传本地文件到ftp服务器
        command='STOR '+filename
        filehander=open(filename,'rb')#将需要上传的本地文件以二进制输入流形式，输入到程序中
        ftp.storbinary(command,filehander,bufsize)
        filehander.close()#文件指针关闭
        print("上传成功")
    def Pwd():#获取当前ftp服务器目录
        print(ftp.pwd())
    def Size(filename):#获取ftp服务器上某个文件的大小
        print(ftp.size(filename))
    def Help():
        print(''' ================================== Simple FTP Script(Python) ================================== get 下载文件 put 上传文件 pwd 获取当前目录 size 获取文件大小 help 帮助 mkdir 在ftp服务器上创建文件夹 rmdir 在ftp服务器上删除文件夹 dir 获取当前目录文件列表 cd 进入文件夹 delete 删除文件(非文件夹) rename 重命名文件夹(文件夹) ''')
    def login_ftp():#登录ftp服务器
        server=input("请输入FTP服务器地址：")
        ftp=FTP(server)
        username=input("请输入用户名:")#若在ftp服务器中未设置特定用户身份验证,即允许所有用户访问,可直接回车忽略
        password=input("请输入密码:")#若允许所有用户访问，回车忽略
        ftp.login(username,password)
        print(ftp.getwelcome())#登陆成功，打印ftp服务器欢迎信息
        return ftp
    if __name__=="__main__":
        bufsize=1024#设置缓冲区大小
        ftp=login_ftp()
        #定义一个字典actions,在里面保存操作命令
        actions={ 'get':Get,'put':Put,'pwd':Pwd,'size':Size,'help':Help,
                 'mkdir':ftp.mkd,'rmdir':ftp.rmd,'dir':ftp.dir,
                 'cd':ftp.cwd,'delete':ftp.rmd,'rename':ftp.rename}
        while True:
            print('pyftp>>')
            cmds=input()
            cmd=str.split(cmds)#使用空格分隔用户输入的内容，返回一个列表
            try:
                if len(cmd)==1:
                    if str.lower(cmd[0])=='quit':#如果用户只输入了一个quit
                        break#退出while循环，然后执行完程序，返回Shell界面
                    else:
                        actions[str.lower(cmd[0])]()#执行类似dir,help,pwd,类似不需要参数的命令
                elif len(cmd)==2:
                    actions[str.lower(cmd[0])](cmd[1])#actions[str.lower(cmd[0])]->对应函数名，(cmd[1])->对应参数名
                elif len(cmd)==3:
                    actions[str.lower(cmd[0])](cmd[1],cmd[2])
                else:
                    print("输入错误")
            except:
                print("命令出错！")
        ftp.quit()

运行效果：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 9]  
对了程序这里的打印的欢迎信息"welcome"是在  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 10]设置的然后返回给客户端

[20190618102622268.png]: /images/20220112/978124305337462196d58cd8b8706ab9.png
[20190618102634618.png]: /images/20220112/bcd88305f85d4818abff31c487270c23.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20190618102649803.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA==,size_16,color_FFFFFF,t_70
[20190618102809897.png]: /images/20220112/33c0e555e4c342f68065a8d7d6ed616e.png
[20190618102835632.png]: /images/20220112/49a20a8fad874dea9a6c7287c5892970.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20190618102902238.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA==,size_16,color_FFFFFF,t_70
[20190618103019654.png]: /images/20220112/9d56b828de67440fabfb5699e4063901.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20190618103038383.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA==,size_16,color_FFFFFF,t_70
[20190618103052148.png]: /images/20220112/533f863178374053a42611d577024f76.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 3]: /images/20220112/0573cae8e1424375bb3c998680db99bb.png
[20190618103552383.png]: /images/20220112/583cdb207e18413ab3d2ff454a35da60.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 4]: /images/20220112/1bcbd1090afc400da84539ceb45a1970.png
[20190618103637862.png]: /images/20220112/fd0cea9d606e438b932154b61f69edbd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 5]: /images/20220112/a7e01ff401d54fabbcd7a9785ccdf9c3.png
[20190618103733965.png]: /images/20220112/4d662ca9e736424bbe4387466577d8c7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 6]: /images/20220112/b2058527b9344aefa7391ca3849ef892.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 7]: /images/20220112/06e7b7fd1a9748f8bdc973b378f7ada2.png
[20190618104249179.png]: /images/20220112/a875a70e417945b288aa51a63e80ef60.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 8]: /images/20220112/30273f5eb8144b1a83043e39f06267a0.png
[ftp_172.17.144.102]: ftp://172.17.144.102
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 9]: /images/20220112/93b31d60062e43b5950e85b7367aec2a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjEyNDIzNA_size_16_color_FFFFFF_t_70 10]: /images/20220112/30925735029c465995f776c74f21351f.png