Go语言搭建SOCKS5代理服务器教程

本文深入剖析了用Go语言从零实现SOCKS5代理服务器的核心难点与最佳实践，涵盖协议握手（认证协商与目标地址协商）的精确字节解析、TCP流量安全中继的goroutine协同与超时控制、域名DNS解析必须在服务端完成的协议合规性要求，以及防止goroutine泄漏和连接堆积的关键防护机制；特别强调了ATYP=0x03场景下的响应码匹配、io.Copy双向同步、deadline设置时机等极易踩坑的实战细节，助你避开“connection reset by peer”等隐晦故障，写出健壮、高效、符合RFC标准的SOCKS5服务端。

SOCKS5 服务器核心要实现哪几个握手阶段

SOCKS5 协议不是“连上就转发”，它强制要求客户端先完成认证协商和目标地址协商两个阶段，跳过任一环节都会导致连接被拒绝或后续 connect 失败。Go 标准库没有内置 SOCKS5 服务端支持，必须手动解析二进制协议流。

实操建议：

• 第一阶段：读取客户端发来的 VERSION（1 字节） + NMETHODS（1 字节） + METHODS（N 字节），只接受 0x00（no auth）或按需实现 0x02（username/password），其他方法如 0x01（GSSAPI）应直接返回 0x01（failure）并关闭连接
• 第二阶段：收到 CONNECT 请求后，解析 VER、CMD（必须是 0x01）、RSV、ATYP（IPv4/IPv6/Domain），再根据 ATYP 提取对应长度的 DST.ADDR 和 DST.PORT；常见错误是把域名长度字节当成地址本身，导致解析出错
• 响应必须严格按协议返回成功包：5 字节固定头（0x05, 0x00, 0x00, 0x01, 0x00…）+ 绑定地址（通常填 0.0.0.0:0），少一个字节客户端就会卡住

如何用 net.Conn 安全地中继 TCP 流量

SOCKS5 的 CONNECT 命令本质是建立一条从客户端到目标服务的双向隧道，但直接用 io.Copy 并发复制两端会引发竞态和资源泄漏——比如一端提前断开时另一端还在写，触发 write: broken pipe。

实操建议：

• 用 sync.WaitGroup 管理两个 io.Copy goroutine，确保双方都结束才关闭连接
• 为每个 net.Conn 设置 SetDeadline（非 SetReadDeadline 单独设），避免某端静默挂起阻塞整个隧道
• 不要复用 net.Conn 对象：客户端连接、目标连接、本地监听连接三者生命周期独立，各自 defer Close()
• 示例关键逻辑：

  go func() { io.Copy(dst, src); dst.Close(); wg.Done() }()
  go func() { io.Copy(src, dst); src.Close(); wg.Done() }()
  wg.Wait()

为什么 DNS 解析要在代理服务器端做而不是客户端

SOCKS5 的 ATYP = 0x03 表示目标地址是域名，此时客户端只传了域名长度+域名字符串，不负责解析。如果在客户端解析再传 IP，就违背了协议语义，且会暴露真实目标（比如 DNS 查询被中间设备记录）。

实操建议：

• 收到 ATYP == 0x03 时，先读取 1 字节长度 L，再读 L 字节得到域名字符串，然后调用 net.LookupIP（注意处理 IPv4/IPv6 优先级）
• 若 LookupIP 失败，必须返回 0x05, 0x04（Host unreachable）响应，不能静默丢弃或 fallback 到本地 hosts
• 避免在主线程里同步解析：DNS 超时可能长达数秒，应设 context.WithTimeout 控制解析时间，超时即返回 0x05, 0x05（Connection refused）

如何防止 goroutine 泄漏和连接堆积

一个未加限制的 SOCKS5 服务器在面对扫描器或异常客户端时，会在握手失败前就创建大量 goroutine，最终耗尽内存或文件描述符。Go 的 net.Listener 默认不限流，必须主动控制。

实操建议：

• 用 semaphore（如 golang.org/x/sync/semaphore）限制并发连接数，Accept 后立即 Acquire，handshake 失败也要 Release
• 对每个连接设置 SetReadDeadline：在读 VERSION/NMETHODS 阶段，超时设为 5 秒；进入 CONNECT 阶段后可延长，但初始握手必须短
• 禁用 Keep-Alive：SOCKS5 是 per-request tunnel，连接用完即关，不要在 http.Transport 等上层复用底层 net.Conn
• 监听时用 net.Listen("tcp", addr) 后立即调用 SetDeadline 不生效，必须在 Accept() 返回的 net.Conn 上设

实际跑起来最难缠的，是 ATYP=0x03 时 DNS 解析失败的响应码匹配、以及两个 io.Copy 之间缺少信号同步导致的半关闭残留。这两处不细扣，日志里只会看到 “connection reset by peer” 却找不到源头。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Go语言搭建SOCKS5代理服务器教程》文章吧，也可关注golang学习网公众号了解相关技术文章。