# 端口映射看反了

**URL:** <https://buildx.do/t/%E7%AB%AF%E5%8F%A3%E6%98%A0%E5%B0%84%E7%9C%8B%E5%8F%8D%E4%BA%86/65>\
**Category:** 云栈探研\
**Tags:** 容器技术\
**Created:** [2026 年10 月 4 日 07:13 UTC](https://buildx.do/t/%E7%AB%AF%E5%8F%A3%E6%98%A0%E5%B0%84%E7%9C%8B%E5%8F%8D%E4%BA%86/65 "2026-10-04T07:13:00Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![huangning](https://buildx.do/letter_avatar_proxy/v4/letter/h/f07891/32.png) [@huangning](https://buildx.do/u/huangning)\
**Post date:** [2026 年10 月 4 日 07:13 UTC](https://buildx.do/t/%E7%AB%AF%E5%8F%A3%E6%98%A0%E5%B0%84%E7%9C%8B%E5%8F%8D%E4%BA%86/65/1 "2026-10-04T07:13:00Z")

</div>

「端口映射看反了」。

写成了容器里面的端口对到同一个数字，其实外面要另一个。先写明哪边是对外的。

收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。

镜像里不要留安装缓存，不要用 root 图省事。挂载为空时，把宿主机路径和容器路径都打印出来。端口先写明哪边对外。基础镜像版本写死，避免本地有的库线上没有。健康检查只用镜像里存在的命令。重启策略和数据卷一起看，机器重启后服务还在，才算配完。

给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。

复查「端口映射看反了」时按这四步，不靠感觉。用改之前的同一组输入再走一遍，结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名，确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。

补充记录。镜像和运行分开看。构建阶段清掉安装缓存，最终镜像不带编译工具，不用 root。运行阶段写明对外端口、数据卷、重启策略。挂载进去是空的，就把两边路径都打印出来，多半是多了一层目录。健康检查只用镜像里真有的命令，命令不存在会一直失败，看起来像应用没就绪。基础镜像版本写死，避免本地有的库在服务器上没有。两个容器不能互相等对方先启动，把真正的依赖写出来，另一个改成可以稍后连接。机器重启后服务还在、数据还在，这份配置才算完。

操作顺序。1. 写明基础镜像的版本，不写 latest。2. 构建末尾清掉安装缓存，最终阶段不带编译工具。3. 进程不用 root，缺目录就补权限。4. 启动时打印对外端口、挂载路径和实际读到的环境变量名。5. 健康检查改成镜像里存在的命令。6. 写上重启策略，重启机器后确认进程和数据都还在。7. 两个容器若互相等待，改成一个可稍后连接。路径或端口看反，会表现为空目录或连不上，先核对打印出来的值。

---

<div class="post-metadata">

**Author:** ![hetaoyu](https://buildx.do/letter_avatar_proxy/v4/letter/h/b38774/32.png) [@hetaoyu](https://buildx.do/u/hetaoyu)\
**Post date:** [2026 年10 月 4 日 08:08 UTC](https://buildx.do/t/%E7%AB%AF%E5%8F%A3%E6%98%A0%E5%B0%84%E7%9C%8B%E5%8F%8D%E4%BA%86/65/2 "2026-10-04T08:08:00Z")

</div>

端口先写明哪边是对外的。容器内端口和外面端口看反，是常见配置错误。
