NAS 怎么排查 Docker 容器端口被占用起不来
容器起不来多半是端口撞了系统套件,看日志、查占用、改映射、重建容器四步搞定。
容器起不来,日志里最常见的一句就是端口已被占用。NAS 上的 80、443 这类端口往往早就被系统套件占着,装之前不查就会撞。下面按看日志、找占用、改端口、重建容器的顺序走一遍,绝大多数冲突都能定位。
入口在哪
- 容器管理套件(有的叫 Docker,有的叫 Container Manager)里的容器详情与日志页。
- 计划任务或 SSH 终端,用来执行查询命令。
- 系统概览里的端口占用或服务列表,能看到套件占了哪些端口。
- 开机自启设置,决定重建之后哪些服务会跟着起来。
具体步骤
- 打开容器日志,找到 address already in use 这类关键字,先把冲突的端口号记下来。
- SSH 登录后执行
ss -ltnp列出所有监听端口与对应进程,或者用lsof -i:端口号精确查一个口。 - 判断占用者是系统套件、反向代理,还是另一个容器。前者优先改新容器的端口,别去动系统服务。
- 改映射关系:容器内部端口可以不动,把主机侧的端口换成空闲的即可。
- 映射端口不能热改,需要停止后重建容器。重建时把原来的数据卷和挂载路径原样带上。
- 建一张端口规划表,把常用服务的端口固定下来,避免下次再撞。
几个坑
- 只改容器内部端口、不改主机映射,等于白改,外部照样连不上。
- 用 host 网络模式的容器会直接抢占主机端口,和别的容器冲突时只能换模式或换端口。
- 系统套件常年占着 80 与 443,反向代理也在这两个口上。装 Web 类应用前先确认,否则改了三个端口还是起不来。
- 重建容器时漏了数据卷映射,看起来像数据全丢。数据还在卷里,先别删卷,重新挂上就能恢复;删了卷就真没了。
- 防火墙或反向代理规则里写死了旧端口,改完容器还要同步改,否则依旧访问不了。
怎么验证
用 docker ps 看容器状态是否为运行中;用 ss -ltnp 确认新端口在监听且进程正确;在本机 curl 一次;再从局域网另一台机器用浏览器访问;最后翻一遍容器日志,确认不再出现端口相关的错误。
常见问题
端口冲突但查不到进程
多半是权限不够,或者进程在容器自己的命名空间里。用管理员权限重查一次,必要时按端口号全局搜索,再看是不是 host 模式的容器占了。
两个容器能共用 80 端口吗
不能同时绑定同一个端口。标准做法是前面放一个反向代理,按域名或路径分流到不同容器,每个容器用各自的高位端口。
改完端口客户端连不上
书签、手机 App、反向代理规则里的旧端口都要同步改,改完清一次浏览器缓存。若是套件走固定端口,还得在套件设置里一起改。
一句话总结:先看日志拿到端口号,再用命令找出占用者,改主机侧映射并带上数据卷重建,最后从另一台机器验证。