Java使用SFTP上传文件到服务器的简单使用

什么是SFTP

SFTP（Secure File Transfer Protocol）是一种安全的文件传输协议，通过SFTP可以实现加密的文件传输。SFTP已经被广泛应用于网站部署、数据备份、文件同步等场景。

SFTP的工作原理

SFTP是基于SSH协议实现的，其工作原理与FTP比较类似，但是SFTP具有更高的安全性，因为其加密传输数据。SFTP的工作流程如下：

1. 客户端向服务器发送连接请求；
2. 服务器返回连接响应，并分配一个随机的端口号；
3. 客户端通过随机端口与服务器的SFTP服务器建立连接，通过该连接进行文件上传、下载、修改等操作；
4. 客户端与服务器的SFTP服务器断开连接。

Java如何使用SFTP上传文件

Java通过JSch库提供了对SFTP的支持，通过JSch库的封装，我们可以轻松地实现SFTP的上传、下载、删除等操作。以下是Java使用SFTP上传文件的简单步骤：

步骤一：导入JSch库

在你的Java项目中导入JSch库，具体方法请参考JSch官方文档。

步骤二：连接SFTP服务器

String SFTP_HOST = "your_sftp_host";
int SFTP_PORT = 22;
String SFTP_USERNAME = "your_sftp_username";
String SFTP_PASSWORD = "your_sftp_password";

// 创建SFTP会话
JSch jsch = new JSch();
Session session = null;
try {
    session = jsch.getSession(SFTP_USERNAME, SFTP_HOST, SFTP_PORT);
} catch (JSchException e) {
    e.printStackTrace();
}

// 设置SFTP登录密码
Properties properties = new Properties();
properties.put("StrictHostKeyChecking", "no");
session.setConfig(properties);
session.setPassword(SFTP_PASSWORD);

// 连接SFTP服务器
try {
    session.connect();
} catch (JSchException e) {
    e.printStackTrace();
}

// 打开SFTP通道
ChannelSftp channelSftp = null;
try {
    channelSftp = (ChannelSftp) session.openChannel("sftp");
    channelSftp.connect();
} catch (JSchException e) {
    e.printStackTrace();
}

步骤三：上传文件

String localFilePath = "/path/to/local/file";
String remoteFilePath = "/path/to/remote/file";

// 上传文件
try {
    channelSftp.put(localFilePath, remoteFilePath);
} catch (SftpException e) {
    e.printStackTrace();
}

步骤四：关闭SFTP连接

// 关闭SFTP通道
channelSftp.disconnect();

// 断开SFTP会话
session.disconnect();

示例

示例一：上传本地文件到远程服务器

String SFTP_HOST = "your_sftp_host";
int SFTP_PORT = 22;
String SFTP_USERNAME = "your_sftp_username";
String SFTP_PASSWORD = "your_sftp_password";
String localFilePath = "/path/to/local/file";
String remoteFilePath = "/path/to/remote/file";

JSch jsch = new JSch();
Session session = null;
try {
    session = jsch.getSession(SFTP_USERNAME, SFTP_HOST, SFTP_PORT);
} catch (JSchException e) {
    e.printStackTrace();
}

Properties properties = new Properties();
properties.put("StrictHostKeyChecking", "no");
session.setConfig(properties);
session.setPassword(SFTP_PASSWORD);

try {
    session.connect();
} catch (JSchException e) {
    e.printStackTrace();
}

ChannelSftp channelSftp = null;
try {
    channelSftp = (ChannelSftp) session.openChannel("sftp");
    channelSftp.connect();
} catch (JSchException e) {
    e.printStackTrace();
}

try {
    channelSftp.put(localFilePath, remoteFilePath);
} catch (SftpException e) {
    e.printStackTrace();
}

channelSftp.disconnect();
session.disconnect();

示例二：上传文件流到远程服务器

String SFTP_HOST = "your_sftp_host";
int SFTP_PORT = 22;
String SFTP_USERNAME = "your_sftp_username";
String SFTP_PASSWORD = "your_sftp_password";
InputStream inputStream = new FileInputStream(new File("/path/to/local/file"));
String remoteFilePath = "/path/to/remote/file";

JSch jsch = new JSch();
Session session = null;
try {
    session = jsch.getSession(SFTP_USERNAME, SFTP_HOST, SFTP_PORT);
} catch (JSchException e) {
    e.printStackTrace();
}

Properties properties = new Properties();
properties.put("StrictHostKeyChecking", "no");
session.setConfig(properties);
session.setPassword(SFTP_PASSWORD);

try {
    session.connect();
} catch (JSchException e) {
    e.printStackTrace();
}

ChannelSftp channelSftp = null;
try {
    channelSftp = (ChannelSftp) session.openChannel("sftp");
    channelSftp.connect();
} catch (JSchException e) {
    e.printStackTrace();
}

try {
    channelSftp.put(inputStream, remoteFilePath);
} catch (SftpException e) {
    e.printStackTrace();
}

channelSftp.disconnect();
session.disconnect();

注意事项

1. SFTP服务器需要开启SFTP服务；
2. SFTP服务器需要开放SFTP端口（默认为22）；
3. 上传文件的本地路径和远程路径必须是绝对路径；
4. 上传文件的本地路径必须是文件的完整路径，不能是相对路径；
5. 本地文件必须存在且可读；
6. 使用SFTP上传文件时，需要确保上传的文件大小不超过SFTP服务器的最大上传限制。

总结

本文介绍了Java使用SFTP上传文件到服务器的简单使用，并给出了两个具体的示例。使用JSch库可以轻松地实现SFTP文件上传、下载和删除等操作。SFTP作为一种安全的文件传输协议，其在网站部署、数据备份、文件同步等场景中应用广泛，因此熟练掌握SFTP的使用对于Java开发人员来说是十分有必要的。