httpie Docker镜像文档

镜像概述与主要用途

本镜像是基于Alpine Linux构建的httpie容器化版本，包含Python3、pip3及httpie工具。当httpie官方发布新版本时，将自动触发Docker镜像构建，确保用户能及时获取最新版本。httpie是一款命令行HTTP客户端，旨在让API交互更简单、人性化，支持JSON、表单提交、文件上传下载等功能。

核心功能与特性

轻量级基础

基于Alpine Linux构建，镜像体积小，资源占用低。

多架构支持

• 支持版本：v3.2.2及以上版本提供多架构支持，涵盖平台：linux/amd64, linux/arm/v7, linux/arm64/v8, linux/arm/v6, linux/ppc64le, linux/s390x。
• 平台限制：仅提供linux/amd64平台的技术支持（因缺乏其他架构测试环境），其他架构问题需通过PR自行修复。
• 使用无差异：拉取和运行命令与常规操作一致，例如ARM架构（如Mac M1芯片）可直接执行docker pull alpine/httpie:3.2.2获取对应架构镜像。

自动构建与更新

通过CI/CD流程，在httpie官方发布新版本时自动触发镜像构建，确保镜像版本与上游同步。

使用场景与适用范围

• 无本地安装需求：无需在主机系统安装httpie，通过Docker容器即可使用。
• 跨平台一致性：在不同架构（如x86_64、ARM）的设备上提供一致的httpie运行环境。
• 临时或测试环境：快速创建httpie实例，用完即弃（--rm参数），不残留系统文件。
• 配置持久化：支持挂载.netrc文件和.httpie配置目录，保留认证信息和个性化设置。

使用方法与配置说明

基础使用（设置别名）

通过别名简化命令，将http和https命令映射为Docker容器运行：

# 设置http别名
alias http='docker run -ti --rm alpine/httpie'
# 设置https别名（指定entrypoint为https）
alias https='docker run -ti --rm --entrypoint=https alpine/httpie'

说明：-ti确保终端交互，--rm在命令执行后自动删除容器，避免残留。

持久化.netrc文件

若需使用.netrc文件（用于自动认证），可挂载主机的.netrc到容器：

# 持久化.netrc的http别名
alias http='docker run -ti --rm -v ~/.netrc:/root/.netrc alpine/httpie'
# 持久化.netrc的https别名
alias https='docker run -ti --rm -v ~/.netrc:/root/.netrc --entrypoint=https alpine/httpie'

注意：需确保主机~/.netrc文件存在，容器内httpie以root用户运行，因此读取/root/.netrc。

持久化.httpie配置目录

httpie的配置文件（如config.json）存储在.httpie目录，可挂载该目录实现配置持久化：

# 持久化.httpie配置的http别名
alias http='docker run -ti --rm -v ~/.httpie:/root/.httpie alpine/httpie'
# 持久化.httpie配置的https别名
alias https='docker run -ti --rm -v ~/.httpie:/root/.httpie --entrypoint=https alpine/httpie'

说明：若主机~/.httpie目录不存在，首次运行时会自动创建，并生成默认config.json。

别名持久化

上述别名仅在当前终端会话有效，若需重启后保留，可将别名追加到shell配置文件（如~/.bashrc、~/.zshrc）：

# 将http别名写入.bashrc
alias http >> ~/.bashrc
# 将https别名写入.bashrc
alias https >> ~/.bashrc

使用示例

基础请求（Hello World）

https httpie.io/hello

自定义HTTP方法、头信息与JSON数据

# PUT请求，自定义头X-API-Token，JSON数据name=John
http PUT example.org X-API-Token:123 name=John

提交表单数据

# -f表示表单格式，POST提交hello=World
http -f POST example.org hello=World

文件上传（重定向输入）

# 上传file.json内容到example.org
http example.org < file.json

文件下载（重定向输出）

# 下载文件并保存到本地file
http example.org/file > file

说明：所有httpie参数均可直接传递，无修改。

镜像标签与版本

镜像标签列表可在Docker Hub查看：
[***]

构建流程

1. 定时CI构建：通过GitHub仓库的CI定时任务（每周）在master分支触发构建。
2. 版本同步：构建并推送最新版本镜像，本地运行镜像获取应用版本后，使用该版本打标签。
3. 多架构推送：通过crane工具推送多架构镜像。

帮助信息

官方文档

httpie官方文档：[***]

内置帮助

通过--help查看命令参数说明：

http --help

相关链接

• GitHub仓库：[***]
• CI构建日志：[***]
• 镜像列表：[***]