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

A-刘晨阳2025-08-30 11:41

👨‍🎓博主简介

🏅CSDN博客专家

🏅云计算领域优质创作者

🏅华为云开发者社区专家博主

🏅阿里云开发者社区专家博主

💊交流社区： 运维交流社区 欢迎大家的加入！

🐋 希望大家多多支持，我们一起进步！😄

🎉如果文章对你有帮助的话，欢迎 点赞 👍🏻 评论 💬 收藏 ⭐️ 加关注+💗

文章目录

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

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

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

2️⃣ JSON → Go template 翻译法

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

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嵌套内容：

bash 复制代码 
    "NetworkSettings": {
      "IPAddress": "172.17.0.2"
    },

那这样就变成了两层，也就是说要把这两个键都输入才能查到，如果只输入最外面这层的键是拿不到数据的：{``{.NetworkSettings.IPAddress}}，如果是三层或者四层，以此类推就行，具体可查看如下[JSON → Go 模板 的映射规则](#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<Go模板> "拼接内容" "HostConfig": { "Binds": [ "/home...:/usr/..."] {``{join .HostConfig.Binds " "}} 用空格拼接数组
lower / upper "Name": "/nginx" {``{lower .Name}} {``{upper .Name}} 转小写 转大写
printf 无 {``{printf "%.2f" .SizeRw}} 格式化数字

✅ 最终：组合成命令

bash 复制代码 
############################ 基础 ############################
# 查看容器id
docker 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%常用参数。

bash 复制代码 
docker inspect -f '<Go template>' 容器名
需求 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
查看容器的创建时间 `docker inspect 容器名
查看容器是否因内存不足被杀死 `docker inspect 容器名
查看容器启动时间 `docker inspect 容器名
查看容器结束时间 `docker inspect 容器名
查看容器的网络模式 `docker inspect 容器名
查看容器内的工作目录 `docker inspect 容器名
查看容器外映射路径 `docker inspect 容器名
查看容器的主机名 `docker inspect 容器名
查看进入容器默认工作路径 `docker inspect 容器名
查看容器的 IP `docker inspect 容器名
查看容器的 mac 地址 `docker inspect 容器名
查看容器的 网关 地址 `docker inspect 容器名

4️⃣ 口诀速记

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

热门推荐
01UV安装并设置国内源02不再让Windows更新！&Edge游戏助手卸载及关闭自动更新03KGG转MP3工具|非KGM文件|解密音频04奈飞工厂官网，国内Netflix影视在线看|中文网页电脑版入口05Linux下V2Ray安装配置指南06Qwen3-Coder 快速上手教程 | Qwen Code + Claude Code07蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接08【2025.08.06最新版】Android Studio下载、安装及配置记录（自动下载sdk）09突破百度网盘的下载限速，两种方法教会你【超详细】10Claude Code VSCode集成开发指南：AI编程助手完整配置