Docker 容器详细元数据查看怎么使用 --format 精准提取

轻墨君_8755

轻墨君_8755

2026-07-29

896人浏览

原创

docker inspect --format 使用 Go 模板语法精准提取容器元数据,支持点号路径、range 遍历、index 定位、if 条件判断及 json 函数,轻量可靠,适合脚本集成。

docker 容器详细元数据查看怎么使用 --format 精准提取

用 docker inspect --format 提取容器元数据,核心是用 Go 模板语法定位嵌套字段,跳过冗长 JSON,直接输出需要的值。它不依赖外部工具,轻量、可靠、适合脚本集成。

常用字段提取写法

字段路径按 JSON 层级逐级展开,用点号连接;数组或 map 类型需配合 range 或 index 处理:

  • 容器 IP 地址:docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' my-nginx
  • 镜像名称:docker inspect -f '{{.Config.Image}}' my-nginx
  • 启动命令:docker inspect -f '{{.Config.Cmd}}' my-nginx
  • 内存限制(字节):docker inspect -f '{{.HostConfig.Memory}}' my-nginx
  • 挂载卷详情:docker inspect -f '{{json .Mounts}}' my-nginx | jq(加 jq 美化更易读)

处理多网络或多端口映射

容器可能接入多个网络,或暴露多个端口,单一字段不存在时会报错,必须用 range 遍历或 index 定位:

Portainer Docker Control
Portainer Docker Control

使用 Portainer API 控制 Docker 容器和堆栈,包括列出容器、启停/重启、查看日志以及从 Git重新部署堆栈。

下载
  • 遍历所有网络获取网关:docker inspect -f '{{range .NetworkSettings.Networks}}{{.Gateway}}{{"\n"}}{{end}}' my-nginx
  • 查特定端口映射(如 8080/tcp 的宿主机端口):docker inspect -f '{{(index .NetworkSettings.Ports "8080/tcp" 0).HostPort}}' my-nginx
  • 查所有暴露端口及映射:docker inspect -f '{{json .NetworkSettings.Ports}}' my-nginx

安全提取与容错写法

字段可能缺失(如未配置健康检查、无挂载卷),硬引用会报错。可用条件判断避免中断:

  • 判断健康状态是否存在:docker inspect -f '{{if .State.Health}}{{.State.Health.Status}}{{else}}n/a{{end}}' my-nginx
  • 提取安全选项(如 no-new-privileges):docker inspect -f '{{range .HostConfig.SecurityOpt}}{{if contains . "no-new-privileges"}}{{.}}{{end}}{{end}}' my-nginx
  • 获取日志路径(存在才输出):docker inspect -f '{{if .LogPath}}{{.LogPath}}{{else}}not set{{end}}' my-nginx

配合 json 函数结构化输出

对复杂嵌套结构(如 .Mounts、.State.Health.Log),直接用 {{json .Field}} 输出格式化 JSON,再交给 jq 过滤更稳妥:

  • 查看健康检查完整日志:docker inspect -f '{{json .State.Health.Log}}' my-nginx | jq '.[-1]'
  • 列出所有绑定挂载源路径:docker inspect -f '{{json .Mounts}}' my-nginx | jq -r 'map(select(.Type=="bind"))[].Source'

相关专题

更多
format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1889

3

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.06.27

1231

7

k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

825

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

6919

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

8097

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

3253

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

379

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

511

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

460

26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
光速学会docker容器
光速学会docker容器

共33课时 | 3.1万人学习

Docker Desktop故障排查手册
Docker Desktop故障排查手册

共0课时 | 0人学习