使用 github.com/pkg/sftp 搭建最小可用 sftp 服务端需依赖 golang.org/x/crypto/ssh 处理 ssh 认证与连接，并通过 sftp.newserver 配合 sftp.withrootpath 绑定本地目录；必须设置 passwordauthcallback 或 publickeyauthcallback，启用 debugwriter 调试日志，且在 goroutine 中调用 serve() 启动服务。
用 github.com/pkg/sftp 搭建最小可用 SFTP 服务端
Go 本身不内置 SFTP 服务端支持，必须依赖第三方库；github.com/pkg/sftp 是目前最稳定、被广泛验证的选择。它基于 golang.org/x/crypto/ssh 构建，只负责 SFTP 协议层，SSH 连接和认证需自己处理。
实操建议：
- 先引入两个核心依赖：
golang.org/x/crypto/ssh（处理 SSH 连接与用户认证）和github.com/pkg/sftp（处理 SFTP 子系统） - 不要试图绕过 SSH 层直接启动 SFTP——SFTP 是 SSH 的子系统，没有合法的 SSH 连接，
sftp.NewServer会立即失败 - 监听端口用
net.Listen("tcp", ":2222")更安全，避免占用系统 22 端口需 root 权限 - 示例骨架中，
ssh.ServerConfig必须设置PublicKeyAuthCallback或PasswordAuthCallback，否则任何连接都会被拒绝
实现密码登录 + 本地文件系统映射
多数内部工具场景只需要简单密码登录和读写本机目录，无需完整用户体系。关键在于把用户凭据校验和文件系统路径绑定起来。
常见错误现象：
立即学习“go语言免费学习笔记（深入）”；
- 客户端报错
Unable to connect: EOF或Connection closed：大概率是ssh.ServerConfig缺少认证回调，或回调里没返回nil表示成功 - SFTP 客户端能登录但看不到文件 / 提示
Permission denied：sftp.FileSystem实现返回了空或错误的fs.File，或底层路径权限不对（如 Go 进程无权读取目标目录）
实操建议：
- 用
ssh.PasswordAuthCallback做明文密码比对（仅限测试环境），生产务必换成密钥或集成 PAM - 用
sftp.WithRootPath("/path/to/user/home")最简方式绑定根目录，避免手写FileSystem接口 - 确保运行 Go 程序的用户对目标目录有读写执行权限（
os.Chmod不解决所有问题，注意父目录的x权限）
sftp.Server 启动后卡住不响应？检查 goroutine 和连接生命周期
sftp.NewServer 返回的是一个可启动的服务对象，但它不会自动接管连接——你得手动调用 .Serve()，且该方法会阻塞。若没在单独 goroutine 中运行，整个程序就停在这儿了。
性能与兼容性影响：
- 每个 SSH 连接应启动一个独立
sftp.Server实例（不是全局单例），否则并发上传/下载会相互干扰 -
sftp.Server.Serve()内部会循环处理子请求，一旦 panic（比如文件操作触发空指针）会导致整个连接中断，建议用recover()包裹 handler - 客户端断连时，
sftp.Server.Close()不会自动触发，需监听ssh.Channel关闭或设超时
示例片段：
go func() {
defer sftpServer.Close()
if err := sftpServer.Serve(); err != nil && !strings.Contains(err.Error(), "use of closed network connection") {
log.Printf("SFTP serve error: %v", err)
}
}()
调试时看不到具体错误？加日志钩子和 ssh.ServerConfig.DebugWriter
默认情况下，SSH/SFTP 协议层的握手失败、子系统拒绝等细节全被吞掉，只留客户端模糊提示。必须主动开启调试输出才能定位真实原因。
容易踩的坑：
- 只给
ssh.ServerConfig设置DebugWriter，但忘了给sftp.Server传sftp.WithDebugWriter，导致 SFTP 协议交互仍无日志 - 日志输出到
os.Stderr被重定向或缓冲，建议用log.New(os.Stdout, "[sftp] ", 0)显式控制 - 某些客户端（如 FileZilla）在首次连接失败后会缓存失败原因，改完代码务必清空客户端历史连接或换端口测试
实操建议：
- 开发阶段，在
ssh.ServerConfig初始化时加上：DebugWriter: os.Stdout - 创建
sftp.Server时传入：sftp.WithDebugWriter(os.Stdout) - 关注日志中是否出现
subsystem request for sftp—— 没这行说明 SSH 层已拒绝，问题出在认证或配置
真正麻烦的从来不是启动服务，而是让不同客户端（WinSCP、Cyberduck、OpenSSH sftp）在各种认证模式下都走通。哪怕只支持密码登录，也要测一遍空密码、特殊字符密码、超长密码的响应行为——这些边界在 pkg/sftp 的日志里藏得很深。
