如何配置CURL自定义成功判定规则适配Docker HEALTHCHECK场景？

完全可以通过curl参数搭配简单shell逻辑实现你要的所有需求，以下是对应不同场景的实现方案：

方案1：仅将连接级错误判定为失败 #

直接去掉原有命令中的--fail参数即可，curl默认只有在网络层错误（包括连接拒绝、超时、DNS解析失败等）时才会返回非0状态码，只要成功和服务器建立连接、拿到HTTP响应（不管状态码是401还是其他）都会返回0，刚好匹配你的第二个需求：

HEALTHCHECK --interval=5s --timeout=3s --retries=3 \
  CMD curl --connect-timeout 2 http://host.docker.internal:8000 || exit 1

注：--connect-timeout 2参数用于限制连接建立的最长时间，避免健康检查长时间卡住。

方案2：灵活自定义可接受的HTTP状态码（最优方案） #

如果需要更精细的判定规则，比如仅接受200、401为正常响应，其他如500、404等状态码都判定为失败，可以通过curl的--write-out参数提取响应状态码，结合shell逻辑实现自定义校验：

HEALTHCHECK --interval=5s --timeout=3s --retries=3 CMD \
  STATUS=$(curl --connect-timeout 2 --write-out "%{http_code}" --output /dev/null --silent http://host.docker.internal:8000) || exit 1; \
  [ "$STATUS" -eq 200 ] || [ "$STATUS" -eq 401 ] || exit 1

用到的curl参数说明：

• --write-out "%{http_code}"：请求完成后输出HTTP响应的状态码
• --output /dev/null：丢弃响应正文，避免产生无用日志
• --silent：关闭curl默认的进度条、报错信息等多余输出

你可以根据实际业务需求调整shell判断条件，比如新增204状态码为可接受值，仅需要在判断逻辑中新增对应规则即可。

内容的提问来源于stack exchange，提问作者Pedro Rodrigues