专属域名
文档搜索
轩辕助手
Run助手
邀请有礼
返回顶部
快速返回页面顶部
收起
收起工具栏
轩辕镜像 官方专业版
轩辕镜像 官方专业版轩辕镜像 官方专业版官方专业版
首页个人中心搜索镜像

交易
充值流量我的订单
工具
提交工单镜像收录一键安装
Npm 源Pip 源Homebrew 源
帮助
常见问题
其他
关于我们网站地图

官方QQ群: 51517718

mikefarah/yq Docker 镜像 - 轩辕镜像

yq
mikefarah/yq
yq是一款可移植的命令行YAML处理器
31 收藏0 次下载activemikefarah镜像
🚀专业版镜像服务,面向生产环境设计
中文简介版本下载
🚀专业版镜像服务,面向生产环境设计

yq

!Build !Docker Pulls !Github Releases (by Release) !Go Report

一款轻量级且可移植的命令行YAML处理器。

本项目旨在成为YAML文件的jq或sed工具。

V4版本已发布!

V4版本现已正式发布,与V3版本有较大差异(抱歉带来迁移成本),但它更接近jq,采用类似的表达式语法,因此支持更复杂的功能!

如果您一直在使用V3版本并希望/需要升级,请查看升级指南。

安装

Docker运行方式
一次性使用:
bash
docker run --rm -v "${PWD}":/workdir mikefarah/yq <command> [flags] [expression ]FILE...
交互式运行命令:
bash
docker run --rm -it -v "${PWD}":/workdir mikefarah/yq sh

创建bash函数可避免输入完整的docker命令,更为便捷:

bash
yq() {
  docker run --rm -i -v "${PWD}":/workdir mikefarah/yq "$@"
}
其他安装方式(简要说明)
  • 二进制下载:下载最新二进制文件
  • MacOS:使用Homebrew brew install yq
  • Linux (snap):snap install yq(注意严格限制模式下的文件访问方式)
  • wget:下载预编译二进制到/usr/bin/yq并添加执行权限
  • Go Get:GO111MODULE=on go get github.com/mikefarah/yq/v4

社区支持的安装方式(可能不是最新版本):Windows (choco install yq)、MacPorts、Alpine Linux、Ubuntu (Debian包)等

核心功能和特性

  • 使用可移植的Go语言编写,提供无依赖的独立二进制文件
  • 采用类似jq的语法,适用于YAML和JSON文件处理
  • 完全支持多文档YAML文件
  • 彩色YAML输出
  • 深度遍历YAML
  • 按键排序YAML
  • 操作YAML的注释、样式、标签和锚点
  • 原地更新YAML
  • 复杂表达式选择和更新
  • 更新时保留YAML格式和注释(存在空白字符处理问题)
  • JSON与YAML互转
  • 通过'-'管道输入数据
  • 通用shell补全脚本(bash/zsh/fish/powershell)

使用场景和适用范围

适用于需要在命令行环境中高效处理YAML文件的场景,包括但不限于:

  • 配置文件的快速修改与查询
  • 从YAML/JSON文件中提取特定数据
  • YAML与JSON格式相互转换
  • 批量处理多文档YAML文件
  • 自动化脚本中集成YAML数据处理

详细使用方法

命令语法
yq [flags]
yq [command]
可用命令
  • eval:对每个YAML文件中的每个文档应用表达式
  • eval-all:加载所有YAML文件的所有文档并运行一次表达式
  • help:获取命令帮助
  • shell-completion:生成补全脚本
主要标志
标志描述
-C, --colors强制彩色输出
-e, --exit-status无匹配项或返回null/false时设置退出状态
-h, --help显示帮助信息
-I, --indent int设置输出缩进级别(默认2)
-i, --inplace原地更新第一个YAML文件
-M, --no-colors强制无彩色输出
-N, --no-doc不打印文档分隔符(---)
-n, --null-input不读取输入,仅计算给定表达式(用于创建YAML文档)
-j, --tojson输出为JSON,缩进设为0时单行显示
-v, --verbose详细模式
-V, --version打印版本信息并退出
使用示例
基本示例
bash
yq e '.a.b | length' f1.yml f2.yml 
Docker运行示例

