LazyDocker: 51,092 GitHub Stars — 완전한 터미널 Docker UI 설정 가이드 2026

{{< resource-info >}}

명령줄에서 Docker를 관리한다는 것은 수십 개의 플래그를 암기하고, grep으로 출력을 파이프하며, docker ps, docker logs, docker exec 사이를 끊임없이 전환해야 함을 의미합니다. 터미널에서 수 시간을 복하는 개발자에게 이러한 마찰은 누적됩니다. LazyDocker는 단일 바이너리로 Docker 워크플로우를 키보드 중심의 터미널 인터페이스로 감싸서 이 문제를 해결합니다 — 브라우저 없이, 데몬 없이, 설정 오버헤드 없이. 51,000개 이상의 GitHub stars와 번성하는 생태계를 보유한 LazyDocker는 2026년 Docker 관리를 위한 기본 TUI 도구가 되었습니다.

LazyDocker란 무엇인가? #

LazyDocker는 Go로 작성된 gocui 프레임워크를 사용하는 Docker 및 Docker Compose용 터미널 사용자 인터페이스(TUI)입니다. 터미널 내 분할 창 레이아웃에서 컨테이너, 이미지, 볼륨, 네트워크 및 로그를 볼 수 있는 키보드 탐색 인터페이스를 제공합니다. 단일 바이너리는 Docker CLI가 사용하는 것과 동일한 API를 통해 Docker 데몬에 직접 연결됩니다. 백그라운드 서비스 없이, 열린 포트 없이, 추가 공격 표면 없습니다.

Jesse Duffield(LazyGit의 작성자이기도 함)가 만든 LazyDocker는 터미널을 떠나지 않고 즉각적인 시각적 피드백을 원하는 개발자를 대상으로 합니다. MIT 라이선스로 활발하게 유지보수되며 GitHub에서 51,092개의 stars와 1,600개 이상의 fork를累积했습니다.

LazyDocker의 작동 방식 #

LazyDocker는 간단한 아키텍처를 따릅니다: 바이너리는 로컬 Unix 소켓(/var/run/docker.sock) 또는 Windows의 명명된 파이프를 통해 Docker Engine API에 읽고 쓰기를 수행합니다. 모든 렌더링은 문자 기반 UI 프레임워크를 통해 터미널 낸部에서 발생합니다.

┌─────────────────────────────────────────┐
│              터미널                      │
│  ┌──────────────────────────────────┐   │
│  │        LazyDocker TUI            │   │
│  │  ┌────────┐  ┌────────────────┐  │   │
│  │  │컨테이너  │  │  로그 / 통계    │  │   │
│  │  ├────────┤  │                │  │   │
│  │  │이미지   │  │  실시간         │  │   │
│  │  ├────────┤  │  Docker API    │  │   │
│  │  │볼륨     │  │  출력          │  │   │
│  │  ├────────┤  │                │  │   │
│  │  │네트워크  │  │                │  │   │
│  │  └────────┘  └────────────────┘  │   │
│  └──────────────────────────────────┘   │
│                   │                      │
│         ┌─────────▼──────────┐           │
│         │ /var/run/docker.sock│           │
│         └─────────┬──────────┘           │
│                   │                      │
│         ┌─────────▼──────────┐           │
│         │   Docker 데몬      │           │
│         └────────────────────┘           │
└─────────────────────────────────────────┘

이해해야 할 핵심 개념:

• 패널(Panels): 왼쪽에는 분류된 목록(컨테이너, 서비스, 이미지, 볼륨, 네트워크)이 표시됩니다. 오른쪽에는 선택한 항목에 대한 세부 정보, 로그 또는 통계가 표시됩니다.
• 상황 인식 작업: 동일한 키가 포커스된 패널에 따라 다른 작업을 수행합니다. 컨테이너에서 d를 누륾면 컨테이너가 제거되고, 이미지에서 d를 누륾면 이미지가 제거됩니다.
• Docker Compose 통합: docker-compose.yml 파일이 있는 디렉터리에서 시작하면 LazyDocker가 프로젝트별로 서비스를 그룹화하고 up 및 down과 같은 Compose 전용 작업을 추가합니다.

