Java把文件复制到另一个服务器，核心思路是基于网络传输协议，最主流方案是使用FTP或SFTP类库，分别对应Apache Commons Net和JSch，如果追求安全性，直接选SFTP；如果追求兼容性，FTP仍是常见选择。
使用FTP协议实现文件复制到远程服务器
FTP是历史最悠久的文件传输协议,在Java生态中，Apache Commons Net库提供了完整的FTP客户端实现，这个方案适合内部网络环境或对传输速度要求较高的场景，因为FTP在传输大文件时效率较高。
搭建FTP客户端的基本步骤
- 引入依赖：Maven项目添加commons-net坐标。
- 创建FTPClient对象,连接服务器地址和端口。
- 登录验证,传入用户名和密码。
- 设置传输模式：被动模式（PASV）能绕过大部分防火墙限制，建议主动调用
enterLocalPassiveMode()。 - 设置文件类型：二进制传输用
setFileType(FTP.BINARY_FILE_TYPE)，文本文件可用ASCII。 - 打开本地文件输入流,调用
storeFile()方法，传入远程路径和流。 - 传输完成后关闭流,登出并断开连接。
需要留意的几个坑
- 中文文件名乱码：FTP协议默认使用ISO-8859-1编码，如果文件名包含中文，需要设置控制编码为UTF-8，调用
setControlEncoding("UTF-8")，并且服务器端也要支持。 - 被动模式 vs 主动模式：多数情况下被动模式能正常工作，如果连接超时或数据通道失败，切换尝试主动模式。
- 目录不存在：
storeFile()不会自动创建目录，需要先用makeDirectory()递归创建。 - 防火墙干扰：FTP的数据端口是动态分配的，容易被安全策略拦截，建议在局域网内使用。
代码骨架演示
FTPClient ftp = new FTPClient();
ftp.connect("192.168.1.100", 21);
ftp.login("user", "pass");
ftp.enterLocalPassiveMode();
ftp.setFileType(FTP.BINARY_FILE_TYPE);
try (InputStream in = new FileInputStream("local.txt")) {
boolean done = ftp.storeFile("/remote/remote.txt", in);
if (done) System.out.println("上传成功");
}
ftp.logout();
ftp.disconnect();
这个方案在网上有大量java文件复制到远程服务器代码示例，稳定可靠，但明文传输密码和内容，不适合公网环境。
基于SFTP的Java文件上传方案哪个更安全
SFTP（SSH File Transfer Protocol）本质是SSH协议的一部分，所有通信都经过加密，是目前公网传输文件的首选，Java中常用的库是JSch，它实现了SSH2协议，能够处理文件上传、下载、目录操作等。
安全性与效率的权衡
- 加密带来的开销：每次传输都需要握手和加密，小文件传输时延迟明显，但大文件传输时影响不大。
- 端口复用：SFTP使用SSH端口（默认22），一台服务器只需要开放一个端口就能同时管理远程登录和文件传输，降低了攻击面。
- 密钥认证：支持密码和密钥对两种方式，生产环境建议使用密钥认证，避免密码泄露。
使用JSch实现SFTP上传的关键步骤
- 添加JSch依赖。
- 创建Session对象,设置主机、端口、用户名。
- 配置认证信息：
session.setPassword()或加载私钥。 - 设置一些连接参数,比如
StrictHostKeyChecking可以设为no（测试环境）或加载known_hosts。 - 连接Session,打开SFTP通道：
ChannelSftp channel = (ChannelSftp) session.openChannel("sftp")。 - 调用
channel.put()方法，传入本地输入流和远程路径。 - 操作完成后关闭通道和Session。
对比：FTP与SFTP到底选哪个
| 对比维度 | FTP（Commons Net） | SFTP（JSch） |
|---|---|---|
| 传输加密 | 明文，可被嗅探 | 加密，安全 |
| 认证方式 | 密码（明文） | 密码或密钥 |
| 防火墙友好度 | 被动模式可，但数据端口随机 | 单一端口，易于穿透 |
| 传输速度 | 略快，无加密开销 | 略慢，有加密开销 |
| 易用性 | 代码简单，库成熟 | 代码稍复杂，但可控性强 |
| 适用场景 | 内网、信任环境 | 公网、跨网络、安全要求高 |
行业共识认为，凡是涉及公网传输或敏感数据，优先选择SFTP，如果只是在公司内部服务器之间转移日志文件，FTP也能胜任。
其他Java文件传输方案选型
除了FTP和SFTP,根据实际场景还有一些备选方案，它们在特定需求下可能更合适。
基于HTTP的多部分上传
如果目标服务器提供了HTTP接口,可以用HttpURLConnection或Apache HttpClient发送multipart/form-data请求，这种方式最简单，不需要额外开启FTP或SSH服务，但需要服务端配合，适合Web应用之间的文件传递，比如用户上传头像到文件服务器。
使用Java NIO自建传输通道
当标准协议无法满足需求时,比如需要自定义传输逻辑或加密方式，可以基于Socket或ServerSocket实现，Java NIO的Channel和Buffer模型能高效处理大文件，但开发成本高，需要处理粘包、断点续传、异常恢复等细节，只有极少数特殊场景才值得自己造轮子。
借助云存储SDK
如果目标服务器是简米云OSS、酷番云COS、AWS S3等对象存储，可以直接使用官方SDK，这些SDK内部封装了签名、分片、并发上传等逻辑，上传速度很快，而且成本可控，很多公司现在把文件直接存到云端，再用Java从应用服务器上传到云存储，替代了传统的FTP方案。
实战：Java文件传输代码示例
这里提供一份基于SFTP的完整示例,包含连接、上传、断开三个核心步骤，适合直接复制到项目中修改。
import com.jcraft.jsch.;
public class SftpUploader {
public static void upload(String host, int port, String user, String password,
String localFile, String remoteDir) {
Session session = null;
ChannelSftp channel = null;
try {
JSch jsch = new JSch();
session = jsch.getSession(user, host, port);
session.setPassword(password);
// 测试环境跳过主机密钥检查，生产环境请配置known_hosts
session.setConfig("StrictHostKeyChecking", "no");
session.connect(30000);
channel = (ChannelSftp) session.openChannel("sftp");
channel.connect(10000);
// 如果远程目录不存
在，自动创建
try {
channel.cd(remoteDir);
} catch (SftpException e) {
channel.mkdir(remoteDir);
channel.cd(remoteDir);
}
try (FileInputStream fis = new FileInputStream(localFile)) {
channel.put(fis, localFile.substring(localFile.lastIndexOf(File.separator) + 1));
}
System.out.println("文件传输完成");
} catch (Exception e) {
e.printStackTrace();
} finally {
if (channel != null) channel.disconnect();
if (session != null) session.disconnect();
}
}
}
这个示例处理了目录不存在的情况,并设置了连接超时，避免长时间阻塞，实际使用时，密码和主机信息建议从配置文件读取，不要硬编码。
常见问题与解答
Java复制文件到服务器时中文文件名乱码如何解决？
FTP下,需要显式设置控制编码为UTF-8，并确保服务器端也使用UTF-8编码，SFTP通常不会出现乱码，因为传输基于UTF-8，但如果服务器系统编码不一致，建议在远程路径中使用英文名称，或者对文件名进行URL编码。
如何提高大文件传输速度？
- 使用缓冲流：
BufferedInputStream包裹文件流，减少磁盘I/O次数。 - 调整FTP或SFTP的缓冲区大小,例如
ftp.setBufferSize(10241024)。 - 启用并发传输：将大文件分片，用多线程同时上传，最后在服务器端合并，Apache Commons Net本身不支持分片，需要自己实现或使用第三方库。
- 选择更快的协议：FTP在非加密场景下通常比SFTP快，因为少了加密计算。
选择FTP还是SFTP主要看什么？
主要看网络环境和安全要求,如果两台服务器都在同一个可控内网，且没有安全合规要求，FTP简单易用，如果涉及公网、跨机房、或需要传输敏感数据，必须选择SFTP，要考虑目标服务器是否已开通SSH服务，如果只开了FTP端口，那就只能选FTP。java文件复制到远程服务器时应优先确认服务器支持哪些协议。
无论是哪种方案,核心都是通过可靠的网络连接，将本地文件流写入远程文件系统，先把协议选对，再按步骤实现，传输过程就不会出大问题。
首发原创文章，作者：王坚，如若转载，请注明出处：https://test.idctop.com/article/513908.html
