使用github.com/jlaffaye/ftp库可实现Go语言中FTP文件上传下载。1. 通过ftp.Dial连接服务器并Login登录;2. 调用Stor方法上传本地文件;3. 使用Retr和io.Copy下载远程文件;4. List列出目录内容;5. MakeDir创建目录,ChangeDir切换路径。完整示例包含上传、下载流程,适用于测试环境,生产环境需添加错误处理、重试机制,敏感数据建议采用SFTP或FTPS加密传输。

在 Golang 中实现 FTP 文件的上传和下载,虽然标准库没有内置 FTP 支持,但可以通过第三方库 github.com/jlaffaye/ftp 来轻松操作 FTP 服务。本文提供一个实用的 Golang FTP Client 示例,涵盖连接、文件上传、下载、目录操作等常见需求。
安装 FTP 第三方库
使用以下命令安装流行的 Go FTP 客户端库:go get github.com/jlaffaye/ftp
连接到 FTP 服务器
连接前需确保已获取 FTP 服务器地址、端口、用户名和密码。以下代码展示如何建立连接并登录:
package main
import (
"fmt"
"log"
"github.com/jlaffaye/ftp"
)
func main() {
// 连接到 FTP 服务器
conn, err := ftp.Dial("ftp.example.com:21")
if err != nil {
log.Fatal(err)
}
defer conn.Quit()
// 登录
err = conn.Login("username", "password")
if err != nil {
log.Fatal(err)
}
fmt.Println("成功连接并登录 FTP 服务器")
}
上传文件到 FTP 服务器
使用 Stor 方法将本地文件上传到远程路径:
// 打开本地文件
file, err := os.Open("localfile.txt")
if err != nil {
log.Fatal(err)
}
defer file.Close()
// 上传文件
err = conn.Stor("remotefile.txt", file)
if err != nil {
log.Fatal(err)
}
fmt.Println("文件上传成功")
从 FTP 下载文件
使用 Retrieve 方法将远程文件下载到本地:
// 下载远程文件
resp, err := conn.Retr("remotefile.txt")
if err != nil {
log.Fatal(err)
}
defer resp.Close()
// 创建本地文件
outFile, err := os.Create("downloaded_file.txt")
if err != nil {
log.Fatal(err)
}
defer outFile.Close()
// 写入本地
_, err = io.Copy(outFile, resp)
if err != nil {
log.Fatal(err)
}
fmt.Println("文件下载成功")
列出目录内容
使用 List 方法查看远程目录中的文件和子目录:
entries, err := conn.List("/")
if err != nil {
log.Fatal(err)
}
for _, entry := range entries {
fmt.Printf("%s %d %s\n", entry.Name, entry.Size, entry.Time)
}
创建目录与切换路径
常用操作包括创建目录和更改当前工作目录:
-
创建目录:
conn.MakeDir("/newdir") -
切换目录:
conn.ChangeDir("/newdir") -
返回上级目录:
conn.ChangeDirToParent()
完整示例:上传并下载文件
整合上述功能的一个小例子:
package main
import (
"io"
"log"
"os"
"github.com/jlaffaye/ftp"
)
func main() {
conn, err := ftp.Dial("ftp.example.com:21")
if err != nil {
log.Fatal(err)
}
defer conn.Quit()
err = conn.Login("your-username", "your-password")
if err != nil {
log.Fatal(err)
}
// 上传文件
file, err := os.Open("test.txt")
if err != nil {
log.Fatal(err)
}
defer file.Close()
err = conn.Stor("test.txt", file)
if err != nil {
log.Fatal(err)
}
// 下载文件
resp, err := conn.Retr("test.txt")
if err != nil {
log.Fatal(err)
}
defer resp.Close()
outFile, err := os.Create("downloaded_test.txt")
if err != nil {
log.Fatal(err)
}
defer outFile.Close()
_, err = io.Copy(outFile, resp)
if err != nil {
log.Fatal(err)
}
log.Println("上传和下载完成")
}
基本上就这些。通过 jlaffaye/ftp 库,Golang 可以方便地实现 FTP 客户端功能。注意处理连接超时、网络异常等场景,在生产环境中建议封装重试机制和日志记录。FTP 协议本身不加密,敏感数据建议使用 SFTP 或 FTPS。不过对于内部系统或测试环境,这种方式简单有效。










