当前位置： 首页 > news >正文

来一个复古的技术FTP

news 来源：原创 2025/5/17 6:03:53

背景

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

CentOS7安装FTP

步骤1：安装 vsftpd

# 更新系统软件包
sudo yum update -y# 安装 vsftpd
sudo yum install vsftpd -y

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

# 启动 vsftpd 服务
sudo systemctl start vsftpd# 设置开机自启
sudo systemctl enable vsftpd# 检查服务状态
sudo systemctl status vsftpd# 停止服务
sudo systemctl stop vsftpd# 重启服务
sudo systemctl restart vsftpd

步骤3：配置防火墙

# 开放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

cd /etc/vsftpd/cp vsftpd.conf vsftpd.conf_default
修改下列参数的值
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
以上配置可以直接用下面命令进行替换修改(一句一句执行)
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用户

# 创建用户（例如用户名为 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服务

# 启动 vsftpd 服务
sudo systemctl restart vsftpd

步骤7：客户端登录测试

ftp localhost
问题1：ftp客户端未安装

解决办法：
sudo yum install ftp
问题2：登录失败

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

 解决办法：
vi /etc/pam.d/vsftpd# 注释以下一行
#auth       required    pam_shells.so

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

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

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

扩展防火墙命令：

一、防火墙的开启、关闭、禁用命令
设置开机启用防火墙：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_enableNO是否允许匿名登录（YES/NO）
local_enableYES是否允许本地用户登录（YES/NO）
write_enableYES是否允许写入操作（上传/删除/重命名）
2. 权限与安全
配置项默认值说明
local_umask022本地用户创建文件的权限掩码（022表示文件权限为644，目录为755）
chroot_local_userNO是否将本地用户限制在其主目录（需配合allow_writeable_chroot=YES使用）
allow_writeable_chrootNO允许被chroot的用户目录可写（需chroot_local_user=YES）
3. 连接与日志
配置项默认值说明
dirmessage_enableYES显示目录欢迎消息（消息文件默认为.message）
xferlog_enableYES启用传输日志（记录上传/下载）
xferlog_file/var/log/vsftpd.log指定日志文件路径
xferlog_std_formatYES使用标准FTP日志格式（兼容wu-ftp格式）
connect_from_port_20YES主动模式时，强制数据连接从端口20发起
4. 超时设置
配置项默认值说明
idle_session_timeout600空闲会话超时时间（秒）
data_connection_timeout120数据连接超时时间（秒）
5. 被动模式（PASV）配置
配置项默认值说明
pasv_enableYES启用被动模式
pasv_min_port-被动模式端口范围下限（如30000）
pasv_max_port-被动模式端口范围上限（如31000）
pasv_address-服务器公网IP（NAT环境下需指定）
6. 高级选项
配置项默认值说明
listenNO以独立模式运行（YES=IPv4，NO=通过xinetd启动）
listen_ipv6NO启用IPv6监听
tcp_wrappersYES使用TCP Wrappers进行主机访问控制
userlist_enableNO启用用户列表控制（userlist_file指定文件）
userlist_denyYES用户列表中的用户是否被拒绝（YES=黑名单，NO=白名单）

FTP-DEMO Springboot3代码

maven需要引用的包：

    ......<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>......

配置文件：

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

代码部分：

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;}
}

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);}}}
}

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 然后查看内容

 

浏览器执行

http://localhost:8080/download

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

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

打完收工。

相关文章：

  • 交叉熵损失函数，KL散度， Focal loss
  • PHP：经典编程语言在新时代的持续活力与演进
  • 中exec()函数因$imagePath参数导致的命令注入漏洞
  • 自定义CString类与MFC CString类接口对比
  • 奥运数据可视化：探索数据讲述奥运故事
  • w~深度学习~合集3
  • PyTorch 的 F.scaled_dot_product_attention 返回Nan
  • 三格电子上新了——Modbus转IEC104网关
  • C42-作业练习
  • 速通RocketMQ配置
  • MySQL——3、数据类型
  • YOLOv8在单目向下多车辆目标检测中的应用
  • VsCode和AI的前端使用体验：分别使用了Copilot、通义灵码、iflyCode和Trae
  • CentOS系统中升级Python 3.12.2版本
  • 基于对抗性后训练的快速文本到音频生成：stable-audio-open-small 模型论文速读
  • 火语言RPA--EmpireV7下载发布
  • 【大模型面试每日一题】Day 20：大模型出现“幻觉”（Hallucination）的可能原因有哪些？如何从数据或训练层面缓解？
  • nosqlbooster pojie NoSQLBooster for MongoDB
  • 4.2.3 Thymeleaf标准表达式 - 5. 片段表达式
  • SAP ABAP 程序中归档数据读取方式
  • 乌克兰官员与法德英美四国官员举行会谈
  • “9+2”复式票，浦东购彩者拿下体彩大乐透1153万头奖
  • “女硕士失踪13年生两孩”案进入审查起诉阶段，哥哥：妹妹精神状态好转
  • 马上评｜让查重回归促进学术规范的本意
  • 古巴外长谴责美国再次将古列为“反恐行动不合作国家”
  • 违法违规收集使用个人信息，爱奇艺、轻颜等65款App被点名