必须用docker-compose.yml显式隔离网络、端口和启动参数，否则多实例会端口冲突、环境变量污染、DNS解析失败、日志卷混杂；单靠docker run易出错且无法统一管理服务发现与依赖关系。
能部署，但必须用 docker-compose.yml 显式隔离网络、端口和启动参数，否则多个实例会抢 :8080 或共享同一份环境变量，直接崩。
为什么不能只用 docker run 反复起多个容器？
单靠 docker run 启动多个 Go 实例，最容易踩的坑是端口冲突和环境变量污染：
- 没加
-p映射时，容器内都监听:8080，但宿主机无法区分谁是谁；加了又容易手动写错，比如重复映射-p 9001:8080和-p 9001:8080 - Go 程序若读取
PORT环境变量启动，所有容器若没显式指定-e PORT=9001，就会全用默认值，导致监听失败或覆盖 - 没有统一网络，实例间无法通过服务名通信（比如一个实例要调另一个健康检查接口）
- 日志、卷挂载路径若不区分，多个实例写同一个
/app/logs，内容混在一起根本没法查
docker-compose.yml 必须声明的四个字段
部署多个长连接 Go 实例，docker-compose.yml 里这四点漏一个就大概率启动失败：
-
container_name：必须唯一，比如go-ws-01、go-ws-02，避免 Docker 自动分配随机名造成管理混乱 -
ports：宿主机端口必须不同，容器内端口可一致（如都用8080），例如- "9001:8080"和- "9002:8080" -
environment：至少传PORT和INSTANCE_ID，让 Go 程序知道自己监听哪端口、叫什么名字，方便日志打标和 metrics 上报 -
networks：定义共用的自定义 bridge 网络（如ws-net），而不是用默认bridge—— 否则容器间 DNS 解析失败，curl http://go-ws-01:8080/health会报Could not resolve host
Go 程序自身要适配多实例启动
光靠 Docker 配置不够，Go 代码里也得配合，否则多个实例可能争抢同一份资源：
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 监听地址必须用
fmt.Sprintf(":%s", os.Getenv("PORT"))，不能硬写":8080" - 长连接管理（如用
map[string]*websocket.Conn）不能依赖全局变量存状态——每个实例是独立进程，状态不互通；需把连接元数据下沉到 Redis 或 etcd - 心跳检测、断连重试逻辑里，如果用了本地定时器（如
time.Ticker）触发清理，得确保 tick 间隔在多实例下不会因时间偏移引发误删 - 若用
log.Printf打日志，建议加前缀：log.Printf("[%s] connected: %s", os.Getenv("INSTANCE_ID"), clientIP)，不然日志流混在一起没法归因
验证多实例是否真正隔离
跑起来后别急着写业务，先做三件事确认隔离有效：
- 执行
docker-compose ps，看所有State是Up，且Ports列显示不同宿主机端口 - 进任意一个容器：
docker exec -it go-ws-01 sh，然后netstat -tlnp | grep :8080，确认只监听本容器内端口，没被其他实例劫持 - 从宿主机分别 curl：
curl http://localhost:9001/health和curl http://localhost:9002/health，两个都返回200 OK且instance_id字段不同
长连接场景下，最常被忽略的是连接保活超时配置和 TCP keepalive 参数——Docker 默认不透传这些，得在 Go 代码里显式设置 SetKeepAlive 和 SetKeepAlivePeriod，否则 NAT 网关或云厂商 SLB 会在 300 秒无流量后静默断开连接。
