lazyteam/lazydocker

lazydocker 镜像文档

镜像概述和主要用途

lazydocker 是一个用 Go 语言编写的终端 UI 工具，基于 https://github.com/jroimartin/gocui 库开发，专为简化 docker 和 docker-compose 的日常管理而设计。它将容器状态、日志、指标等关键信息整合到单一终端窗口，通过快捷键或鼠标操作即可执行常见 Docker 命令，解决了记忆复杂命令、跨终端管理容器的痛点。

!演示动图

核心功能和特性

• 一站式信息展示：在单个终端窗口中查看 Docker 或 docker-compose 环境的容器、服务状态
• 日志管理：便捷查看特定容器/服务的日志，支持实时跟踪
• 性能监控：通过 ASCII 图表展示容器指标（可自定义监控指标）
• 便捷操作：一键执行容器/服务的重启、删除、重建、附加等操作
• 镜像管理：查看镜像的祖先层信息
• 资源清理：清理占用磁盘空间的容器、镜像或卷
• 鼠标支持：支持鼠标操作，提升交互便捷性
• 自定义配置：可通过配置文件自定义命令模板、界面样式等

使用场景和适用范围

• 开发环境管理：日常开发中快速查看和操作本地 Docker 容器
• 微服务监控：集中监控多个微服务容器的运行状态和日志
• 命令简化：避免记忆复杂的 Docker 命令及其参数
• 资源优化：识别并清理无用的 Docker 资源，释放磁盘空间

系统要求

• Docker 版本 >= 1.13（API 版本 >= 1.25）
• Docker-Compose 版本 >= 1.23.2（可选）

安装方法

Homebrew（macOS/Linux）

推荐使用官方 tap 以获取最新版本：

sh
brew install jesseduffield/lazydocker/lazydocker

也可使用 Homebrew 核心仓库版本：

sh
brew install lazydocker

Scoop（Windows）

sh
scoop install lazydocker

Chocolatey（Windows）

sh
choco install lazydocker

asdf-vm

插件设置（一次性）

sh
asdf plugin add https://github.com/comdotlinux/asdf-lazydocker.git

安装/升级

sh
asdf list all lazydocker  # 列出可用版本
asdf install lazydocker 0.12  # 安装指定版本
asdf global lazydocker 0.12  # 设置全局版本

二进制发布（Linux/OSX/Windows）

从 https://github.com/jesseduffield/lazydocker/releases 手动下载对应平台的二进制文件，或使用自动化安装脚本：

sh
curl https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash

默认安装到 /usr/local/bin，可通过 DIR 环境变量指定安装目录。

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

开发版本 AUR 包：https://aur.archlinux.org/lazydocker-git.git

Docker 容器运行

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
  

运行容器

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

注意：将 /yourpath 替换为实际用于存储配置的路径。可使用 https://github.com/jesseduffield/lazydocker/blob/master/docker-compose.yml 进行配置管理。

建议创建别名以简化使用：

sh
echo "alias lzd='docker run --rm -it -v /var/run/docker.sock:/var/run/docker.sock -v /yourpath/config:/.config/jesseduffield/lazydocker lazyteam/lazydocker'" >> ~/.zshrc

使用方法

基本使用

在终端中直接执行命令：

sh
lazydocker

建议设置别名（以 zsh 为例）：

sh
echo "alias lzd='lazydocker'" >> ~/.zshrc

视频教程和快捷键

• 基础视频教程：***
• 快捷键列表：查看文档

配置说明

编辑配置文件

在 lazydocker 界面中，点击左上角的 "project" 面板，按 o 键（或 e 键，若编辑器为 vim）打开配置文件。详细配置说明见 Config Docs。

常用配置项

• 文本换行：默认关闭，可通过 gui.wrapMainPanel: true 启用（可能影响性能）
• 鼠标事件：默认启用，可通过 gui.ignoreMouseEvents: true 禁用（禁用后可直接选择文本）
• 日志显示范围：默认显示最近 1 小时日志，可通过 commandTemplates 配置修改

常见问题（FAQ）

为什么看不到容器日志？

默认仅显示最近 1 小时的日志以减少资源占用，可通过修改配置中的 commandTemplates 调整日志范围。若在 Docker 容器中运行 lazydocker，日志和 CPU 使用率显示可能存在已知问题。

如何选择文本？

启用鼠标事件时，按住 Option 键拖动鼠标选择文本；或通过 gui.ignoreMouseEvents 禁用鼠标事件后直接选择。Mac 用户可参考 https://github.com/jesseduffield/lazydocker/issues/190 获取更多选项。

替代工具

• 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%9A%E5%9F%BA%E4%BA%8E%E6%B5%8F%E8%A7%88%E5%99%A8%E7%9A%84 Docker 管理工具，支持 Swarm
• 更多工具见 https://github.com/veggiemonk/awesome-docker/blob/master/README.md#terminal