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");
}
⚠️ 注意事项：
Windows 桌面自动化技能，支持鼠标控制（移动/点击/拖拽/滚轮/截图）、键盘输入（文字输入/按键/组合键）、窗口管理（查找/聚焦/最大化/最小化/关闭/移动）、截图并发送文件。提供两种截图方式：Python pyautogui 截图（集成在自动化流程中）和 PowerShell + .NET 零依赖截图（支持区域截图和多显示器）。当用户需要自动化 Windows 桌面操作、控制鼠标键盘、管理窗口、执行 GUI 自动化任务、截图发送文件时使用。
- 无需端口映射（-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免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
