# restic으로 암호화 백업 만들기: 증가분 저장, 복원 검증, 손상 감지까지

> 오픈소스 백업 도구 restic을 도커로 실행해 암호화 저장소를 만들고, 두 번째 백업에서 바뀐 부분만 저장되는지, 복원본이 원본과 같은지, 저장소 파일 일부를 일부러 망가뜨렸을 때 어떤 점검이 잡는지 확인합니다.

- 주소: https://copyandrun.com/blog/restic-encrypted-backup-restore/
- 분야: AX
- 발행일: 2026-10-29
- 태그: restic, 백업, 암호화, 복원 검증

백업은 만드는 것보다 되돌릴 수 있는지 확인하는 일이 더 중요합니다. 복원해 본 적이 없는 백업은 백업이라고 부르기 어렵습니다. restic은 파일을 암호화해서 저장하고, 같은 내용은 한 번만 저장하며(중복 제거), 저장소가 망가졌는지 점검하는 기능까지 갖춘 오픈소스 백업 도구입니다. 실행 파일 하나로 동작하고 저장소의 모든 데이터가 비밀번호로 암호화됩니다. 이 글에서는 도커로 restic을 실행해 백업, 증가분, 복원 비교, 비밀번호 오류, 오래된 백업 정리, 저장소 손상 감지를 차례로 해 봅니다.

## 준비물

| 항목 | 확인한 값 |
|---|---|
| Docker | 29.5.3 (Windows 11) |
| restic | 0.19.1 (`restic/restic` 이미지) |

모든 데이터는 도커 볼륨 안에서만 다룹니다. 백업 원본은 `osk_rs_src`, 저장소는 `osk_rs_repo`, 복원 위치는 `osk_rs_out`입니다. 내 PC의 폴더를 건드리지 않으므로 지우기도 쉽습니다. 실제로 쓸 때는 `-v 내폴더:/data:ro`처럼 원본을 읽기 전용으로 연결하고, 저장소는 다른 디스크나 다른 장비에 둡니다.

## 1. 원본 만들기

<!-- files: restic_demo.sh -->

백업할 파일 일곱 개를 만들었습니다. 문서 다섯 개(한글 한 줄씩), 무작위 내용의 사진 파일 두 개(3MB, 2MB)이고 전체 4,920KB입니다. 무작위 바이트는 압축이나 중복 제거가 되지 않으므로 증가분 시험에 맞습니다.

## 2. 저장소 만들기와 첫 백업

<!-- files: restic_demo.sh -->

```bash
restic -r /repo init
restic -r /repo backup --host lab /data
```

비밀번호는 환경 변수 `RESTIC_PASSWORD`로 넘깁니다(이 글에서는 실습용 값을 썼습니다). `init`이 저장소를 만들고(`created restic repository ...`), 첫 백업 결과는 다음과 같았습니다.

| 항목 | 값 |
|---|---|
| 파일 | 7개 새로 추가, 변경 0, 그대로 0 |
| 저장소에 더해진 양 | 4.772 MiB (실제 저장 4.771 MiB) |

`--host lab`은 호스트 이름을 고정하는 옵션입니다. 도커는 실행할 때마다 컨테이너 이름(호스트 이름)이 달라지는데, restic은 같은 호스트와 같은 경로의 이전 스냅샷을 기준으로 바뀐 파일을 가려냅니다. 이름을 고정하지 않으면 두 번째 백업에서 매번 "전부 새 파일"로 보입니다. 처음에 이름 없이 시험했을 때 "8 new, 0 unmodified"가 나와서 알게 된 점입니다.

## 3. 저장소 안은 암호화되어 있습니다

저장소 폴더에는 `config`, `data`, `index`, `keys`, `locks`, `snapshots`가 있었습니다. 저장소 전체에서 원본에 들어 있던 한글 문자열 "회의록"을 찾았더니 이 문자열이 든 파일은 0개였습니다. 파일 내용뿐 아니라 이름과 구조도 암호화되어 있다는 뜻입니다. 저장소 파일을 누가 가져가도 비밀번호 없이는 읽을 수 없습니다. 그만큼 비밀번호를 잃으면 복구할 방법이 없습니다. `keys` 폴더의 키 파일도 비밀번호로 보호됩니다.

## 4. 두 번째 백업: 바뀐 부분만 저장됩니다

<!-- files: restic_demo.sh -->

