【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

文章大纲

????️ 一、前言

????️ 二、专栏推荐

???? 三、Window系统FTP服务器搭建

♈ 3.1、FTP服务器怎么玩

♉ 3.2、FTP(File Transfer Protocol,文件传输协议)

♊ 3.3、FTP服务器

♋ 3.4、FTP服务器搭建

♌ 3.5、FTP服务器搭建出现的问题

???? 四、通过程序实现FTP文件的上传和下载

???? 4.1、项目结构

???? 4.2、实现技术

???? 4.2、相关配置

???? 4.3、核心代码

???? 4.4、执行结果

???? 4.5、开发过程中遇到的坑

???? 六、写在最后

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

????️ 一、前言


大家好,我是小诚,在开始学习之前,先给大家推荐下最近筹划的【技术圈子】,在没有更文的20多天里,一直在梳理之前的文章知识和学习资源,现在已经初步梳理完成,圈子中所有资源都免费分享,资源包括但不限于面试资源、简历模板、年终汇报PPT、CSDN VIP下载资源等等,感兴趣者请点击【技术圈子】,期待您的加入。


如果文章对你有帮助,可以帮忙一键三连和专栏订阅哦!


本篇文章重点介绍:Window环境搭建FTP服务器,JAVA程序实现FTP服务器文件上传、下载功能。

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

????️ 二、专栏推荐


  良心推荐: 下面的相关技术专栏还在免费分享哦,大家可以帮忙点点订阅哦!


  面试干货专栏


  常见开发问题专栏


  JAVA进阶知识专栏


  从0到1-全面深刻理解MySQL系列专栏

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

???? 三、Window系统FTP服务器搭建


 在搭建FTP服务器之前,先跟大家介绍下什么是FTP服务器,不然怕有些小伙伴可能只是有个模糊的概念,学习要尽量知其然,知其所以然,不要一知半解,否则自己用着也不踏实。



♈ 3.1、FTP服务器怎么玩


 在介绍前,我们先来看看搭建完FTP服务器后能怎么玩,不然总是有些小伙伴觉的文章太长看到一半就跑路了,错过就没有了!


 1、上传、下载小视频(共享文件),自定义权限控制,控制使用用户。


 2、实现某些业务场景下文件存储和文件下载(即文件服务器操作)。


 3、更多玩法等你开发,尽情发挥你的脑洞…



♉ 3.2、FTP(File Transfer Protocol,文件传输协议)


 先简单认识下FTP协议,FTP即文件传输协议的简称,它是TCP/IP协议簇中的一员,也是Internet上最早使用的协议之一,通过它可以实现电脑与电脑间对文件的各种操作(如文件的增、删、改、查、传送等),FTP的目标是提高文件的共享性,提供非直接使用远程计算机,实现计算机文件的相互操作,使存储介质对用户透明和可靠高效地传送数据。


 它是基于C/S(客户端/服务端)模型设计,工作在网络体系结构中的应用层,使用TCP进行传输,保证客户与服务器之间的连接是可靠的。


 支持的连接方式:


 FTP支持Standard (PORT方式,主动方式),Passive (PASV,被动方式)两种连接模式,连接的流程大致如下:


 1、FTP客户端发起FTP会话,与FTP服务器建立相应的连接,在会话期间,FTP会建立控制信息进程与数据进程两个连接。


 2、控制进程连接的用途: 用于传输FTP内部命令以及命令的响应等控制信息,无法进行数据传输。


 3、数据进程连接的用途: 用于客户端与服务端之间数据的传输,它是全双工的,可以支持双向数据传输,当数据传输完成后,它就会撤销然后回到FTP会话状态,直到控制连接进程也取消,退出整个FTP会话。


 PORT模式:


 FTP客户端会与服务端的TCP 21端口创建连接(控制连接),用于发送命令,当客户端需要接收数据时,会通过这个连接向服务端发送PORT命名,PORT命令中包含了会使用什么端口来接收服务端传输的数据,此时,服务端会通过TCP 20端口跟FTP客户端创建连接(数据连接)完成数据传输。


 Passive模式:


 FTP客户端会与服务端的TCP 21端口创建连接(控制连接),用于发送命令,当客户端需要接收数据时,会通过这个连接向服务端发送Pasv命名,服务器收到Pasv命令后,打开一个临时端口(端口号大于1023小于65535)并且通知客户端在这个端口上传送数据的请求,客户端连接FTP服务器此端口,然后FTP服务器将通过这个端口传送数据。


 说明:上面FTP协议知识介绍参考百度百科:FTP协议




