net.ListenTCP在内网穿透中常被误用，因其被错误用于监听公网IP或0.0.0.0，而穿透本质是客户端主动连服务器再转发至内网服务；正确做法是服务器监听固定端口接收客户端连接，内网服务端不监听，客户端不调用net.ListenTCP监听本地端口。
为什么 net.ListenTCP 在内网穿透中常被误用
因为很多人直接拿它监听公网 IP 或 0.0.0.0，却忘了内网穿透本质是「反向代理」：客户端主动连服务器，服务器再把连接转给内网服务。监听本地端口不是错，但监听位置和时机错了就卡死。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 服务器端用
net.ListenTCP监听一个固定端口（如:8080），只收「穿透客户端」的连接请求，不暴露给外网服务 - 内网服务端不监听任何 TCP 端口，由穿透客户端主动建立隧道连接后，再把本地
127.0.0.1:3000的流量通过该隧道转发出去 - 别在客户端代码里写
net.ListenTCP("0.0.0.0:3000")—— 这会让客户端自己开服务，违背穿透逻辑
如何让 io.Copy 不丢包、不断流
io.Copy 看似简单，但在双向隧道中直接套用会导致一端关闭后另一端还卡着读，连接假死。根本原因是没处理 EOF 和 close 信号的时序。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 不要只写
io.Copy(dst, src)一次 —— 必须对 client→server 和 server→client 两个方向分别起 goroutine，并用sync.WaitGroup等待双方结束 - 任一方向复制完成（
io.Copy返回非 nil error 或 EOF），立刻调用dst.CloseWrite()（如果 dst 是net.Conn，需先转成net.Conn再调CloseWrite） - 避免用
io.Copy处理含心跳或长连接保活的协议；HTTP/1.1 的 keep-alive 可能导致连接迟迟不关闭，建议加超时控制
为什么 http.Transport 的 Proxy 字段对穿透无效
有人想复用 Go 标准库的 HTTP 客户端走穿透隧道，于是设 http.DefaultTransport.Proxy = http.ProxyURL(...)，结果发现请求还是直连 —— 因为 Proxy 只影响 outbound HTTP 请求的「第一跳」，而穿透需要的是底层 TCP 连接劫持。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- HTTP 场景下，穿透客户端应实现一个自定义
RoundTripper，在RoundTrip中手动建立隧道连接，再把*http.Request序列化发过去 - 更轻量的做法是改用
http.ServeMux+ReverseProxy：服务器端收到隧道数据后，解析出目标地址，用httputil.NewSingleHostReverseProxy转发到内网服务 - 别依赖
HTTP_PROXY环境变量 —— 它只对 go toolchain 或部分 stdlib 函数生效，对自定义连接无作用
调试时 connection refused 到底来自哪一层
这个错误最常出现在客户端已连上服务器，但服务器无法连通内网服务时。不是网络不通，而是穿透链路中间某段没打通：可能是客户端没正确把本地端口传给服务器、服务器 DNS 解析失败、或内网服务根本没起来。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在服务器日志里打全路径：收到客户端请求时，记录它声称要代理的目标地址（如
"127.0.0.1:3000"），再记录net.Dial的返回 error - 用
telnet 127.0.0.1 3000在服务器本机测试能否直连内网服务 —— 注意：必须在服务器机器上执行，不能在你本地 - 客户端发起连接前，检查本地
127.0.0.1:3000是否真有进程监听：lsof -i :3000（macOS/Linux）或netstat -ano | findstr :3000（Windows）
穿透最难的从来不是编码，而是确认每一跳的「谁连谁、连什么、有没有权限连」—— 日志里少打一行目标地址，排查就得绕半天。