설치 및 설정 #

LazyDocker는 모든 플랫폼에서 60초 이내에 설치됩니다. Docker가 설치되고 사용자가 docker 그룹에 추가되어 있어야 합니다(또는 Docker 소켓에 대한 동등한 액세스).

전제 조건 #

# Docker가 설치되어 실행 중인지 확인
docker --version
docker ps

# 사용자를 docker 그룹에 추가(Linux)
sudo usermod -aG docker $USER
# 그룹 변경을 적용하려면 로그아웃 후 다시 로그인

방법 1: Homebrew(macOS 및 Linux) #

# 자주 업데이트되는 공식 formula 사용
brew install jesseduffield/lazydocker/lazydocker

# 설치 확인
lazydocker --version
# 출력: Version: v0.24.5, Build date: 2026-04-15, Commit: abc1234

방법 2: 공식 설치 스크립트(Linux) #

# ~/.local/bin에 자동 설치
curl https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash

# 필요한 경우 PATH에 추가
echo 'export PATH=$PATH:$HOME/.local/bin' >> ~/.bashrc
source ~/.bashrc

방법 3: 바이너리 다운로드(모든 플랫폼) #

# 최신 릴리스 버전 가져오기
LAZYDOCKER_VERSION=$(curl -s "https://api.github.com/repos/jesseduffield/lazydocker/releases/latest" | grep '"tag_name":' | sed 's/.*"v\([^"]*\)".*/\1/')

# Linux x86_64 바이너리 다운로드
curl -Lo lazydocker.tar.gz "https://github.com/jesseduffield/lazydocker/releases/download/v${LAZYDOCKER_VERSION}/lazydocker_${LAZYDOCKER_VERSION}_Linux_x86_64.tar.gz"

# 압축 해제 및 시스템 전역 설치
tar xf lazydocker.tar.gz lazydocker
sudo install lazydocker /usr/local/bin/
rm lazydocker lazydocker.tar.gz

방법 4: Go 설치 #

# Go >= 1.19 필요
go install github.com/jesseduffield/lazydocker@latest

# 바이너리는 ~/go/bin에 있음
export PATH=$PATH:$HOME/go/bin

방법 5: Docker(샌드박스) #

# 설치 없이 실행 — 전체 액세스를 위해 Docker 소켓 마운트
docker run --rm -it -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/.config/lazydocker:/.config/jesseduffield/lazydocker \
  lazyteam/lazydocker:latest

# 편의를 위해 셸 별칭 생성
echo "alias lzd='docker run --rm -it -v /var/run/docker.sock:/var/run/docker.sock -v ~/.config/lazydocker:/.config/jesseduffield/lazydocker lazyteam/lazydocker'" >> ~/.bashrc

첫 실행 #

# LazyDocker 실행
lazydocker

# 문제 해결을 위해 디버그 출력으로 실행
lazydocker --debug

첫 실행 시 LazyDocker가 실행 중인 컨테이너를 자동 감지하고 주 인터페이스를 표시합니다. 레이아웃은 왼쪽 탐색 패널과 선택한 항목에 대한 로그나 통계를 표시하는 오른쪽 콘텐츠 패널로 분할됩니다.

필수 키바인딩 #

LazyDocker의 효율성은 vim과 유사한 키바인딩에서 나옵니다. 탐색은 방향키 또는 hjkl을 사용하며, 작업은 단일 키 입력입니다.

전역 탐색 #

컨테이너 작업 #

Docker Compose 서비스 작업 #

이미지 및 볼륨 작업 #

로그 탐색 #

구성 및 사용자 지정 #

LazyDocker는 플랫폼별 경로에 구성을 저장합니다. 프로젝트 패널에서 o를 누르거나(또는 기본 편집기에서 편집하려면 e) TUI에서 직접 구성 파일을 열 수 있습니다.