♊ 3.3、FTP服务器


 了解了FTP协议,那FTP服务器就很容易理解了。FTP服务器就是支持FTP协议的服务器,我们平常可以在电脑上安装一个FTP工具就可实现与FTP服务器进行文件传输,FTP服务器常见分为:Windows FTP服务器和Linux FTP服务器。


 我们自己的电脑也可以当做一个FTP服务器,如Windows系统就可以通过自带的ISS管理器来搭建一个FTP服务器(本文案例就是使用这个),Linux系统最常用的借助vsftp软件做FTP服务器搭建。


 常见的例子: 在学校里上电脑课或者电脑考试时,老师会将上课题目或者考试题目放在某个文件夹中,让学生访问某个地址如:ftp://ip地址,通过这个地址每位同学看到老师共享的文件,下载的对应的试题完成考试。


 上面例子上过电脑课的同学应该都经历过(多么美好的学生时代),学生们访问到的其实就是老师搭建好的FTP服务器,老师提前将共享的文件上传到FTP服务器,学生们可以进行下载等操作。


 啰啰嗦嗦了一大堆,下面开始进行FTP服务器搭建和上传下载功能开发吧!



♋ 3.4、FTP服务器搭建


 安装环境: Win10


 步骤一: 安装FTP服务器支持和IIS管理平台。


 操作步骤: 电脑 => 控制面板 => 程序和功能 => 启用和关闭Windows功能 => Internet Infomation Services => 勾选【FTP服务器】和Web管理工具的【IIS管理控制台】=> 点击确定等待安装完成

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

步骤二: 打开IIS管理器


操作步骤: 电脑 => 控制面板 => 管理工具 => Internet Infomation Services(IIS)管理器

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

步骤三: 创建FTP服务器


操作1: 在某个盘符如D盘,创建一个FTP共享文件夹,用于FTP共享文件存放地址


步骤2: 右键IIS管理器左边导航栏 => 添加FTP站点

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

步骤3: 指定【站点名称】和【FTP共享的文件夹路径】

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

步骤4: 配置FTP服务器相关信息

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

步骤5: 配置FTP服务器验证和权限信息【注意:如果想通过程序实现上传、下载功能,身份验证中的基本选项需要勾选上,后面程序需要通过这个方式使用账号和密码登录到FTP服务器

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

步骤5: 到这一步,一个FTP服务器就已经搭建完成了,在IIS管理器还可以对搭建好的FTP服务器进行配置管理。

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

步骤6: 在同一网段的小伙伴可以通过:ftp://ftp配置的ip地址 格式访问到FTP服务器。

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

♌ 3.5、FTP服务器搭建出现的问题


 问题一: FTP按照流程搭建完成后,在同一网段的小伙伴却无法访问!


 原因: 可能是开启了防火墙拦截,需要在防火墙放行FTP服务器。


 解决: 电脑 => 控制面板 => Windows Defender 防火墙 => 允许应用通过Windows Defender 防火墙进行通信 => 勾选【FTP服务器】

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

???? 四、通过程序实现FTP文件的上传和下载


 通过上面的步骤,我们完成了FTP服务器的搭建,可以手动将文件上传到服务器,让在同一网段的小伙伴*从上面下载,但是,在实际业务开发中,我们需要的是通过程序实现上传和下载,而不是通过人为手动的方式,下面,就来看看如何实现吧。


 说明: 文章只贴出部分代码,全部案例代码已经上传到Gitee,需要者可直接访问下载(有帮助记得给个star呀):【实战-FTP服务器搭建,实现上传、下载】