문서 하나를 추가하고(`note6.txt`) 다른 문서 하나에 한 줄을 덧붙인(`note1.txt`) 뒤 다시 백업했습니다.

| 항목 | 첫 백업 | 두 번째 백업 |
|---|---|---|
| 파일 | 7 새로 | 1 새로, 1 변경, 6 그대로 |
| 저장소에 더해진 양 | 4.772 MiB | 3.146 KiB (실제 저장 1.431 KiB) |

원본은 약 4.8MB 그대로인데 두 번째 백업은 3KB만 더했습니다. 사진 두 개는 바뀌지 않았으므로 다시 저장되지 않았습니다. 매일 백업해도 저장소가 원본 크기의 며칠 치만큼 불어나지 않는 이유입니다. 스냅샷 목록은 각 시점이 4.769 MiB 전체를 가리키지만 실제 데이터는 공유합니다.

## 5. 복원하고 원본과 비교하기

<!-- files: restic_demo.sh -->

```bash
restic -r /repo restore latest --target /out
diff -r /data /out/data
```

복원은 11개 파일과 폴더(4.769 MiB)를 1초 안에 끝냈고, `diff -r`은 아무 차이도 출력하지 않았습니다. 백업 점검에서 가장 기본이 되는 일입니다. 복원해서 원본과 비교하는 일을 주기적으로 자동화합니다.

## 6. 비밀번호가 틀리면

<!-- files: restic_demo.sh -->

틀린 비밀번호로 `snapshots`를 부르자 `Fatal: wrong password or no key found`로 끝났고, 저장소 내용은 아무것도 보이지 않았습니다.

## 7. 오래된 스냅샷 정리

스냅샷을 세 개로 늘린 뒤 `forget --keep-last 2 --prune`을 실행했습니다.

| 단계 | 결과 |
|---|---|
| 정리 전 | 3 snapshots |
| 정책 | `keep 2 latest snapshots` |
| `forget` | 1개 제거, 이어서 `prune`이 쓰이지 않는 데이터 3개(1007바이트) 제거 |
| 정리 후 | 2 snapshots |

`forget`은 스냅샷 목록에서 지우는 것이고, 실제로 공간을 돌려받는 것은 `prune`입니다. `--prune`을 붙이면 한 번에 둘 다 합니다. 이 글의 데이터가 작아서 줄어든 용량은 1KB 남짓이었습니다. 정책은 `--keep-daily 7 --keep-weekly 4`처럼 기간으로도 정합니다. 이 글에서는 `--keep-last`만 시험했습니다.

