docker端口冲突是指多个容器或宿主机进程尝试绑定同一宿主机端口导致启动失败，根本原因是tcp/ip协议要求端口在相同ip上独占监听；常见场景包括多selenium hub（如4444/5444/6444）映射冲突，解决需先用netstat或lsof检测占用、docker ps查映射，再通过错开宿主端口、限制绑定ip或批量生成独立compose配置来规避。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当多个用户同时通过Grok访问不同服务时，宿主机端口被重复绑定导致容器启动失败或请求被拒绝，必须为每个服务分配独立且不重叠的宿主机端口。
确认当前端口占用情况
执行 sudo netstat -tulnp | grep :4444 查看4444端口是否已被占用——这是Selenium Hub默认端口，也是Grok中多数自动化测试服务的常见入口点。
运行 docker ps --format "table {{.Names}}\t{{.Ports}}" 列出所有正在运行的容器及其映射端口，重点关注 【4444、5444、6444 这三个典型Hub端口是否已出现在输出中】。
若发现已有容器占用了目标端口，必须先停止它：docker stop selenium-chrome-hub，否则后续映射会直接报错“port is already allocated”。
为Grok多用户环境配置非冲突端口映射
方法一：手动指定错开的宿主机端口（推荐用于固定测试环境）
在 docker-compose.yml 中为每个服务定义唯一宿主端口：
- Chrome Hub 映射为 "4444:4444"
- Edge Hub 映射为 "5444:4444"
- Firefox Hub 映射为 "6444:4444"
这样三个浏览器实例可同时运行，用户分别访问 http://localhost:4444、http://localhost:5444、http://localhost:6444 即可互不干扰。
方法二：限制绑定IP提升安全性（适用于本地开发调试）
将映射改为 "127.0.0.1:4444:4444"，确保仅本机可访问，避免局域网内其他设备误连引发意外并发。
批量生成端口映射配置
第一步：准备端口列表文件 ports.txt，每行一个可用端口（如 4444、5444、6444、7444）
第二步：用 shell 脚本循环读取并注入到 compose 模板中：
while read port; do sed "s/PLACEHOLDER/$port/" template.yml >> grok-$port.yml; done
第三步：依次启动各配置：docker-compose -f grok-4444.yml up -d → docker-compose -f grok-5444.yml up -d → docker-compose -f grok-6444.yml up -d
这一步必须严格按顺序执行，【中间任意一个失败都会导致后续容器因端口被占而启动中断】。