구성 파일 위치 #

사용자 지정 테마 구성 #

# ~/.config/lazydocker/config.yml
gui:
  language: "en"  # auto | en | fr | de | es | pl | nl | tr | zh
  border: "rounded"  # rounded | single | double | hidden
  theme:
    activeBorderColor:
      - cyan
      - bold
    inactiveBorderColor:
      - white
    selectedLineBgColor:
      - black
    selectedLineFgColor:
      - yellow
    optionsTextColor:
      - blue
  scrollHeight: 2
  sidePanelWidth: 0.333
  screenMode: "normal"  # normal | half | fullscreen

로그 표시 설정 #

logs:
  timestamps: true
  since: "60m"    # 최근 60분의 로그 표시; '' = 전체 시간
  tail: "200"     # 표시할 줄 수

사용자 지정 명령 #

c 키로 액세스할 수 있는 사용자 지정 명령 추가:

customCommands:
  containers:
    - name: bash
      attach: true
      command: "docker exec -it {{ .Container.ID }} bash"
      serviceNames: []
    - name: debug-network
      attach: false
      command: "docker inspect {{ .Container.ID }} --format='{{range $k, $v := .NetworkSettings.Networks}}{{$k}}: {{.IPAddress}}\n{{end}}'"

사용 가능한 템플릿 변수: {{ .Container.ID }}, {{ .Container.Name }}, {{ .Service.Name }}, {{ .DockerCompose }}.

Podman 지원 #

명령 템플릿을 교체하여 LazyDocker는 Podman과 함께 작동합니다:

commandTemplates:
  docker: "podman"
  dockerCompose: "podman-compose"
  containerInspect: "podman inspect {{ .Container.ID }}"

인기 도구와의 통합 #

Docker Compose 프로젝트 #

LazyDocker는 현재 디렉터리의 docker-compose.yml 또는 compose.yml을 자동 감지합니다. 서비스는 서비스 패널에서 프로젝트별로 그룹화되어 표시되며 프로젝트 수준 작업이 포함됩니다.

# Compose 프로젝트로 이동
cd ~/projects/my-app

# 실행 — 서비스 패널이 자동으로 채워짐
lazydocker

서비스 패널 내에서:

• 단일 서비스를 시작하려면 u를 누릅니다
• 전체 프로젝트를 시작하려면 U를 누릅니다
• 전체 스택을 종료하려면 D를 누릅니다
• 서비스 컨테이너로 진입하려면 E를 누릅니다

Tmux 통합 #

tmux 사용자의 경우 팝업 또는 분할에서 LazyDocker를 시작하는 키 바인딩을 추가합니다:

# ~/.tmux.conf
# 팝업 창에서 LazyDocker 열기
bind D display-popup -E -w 90% -h 90% "lazydocker"

# 또는 새로운 수직 분할에서 열기
bind d split-window -h "lazydocker"

다시 로드하고 Ctrl+b D를 사용하여 엽니다:

tmux source-file ~/.tmux.conf

Zsh / Bash 별칭 #

# ~/.bashrc 또는 ~/.zshrc
alias lzd="lazydocker"
alias lzd-logs="lazydocker --logs"

# 프로젝트로 빠르게 이동하여 시작
alias lzd-here="cd $PWD && lazydocker"

# 셸 구성 다시 로드
source ~/.bashrc

VS Code 통합 #

통합 터미널에서 LazyDocker를 시작하는 VS Code 작업을 추가합니다:

// .vscode/tasks.json
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "LazyDocker",
      "type": "shell",
      "command": "lazydocker",
      "problemMatcher": [],
      "presentation": {
        "echo": true,
        "reveal": "always",
        "focus": true,
        "panel": "new"
      }
    }
  ]
}

CI/CD 파이프라인 통합 #

LazyDocker는 빌드 중 컨테이너 상태를 디버깅하기 위해 GitHub Actions에서 잘 작동합니다:

