httpie

alpine/httpie Docker Image

自动构建

当httpie有新版本发布时自动触发Docker构建的镜像

23 次收藏下载次数: 0状态:自动构建维护者:Alpine 工具与轻量镜像仓库类型:镜像最近更新:

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 docker.xuanyuan.run/alpine/httpie:3.2.2获取对应架构镜像。

自动构建与更新

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

使用场景与适用范围

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

使用方法与配置说明

基础使用(设置别名)

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

bash
# 设置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到容器:

bash
# 持久化.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目录,可挂载该目录实现配置持久化:

bash
# 持久化.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):

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

使用示例

基础请求(Hello World)

bash
https httpie.io/hello

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

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

提交表单数据

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

文件上传(重定向输入)

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

文件下载(重定向输出)

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

说明:所有https://github.com/jakubroztocil/httpie#readme均可直接传递,无修改。

镜像标签与版本

镜像标签列表可在Docker Hub查看:
https://hub.docker.com/r/alpine/httpie/tags/

构建流程

  1. 定时CI构建:通过GitHub仓库的CI定时任务(每周)在master分支触发构建。
  2. 版本同步:构建并推送最新版本镜像,本地运行镜像获取应用版本后,使用该版本打标签。
  3. 多架构推送:通过https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane.md推送多架构镜像。

帮助信息

官方文档

httpie官方文档:https://github.com/jakubroztocil/httpie#readme

内置帮助

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

bash
http --help

相关链接

  • GitHub仓库:https://github.com/alpine-docker/multi-arch-libs/tree/master/httpie
  • CI构建日志:https://app.circleci.com/pipelines/github/alpine-docker/multi-arch-libs
  • 镜像列表:https://github.com/alpine-docker/multi-arch-libs/tree/master#image-details

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 httpie 镜像标签

docker pull docker.xuanyuan.run/alpine/httpie:<标签>

DockerHub 原生拉取命令

docker pull alpine/httpie:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告