본문 바로가기
Q&A해결2026년 4월 22일1분 읽기

GitHub Actions self-hosted runner에서 docker-in-docker 권한 거부

사
사내CI담당
조회 1145댓글 1

사내 self-hosted GitHub Actions runner를 EC2에 구축했습니다. 일반 워크플로는 잘 돌아가는데 docker build 단계에서 permission denied while trying to connect to the Docker daemon socket at /var/run/docker.sock이 발생합니다.

runner 사용자를 docker 그룹에 추가하고 newgrp docker도 했는데 그대로입니다. 어떻게 해결해야 하나요?

댓글 1

김김영삼7개월 전

self-hosted runner의 docker 권한 이슈는 보통 두 단계가 모두 필요합니다 — 그룹 추가만으로는 충분하지 않은 경우가 많습니다.

1) docker.sock 권한 영구 적용

# runner 사용자 (예: actions-runner)를 docker 그룹에 추가
sudo usermod -aG docker actions-runner

# 적용 — newgrp는 같은 셸에서만 유효
# runner 서비스를 재시작해야 그룹 변경이 반영됨
sudo systemctl restart actions.runner.<org>-<repo>.<name>.service

핵심: runner는 systemd 서비스로 등록되어 있는데, 서비스가 시작될 때 그룹이 결정됩니다. newgrp은 셸에서만 유효하고 서비스에 영향을 주지 않습니다. 반드시 서비스 재시작.

2) systemd 서비스 자체에 명시적 SupplementaryGroups

일부 환경에서는 그룹 추가만으로 부족합니다. systemd 서비스 정의에 직접 명시:

sudo systemctl edit actions.runner.<org>-<repo>-<name>.service
[Service]
SupplementaryGroups=docker
sudo systemctl daemon-reload
sudo systemctl restart actions.runner.<org>-<repo>-<name>.service

3) 검증

# runner 사용자로 직접 검증
sudo -u actions-runner docker ps
# Permission denied가 안 나오면 OK

# 워크플로에서도 확인
- run: |
id
docker version

대안 — Docker Buildx + buildkitd-rootless

Docker daemon을 root로 굴리는 보안 부담이 큰 환경이라면 rootless 옵션도 있습니다.

- uses: docker/setup-buildx-action@v3
with:
driver: docker-container # daemon 권한 필요 없음

더 큰 그림 — runner 격리

self-hosted runner는 동일 호스트에 여러 워크플로가 동거하면 보안·격리 문제가 큽니다. 권장 구조:

  • 각 워크플로는 격리된 컨테이너에서 실행 (actions/runner-controller + Kubernetes)
  • 또는 ephemeral runner — 매 작업마다 새 VM 띄우기 (terraform·packer 조합)
  • 레거시 단순 EC2 runner는 시크릿 노출·crypto miner 침투 사례가 자주 있음

실무 체크리스트:

  1. id 명령으로 docker 그룹 포함 확인
  2. systemd 서비스 재시작 (단순 newgrp 안 됨)
  3. SupplementaryGroups=docker override 적용
  4. 장기적으로 ARC(Actions Runner Controller) 또는 ephemeral runner로 전환
  5. runner 호스트에 SOC 도구(EDR) 필수 — 침해 시 시크릿이 모두 노출됨

"권한 부여했는데 안 됨"의 99%는 서비스가 옛 그룹 컨텍스트로 살아있다입니다. 재시작 잊지 마세요.

Ctrl+Enter로 등록