如何为k9s添加dive插件？配置后无法使用的问题排查

一、明确dive插件的作用范围 #

dive是本地镜像分析工具，k9s的dive插件本质是调用本地dive命令工作——也就是说，你的工作站必须先拉取到目标镜像，才能用dive查看细节。你提到工作站没有服务的全部镜像，这是核心问题之一：如果本地不存在目标镜像，即便插件配置正确，按快捷键也会因找不到镜像无反应（后台可能报错但k9s未给出提示）。

二、检查dive插件配置是否正确 #

首先确认dive.yml的格式与路径是否符合要求：

1. 标准配置模板（快捷键改为b） #

# dive.yml
plugin:
  dive:
    shortCut: b
    description: "用Dive分析容器镜像"
    scopes:
    - containers
    command: "dive"
    args:
    - "{{ .Image }}"

关键注意点：

• scopes必须包含containers，匹配你操作的容器列表页面
• {{ .Image }}是k9s的模板变量，用于传递选中容器的完整镜像名（含tag）
• 配置文件路径错误：k9s插件需放在plugins子目录下，而非直接放在~/.config/k9s/或/etc/xdg/k9s/根目录。正确路径是~/.config/k9s/plugins/dive.yml（用户目录）或/etc/xdg/k9s/plugins/dive.yml（全局目录）。

三、分步解决问题 #

1. 修正配置文件路径 #

• 创建插件目录：mkdir -p ~/.config/k9s/plugins
• 移动配置文件到正确位置：mv ~/.config/k9s/dive.yml ~/.config/k9s/plugins/
• 重启k9s加载新配置

2. 处理本地无镜像的问题 #

有两种可行方案：

• 手动拉取镜像：在本地执行docker pull <镜像名:tag>，拉取完成后再在k9s中按b调用dive
• 在集群节点上运行dive：如果节点已安装dive，可修改插件命令，通过kubectl exec直接在节点上执行分析（无需本地拉取镜像），修改后的dive.yml如下：

plugin:
  dive:
    shortCut: b
    description: "在节点上用Dive分析镜像"
    scopes:
    - containers
    command: "kubectl"
    args:
    - "exec"
    - "-it"
    - "{{ .NodeName }}"
    - "--"
    - "dive"
    - "{{ .Image }}"

此方案要求你拥有节点的exec权限，且目标节点已安装dive。

3. 验证配置生效 #

启动k9s后，进入容器列表页面按?打开帮助菜单，搜索dive或快捷键b，若能看到对应插件说明，证明配置已生效。若看不到，检查配置文件格式、路径是否正确。

4. 排查无反应的其他可能 #

• 确认dive在k9s的环境PATH中：终端执行which dive获取路径，在k9s中按Ctrl+Shift+P打开命令面板，执行env查看PATH是否包含该路径
• 查看k9s日志：启动k9s时加-v参数（k9s -v），检查是否有插件加载失败的报错信息

内容的提问来源于stack exchange，提问作者CodeGorilla