来一个复古的技术FTP

窦再兴2025-05-17 13:59

背景

10年前的老代码，需要升级springboot框架，在升级过程中，测试业务流程里，有FTP的下载业务，不管测试环境如何测试，都没有成功，最后只能自己搭建一个FTP服务器，写一个ftp-demo来测试。记录一下过程，防止后续使用的时候在来一次。

CentOS7安装FTP

步骤1：安装 vsftpd

TypeScript 复制代码 
# 更新系统软件包
sudo yum update -y

# 安装 vsftpd
sudo yum install vsftpd -y

步骤2：启动服务并设置开机自启

TypeScript 复制代码 
# 启动 vsftpd 服务
sudo systemctl start vsftpd
     
# 设置开机自启
sudo systemctl enable vsftpd
     
# 检查服务状态
sudo systemctl status vsftpd

# 停止服务
sudo systemctl stop vsftpd

# 重启服务
sudo systemctl restart vsftpd

步骤3：配置防火墙

TypeScript 复制代码 
# 开放FTP端口（21和被动模式端口范围）
sudo firewall-cmd --zone=public --add-port=21/tcp --permanent
sudo firewall-cmd --zone=public --add-port=30000-31000/tcp --permanent
sudo firewall-cmd --zone=public --add-service=ftp --permanent

# 重新加载防火墙规则
sudo firewall-cmd --reload

步骤4：配置 vsftpd

TypeScript 复制代码 
cd /etc/vsftpd/

cp vsftpd.conf vsftpd.conf_default
修改下列参数的值
TypeScript 复制代码 
anonymous_enable=NO          #禁止匿名登录FTP服务器
local_enable=YES             #允许本地用户登录FTP服务器
listen=YES                   #监听IPv4 sockets
#listen_ipv6=YES             #关闭监听IPv6 sockets或者改为NO
chroot_local_user=YES        #全部用户被限制在主目录
chroot_list_enable=YES       #启用例外用户名单
chroot_list_file=/etc/vsftpd/chroot_list  #指定例外用户列表文件，列表中用户不被锁定在主目录
allow_writeable_chroot=YES
pasv_enable=YES
pasv_min_port=30000
pasv_max_port=31000
以上配置可以直接用下面命令进行替换修改(一句一句执行)
TypeScript 复制代码 
sed -i 's/anonymous_enable=YES/anonymous_enable=NO/' /etc/vsftpd/vsftpd.conf
sed -i 's/listen=NO/listen=YES/' /etc/vsftpd/vsftpd.conf
sed -i 's/listen_ipv6=YES/listen_ipv6=NO/' /etc/vsftpd/vsftpd.conf
sed -i 's/#chroot_local_user=YES/chroot_local_user=YES/' /etc/vsftpd/vsftpd.conf
sed -i 's/#chroot_list_enable=YES/chroot_list_enable=YES/' /etc/vsftpd/vsftpd.conf
sed -i 's/#chroot_list_file=/chroot_list_file=/' /etc/vsftpd/vsftpd.conf
echo "allow_writeable_chroot=YES" >> /etc/vsftpd/vsftpd.conf
# 被动模式
echo "pasv_enable=YES">> /etc/vsftpd/vsftpd.conf
echo "pasv_min_port=30001">> /etc/vsftpd/vsftpd.conf
echo "pasv_max_port=30010">> /etc/vsftpd/vsftpd.conf

步骤5：创建FTP用户

TypeScript 复制代码 
# 创建用户（例如用户名为 ftpuser，目录为 /home/ftpuser）
sudo useradd -m -d /home/ftpuser -s /sbin/nologin ftpuser

# 设置用户密码
sudo passwd ftpuser

# 确保用户目录权限正确
sudo chmod -R 750 /home/ftpuser
sudo chown -R ftpuser: /home/ftpuser


例如：
sudo useradd -m -d /home/douzi -s /sbin/nologin douzi
sudo passwd 123456
sudo chmod -R 750 /home/douzi
sudo chown -R douzi: /home/douzi

步骤6：重启vsftpd服务

TypeScript 复制代码 
# 启动 vsftpd 服务
sudo systemctl restart vsftpd

步骤7：客户端登录测试

TypeScript 复制代码 
ftp localhost
问题1：ftp客户端未安装
解决办法：
TypeScript 复制代码 
sudo yum install ftp
问题2：登录失败

找的截图，不要纠结里边的命令，只看红框部分即可

解决办法：
TypeScript 复制代码 
vi /etc/pam.d/vsftpd