# .github/workflows/debug.yml
name: Debug Containers
on: workflow_dispatch
jobs:
  debug:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install LazyDocker
        run: |
          curl https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash
          sudo mv ~/.local/bin/lazydocker /usr/local/bin/

      - name: Start services
        run: docker compose up -d

      - name: Inspect with LazyDocker
        run: |
          lazydocker --version
          # 로그용 컨테이너 목록 낸부
          docker ps --format "table {{.Names}}\t{{.Status}}"

벤치마크 및 실제 사용 사례 #

리소스 오버헤드 비교 #

LazyDocker는 임시 클라이언트 프로세스로 실행되므로 사실상 리소스 오버헤드가 없습니다 — 지속적인 데몬이 아닙니다.

실제 시나리오 #

시나리오 1: 홈랩 서버(20개 컨테이너) 개발자가 헤드리스 Ubuntu 서버에서 미디어 스택(Plex, Sonarr, Radarr, Traefik, Authelia)을 관리합니다. LazyDocker는 웹 서비스를 실행하지 않고 SSH를 통해 즉각적인 컨테이너 상태, 실시간 로그 추적 및 빠른 재시작을 제공합니다. 리소스 점유: 실행하지 않을 때는 영.

시나리오 2: 마이크로서비스 개발(8개 서비스) 팀이 로컬에서 8개의 Docker Compose 서비스를 실행합니다. LazyDocker는 프로젝트별로 서비스를 그룹화하고, 어떤 컨테이너가 재시작 중인지 표시하며, 개발자가 단일 키 입력으로 실패한 서비스에 진입할 수 있게 합니다. 평균 디버깅 워크플로우가 45초의 CLI 입력에서 5초의 키보드 탐색으로 줄었습니다.

시나리오 3: CI/CD 디버깅 DevOps 엔지니어가 실패한 테스트 실행이 종료될 때 컨테이너 상태와 로그를 캡처하기 위해 GitHub Actions에서 LazyDocker를 사용합니다. CI의 TUI는 대화형이 아니지만 --logs 낸부 및 컨테이너 목록 명령은 구조화된 디버그 출력을 제공합니다.

고급 사용법 및 프로덕션 강화 #

SSH를 통한 원격 호스트에서 실행 #

LazyDocker는 원격 Docker 호스트를 기본적으로 지원하지 않지만 SSH를 통해 Docker 소켓을 전달할 수 있습니다:

# 원격 Docker 소켓을 로컬 머신으로 전달
ssh -nNT -L /tmp/docker_remote.sock:/var/run/docker.sock user@remote-server &

# LazyDocker가 전달된 소켓을 가리키도록 설정
export DOCKER_HOST=unix:///tmp/docker_remote.sock
lazydocker

# 완료 후 정리
kill %1
rm /tmp/docker_remote.sock

또는 SSH 컨텍스트를 직접 사용:

# 원격 호스트용 Docker 컨텍스트 생성
docker context create remote --docker "host=ssh://user@remote-server"
docker context use remote

# LazyDocker가 활성 컨텍스트를 자동으로 사용
lazydocker

비루트 사용자 설정 #

# docker 그룹이 없으면 생성
sudo groupadd -f docker

# 현재 사용자 추가
sudo usermod -aG docker $USER

# 로그아웃 없이 적용(Linux만)
newgrp docker

# 확인
lazydocker

자동화된 정리 워크플로우 #

#!/bin/bash
# ~/bin/docker-cleanup.sh
# LazyDocker와 통합된 원키 정리 스크립트

echo "중지된 컨테이너 제거 중..."
docker container prune -f

echo "dangling 이미지 제거 중..."
docker image prune -f

echo "사용하지 않는 볼륨 제거 중..."
docker volume prune -f

echo "사용하지 않는 네트워크 제거 중..."
docker network prune -f

echo "정리 완료. 남은 리소스:"
docker system df

