网站导航
> 技术文档 > 【Linux】Docker洞察：掌握docker inspect命令与Go模板技巧

【Linux】Docker洞察：掌握docker inspect命令与Go模板技巧

网友: 技术文档 2025-09-02 19:06:26

👨‍🎓博主简介

  🏅CSDN博客专家
  🏅云计算领域优质创作者
  🏅华为云开发者社区专家博主
  🏅阿里云开发者社区专家博主
💊交流社区：运维交流社区 欢迎大家的加入！
🐋 希望大家多多支持，我们一起进步！😄
🎉如果文章对你有帮助的话，欢迎 点赞 👍🏻 评论 💬 收藏 ⭐️ 加关注+💗

在这里插入图片描述

文章目录

    • 0️⃣ 前言
      • ① `docker inspect` 是做什么的？
      • ② 为什么要用 Go template ？
    • 1️⃣ 基本语法
    • 2️⃣ JSON → Go template 翻译法
      • 📌 原始 JSON（随便选了几个参数作为参考）
      • ✅ 基础：嵌套对象用点号
      • ✅ 进阶：数组 / map[键值对集合] 用 `index` 或 `range`
      • ✅ 高级：辅助函数
      • ✅ 最终：组合成命令
    • 3️⃣ 常用速查表
    • 4️⃣ 口诀速记

0️⃣ 前言

① docker inspect 是做什么的？

   答：docker inspect 是用来查看容器/镜像/卷/网络等详细 JSON 配置的命令，比如可以查找容器的映射路径、端口、网络模式、重启模式等等；

  • docker inspect 参数：
参数 说明 示例 -f, --format 用 Go模板 格式化输出 docker inspect -f \'{{.NetworkSettings.IPAddress}}\' nginx --type 指定对象类型（避免歧义） docker inspect --type=image nginx -s, --size 显示容器总文件大小（仅容器） docker inspect -s my_container

常用参数：-f（或 --format）是 Go template 的格式化参数，允许你只提取需要的字段，避免在一大坨 JSON 里人肉搜索，非常好用。

② 为什么要用 Go template ？

docker inspect 输出的是整坨 JSON（几百行，看着比较繁琐），而我们只想拿其中的 1~2 个字段。

  • 如果每次都用 jq/grep/awk，脚本里要多装一个二进制，还是比较麻烦的；
  • Go template 直接内建在 Docker CLI 里，零依赖、跨平台、一条命令搞定。

本期我们主要讲解 docker inspect -f 的使用。

1️⃣ 基本语法

docker inspect -f \'\' <对象>
  • 可以是：容器名、容器 ID、镜像名/ID、卷名、网络名等等，常用的就是容器名或容器id。
  • 用 Go text/template 语法，字段路径以 点号 分隔。

那么问题来了，我要怎么知道自己想要的数据是要用哪个Go语法呢？接下来我们讲解json如何翻译成go语法。

2️⃣ JSON → Go template 翻译法

📌 原始 JSON（随便选了几个参数作为参考）