???? 4.1、项目结构

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

???? 4.2、实现技术


 1、Apache下的commons-net依赖包: 它包含了一组网络实用工具和协议实现,支持的协议包括:FTP、NNTP、NTP、POP3(S)、SMTP(S)、Telnet、Whois等等,可以用它来实现文件的上传和下载功能。


 2、spring-boot-starter-web: web相关支持


 3、SpringBoot依赖: 快速构建JAVA项目

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        
        <dependency>
            <groupId>commons-net</groupId>
            <artifactId>commons-net</artifactId>
            <version>3.6</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

???? 4.2、相关配置

ftp:
  client:
    # ftp客户端文件使用的字符集
    charset: GBK
  server:
    # ftp服务器绑定ip或者域名
    hostname: 127.0.0.1
    # 端口
    port: 21
    # 连接ftp服务器的用户名
    username: user
    # 密码
    password: 123456
    # ftp的共享文件路径
    workingPath: D:/share/FTPServer
    # ftp服务器文件使用的字符集(用于上传包含中文名的文件和下载包含中文名的文件 - 很重要)
    charset: ISO-8859-1

???? 4.3、核心代码


  因为FTP服务器的上传、下载都是很通用的功能,所以博主封装成了一个工具类,有需要的小伙伴可以引入依赖和相关配置后,直接就可以使用该工具类。


  1、上传核心代码:

/**
     * 上传
     *
     * @return
     */
    public boolean upload(FtpUploadParam param) {
        boolean flag = false;
        FTPClient ftpClient = new FTPClient();
        //1 测试连接
        if (connect(ftpClient, param.getHostname(), param.getPort(), param.getUsername(), param.getPassword())) {
            try {
                //2 检查工作目录是否存在,不存在则创建
                if (!ftpClient.changeWorkingDirectory(param.getWorkingPath())) {
                    ftpClient.makeDirectory(param.getWorkingPath());
                }
                // 将文件编码成Ftp服务器支持的编码类型(FTP协议里面,规定文件名编码为iso-8859-1,所以目录名或文件名需要转码。)
                String fileName = new String(param.getSaveName().getBytes(ftpClientCharset), ftpServerCharset);
                // 3 上传文件
                if (ftpClient.storeFile(fileName, param.getInputStream())) {
                    flag = true;
                } else {
                    log.warn("FtpUtils uploadFile unsuccessfully!!");
                }
            } catch (IOException e) {
                log.error("FtpUtils upload in error:{}", e);
            } finally {
                disconnect(ftpClient);
            }
        }
        return flag;
    }

2、下载核心代码:

public boolean download(FtpDownloadParam param, String downloadFileName) {
        FTPClient ftpClient = new FTPClient();
        FileOutputStream out = null;
        //1 测试连接
        if (connect(ftpClient, param.getHostname(), param.getPort(), param.getUsername(), param.getPassword())) {
            try {
                File file;
                String localPath = param.getDownloadPath() + param.getFileName();
                out = new FileOutputStream(new File(localPath));
                //2 检查工作目录是否存在,不存在返回
//                if (!ftpClient.changeWorkingDirectory(param.getWorkingPath())) {
//                    return false;
//                }
                /*
                 * 打开FTP服务器的PASS模式(不记得FTP协议支持的模式请翻到文章第一阶段)
                 * 这个方法的意思就是每次数据连接之前,ftp client告诉ftp server开通一个端口来传输数据. 因为ftp
                 * server可能每次开启不同的端口来传输数据,但是在linux上,由于安全限制,可能某些端口没有开启,可能出现出现阻塞
                 */
                ftpClient.enterLocalPassiveMode();
                // 设置文件的传输方式
                ftpClient.setFileType(FTP.BINARY_FILE_TYPE);
                // 将文件编码成Ftp服务器支持的编码类型(FTP协议里面,规定文件名编码为iso-8859-1,所以目录名或文件名需要转码。)
                // 缺少编码转换会导致:从FTP服务器下载下来的文件是破损的,无法被打开
                boolean b = ftpClient.retrieveFile(new String(downloadFileName
                        .getBytes(clientCharset), serverCharset), out);
                out.flush();
            } catch (IOException e) {
                log.error("FtpUtils upload in error:{}", e);
                return false;
            } finally {
                try{
                    if(Objects.nonNull(out)){
                        out.close();
                    }
                }catch (Exception e){
                    log.error("FtpUtils upload in error:{}", e);
                }
                disconnect(ftpClient);
            }
        }
        return true;
    }