# 注释以下一行
#auth       required    pam_shells.so

重启vsftpd服务，再进行登录提示:

再手动在/etc/vsftpd/目录下创建一下chroot_list文件即可

TypeScript 复制代码 
cd /etc/vsftpd/

touch /etc/vsftpd/chroot_list

然后重启vsftpd服务，登录即可正常：

登陆后默认为二进制传输模式

扩展FTP客户端命令：

dir ls cd pwd lcd(切换工作目录) mkdir rmdir get mget(下载多个文件) put mput(上传多个文件) rename delete mdelete(删除多个ftp文件) rmdir ascii,bin(切换传输模式) close(关闭链接) open(重连ftp) quit

扩展防火墙命令：

TypeScript 复制代码 
一、防火墙的开启、关闭、禁用命令
设置开机启用防火墙：systemctl enable firewalld
设置开机禁用防火墙：systemctl disable firewalld
启动防火墙：       systemctl start firewalld
关闭防火墙：       systemctl stop firewalld 或 systemctl stop firewalld.service
检查防火墙状态     systemctl status firewalld

二、使用firewall-cmd配置端口
查看防火墙状态： firewall-cmd --state
重新加载配置：   firewall-cmd --reload
查看开放的端口： firewall-cmd --list-ports
开启防火墙端口： firewall-cmd --zone=public --add-port=9200/tcp --permanent

扩展FTP配置项说明：

1. 基础访问控制
配置项 默认值 说明
anonymous_enable NO 是否允许匿名登录（YES/NO）
local_enable YES 是否允许本地用户登录（YES/NO）
write_enable YES 是否允许写入操作（上传/删除/重命名）
2. 权限与安全
配置项 默认值 说明
local_umask 022 本地用户创建文件的权限掩码（022表示文件权限为644，目录为755）
chroot_local_user NO 是否将本地用户限制在其主目录（需配合allow_writeable_chroot=YES使用）
allow_writeable_chroot NO 允许被chroot的用户目录可写（需chroot_local_user=YES）
3. 连接与日志
配置项 默认值 说明
dirmessage_enable YES 显示目录欢迎消息（消息文件默认为.message）
xferlog_enable YES 启用传输日志（记录上传/下载）
xferlog_file /var/log/vsftpd.log 指定日志文件路径
xferlog_std_format YES 使用标准FTP日志格式（兼容wu-ftp格式）
connect_from_port_20 YES 主动模式时，强制数据连接从端口20发起
4. 超时设置
配置项 默认值 说明
idle_session_timeout 600 空闲会话超时时间（秒）
data_connection_timeout 120 数据连接超时时间（秒）
5. 被动模式（PASV）配置
配置项 默认值 说明
pasv_enable YES 启用被动模式
pasv_min_port - 被动模式端口范围下限（如30000）
pasv_max_port - 被动模式端口范围上限（如31000）
pasv_address - 服务器公网IP（NAT环境下需指定）
6. 高级选项
配置项 默认值 说明
listen NO 以独立模式运行（YES=IPv4，NO=通过xinetd启动）
listen_ipv6 NO 启用IPv6监听
tcp_wrappers YES 使用TCP Wrappers进行主机访问控制
userlist_enable NO 启用用户列表控制（userlist_file指定文件）
userlist_deny YES 用户列表中的用户是否被拒绝（YES=黑名单，NO=白名单）

FTP-DEMO Springboot3代码

maven需要引用的包：

XML 复制代码 
    ......
    <parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>3.4.5</version>
		<relativePath /> <!-- lookup parent from repository -->
	</parent>    
    ......
    <properties>
		<java.version>17</java.version>
	</properties>
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>

		<dependency>
			<groupId>cn.hutool</groupId>
			<artifactId>hutool-all</artifactId>
			<version>5.8.35</version>
		</dependency>
		<dependency>
			<groupId>commons-net</groupId>
			<artifactId>commons-net</artifactId>
			<version>3.11.1</version>
		</dependency>
		<dependency>
			<groupId>com.jcraft</groupId>
			<artifactId>jsch</artifactId>
			<version>0.1.55</version>
		</dependency>
		<dependency>
			<groupId>org.projectlombok</groupId>
			<artifactId>lombok</artifactId>
		</dependency>
		<dependency>
			<groupId>ch.qos.logback</groupId>
			<artifactId>logback-core</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>
    ......

配置文件：