![restic_demo.sh 실행 결과 앞부분에서 첫 백업이 7개 새 파일 4.772 MiB를 저장하고, 두 번째 백업은 1개 새 파일과 1개 변경 파일로 3.146 KiB만 더하며, 복원본이 diff 차이 없이 원본과 같고, 틀린 비밀번호는 wrong password로 막히는 것을 확인합니다.](https://copyandrun.com/img/restic-encrypted-backup-restore/01-백업-증가분-복원.png)

## 8. 저장소가 망가지면: check와 check --read-data

저장소가 저장 장치 오류나 전송 중 문제로 상하는 일에 대비한 점검입니다. 가장 큰 데이터 파일(사진 조각이 든 파일)의 한가운데(100,000바이트 위치)를 영(0) 8바이트로 덮어 일부러 망가뜨렸습니다.

| 점검 | 손상 전 | 손상 뒤 |
|---|---|---|
| `restic check` | no errors were found | no errors were found |
| `restic check --read-data` | (시험하지 않음) | 오류 감지: 데이터 파일 하나에 오류 2건, `Fatal: repository contains errors` |
| `restic restore latest` | 성공 | 일부 실패: `pic2.bin`을 복호화하지 못함, `Fatal: There were 1 errors` |

가장 중요한 결과는 첫 줄입니다. 기본 `check`는 구조(색인과 파일 목록)만 보기 때문에 파일 안쪽이 상한 것을 잡지 못해 "오류 없음"이라고 했습니다. 내용을 다시 읽어 확인하는 `--read-data`만 `ciphertext verification failed`로 손상을 찾았습니다. 암호화 저장소는 한 군데만 틀어져도 해당 조각을 복호화하지 못하므로, 상한 조각이 든 파일(`pic2.bin`)만 복원에 실패하고 나머지는 복원되었습니다.

운영에서는 매일 `check`를, 주 1회 정도 `check --read-data`(모든 데이터를 읽어 시간이 걸림)나 일부만 읽는 `--read-data-subset=10%`를 돌립니다. `--read-data-subset`은 이 글에서 시험하지 않았습니다.

![restic_demo.sh 실행 결과 뒷부분에서 스냅샷 세 개가 두 개로 정리되고, 데이터 파일을 손상시킨 뒤 기본 check는 오류가 없다고 하지만 check --read-data는 오류 2건을 찾고 복원은 한 파일에서 실패하는 것을 확인합니다.](https://copyandrun.com/img/restic-encrypted-backup-restore/02-정리-손상-감지.png)

## 9. 운영 전에 정할 것

| 항목 | 내용 |
|---|---|
| 비밀번호 보관 | 잃으면 복구 방법 없음. 비밀번호 관리자나 별도 안전한 곳에 보관. 앞의 Vaultwarden 글의 서버도 후보 |
| 저장소 위치 | 원본과 같은 디스크에 두면 디스크 고장에 함께 사라짐. 다른 디스크나 다른 장비, 원격 저장소 사용. 원격 저장소는 이 글에서 시험하지 않음 |
| 복원 연습 | 5절의 복원과 비교를 정해진 주기로 자동 실행 |
| 일정 | restic은 정해진 시간에 스스로 실행되지 않음. 작업 스케줄러나 cron으로 `backup`, `forget --prune`, `check` 호출 |
| 읽기 전용 원본 | 백업 도구가 원본을 바꾸지 못하게 읽기 전용(`:ro`)으로 연결 |

## 전체 코드

위 1~8절을 한 번에 실행하는 파일입니다. `restic_demo.sh`로 저장하고 `bash restic_demo.sh`로 실행합니다. 이 PC에서는 약 1분이 걸렸습니다. 볼륨 세 개(`osk_rs_repo`, `osk_rs_src`, `osk_rs_out`)를 만들고 끝에서 지웁니다. 같은 이름의 볼륨이 있으면 먼저 지우므로 다른 용도로 쓰는 볼륨과 이름이 겹치지 않는지 확인합니다. 비밀번호는 실습용 값입니다.

```bash
#!/usr/bin/env bash
# restic 으로 암호화 백업을 만들고, 두 번째 백업의 증가분, 복원 검증, 저장소 손상 감지, 오래된 스냅샷 정리까지 한다.
# 준비: Docker. restic 은 컨테이너(restic/restic)로 실행하고 모든 데이터는 도커 볼륨 안에서만 다룬다.
# 주의: 볼륨 osk_rs_repo, osk_rs_src, osk_rs_out 을 만들고 끝에서 지운다. 비밀번호는 실습용 값이다.
# 실행(Git Bash): bash restic_demo.sh   (약 1분)
set -u
export MSYS_NO_PATHCONV=1
PW="lab-only-restic-pass"
R() { docker run --rm -e RESTIC_PASSWORD="$PW" -v osk_rs_repo:/repo -v osk_rs_src:/data -v osk_rs_out:/out restic/restic -r /repo "$@"; }
SH() { docker run --rm -v osk_rs_repo:/repo -v osk_rs_src:/data -v osk_rs_out:/out alpine sh -c "$1"; }

docker volume rm osk_rs_repo osk_rs_src osk_rs_out >/dev/null 2>&1
docker volume create osk_rs_repo >/dev/null; docker volume create osk_rs_src >/dev/null; docker volume create osk_rs_out >/dev/null

echo "## 1. 백업할 원본 파일 만들기"
SH 'mkdir -p /data/docs /data/photos
for i in 1 2 3 4 5; do echo "회의록 $i: 이 파일은 실습용입니다." > /data/docs/note$i.txt; done
head -c 3000000 /dev/urandom > /data/photos/pic1.bin
head -c 2000000 /dev/urandom > /data/photos/pic2.bin
du -sk /data | cut -f1 | sed "s/^/원본 크기(KB): /"; find /data -type f | wc -l | sed "s/^/파일 수: /"'

echo "## 2. 저장소 만들기(init)와 첫 백업(--host lab 으로 이름을 고정해 이전 스냅샷과 비교되게 한다)"
R init 2>&1 | grep -E 'created restic repository'
R backup --host lab /data 2>&1 | grep -E 'Files:|Added to the repository|snapshot .* saved'

echo "## 3. 저장소 안을 들여다보기: 평문이 보이는가"
SH 'ls /repo | tr "
" " "; echo; grep -r -l "회의록" /repo 2>/dev/null | wc -l | sed "s/^/저장소 파일 중 평문 \"회의록\"이 든 것: /"'

echo "## 4. 파일 하나를 추가하고 하나를 고친 뒤 두 번째 백업(증가분만 저장되는가)"
SH 'echo "회의록 6: 새로 추가한 파일" > /data/docs/note6.txt; echo "수정함" >> /data/docs/note1.txt'
R backup --host lab /data 2>&1 | grep -E 'Files:|Added to the repository|snapshot .* saved'

echo "## 5. 복원하고 원본과 비교(diff)"
R restore latest --target /out 2>&1 | tail -1
SH 'diff -r /data /out/data && echo "원본과 복원본이 같다(diff 결과 없음)"'

echo "## 6. 잘못된 비밀번호"
docker run --rm -e RESTIC_PASSWORD="wrong" -v osk_rs_repo:/repo restic/restic -r /repo snapshots 2>&1 | tail -1

echo "## 7. 스냅샷을 세 개로 늘리고 두 개만 남기도록 정리(forget --keep-last 2 --prune)"
SH 'echo "회의록 7" > /data/docs/note7.txt'
R backup --host lab /data 2>&1 | grep -E 'snapshot .* saved'
R snapshots 2>&1 | grep -E 'snapshots$'
R forget --keep-last 2 --prune 2>&1 | grep -E 'keep|remove|snapshots$'
R snapshots 2>&1 | grep -E 'snapshots$'

echo "## 8. 저장소 점검(check)과 손상 감지(check --read-data)"
R check 2>&1 | tail -1
SH 'f=$(ls -S /repo/data/*/* | head -1); echo "가장 큰 데이터 파일을 손상시킨다: $(basename $f | cut -c1-16)..."; head -c 8 /dev/zero | dd of=$f bs=1 seek=100000 conv=notrunc 2>/dev/null'
echo "-- 기본 check (구조만 본다)"
R check 2>&1 | tail -1
echo "-- check --read-data (내용까지 읽는다)"
R check --read-data 2>&1 | grep -E 'Fatal|ciphertext verification failed' | head -2 | cut -c1-150
echo "-- 손상된 저장소에서 복원 시도"
R restore latest --target /out2 2>&1 | grep -E 'Fatal|error|ciphertext' | head -2 | cut -c1-150

docker volume rm osk_rs_repo osk_rs_src osk_rs_out >/dev/null && echo "## 정리: 시험 볼륨 삭제"
```

## 자주 막히는 곳

| 증상 | 원인과 해결 |
|---|---|
| 두 번째 백업에서도 모든 파일이 "새 파일"로 나옴 | 도커가 호스트 이름을 매번 바꾸기 때문. `--host 이름`을 고정 |
| `Fatal: wrong password or no key found` | 비밀번호가 틀렸거나 저장소가 아닌 폴더를 가리킴. `-r` 경로 확인 |
| Git Bash에서 볼륨 경로가 이상하게 바뀜 | `export MSYS_NO_PATHCONV=1`을 먼저 실행 |
| `check`는 통과했는데 복원이 실패함 | `check --read-data`로 내용까지 확인. 8절 참고 |
| 한글이 깨져 보임 | 터미널 인코딩 문제. 저장된 데이터와는 무관 |

## 확인 범위

- **해 본 것:** 2026-10-29, Windows 11 · Docker 29.5.3 · restic 0.19.1에서 저장소 만들기, 백업 두 번(증가분 확인), 복원과 `diff -r`, 틀린 비밀번호, 세 번째 백업과 `forget --keep-last 2 --prune`, 일부러 손상시킨 저장소에서 `check`, `check --read-data`, 복원을 실행했습니다. 끝난 뒤 볼륨을 모두 지웠습니다.
- **해 보지 않은 것:** 원격 저장소(SFTP, S3 등), 기간 기반 보관 정책, `--read-data-subset`, 마운트(`restic mount`), 대용량 데이터의 속도, 저장소 비밀번호 변경, 여러 키 관리, Linux와 macOS.
- **읽을 때 주의:** 원본이 4.8MB뿐이라 속도와 용량 수치는 참고만 합니다. 손상은 파일 한 곳을 덮어쓴 인위적인 시험이며, 실제 저장 장치 오류의 모양은 다를 수 있습니다.
