---
title: "도커 컨테이너 이미지 백업 및 복구 하기 (docker container, save, load, export, import)"
source: "https://yongeekd01.tistory.com/46"
author:
  - "[[빗자루검 블로그]]"
published: 2023-04-26
created: 2025-04-15
description: "도커 컨테이너는 애플리케이션과 해당 애플리케이션을 실행하는 환경을 함께 묶어서 배포하는 기술입니다. 이러한 컨테이너를 이미지라고 부르고 이미지는 도커 허브(Docker Hub)와 같은 저장소에 업로드하여 다른 사람이 다운로드해서 사용할 수 있습니다. 사용중인 컨테이너를 이미지를 만드는 방법은 컨테이너를 중지하고, 그 상태를 스냅샷으로 저장하는 것입니다. 이렇게 저장된 이미지는 다른 서버에서 다시 컨테이너를 생성하거나, 도커 허브에 업로드하여 다른 사람이 사용할 수 있습니다. 하지만 굳이 도커 허브나 로컬 레포지토리에 넣지 않고 작업 중인 도커 컨테이너를 단순히 로컬에 백업을 하기 위해서 사용하시는 분들도 많을 텐데요 그런 경우에 사용하는 법을 정리해 보겠습니다.  현재 사용중인 컨테이너와 이미지를 확인해.."
tags:
  - "clippings"
---
---

IT/리눅스

도커 컨테이너는 애플리케이션과 해당 애플리케이션을 실행하는 환경을 함께 묶어서 배포하는 기술입니다. 이러한 컨테이너를 이미지라고 부르고 이미지는 도커 허브(Docker Hub)와 같은 저장소에 업로드하여 다른 사람이 다운로드해서 사용할 수 있습니다.  
  
사용중인 컨테이너를 이미지를 만드는 방법은 컨테이너를 중지하고, 그 상태를 스냅샷으로 저장하는 것입니다. 이렇게 저장된 이미지는 다른 서버에서 다시 컨테이너를 생성하거나, 도커 허브에 업로드하여 다른 사람이 사용할 수 있습니다.

하지만 굳이 도커 허브나 로컬 레포지토리에 넣지 않고 작업 중인 도커 컨테이너를 단순히 로컬에 백업을 하기 위해서 사용하시는 분들도 많을 텐데요

그런 경우에 사용하는 법을 정리해 보겠습니다.

현재 사용중인 컨테이너와 이미지를 확인해 보겠습니다.

docker images

docker ps -a

![](https://blog.kakaocdn.net/dn/dpxO9t/btscHLXLPaL/GhoJ53mEPsJaH6swUkLec0/img.png)

여기서는 ysyang\_rockylinux8\_cu114\_221122\_img:new 라는 이미지를 이용해서 생성한 ysyang\_rockylinux8\_cu114\_221122 컨테이너가 표시되고 있습니다.

ysyang\_rockylinux8\_cu114\_221122 컨테이너를 백업 하고 복원하는 방법은 2가지가 있습니다.

### 1\. save / load 를 사용하기

#### (1) 작업된 컨테이너를 이미지로 저장하기 (commit)

  
docker commit -p \[컨테이너 이름\] \[이미지 이름:태그\]  
  
ex)  
docker stop ysyang\_rockylinux8\_cu114\_221122  
docker commit -p ysyang\_rockylinux8\_cu114\_221122 my\_image:new  

#### (2) save로 이미지를 tar파일로 백업하기

docker save -o \[저장할이름\].tar \[이미지 이름\]  
  
ex)  
docker save -o my\_image.tar my\_image:new

#### (3) load로 이미지 복원하기

  
docker load < \[백업한 파일이름\].tar  

ex)  
docker load < my\_image.tar

#### (4) 압축하면서 백업 및 복원

\*gzip으로 압축하면서 백업하기  

docker save \[이미지이름 또는 ID\] | gzip > 저장파일명.tar.gz

\*압축파일에서 복원 하기

docker load -i 저장파일명.tar.gz

### 2\. export / import를 사용하기

#### (1) export로 컨테이너를 한번에 이미지로 만들면서 tar.gz으로 백업

docker export \[컨테이너 이름\] | gzip > \[저장할이름\].tar.gz

ex)

docke stop ysyang\_rockylinux8\_cu114\_221122

docker export ysyang\_rockylinux8\_cu114\_221122 | gzip > my\_image.tar.gz

#### (2) import로 이미지 복원 하기

docker import \[저장된 tar.gz 파일\]

ex)

docker import my\_image.tar.gz

import 후에는 이미지 이름이 랜덤으로 생성된다.

혹시 이름을 지정하면서 이미지를 생성하고 싶은 경우에는 다음과 같이 하면 된다. (스페이스 주의)

**cat my\_image.tar.gz | docker import - ysyang\_rockylinux8\_cu114:new**

[저작자표시 비영리 변경금지](https://creativecommons.org/licenses/by-nc-nd/4.0/deed.ko)

#### ' > ' 카테고리의 다른 글

| [리눅스 파일 권한 개념과 변경 방법(permission 표시방법, chmod)](https://yongeekd01.tistory.com/48) (0) | 2023.04.26 |
| --- | --- |
| [리눅스 기본, 필수 명령어 50개 (사용 빈도 순, ls, cd, pwd, cp...)](https://yongeekd01.tistory.com/47) (0) | 2023.04.26 |
| [도커 컨테이너에서 cuda 동작 오류 해결(nvidia docker, container, cuda, 컨테이너 생성 옵션)](https://yongeekd01.tistory.com/45) (0) | 2023.04.26 |
| [ChatGPT 대항마 Goolge Bard 베타버전 성능, 코딩 테스트](https://yongeekd01.tistory.com/42) (0) | 2023.04.20 |
| [chatGPT 모델 종류 및 API 사용 비용(fine tuning model, ChatGPT3.5, ChatGPT4, ada, babbage, curi, danvinci)](https://yongeekd01.tistory.com/41) (0) | 2023.04.20 |

[빗자루검 블로그](https://yongeekd01.tistory.com/) [IT 정보, AI 딥러닝, 개발 자료, 코딩 블로그](https://yongeekd01.tistory.com/)

---