TypeScript 复制代码 
ftp:
  # 服务器地址
  host: 192.168.1.56
  # 端口号
  port: 21
  # 用户名
  userName: douzi
  # 密码
  password: 123456

代码部分：

java 复制代码 
package com.wd.ftp.config;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Configuration;
 
/**
 * ftp配置
 */
@Configuration
public class FtpConfig {
 
    /**
     * 服务器地址
     */
    private static String host;
 
    /**
     * 端口
     */
    private static Integer port;
 
    /**
     * 用户名
     */
    private static String userName;
 
    /**
     * 密码
     */
    private static String password;
 
    @Value("${ftp.host}")
    public void setHost(String host) {
        FtpConfig.host = host;
    }
 
    public static String getHost() {
        return host;
    }
 
    @Value("${ftp.port}")
    public void setPort(Integer port) {
        FtpConfig.port = port;
    }
 
    public static Integer getPort() {
        return port;
    }
 
    @Value("${ftp.userName}")
    public void setUserName(String userName) {
        FtpConfig.userName = userName;
    }
 
    public static String getUserName() {
        return userName;
    }
 
    @Value("${ftp.password}")
    public void setPassword(String password) {
        FtpConfig.password = password;
    }
 
    public static String getPassword() {
        return password;
    }
}
java 复制代码 
package com.wd.ftp.util;

import java.io.File;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

import org.apache.commons.net.ftp.FTPFile;

import com.wd.ftp.config.FtpConfig;

import cn.hutool.core.io.FileUtil;
import cn.hutool.core.util.StrUtil;
import cn.hutool.extra.ftp.Ftp;
import cn.hutool.extra.ftp.FtpMode;
import lombok.extern.slf4j.Slf4j;
 
/**
 * FTP服务工具类
 */
@Slf4j
public class FtpUtil {
    /**
     * 获取 FTPClient对象
     */
    private static Ftp getFTPClient() {
        try {
            if(StrUtil.isBlank(FtpConfig.getHost()) || FtpConfig.getPort() == null
                || StrUtil.isBlank(FtpConfig.getUserName()) || StrUtil.isBlank(FtpConfig.getPassword())) {
                throw new RuntimeException("ftp配置信息不能为空");
            }
 
            Ftp ftp = new Ftp(FtpConfig.getHost(),FtpConfig.getPort(),FtpConfig.getUserName(),FtpConfig.getPassword());
            //设置为被动模式，防止防火墙拦截
            ftp.setMode(FtpMode.Passive);
            return ftp;
        } catch (Exception e) {
            e.printStackTrace();
            log.error("获取ftp客户端异常",e);
            throw new RuntimeException("获取ftp客户端异常:"+e.getMessage());
        }
    }
    