一次性处理文件:

bash
docker run --rm -v "${PWD}":/workdir mikefarah/yq e '.a.b | length' f1.yml f2.yml

交互式运行:

bash
docker run --rm -it -v "${PWD}":/workdir mikefarah/yq sh

已知问题/缺失功能

yq尝试尽可能保留注释位置和空白字符,但并非支持所有场景(详见:[***]

更多详细高级用法请参见官方文档。

查看更多 yq 相关镜像 →
linuxserver/yq logo
linuxserver/yq
by linuxserver.io
linuxserver/yq是一个命令行YAML/XML/JSON处理器镜像,包含yq、jq和xq工具,支持x86-64和arm64架构。提供便捷脚本可像原生工具一样使用,由LinuxServer.io团队维护,确保定期更新、安全补丁和多平台支持。
91M+ pulls
上次更新:22 小时前
chekote/yq logo
chekote/yq
by chekote
暂无描述
5M+ pulls
上次更新:11 个月前
chatwork/yq logo
chatwork/yq
by chatwork
yq是一个轻量级命令行工具,用于处理YAML、JSON等数据格式,支持查询、转换和修改数据,通过Docker镜像可便捷使用,无需本地安装,适用于各类数据处理场景。
10K+ pulls
上次更新:20 小时前
backplane/yq logo
backplane/yq
by backplane
基于scratch的yq命令行YAML处理器的Docker镜像,支持类jq语法处理YAML和JSON文件。
10K+ pulls
上次更新:10 小时前

轩辕镜像配置手册

探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式

登录仓库拉取

通过 Docker 登录认证访问私有仓库

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

Docker Compose

Docker Compose 项目配置

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

Dev Containers

VS Code Dev Containers 配置

MacOS OrbStack

MacOS OrbStack 容器配置

宝塔面板

在宝塔面板一键配置镜像

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

极空间

极空间 NAS 系统配置服务

爱快路由

爱快 iKuai 路由系统配置

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

专属域名拉取

无需登录使用专属域名

需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单

镜像拉取常见问题

轩辕镜像免费版与专业版有什么区别?

免费版仅支持 Docker Hub 访问,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。

轩辕镜像支持哪些镜像仓库?

专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等;免费版仅支持 docker.io。

流量耗尽错误提示

当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。

410 错误问题

通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。

manifest unknown 错误

先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。

镜像拉取成功后,如何去掉轩辕镜像域名前缀?

使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。

查看全部问题→

用户好评

来自真实用户的反馈,见证轩辕镜像的优质服务

oldzhang的头像

oldzhang

运维工程师

Linux服务器

5

"Docker访问体验非常流畅,大镜像也能快速完成下载。"

轩辕镜像
镜像详情
...
mikefarah/yq
官方博客Docker 镜像使用技巧与技术博客
热门镜像查看热门 Docker 镜像推荐
一键安装一键安装 Docker 并配置镜像源
提交工单
咨询镜像拉取问题请 提交工单,官方技术交流群:51517718
轩辕镜像面向开发者与科研用户,提供开源镜像的搜索和访问支持。所有镜像均来源于原始仓库,本站不存储、不修改、不传播任何镜像内容。
咨询镜像拉取问题请提交工单,官方技术交流群:
轩辕镜像面向开发者与科研用户,提供开源镜像的搜索和访问支持。所有镜像均来源于原始仓库,本站不存储、不修改、不传播任何镜像内容。
官方邮箱:点击复制邮箱
©2024-2026 源码跳动
官方邮箱:点击复制邮箱Copyright © 2024-2026 杭州源码跳动科技有限公司. All rights reserved.