youthfulindiscretion/lazydocker

lazydocker 镜像文档

概述

lazydocker 是一个用 Go 语言编写的 Docker 和 docker-compose 终端 UI，基于 https://github.com/jroimartin/gocui 库开发。它提供直观的终端界面，集中展示 Docker 环境关键信息，通过快捷键和鼠标操作简化容器、服务的日常管理，避免记忆复杂命令。

核心功能和特性

• 一站式监控：实时查看 Docker 或 docker-compose 容器环境状态，包括运行状态、资源使用情况
• 日志管理：查看指定容器/服务日志，支持实时跟踪
• 指标可视化：通过 ASCII 图表展示容器 CPU、内存等指标，支持自定义监控项
• 便捷操作：一键重启、删除、重建容器/服务，支持附加到容器
• 镜像管理：查看镜像祖先层信息
• 资源清理：清理无用容器、镜像或卷，释放磁盘空间
• 鼠标支持：支持鼠标交互，提升操作便捷性
• 自定义配置：可通过配置文件自定义命令模板、界面样式等

使用场景

• 开发者日常管理 Docker 容器和服务，避免频繁切换终端和记忆命令
• 监控容器运行状态和资源使用情况
• 快速排查容器日志和故障
• 简化 docker-compose 多服务环境的管理

安装方法

Docker 安装

拉取镜像

sh
docker pull docker.xuanyuan.run/lazyteam/lazydocker

运行容器

sh
docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /path/to/your/config:/.config/jesseduffield/lazydocker \
  docker.xuanyuan.run/lazyteam/lazydocker

注意：将 /path/to/your/config 替换为实际目录，用于存储配置文件。

创建别名（推荐）

sh
echo "alias lzd='docker run --rm -it -v /var/run/docker.sock:/var/run/docker.sock -v /path/to/your/config:/.config/jesseduffield/lazydocker lazyteam/lazydocker'" >> ~/.bashrc  # 或 ~/.zshrc
source ~/.bashrc  # 或 ~/.zshrc

ARM 设备构建

• ARM 32位 v6：

  sh
  docker build -t lazyteam/lazydocker \
    --build-arg BASE_IMAGE_BUILDER=arm32v6/golang \
    --build-arg GOARCH=arm \
    --build-arg GOARM=6 \
    https://github.com/jesseduffield/lazydocker.git
  

• ARM 32位 v7：

  sh
  docker build -t lazyteam/lazydocker \
    --build-arg BASE_IMAGE_BUILDER=arm32v7/golang \
    --build-arg GOARCH=arm \
    --build-arg GOARM=7 \
    https://github.com/jesseduffield/lazydocker.git
  

• ARM 64位 v8：

  sh
  docker build -t lazyteam/lazydocker \
    --build-arg BASE_IMAGE_BUILDER=arm64v8/golang \
    --build-arg GOARCH=arm64 \
    https://github.com/jesseduffield/lazydocker.git
  

其他安装方式

• Homebrew：

  sh
  # 推荐：专用tap获取最新版本
  brew install jesseduffield/lazydocker/lazydocker
  # 或使用Homebrew核心仓库
  brew install lazydocker
  

• Scoop（Windows）：

  sh
  scoop install lazydocker
  

• 二进制发布：从 https://github.com/jesseduffield/lazydocker/releases 下载对应平台二进制文件。

• Go 源码安装（Go >= 1.8）：

  sh
  go get github.com/jesseduffield/lazydocker
  

• Arch Linux AUR：

  sh
  git clone https://aur.archlinux.org/lazydocker.git ~/lazydocker
  cd ~/lazydocker
  makepkg --install
  

使用方法

基本使用

运行命令启动：

sh
lazydocker  # 或使用别名 lzd

操作指南

• 快捷键：参考 https://github.com/jesseduffield/lazydocker/blob/master/docs/keybindings
• 鼠标操作：支持点击切换面板、执行操作（按住 Option 键可选择文本）
• 视频教程：基础使用教程

配置说明

编辑配置

1. 启动 lazydocker
2. 点击左上角"project"面板
3. 按 o 键（或 e 键，若编辑器为 vim）打开配置文件

关键配置项

• gui.wrapMainPanel：设为 true 启用主面板文本换行（默认关闭，因可能影响性能）
• commandTemplates：自定义命令模板，如调整日志显示时间范围（默认最近1小时）
• gui.ignoreMouseEvents：设为 true 禁用鼠标事件，便于文本选择

常见问题

Q: 无法看到容器日志？

A: 默认仅显示最近1小时日志，可修改 commandTemplates 调整时间范围。Docker 容器中运行时，日志和 CPU 使用率显示可能存在已知问题。

Q: 如何选择文本？

A: 按住 Option 键拖动鼠标选择；或通过 gui.ignoreMouseEvents: true 禁用鼠标事件后直接选择。

Q: 如何解决 Docker 版本兼容性问题？

A: 重建镜像时指定 --build-arg DOCKER_VERSION="v$(docker -v | cut -d" " -f3 | rev | cut -c 2- | rev)"，使内置 Docker 二进制与主机版本匹配。

替代方案

• https://github.com/skanehira/docui%EF%BC%9A%E4%BE%A7%E9%87%8D%E5%AE%B9%E5%99%A8%E5%88%9B%E5%BB%BA%E5%92%8C%E9%85%8D%E7%BD%AE%E7%9A%84%E7%BB%88%E7%AB%AF UI
• https://github.com/portainer/portainer%EF%BC%9AWeb 界面 Docker 管理工具，支持 Docker Swarm