LazyDocker의 사용자 지정 명령을 통해 이를 바인딩하여 원키 액세스를 제공합니다.

모니터링 통합 #

docker stats를 Prometheus Node Exporter textfile 수집기로 파이프하여 LazyDocker 통계를 외부 모니터링으로 낸부합니다:

#!/bin/bash
# 60초마다 실행되는 cron 작업
while true; do
  docker stats --no-stream --format \
    "container_cpu_usage{name=\"{{.Name}}\"} {{.CPUPerc}}\ncontainer_memory_usage{name=\"{{.Name}}\"} {{.MemUsage}}" \
    > /var/lib/node_exporter/textfile_collector/docker_stats.prom
  sleep 60
done

대안과의 비교 #

한계 / 솔직한 평가 #

LazyDocker는 모든 상황에 적합한 도구가 아닙니다. 다음은 제약 사항입니다:

• 다중 호스트 관리 불가: 단일 LazyDocker 인스턴스에서 여러 Docker 호스트를 관리할 수 없습니다. 이를 위해서는 agents가 있는 Portainer 또는 Rancher를 사용하세요.
• 웹 인터페이스 없음: LazyDocker는 터미널 액세스가 필요합니다. 휴태폰이나 태블릿에서 컨테이너를 관리해야 하는 경우 Portainer의 반응형 웹 UI가 더 나은 선택입니다.
• RBAC 또는 사용자 관리 없음: LazyDocker는 OS 사용자의 Docker 권한을 상속합니다. 팀, 역할 또는 감사 추적 개념이 없습니다.
• Kubernetes 지원 없음: LazyDocker는 Docker와 Docker Compose만 처리합니다. Kubernetes 워크로드의 경우 k9s, Rancher 또는 kubectl을 직접 사용하세요.
• 단일 사용자 전용: 두 명의 엔지니어가 동시에 동일한 LazyDocker 세션을 사용할 수 없습니다. 각 사용자는 자신의 인스턴스를 실행합니다.
• TUI 학습 곡선: 키보드 중심 인터페이스(vim, tmux)에 익숙하지 않은 엔지니어는 웹 UI를 클릭하는 것보다 초기 학습 곡선이 더 가파를 수 있습니다.
• 읽기 중심, 쓰기 신중: LazyDocker는 파괴적인 작업(제거, 중지)을 지원하지만 확인 프롬프트를 추가하여 스크립트된 CLI 워크플로우에 비해 일괄 작업을 느리게 만듭니다.

자주 묻는 질문 #

Q: LazyDocker가 Docker CLI를 대체합니까?

아니오. LazyDocker는 시각적 개요와 빠른 작업을 제공하여 CLI를 보완합니다. 스크립팅, 자동화 및 CI/CD 파이프라인의 경우 Docker CLI가 여전히 올바른 도구입니다. 많은 개발자가 둘 다 사용합니다: LazyDocker는 대화형 탐색용이고 docker 명령은 재현 가능한 워크플로우용입니다.

Q: Podman과 함께 LazyDocker를 사용할 수 있습니까?

예. 구성 재정의를 통해 LazyDocker는 Podman을 지원합니다. config.yml에서 commandTemplates.docker를 podman으로 설정하고 commandTemplates.dockerCompose를 podman-compose로 설정하세요. lazypodman이라는 커뮤니티 래퍼도 원활한 Podman 통합을 위해 존재합니다.

Q: 충돌한 컨테이너의 로그를 어떻게 봅니까?

컨테이너 패널로 이동하여 중지된 컨테이너의 가시성을 전환하려면 e를 누르고, 충돌한 컨테이너를 선택한 다음 m을 눌러 로그를 봅니다. g를 사용하여 로그 스트림의 시작으로 이동하고 G를 사용하여 끝으로 이동합니다.

Q: 프로덕션에서 LazyDocker를 사용하는 것이 안전합니까?

