Docker容器中Gin服务localhost无法暴露及与0.0.0.0的差异咨询

我在启动Gin服务时，最初使用router.Run("localhost:8080")，执行docker run -p 8080:8080 <IMAGE_NAME>命令后，服务无法暴露到本地机器；改为router.Run("0.0.0.0:8080")后恢复正常。想知道在Docker容器环境中，localhost和0.0.0.0有何区别？我原本以为二者在本地开发时行为一致。

我的main函数代码如下：

func main() {
    fmt.Println("hello world")

    router := gin.Default()

    router.Use(middlewares.CORSMiddleware())
    router.POST("/api/notify", notify.NotifyHandler)

    // router.Run("localhost:8080")
    router.Run("0.0.0.0:8080")
}

核心区别 #

• localhost（对应127.0.0.1）：这是环回地址，服务仅绑定到容器内部的环回网络接口。此时只有容器自身的进程能访问该服务，包括宿主机在内的外部环境完全无法连接。用它启动服务相当于把服务限制在容器私有环境里，宿主机的端口映射自然无法生效。
• 0.0.0.0：这是通配地址，服务会绑定到容器的所有网络接口上。这样一来，宿主机通过docker run -p做的端口映射请求，就能正常被容器内的服务接收，这是Docker容器中对外暴露服务的正确配置。

本地开发与Docker环境的差异 #

本地开发时，服务和请求都运行在同一台机器的同一个网络栈下，不管用localhost还是0.0.0.0，请求都能通过环回接口或本地网卡抵达服务，所以看起来行为一致。但Docker容器拥有独立的网络栈，容器内的localhost仅指向容器自身，和宿主机的localhost完全是两个不同的网络节点，这就导致了二者在Docker环境下的行为差异。

内容的提问来源于stack exchange，提问作者jellypancake