jetbrains/intellij-http-client

IntelliJ HTTP Client CLI Docker镜像

镜像概述

本镜像为JetBrains官方提供的IntelliJ HTTP Client CLI Docker镜像，旨在通过容器化方式简化IntelliJ HTTP Client CLI的部署与使用。该工具可用于命令行环境下执行HTTP请求、测试API接口及进行自动化接口调试，支持环境变量配置、日志级别控制及主机服务测试等功能。

核心功能与特性

• 工作目录管理：默认使用/workdir作为工作目录，支持通过卷挂载本地目录，所有文件路径需相对于该目录
• 命令行参数支持：提供丰富选项如日志级别设置（-L）、环境指定（-e）、环境变量文件（-v）及主机服务测试（-D）
• 环境配置支持：可通过环境变量文件定义请求所需的动态参数，适应多环境测试场景
• 主机服务测试：通过-D选项将请求中的localhost解析为宿主机地址，支持测试本地运行的服务

使用场景

• 命令行快速执行HTTP/HTTPS请求测试
• 自动化API接口测试与验证
• 集成至CI/CD流程实现接口自动化测试
• 本地开发环境中调试主机运行的后端服务

使用方法与配置说明

基本使用

镜像需挂载/workdir卷作为工作目录，所有请求文件路径需相对于该目录。基础命令格式如下：

bash
docker run --rm -i -t -v [本地目录]:/workdir jetbrains/intellij-http-client [选项] [请求文件]

参数说明

基础示例

执行当前目录下的requests.http文件，使用env环境及env.json配置文件，启用详细日志：

bash
docker run --rm -i -t -v $PWD:/workdir jetbrains/intellij-http-client \
  -L VERBOSE \
  -e env \
  -v env.json \
  requests.http

测试主机运行的服务

当请求中的localhost需指向宿主机（而非容器自身）时，使用-D选项。该选项会将请求中的localhost解析为宿主机的docker.host.internal地址。

操作步骤

1. 创建请求文件test.http：

   http
   ### 测试本地API
   GET http://localhost:8080/my-api/health
   

2. 宿主机运行监听8080端口的服务，执行测试命令：

   bash
   docker run --rm -v $PWD:/workdir jetbrains/intellij-http-client -D test.http
   

实现原理

-D选项通过将localhost解析为docker.host.internal实现宿主机访问，该地址由Docker自动映射至宿主机localhost。不同操作系统启用host.docker.internal的方法可参考StackOverflow说明。

反馈与支持

如遇功能问题或需提交改进建议，请通过JetBrains 问题跟踪器创建工单。