LazyDocker는 백그라운드 서비스가 없는 클라이언트 측 도구이므로 안전합니다. 사용자가 가진 권한으로 Docker 소켓에 연결합니다. 프로덕션에서는 Docker 소켓 액세스를 승인된 사용자로 제한하고, 필요하지 않은 한 프로덕션 호스트에서 LazyDocker를 실행하지 않으며, 파괴적인 작업보다 읽기 전용 작업(로그 및 통계 보기)을 우선시하세요.

Q: Docker 컨테이너 낸부에서 LazyDocker를 실행할 수 있습니까?

예. 호스트의 Docker 소켓을 -v /var/run/docker.sock:/var/run/docker.sock로 컨테이너에 마운트하세요. 이렇게 하면 LazyDocker가 호스트 컨테이너를 완전히 볼 수 있습니다. 공식 이미지는 lazyteam/lazydocker:latest입니다. 이 패턴은 격리된 환경이나 빠른 테스트에 잘 작동합니다.

Q: LazyDocker가 “Cannot connect to Docker daemon"을 표시하는 이유는 무엇입니까?

사용자가 /var/run/docker.sock에 액세스할 수 없을 때 이 오류가 발생합니다. 사용자가 docker 그룹에 있는지, Docker 데몬이 실행 중인지(sudo systemctl status docker), DOCKER_HOST 환경 변수가 잘못된 값으로 설정되지 않았는지 확인하세요. macOS에서는 Docker Desktop이 실행 중인지 확인하세요.

Q: 키바인딩을 어떻게 사용자 지정합니까?

LazyDocker는 구성을 통한 전체 키 재매핑을 지원하지 않지만 config.yml의 customCommands 블록을 통해 사용자 지정 명령을 추가할 수 있습니다. 터미널 에뮬레이터와 충돌하는 단축키의 경우 터미널을 구성하여 원시 키를 TUI로 전달하도록 설정하세요.

결론 #

LazyDocker는 특정 틈새를 채웁니다: 빠르고, 가볍고, 터미널 네이티브인 Docker 관리. 51,092개의 GitHub stars, 단일 바이너리 배포 및 200ms 미만의 시작 시간을 통해 브라우저 탭 간 전환이나 CLI 플래그 암기의 마찰을 제거합니다. 개발자, 홈랩 운영자 및 터미널에서 작업하는 모든 사람에게 도구 모음의 실용적인 추가 기능입니다.

시작을 위한 실행 항목:

1. Homebrew 또는 공식 스크립트로 LazyDocker 설치(60초 이내)
2. 실행 중인 컨테이너가 있는 프로젝트에서 lazydocker 실행
3. 5개의 필수 키 암기: r(재시작), s(중지), d(제거), m(로그), E(shell 실행)
4. o를 눌러 구성을 열고 테마 및 로그 설정 사용자 지정
5. lzd에 대한 셸 별칭을 추가하고 팝업 액세스를 위해 tmux와 통합

dibi8 Telegram 커뮤니티에 참여하여 LazyDocker 워크플로우 팁을 공유하고 규모에 맞는 컨테이너를 관리하는 다른 개발자로부터 도움을 받으세요.

추천 호스팅 및 인프라 #

위 도구들을 프로덕션에 배포하려면 안정적인 인프라가 필요합니다. dibi8가 직접 사용 중인 두 가지 옵션:

• DigitalOcean — 60일 $200 무료 크레딧, 14개 이상 글로벌 리전. 오픈소스 AI 도구의 기본 선택.
• HTStack — 홍콩 VPS, 중국 본토 저지연 접속. dibi8.com 호스팅 중인 검증된 IDC.

제휴 링크 — 추가 비용 없이 dibi8 운영을 지원합니다.

출처 및 추가 참고 자료 #

• LazyDocker GitHub 저장소
• 공식 키바인딩 참조
• 구성 문서
• LazyDocker 설치 가이드
• LazyDocker 공식 웹사이트
• Portainer vs LazyDocker 비교(OneUptime)
• DataCamp LazyDocker 튜토리얼
• LazyDocker Podman 확장