Docker Plugin

Docker Engine plugin 설치, 활성화, 설정 변경을 다루는 docker plugin 관리 그룹.

• volume driver, network driver 같은 Engine plugin 관리에 사용한다.
• 일반적인 CLI plugin이나 Compose plugin과는 문맥이 다를 수 있다.
• plugin은 호스트 권한과 밀접하므로 설치 전 capability와 mount 권한을 꼭 확인한다.

docker plugin COMMAND

• install: registry에서 plugin 설치
  • 주요 옵션: –alias, –disable, –grant-all-permissions
• ls: plugin 목록 조회
  • 주요 옵션: –filter, –format, -q
• inspect: 권한, 설정, mount 정보 확인
• enable / disable: plugin 활성화/비활성화
  • 주요 옵션: –timeout
• set: plugin 설정값 변경
• upgrade: 기존 plugin 업그레이드
  • 주요 옵션: –grant-all-permissions, –skip-remote-check, –disable-content-trust
• push: plugin을 registry로 업로드
• rm: plugin 제거
• create: rootfs와 config.json 으로 plugin 패키지 생성

# plugin 목록
docker plugin ls
 
# plugin 설치
docker plugin install vieux/sshfs --grant-all-permissions
 
# 설정 변경 후 활성화
docker plugin set vieux/sshfs DEBUG=1
docker plugin enable vieux/sshfs

• 설치 시 permission prompt를 무시하면 호스트 자원 접근을 과도하게 허용할 수 있다.
• 일부 plugin은 비활성화 상태에서만 설정 변경이 가능하다.
• 운영 호스트에서는 plugin lifecycle을 이미지/컨테이너 배포와 별도로 변경 관리하는 편이 안전하다.

+ docker plugin --help

Usage:  docker plugin COMMAND
 
Manage plugins
 
Commands:
  create      Create a plugin from a rootfs and configuration. Plugin data directory must contain config.json and rootfs directory.
  disable     Disable a plugin
  enable      Enable a plugin
  inspect     Display detailed information on one or more plugins
  install     Install a plugin
  ls          List plugins
  push        Push a plugin to a registry
  rm          Remove one or more plugins
  set         Change settings for a plugin
  upgrade     Upgrade an existing plugin
 
Run 'docker plugin COMMAND --help' for more information on a command.

+

• docker
• system

• codex:: 2026-07-06 Added docker plugin subpage with install, permission, and lifecycle notes.