    /**
     * 下载ftp服务器上的文件到本地
     * @param remoteFile    ftp上的文件路径
     * @param localFile     输出的目录，使用服务端的文件名
     */
    public static void download(String remoteFile, String localPath) {
        if(StrUtil.isBlank(remoteFile) || StrUtil.isBlank(localPath)) {
            return;
        }
 
        Ftp ftp = getFTPClient();
        try {
            if(!FileUtil.exist(localPath)){
                FileUtil.mkdir(localPath);
            }    
 
            File lFile = FileUtil.file(localPath);
            ftp.download(remoteFile, lFile);
        } catch (Exception e) {
            e.printStackTrace();
            log.error("FTP文件下载异常",e);
        } finally {
            //关闭连接
            try {
                if(ftp != null)  ftp.close();
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }
    }
 
    /**
     * 本地文件上传到ftp服务器上
     * @param remoteDir 上传的ftp目录
     * @param remoteFileName  保存到ftp服务器上的名称
     * @param localFile 本地文件全名称
     */
    public static boolean upload(String remoteDir, String remoteFileName, String localFile) {
        if(StrUtil.isBlank(remoteDir) || StrUtil.isBlank(remoteFileName) || StrUtil.isBlank(localFile)) {
            return false;
        }
        Ftp ftp = getFTPClient();
        try {
            File lFile = FileUtil.file(localFile);
            if(!lFile.exists()) {
                log.error("本地文件不存在");
                return false;
            }
 
            if(StrUtil.isBlank(remoteFileName)) {
                return ftp.upload(remoteDir, lFile);
            } else {
                return ftp.upload(remoteDir, remoteFileName, lFile);
            }
        } catch (Exception e) {
            e.printStackTrace();
            log.error("文件上传FTP异常",e);
            return false;
        } finally {
            //关闭连接
            try {
                if(ftp != null)  ftp.close();
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }
    }
 
    /**
     * 删除FTP服务器中的文件
     * @param remoteFile    ftp上的文件路径
     */
    public static boolean delFile(String remoteFile) {
        if(StrUtil.isBlank(remoteFile)) {
            return false;
        }
 
        Ftp ftp = getFTPClient();
        try {
            return ftp.delFile(remoteFile);
        } catch (Exception e) {
            e.printStackTrace();
            log.error("删除FTP服务器中的文件异常",e);
            return false;
        } finally {
            //关闭连接
            try {
                if(ftp != null)  ftp.close();
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }
    }
 
    /**
     * 遍历某个目录下所有文件，不会递归遍历
     * @param path    目录
     */
    public static List<String> listFile(String path) {
        List<String> listFile = new ArrayList<>();
        Ftp ftp = getFTPClient();
        try {
            FTPFile[] ftpFiles = ftp.lsFiles(path);
            for (int i = 0; i < ftpFiles.length; i++) {
                FTPFile ftpFile = ftpFiles[i];
                if(ftpFile.isFile()){
                    listFile.add(ftpFile.getName());
                }
            }
            return listFile;
        } catch (Exception e) {
            e.printStackTrace();
            log.error("遍历某个目录下所有文件异常",e);
            return null;
        } finally {
            //关闭连接
            try {
                if(ftp != null)  ftp.close();
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }
    }
}
java 复制代码 
package com.wd.ftp.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import com.wd.ftp.util.FtpUtil;
import com.wd.ftp.util.SftpUtil;

import jakarta.servlet.http.HttpServletRequest;

@RestController
public class FtpController {
	
	
	 /**
     * 下载ftp服务器上的文件到本地
     * @param rf    ftp上的文件路径
     * @param lp     输出的目录，使用服务端的文件名
     */
	@GetMapping("/download")
	public String download(
			@RequestParam(required = false, defaultValue = "1.xml") String rf, 
			@RequestParam(required = false, defaultValue = "/ftp/download/") String lp) {
		FtpUtil.download(rf, lp);
		return "success";
	}

}

可以根据FtpUtil扩展SftpUtil的代码，从而支持Sftp模式。

执行效果：

随便造一个1.xml上传ftp

cd /home/douzi 然后查看内容

浏览器执行

html 复制代码 
http://localhost:8080/download

windows下，代码在哪个盘执行，就会生成在哪个盘。

下载成功！其他上传，删除等功能自行试验。

打完收工。

相关推荐
purrrew2 分钟前
【Java ee初阶】IP协议
服务器·网络协议·tcp/ip
一叶屋檐4 分钟前
Neo4j 图书馆借阅系统知识图谱设计
服务器·数据库·cypher
愚润求学14 分钟前
【Linux】动静态库链接原理
linux·运维·服务器·开发语言·笔记
云攀登者-望正茂1 小时前
无缝部署您的应用程序：将 Jenkins Pipelines 与 ArgoCD 集成
运维·jenkins·argocd
wingaso1 小时前
[经验总结]删除gitlab仓库分支报错：错误：无法推送一些引用到“http:”
linux·数据仓库·git
独行soc1 小时前
2025年渗透测试面试题总结-阿里云[实习]阿里云安全-安全工程师（题目+回答）
linux·经验分享·安全·阿里云·面试·职场和发展·云计算
勤不了一点2 小时前
小白上手RPM包制作
linux·运维·服务器·软件工程
盛夏绽放2 小时前
Python字符串常用内置函数详解
服务器·开发语言·python
麦a~M了M3 小时前
ansible
linux·运维·ansible
zizle_lin3 小时前
优雅使用Gunicorn进程管理FastAPI
服务器·fastapi·gunicorn
热门推荐
01YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】02KGG转MP3工具|非KGM文件|解密音频03从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑04【SpeedAI科研小助手】2分钟极速解决知网维普重复率、AIGC率过高，一键全文降！文件格式不变，公式都保留的！05DeepSeek各版本说明与优缺点分析06Coze扣子平台完整体验和实践（附国内和国际版对比）07YOLOv5改进 | 添加CA注意力机制 + 增加预测层 + 更换损失函数之GIoU08苍穹外卖面试总结09yolov8，yolo11，yolo12 服务器训练到部署全流程 笔记10深度学习基础--ResNet网络的讲解，ResNet50的复现(pytorch)以及用复现的ResNet50做鸟类图像分类