linuxserver/yq Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

linuxserver/yq

linuxserver/yq 是由LinuxServer.io团队提供的Docker镜像，包含yq、jq和xq工具，用于在命令行中处理YAML、XML和JSON文档。yq是YAML/XML处理器，可视为jq（JSON处理器）的包装器，而xq则专注于XML处理。

镜像特点

LinuxServer.io团队的镜像具有以下特性：

• 定期且及时的应用更新
• 简单的用户映射（PGID、PUID）
• 基于s6 overlay的自定义基础镜像
• 每周基础操作系统更新，通过跨生态系统的通用层减少空间占用、 downtime和带宽消耗
• 定期安全更新

支持的架构

镜像支持多种架构，利用Docker manifest实现多平台识别：

直接拉取linuxserver/yq将自动获取适合您架构的镜像。

使用方法

Docker CLI直接运行

可以通过指定入口点直接运行yq、jq或xq命令：

yq示例

bash
docker run --rm \
  -v "$PWD:$PWD" \
  -w="$PWD" \
  --entrypoint yq \
  linuxserver/yq \
  .foo.bar input.yml

将最后一行替换为任意yq命令及参数。

jq示例

bash
docker run --rm \
  -v "$PWD:$PWD" \
  -w="$PWD" \
  --entrypoint jq \
  linuxserver/yq \
  .foo.bar input.json

将最后一行替换为任意jq命令及参数。

xq示例

bash
docker run --rm \
  -v "$PWD:$PWD" \
  -w="$PWD" \
  --entrypoint xq \
  linuxserver/yq \
  .foo.bar input.xml

将最后一行替换为任意xq命令及参数。

推荐方法

提供便捷脚本，使工具像原生安装一样运行：

安装yq

bash
sudo curl -L --fail [***] -o /usr/local/bin/yq
sudo chmod +x /usr/local/bin/yq

安装后可直接使用：yq .foo.bar input.yml

安装jq

bash
sudo curl -L --fail [***] -o /usr/local/bin/jq
sudo chmod +x /usr/local/bin/jq

安装后可直接使用：jq .foo.bar input.json

安装xq

bash
sudo curl -L --fail [***] -o /usr/local/bin/xq
sudo chmod +x /usr/local/bin/xq

安装后可直接使用：xq .foo.bar input.xml

Docker Mods

通过Docker Mods可扩展容器功能，点击上方链接查看可用mods。

支持信息

• 查看镜像版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/yq
  

更新信息

通过Docker CLI更新

• 更新镜像：docker pull linuxserver/yq
• 清理旧镜像：docker image prune

本地构建

如需本地修改或开发：

bash
git clone [***]
cd docker-yq
docker build \
  --no-cache \
  --pull \
  -t linuxserver/yq:latest .

在x86_64硬件上构建ARM变体：

bash
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset

然后使用-f Dockerfile.aarch64指定架构Dockerfile。

版本历史

• 09.07.25: - 重新基于Alpine 3.22构建。
• 29.05.24: - 重新基于Alpine 3.20构建。
• 08.01.24: - 重新基于Alpine 3.19构建。
• 19.09.22: - 重新基于Alpine 3.18，弃用armhf架构。
• 19.09.22: - 重新基于Alpine 3.17构建。
• 19.09.22: - 重新基于Alpine 3.15构建。
• 18.05.21: - 重新基于Alpine 3.13，添加linuxserver wheel仓库。
• 09.10.20: - 修复运行脚本中$符号的错误解析（如单引号内），请重新运行推荐方法中的安装命令。
• 07.10.20: - 初始发布。