seandever376/localhost-curl Docker 镜像 - 轩辕镜像

curl-localhost 镜像文档

镜像概述

curl-localhost 是一个轻量级Docker镜像，内置curl工具，旨在提供便捷的本地服务连接测试和网络请求功能。该镜像基于精简的基础镜像构建，体积小巧，适合在开发、测试环境中快速验证本地服务可用性或执行简单网络诊断。

核心功能与特性

• 轻量级设计：基于Alpine或类似精简基础镜像，镜像体积小，启动速度快
• 完整curl工具：包含最新版curl，支持HTTP/HTTPS请求、GET/POST等方法
• 即开即用：无需额外配置，直接通过命令行执行curl命令
• 网络兼容性：支持与宿主机网络、容器网络的互联互通测试

使用场景

• 开发环境中快速测试本地运行的Web服务接口
• 验证容器化应用与宿主机或其他容器的网络连通性
• 执行简单的HTTP请求测试，如状态码检查、响应内容获取
• 容器内网络诊断，排查服务访问问题

使用方法

基本使用

通过docker run命令直接执行curl请求：

bash
docker run --rm --network=host curl-localhost curl localhost:8080

说明：

• --rm：容器退出后自动删除
• --network=host：使用宿主机网络，使容器内的localhost指向宿主机
• curl localhost:8080：执行curl命令访问宿主机的8080端口服务

自定义请求示例

发送POST请求

bash
docker run --rm --network=host curl-localhost curl -X POST -d "param1=value1" localhost:8080/api

设置请求头

bash
docker run --rm --network=host curl-localhost curl -H "Content-Type: application/json" -d '{"key":"value"}' localhost:8080/api

检查服务状态码

bash
docker run --rm --network=host curl-localhost curl -I -s -o /dev/null -w "%{http_code}" localhost:8080

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  curl-test:
    image: curl-localhost
    network_mode: host
    command: curl -v localhost:8080

运行：

bash
docker-compose up

注意事项

• 使用--network=host模式时，容器将直接使用宿主机网络栈，此时localhost指向宿主机
• 若不使用host网络，需通过容器名称或IP访问其他服务，如curl service-name:8080（需在同一网络中）
• 该镜像主要用于测试目的，不建议在生产环境中长时间运行