最新

NAS 怎么排查 Docker 容器端口被占用起不来

容器起不来多半是端口撞了系统套件,看日志、查占用、改映射、重建容器四步搞定。

容器起不来,日志里最常见的一句就是端口已被占用。NAS 上的 80、443 这类端口往往早就被系统套件占着,装之前不查就会撞。下面按看日志、找占用、改端口、重建容器的顺序走一遍,绝大多数冲突都能定位。

入口在哪

  • 容器管理套件(有的叫 Docker,有的叫 Container Manager)里的容器详情与日志页。
  • 计划任务或 SSH 终端,用来执行查询命令。
  • 系统概览里的端口占用或服务列表,能看到套件占了哪些端口。
  • 开机自启设置,决定重建之后哪些服务会跟着起来。

具体步骤

  1. 打开容器日志,找到 address already in use 这类关键字,先把冲突的端口号记下来。
  2. SSH 登录后执行 ss -ltnp 列出所有监听端口与对应进程,或者用 lsof -i:端口号 精确查一个口。
  3. 判断占用者是系统套件、反向代理,还是另一个容器。前者优先改新容器的端口,别去动系统服务。
  4. 改映射关系:容器内部端口可以不动,把主机侧的端口换成空闲的即可。
  5. 映射端口不能热改,需要停止后重建容器。重建时把原来的数据卷和挂载路径原样带上。
  6. 建一张端口规划表,把常用服务的端口固定下来,避免下次再撞。

几个坑

  • 只改容器内部端口、不改主机映射,等于白改,外部照样连不上。
  • 用 host 网络模式的容器会直接抢占主机端口,和别的容器冲突时只能换模式或换端口。
  • 系统套件常年占着 80 与 443,反向代理也在这两个口上。装 Web 类应用前先确认,否则改了三个端口还是起不来。
  • 重建容器时漏了数据卷映射,看起来像数据全丢。数据还在卷里,先别删卷,重新挂上就能恢复;删了卷就真没了。
  • 防火墙或反向代理规则里写死了旧端口,改完容器还要同步改,否则依旧访问不了。

怎么验证

用 docker ps 看容器状态是否为运行中;用 ss -ltnp 确认新端口在监听且进程正确;在本机 curl 一次;再从局域网另一台机器用浏览器访问;最后翻一遍容器日志,确认不再出现端口相关的错误。

常见问题

端口冲突但查不到进程

多半是权限不够,或者进程在容器自己的命名空间里。用管理员权限重查一次,必要时按端口号全局搜索,再看是不是 host 模式的容器占了。

两个容器能共用 80 端口吗

不能同时绑定同一个端口。标准做法是前面放一个反向代理,按域名或路径分流到不同容器,每个容器用各自的高位端口。

改完端口客户端连不上

书签、手机 App、反向代理规则里的旧端口都要同步改,改完清一次浏览器缓存。若是套件走固定端口,还得在套件设置里一起改。

一句话总结:先看日志拿到端口号,再用命令找出占用者,改主机侧映射并带上数据卷重建,最后从另一台机器验证。