???? 4.4、执行结果


  1、演示代码:

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

2、上传文件到FTP服务器:

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

3、从FTP服务器下载文件到本地:

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

???? 4.5、开发过程中遇到的坑


 问题1、连接FTP服务器失败:


 问题描述: 在配置文件中指定了账号和密码,但是却连接失败。


 解决方案: 经过排查,发现是在搭建FTP服务器的时候只开启了匿名验证,没有开启基本验证(账号和密码登录的方式),只需要到IIS管理器中开启【基本验证】即可。


 解决步骤: 电脑 => 控制面板 => 管理工具 => IIS管理器 => 搭建好的FTP服务器 => FTP身份验证 => 开启基本身份验证模式。

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

问题2、FTP上传中文文件失败:


 问题描述: 选择文件名为英文的文件上传正常,但是选择中文的文件名上传却失败,错误信息:550-The filename, directory name, or volume label syntax is incorrect. 。


 解决方案: 经过排查,发现 FTP协议里面,规定文件名编码为iso-8859-1(注意:这个现在是在Windows搭建的FTP服务器出现的情况,如果是Linux环境的话,还需要查看linux默认的支持编码而定,但是需要将上传的文件名编码这个步骤是确定的),所以目录名或文件名需要转码。 所以在上传文件代码处你会看到下面的对文件解码再编码的代码:

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

问题3、调用FTPClient的切换目录方法changeWorkingDirectory总是失败


 原因和解决: FTP服务器搭建的时候需要我们制定共享的一个文件路径,当我们和FTP服务器建立连接后,默认就在这个目录下了,如果想切换到该目录下的子目录,不需要写全路径。


 示例: 如果FTP服务器共享的文件夹路径为:D:/ftpserver,此时我们需要切换到ftpserver文件夹下的子文件demo中,正确的写法:fTPClient.changeWorkingDirectory("demo") 而不是 fTPClient.changeWorkingDirectory(“D:/ftpserver/demo”)

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

问题4、从FTP服务器下载的文件破损,无法打开 


  问题描述: 尝试从FTP服务器下载有中文字符文件名的文件,成功下载到本地后却无法正常打开,提示已经破损。


  问题原因: 原因其实和第二个问题一样,是因为包含中文字符的文件名下载时需要进行编码转换,否则下载后无法被打开。

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

【实战-干货】手把手带你搭建自己的FTP服务器,实现文件上传、下载

???? 六、写在最后


 FTP服务器实战项目所有代码都已上传到Gitee,有需要可以自取(后面会传到CSDN免费下载),如果有帮助不要忘了star哦,Gitee项目直通车如下:【实战-FTP服务器搭建,实现上传、下载】


 推荐一下: 【技术圈子】中有免费面试资源、简历模板、年终汇报PPT、CSDN VIP下载资源等等,期待您的加入!【不是一个人的圈子,而是技术人的圈子】


 感兴趣者可以扫描下面二维码或者查看左边导航栏进入技术圈子。


上一篇:[算法系列之十七]数据压缩之位图


下一篇:【实战干货】SpringBoot整合多数据源