docker 容器内 java socket 客户端需通过特殊网络配置（如 `host-gateway` 映射）才能访问宿主机上运行的 socket 服务（如 windows 上的 9001 端口），无需端口映射或绑定冲突。
在 Docker 容器中运行 Java Socket 客户端时，若目标服务（如 Socket 服务器）直接运行在宿主机（Windows/macOS/Linux）而非容器内，客户端不能简单使用 localhost:9001 —— 因为容器内的 localhost 指向容器自身，而非宿主机。此时，关键在于让容器能可靠解析并路由到宿主机网络栈。
✅ 正确做法是利用 Docker 内置的 host-gateway 机制：
从 Docker 20.10+（Desktop for Windows/macOS 默认支持）起，可通过 --add-host 参数将一个自定义主机名（如 host.docker.internal）解析为宿主机的内部 IP 地址：
docker run \ --add-host=host.docker.internal:host-gateway \ -it your-java-client-image
随后，在 Java 客户端代码中，直接连接该主机名与目标端口即可：
String serverHost = "host.docker.internal"; // 不是 "localhost"！
int serverPort = 9001;
try (Socket socket = new Socket(serverHost, serverPort)) {
// 发送/接收数据...
System.out.println("Connected to host server on port 9001");
}⚠️ 注意事项：
通过 `dcc-mcp-cli` 命令行工具控制实时 DCC 主机（Maya、Blender、Houdini、Photoshop、3ds Max 以及自定义的 Studio 工具）。 针对 ClawHub、OpenClaw、Cursor、Claude 和支持 shell 的 Agent 主机：验证网关健康状态、列出已注册的 DCC 实例、搜索工具、检查 Schema、调用工具——全程无需直接编写或发送 MCP 请求。 若系统中未安装 `dcc-mcp-cli`，需先征得用户同意，再从 GitHub
- 无需端口映射（-p）：-p 9001:9001 是将宿主机端口暴露给外部，而此处客户端主动出向连接宿主机，故不需也不应绑定该端口（避免冲突）；
- Windows 用户确认防火墙：确保 Windows 防火墙允许入站连接至 9001（尤其是对 127.0.0.1 或 0.0.0.0 的监听）；
- 服务器监听地址：服务端 ServerSocket 应绑定 0.0.0.0:9001 或 InetAddress.getByName(null)（即通配地址），而非仅 127.0.0.1，否则可能拒绝来自容器的连接；
- 旧版 Docker 替代方案：若环境不支持 host-gateway（如较老 Linux Docker），可临时用 --network=host（Linux 专用，不推荐用于生产）或手动指定宿主机真实 IP（如 192.168.x.x），但后者缺乏可移植性。
总结：容器内 Java Socket 客户端连接宿主机服务的核心不是“端口转发”，而是“网络可达性”。借助 host.docker.internal + host-gateway 是跨平台、安全且 Docker 原生推荐的标准实践，既规避了端口占用问题，又保持了开发与部署的一致性。
立即学习“Java免费学习笔记（深入）”；