[ { \"Id\": \"59c88ce44ce023f......\", \"Created\": \"2025-07-22T03:15:24.968351115Z\", \"Path\": \"bash\", \"Args\": [], \"State\": { \"Status\": \"running\", \"Pid\": 16698, \"StartedAt\": \"2025-07-22T03:15:26.473607152Z\", }, \"Name\": \"/my_nginx\", \"HostConfig\": { \"Binds\": [ \"/home/lcy/nginx/conf/:/usr/local/nginx/conf/\", \"/home/lcy/nginx/html/:/application/nginx/html/\", \"/home/lcy/nginx/logs/:/application/nginx/logs/\", \"/etc/localtime:/etc/localtime/\" ], \"NetworkSettings\": { \"IPAddress\": \"172.17.0.2\" }, \"Mounts\": [ { \"Type\": \"bind\", \"Source\": \"/home/lcy/nginx/conf/\", \"Destination\": \"/usr/local/nginx/conf/\" } { \"Type\": \"bind\", \"Source\": \"/home/lcy/nginx/logs/\", \"Destination\": \"/usr/local/nginx/logs/\" } ], \"Config\": { \"Env\": [\"PATH=/usr/bin\", \"FOO=bar\"] } }]

✅ 基础：嵌套对象用点号

我们看json其实就类似与键值对那种，比如\"Id\": \"59c88ce44ce023f......\"，我们就可以找到键Id，然后给他转成Go模板的时候就可以变成{{.Id}}，这样docker inspect -f \'{{.Id}}\' nginx的时候就可以输出Id的值了。

拆分{{.Id}}解析：以.作为分割，Id为要查找内容的键，加上{{}}，{{ }} 是 Go 模板语法里的“占位符”，告诉 Docker：“把这里换成真正的值”。

如果是如下多行json嵌套内容：

 \"NetworkSettings\": { \"IPAddress\": \"172.17.0.2\" },

那这样就变成了两层，也就是说要把这两个键都输入才能查到，如果只输入最外面这层的键是拿不到数据的：{{.NetworkSettings.IPAddress}}，如果是三层或者四层，以此类推就行，具体可查看如下JSON → Go 模板 的映射规则。

  • JSON → Go 模板 的映射规则
JSON 片段 模板写法 说明 / 口诀 \"Name\": \"/my_c\" {{.Name}} 顶层字段直接写 \"State\": {\"Status\": \"running\"} {{.State.Status}} 嵌套对象用点号 \"NetworkSettings\": {\"Networks\": {\"bridge\": {\"IPAddress\": \"172..\"}}} {{.NetworkSettings.Networks.bridge.IPAddress}} 多级嵌套一路点下去 \"Env\": [\"PATH=...\", \"FOO=bar\"] {{index .Env 1}} 数组/切片用 index \"Mounts\": [{ \"Source\": \"/home/...}{ \"Source\": \"/home/...}] {{range .Mounts}}{{.Source}}{{end}} 遍历 map/array用range \"Mounts\": [{...}] {{json .Config.Labels}} 输出原始 JSON 字符串用json \"HostConfig\": { \"Binds\": [ \"/home...:/usr/...\"] {{join .HostConfig.Binds \" \"}} 拼接数组用join “ ” 无 {{printf \"%.2fMB\" .SizeRw}} 格式化printf \"Name\": \"/nginx\" {{lower .Name}}
{{upper .Name}} 转小写lower
转大写 upper

以下为简单的几种转换：

JSON Go template 说明 \"Id\": \"59c88ce44ce023f......\" {{.Id}} 容器ID \"Created\": \"2025-07-22T03:15:24.968351115Z\" {{.Created}} 容器创建时间 \"State\": { \"Status\": \"running\" } {{.State.Status}} 容器运行状态 \"NetworkSettings\": { \"IPAddress\": \"172.17.0.2\" } {{.NetworkSettings.IPAddress}} 查看容器ip地址

✅ 进阶：数组 / map[键值对集合] 用 index 或 range

数组/map JSON Go template 说明 数组 \"HostConfig\": { \"Binds\": [ \"/home...:/usr/...\"] 列出所有：{{.HostConfig.Binds}}
取第一个值：{{index .HostConfig.Binds 0}} 查看容器映射路径 数组 \"Env\": [\"PATH=...\", \"FOO=bar\"] 取第一个值：{{index .Config.Env 0}} 查看容器环境变量配置 map \"Mounts\": [{...}] 遍历：{{range .Mounts}}{{.Source}}{{end}} 遍历多组挂载路径

✅ 高级：辅助函数

函数 JSON Go template 说明 json \"Mounts\": [{...}] {{json .Mounts}} 输出原始 JSON 字符串 join \"拼接内容\" \"HostConfig\": { \"Binds\": [ \"/home...:/usr/...\"] {{join .HostConfig.Binds \" \"}} 用空格拼接数组 lower / upper \"Name\": \"/nginx\" {{lower .Name}}
{{upper .Name}} 转小写
转大写 printf 无 {{printf \"%.2f\" .SizeRw}} 格式化数字

✅ 最终：组合成命令

############################ 基础 ############################# 查看容器iddocker inspect -f \'{{.Id}}\' nginx# 查看容器创建时间docker inspect -f \'{{.Created}}\' nginx# 查看运行状态docker inspect -f \'{{.State.Status}}\' nginx############################ 进阶 ############################# 查看创建容器的映射路径docker inspect -f \'{{.HostConfig.Binds}}\' nginx# 查看创建容器的映射路径（只查看第一行）docker inspect -f \'{{index .HostConfig.Binds 0}}\' nginx# 查看容器的环境变量docker inspect -f \'{{index .Config.Env 0}}\' nginx# 遍历多组挂载路径docker inspect -f \'{{range .Mounts}}{{.Source}}{{end}}\' nginx############################ 高级 ############################# 查看容器的挂载路径，以json格式输出docker inspect -f \'{{json .Mounts}}\' nginx# 用空格拼接挂载目录docker inspect -f \'{{join .HostConfig.Binds \" \"}}\' nginx# 切换容器名为小写docker inspect -f \'{{lower .Name}}\' nginx# 切换容器名为大写docker inspect -f \'{{upper .Name}}\' nginx# 格式化数字输出docker inspect -f \'{{printf \"%.2f\" .SizeRw}}\' nginx

3️⃣ 常用速查表

使用命令嵌套使用，覆盖99%常用参数。

docker inspect -f \'\' 容器名
需求 Go template 容器 ID {{.Id}} 容器名 {{.Name}} 容器启动命令 {{.Path}} {{join .Args \" \"}} 容器创建时间 {{.Created}} 状态 {{.State.Status}} 主进程 PID {{.State.Pid}} 容器是否因内存不足被杀死 {{.State.OOMKilled}} 容器运行时的错误信息 {{.State.Error}} 容器启动时间 {{.State.StartedAt}} 容器结束时间 {{.State.FinishedAt}} 宿主机和容器之间的挂载路径 {{.HostConfig.Binds}} 容器网络模式 {{.HostConfig.NetworkMode}} 容器的重启策略 {{.HostConfig.RestartPolicy.Name}} 容器内的工作目录 {{.GraphDriver.Data.MergedDir}} 所有挂载源路径 {{range .Mounts}}{{.Source}} {{end}} 容器的主机名 {{.Config.Hostname}} 容器的环境变量 {{.Config.Env}}
{{index .Config.Env 0}} 容器使用的镜像名称 {{.Config.Image}} 容器默认的工作路径 {{.Config.WorkingDir}} 容器端口映射 {{range $p,$c := .NetworkSettings.Ports}}{{$p}}->{{(index $c 0).HostPort}}{{end}}
{{.NetworkSettings.Ports}} 容器 网关 地址 {{.NetworkSettings.Gateway}}
{{range .NetworkSettings.Networks}}{{.Gateway}}{{end}} 容器 IP 地址 {{.NetworkSettings.IPAddress}}
{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}} 容器 mac 地址 {{.NetworkSettings.MacAddress}}
{{range .NetworkSettings.Networks}}{{.MacAddress}}{{end}}
  • 更多简便的查询命令（[过滤]，相对与使用如上命令简单点）：
需求 命令 查看容器：使用镜像、运行时长、容器名、
启动命令、容器ID、运行状态、端口映射 docker ps -a | grep 容器名 查看容器的创建时间 docker inspect 容器名 | grep -i created 查看容器是否因内存不足被杀死 docker inspect 容器名 | grep -i OOMKilled 查看容器启动时间 docker inspect 容器名 | grep -i StartedAt 查看容器结束时间 docker inspect 容器名 | grep -i FinishedAt 查看容器的网络模式 docker inspect 容器名 | grep -i NetworkMode 查看容器内的工作目录 docker inspect 容器名 | grep -i MergedDir 查看容器外映射路径 docker inspect 容器名 | grep -i source 查看容器的主机名 docker inspect 容器名 | grep -i hostname 查看进入容器默认工作路径 docker inspect 容器名 | grep -i WorkingDir 查看容器的 IP docker inspect 容器名 | grep -i ipaddress 查看容器的 mac 地址 docker inspect 容器名 | grep -i macaddress 查看容器的 网关 地址 docker inspect 容器名 | grep -i gateway

4️⃣ 口诀速记

嵌套一路点到底，数组切片 index，map 切片 range，数组或map过多用join连接，模板单引号包起来。

网络标签：

相关问题