安全拆分 host:port 应先用 net.SplitHostPort 剥离方括号和端口，再用 net.ParseIP 校验 IP；若为 nil 则需 DNS 解析，且必须判空防 panic。
Go 的 net 包处理 IP 地址，核心不是“万能解析”，而是“职责分离”：用 net.ParseIP 专做地址校验，用 net.SplitHostPort 专拆带端口的字符串，用 net.LookupIP 和 net.LookupAddr 分别做正向/反向 DNS 查询——混用或跳过判空，90% 的问题就出在这儿。
如何安全拆分 "host:port" 并提取有效 IP？
用户输入如 "[::1]:8080" 或 "192.168.1.10:3000"，不能直接丢给 net.ParseIP，它不认端口，更不认方括号。
-
net.SplitHostPort是唯一正确入口：它自动识别 IPv6 方括号，把"[::1]:8080"拆成 host ="::1"、port ="8080" - 拆出的
host再喂给net.ParseIP——这时才真正做地址合法性校验 - 若
net.ParseIP(host)返回nil，说明是域名（如"localhost"），不是 IP，后续需走net.LookupIP解析 - 永远检查错误：
if ip == nil { /* 拒绝监听或报错 */ }，否则监听"invalid:8080"会 panic
为什么遍历 net.Interfaces() 常拿到 127.0.0.1 或重复 IP？
因为系统有多个接口（Docker 虚拟网卡、Wi-Fi、以太网、vEthernet），而 net.Interfaces() 不区分主次，也不查路由表。
- 必须过滤：
iface.Flags & net.FlagUp != 0（只取启用状态）、!ip.IsLoopback()（剔除回环）、ip.To4() != nil（只留 IPv4） - 若有多张活跃网卡（比如笔记本同时连了 Wi-Fi 和 USB 网络共享），第一个非回环 IPv4 很可能不是你期望的出口 IP
- 真要拿“默认路由出口 IP”，得用 UDP 拨号法：
conn, _ := net.Dial("udp", "8.8.8.8:53")，再取conn.LocalAddr().(*net.UDPAddr).IP——它依赖系统路由决策，更贴近真实通信路径 - 离线环境该方法失效，务必 fallback 到接口遍历，并加日志提示“未联网，返回首个可用局域网 IP”
net.LookupIP 和 net.LookupAddr 别用反了
这是新手最高频误用：拿 net.LookupHost("1.1.1.1") 想查域名，结果返回 ["1.1.1.1"] ——它根本没查 PTR 记录，只是把 IP 当作主机名原样返回。
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
立即学习“go语言免费学习笔记（深入）”；
- 正向查域名 → IP：
net.LookupIP("google.com")，返回[]net.IP，记得用ip.To4()或ip.To16()过滤协议 - 反向查 IP → 域名：
net.LookupAddr("8.8.8.8")，查的是 DNS 的in-addr.arpaPTR 记录，失败常见原因是目标 IP 没配反向解析（比如云服务器默认不配） - 超时必须控制：
ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)，传给resolver.LookupIP(ctx, ...)，否则卡死在 DNS 请求上 - 自定义 DNS 服务器？用
&net.Resolver{PreferGo: true, Dial: ...}，别改系统/etc/resolv.conf——容器或 CI 环境不可控
IPv6 处理最容易忽略的三个细节
不是所有 "::1" 都能直接监听，也不是所有 "[::1]:8080" 都能被 ParseIP 接收。
-
net.ParseIP("[::1]")会失败 —— 方括号是SplitHostPort的语法糖，不是 IP 字符串的一部分；必须先剥离再解析 - 监听 IPv6 地址时，
net.Listen("tcp", "[::1]:8080")是合法的，但net.Listen("tcp", "::1:8080")会报"lookup ::1: no such host" -
ip.IsGlobalUnicast()比ip.To16() != nil更语义准确：它能排除fe80::/10（链路本地）、fc00::/7（ULA）等不可路由地址，避免监听了“通不了外网”的 IPv6
IP 处理最麻烦的从来不是写不对函数，而是边界情况太多：IPv6 方括号、域名和 IP 混输、多网卡路由歧义、DNS 反向记录缺失、离线 fallback……每个 if 分支背后，都对应一个真实部署时掉坑的瞬间。
