Go程序必须监听0.0.0.0:端口而非127.0.0.1或localhost,否则Docker端口映射后宿主机curl仍不通;正确写法为http.ListenAndServe("0.0.0.0:8080", handler)或简写":8080",并需配合-p参数及防火墙检查。

Go 程序监听地址必须是 0.0.0.0:端口号,不是 localhost 或 127.0.0.1
容器内 Go 服务若监听 localhost:8080 或 127.0.0.1:8080,即使 Docker 映射了端口,宿主机也 curl 不通。因为容器的 localhost 指向自身网络命名空间,不对外暴露。
正确写法只有这一种:http.ListenAndServe("0.0.0.0:8080", handler)。它让 Go 绑定到所有可用网络接口,Docker 的端口映射才能生效。
- 用环境变量更灵活:
addr := os.Getenv("ADDR"); if addr == "" { addr = "0.0.0.0:8080" } - 硬编码
localhost在本地开发可能“碰巧能跑”,但一进容器就失效 -
net.Listen("tcp", ":8080")是简写,等价于"0.0.0.0:8080",可直接用
Docker -p 参数决定外部是否能访问,Go 完全不参与映射逻辑
Docker 的端口映射是运行时行为,和 Go 代码无关。Go 只负责监听;docker run -p 才决定谁、从哪、能连上哪个端口。
-
docker run -p 8080:8080 myapp→ 宿主机8080转发到容器8080 -
docker run -p 127.0.0.1:8080:8080 myapp→ 仅本机可访问,更安全,适合开发调试 -
docker run -p 8080→ Docker 随机分配宿主机端口(查用docker port) -
EXPOSE在 Dockerfile 中只是元信息,不影响实际映射
监听多个端口时,main 函数不能提前退出
如果你在 Go 中启动多个 net.Listen goroutine(比如监听 14480–15000),但 main 函数立刻返回,整个进程会立即终止——所有监听器都被强制回收,日志可能还在打,但实际已无服务。
必须阻塞 main,常见做法是:
- 最简:
select{}永久挂起 - 生产建议:用
sync.WaitGroup管理监听 goroutine,并配合信号捕获(如os.Interrupt)实现优雅退出 - 别自己写
time.Sleep(10000 * time.Hour)—— 不够可靠,且难测试
安全连接本身不靠端口配置,而靠 TLS 和监听逻辑分离
Go 的 HTTPS 服务不是“换个端口就行”。http.ListenAndServeTLS 必须显式传入证书路径,且仍需绑定 0.0.0.0:443(或其它端口),否则同样无法被外部访问。
- 错误示范:
http.ListenAndServeTLS("localhost:443", cert, key, handler)→ 容器内不可达 - 正确写法:
http.ListenAndServeTLS("0.0.0.0:443", cert, key, handler) - 若用反向代理(如 Nginx、Traefik),Go 应退回到 HTTP + 内网监听(如
0.0.0.0:8080),TLS 终止由前置组件处理
真正容易被忽略的是:端口映射是三层协作结果——Go 监听地址、Docker -p 规则、宿主机防火墙/SELinux 设置,任意一层卡住都会表现为“连不上”。调试时得一层层确认,不能只盯 Go 代码。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











