使用 goftp 库可快速实现 FTP 客户端，1. 连接认证：通过 ftp.Connect 和 Login 登录服务器；2. 文件操作：List 列目录，Stor 上传，Retr 下载；3. 目录切换：ChangeDir 切换路径；4. 被动模式与超时：默认 PASV 支持，可设置 DialWithTimeout 控制超时；5. 注意非加密传输，建议敏感场景用 SFTP/FTPS。
实现一个简单的 FTP 客户端在 Golang 中并不复杂，虽然标准库没有内置 FTP 支持，但我们可以借助第三方库来完成常见操作，比如文件上传、下载、目录切换等。本文将带你使用 goftp 库快速搭建一个轻量级 FTP 客户端，并演示常用功能的实践方法。
选择合适的 FTP 库
Go 标准库不包含 FTP 协议支持，因此需要引入外部包。目前较为成熟且维护良好的是 jfcote87/goftp，它基于早期的 goftp 包持续更新，兼容性好，API 简洁。
安装方式：
go get github.com/jfcote87/ftp
连接与身份认证
使用该库建立连接非常直观。你需要提供服务器地址、端口、用户名和密码。默认 FTP 端口为 21。
立即学习“go语言免费学习笔记（深入）”；
示例代码：
package main
<p>import (
"fmt"
"github.com/jfcote87/ftp"
)</p><p>func main() {
// 连接配置
addr := "ftp.example.com:21"
username := "your_username"
password := "your_password"</p><pre class='brush:php;toolbar:false;'>// 建立连接
conn, err := ftp.Connect(addr)
if err != nil {
panic(err)
}
defer conn.Quit()
// 登录
err = conn.Login(username, password)
if err != nil {
panic(err)
}
fmt.Println("登录成功")}
这里调用 Connect 创建 TCP 连接，再通过 Login 完成认证。记得用 defer conn.Quit() 关闭会话，释放资源。
常用文件操作实践
连接成功后，就可以执行常见的 FTP 操作了。以下是一些高频使用的功能示例。
列出远程目录内容
entries, err := conn.List(".")
if err != nil {
panic(err)
}
for _, entry := range entries {
fmt.Printf("%s %d %s\n", entry.Name, entry.Size, entry.Time)
}
上传本地文件
file, err := os.Open("localfile.txt")
if err != nil {
panic(err)
}
defer file.Close()
<p>err = conn.Stor("remote_file.txt", file)
if err != nil {
panic(err)
}
fmt.Println("上传完成")</p>下载远程文件到本地
resp, err := conn.Retr("remote_file.txt")
if err != nil {
panic(err)
}
defer resp.Close()
<p>outFile, err := os.Create("downloaded.txt")
if err != nil {
panic(err)
}
defer outFile.Close()</p><p>_, err = io.Copy(outFile, resp)
if err != nil {
panic(err)
}
fmt.Println("下载完成")</p>切换工作目录
err = conn.ChangeDir("/uploads")
if err != nil {
fmt.Println("无法进入目录:", err)
}
处理被动模式与超时设置
某些网络环境下（如 NAT 或防火墙），主动模式可能失败，建议启用被动模式（PASV）。这个库默认使用 PASV，无需额外设置。
你也可以自定义连接超时时间：
dialer := &ftp.DialWithTimeout{Timeout: 30 * time.Second}
conn, err := dialer.Dial(addr, ftp.SwitchUser(username, password))
这种方式更灵活，适合对连接稳定性要求较高的场景。
基本上就这些。通过引入 goftp 库，你可以轻松实现 FTP 客户端的核心功能。整个过程清晰、简洁，适合集成进自动化脚本或运维工具中。注意传输非加密，敏感环境建议升级到 SFTP 或 FTPS。
