windows上docker健康检查需区分linux/windows容器模式：linux容器用curl等工具配合healthcheck指令（返回0=健康）；windows容器须用powershell命令如test-netconnection，并设长start-period、避免localhost绑定问题。
windows 上用 docker 编写健康检查探针，核心是通过 healthcheck 指令在 dockerfile 中定义容器内服务的存活判断逻辑，docker 会定期执行该命令并根据返回码（0=健康，非0=不健康）更新容器状态。关键在于命令必须能在容器内部稳定运行，且 windows 容器与 linux 容器的 shell 环境、工具链不同，需针对性适配。
确认 Docker 运行模式和基础镜像类型
Windows 主机上运行 Docker，需先明确使用的是 Linux 容器模式 还是 Windows 容器模式（通过右下角 Docker Desktop 图标切换）。两者健康检查写法差异明显：
- Linux 容器（默认，推荐用于大多数应用）：基于 WSL2，可使用
curl、netstat、ps等常见工具，HEALTHCHECK命令写法与 Linux 一致 - Windows 容器（需启用 Windows 容器支持）：底层是 Windows Server Core 或 Nano Server，不带 bash/sh，只能用 PowerShell 或 Windows 命令（如
ping、Test-NetConnection），且需注意路径、权限和进程可见性
Linux 容器中的 HEALTHCHECK 写法（推荐）
适用于 .NET Core、Node.js、Python 等跨平台应用，Dockerfile 示例：
FROM node:18-alpine WORKDIR /app COPY package*.json ./ RUN npm ci --only=production COPY . . EXPOSE 3000 # 使用 curl 检查 HTTP 服务是否响应 2xx/3xx HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \ CMD curl -f http://localhost:3000/health || exit 1 CMD ["npm", "start"]
说明：
-
--interval：每 30 秒检查一次 -
--timeout：命令超时为 3 秒，超时即视为失败 -
--start-period：容器启动后前 5 秒内检查失败不计入重试 -
--retries：连续 3 次失败才标记为 unhealthy -
curl -f的-f参数确保 HTTP 非 2xx/3xx 状态码时返回非零退出码
Windows 容器中的 HEALTHCHECK 写法（需谨慎）
适用于 ASP.NET Framework、IIS 托管应用等，Dockerfile 示例（基于 mcr.microsoft.com/dotnet/framework/runtime:4.8）：
FROM mcr.microsoft.com/dotnet/framework/runtime:4.8
SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]
COPY ./app /app
EXPOSE 80
HEALTHCHECK --interval=30s --timeout=5s --start-period=60s --retries=3 \
CMD if (!(Test-NetConnection -Port 80 -ComputerName localhost -WarningAction SilentlyContinue).TcpTestSucceeded) { exit 1 }
注意事项：
- 必须显式设置
SHELL为 PowerShell，否则默认 cmd.exe 不支持Test-NetConnection - Windows 容器中进程隔离较严格，
localhost可能无法访问本容器内监听的服务（尤其 IIS），建议改用127.0.0.1或容器内 IP（可用Get-NetIPAddress -AddressFamily IPv4 | ? {$_.IpAddress -ne '127.0.0.1'} | % IpAddress获取） -
--start-period建议设长些（如 60s），因 Windows 容器启动慢，IIS 初始化耗时较长 - 避免依赖外部工具（如 curl.exe），Nano Server 镜像默认不含 curl；如需 HTTP 检查，可用
Invoke-WebRequest，但要注意 TLS 版本兼容性
验证和排查健康状态
构建并运行后，用以下命令观察结果：
-
docker ps：查看 STATUS 列是否显示healthy、unhealthy或starting -
docker inspect <container_id> | findstr Health</container_id>（Windows）或grep -A 10 Health（Linux/macOS）：查看详细健康状态、最近检查结果、失败日志 - 若始终 unhealthy，进入容器手动执行 HEALTHCHECK 命令（如
docker exec -it <id> curl -f http://localhost:3000/health</id>），确认端口是否真在监听、路径是否存在、权限是否足够
不复杂但容易忽略。
