파일 복원

어떤 스냅샷에서든 파일을 되찾을 수 있습니다. 새 폴더에 복원하거나, 원본 위에 덮어쓸 수 있습니다.

가장 쉬운 방법은 스냅샷 브라우저입니다. frost browse를 실행하고 필요한 항목을 찾아 [space]로 선택한 다음 [r]을 누르세요. 자세한 내용은 스냅샷 브라우저를 참고하세요. 이 페이지에서는 명령줄에서 복원하는 방법을 설명합니다.

#restore 명령어

frost restore <snapshot> [paths...] --beside | --to <dir> | --overwrite

스냅샷: 어느 스냅샷에서 복원할지 정합니다. 아래의 "스냅샷 고르기"를 참고하세요.
경로: 복원할 파일이나 폴더입니다. 각각 그 안의 모든 내용을 포함합니다. 생략하면 스냅샷 전체를 복원합니다.
복원 위치: --beside, --to, --overwrite 중 정확히 하나를 지정합니다.

예:

frost restore latest ~/Documents/taxes --beside
frost restore yesterday ~/notes.txt --to ~/Desktop
frost restore maple-absurd-3f1c --overwrite

frost restore를 인자 없이 실행하면 스냅샷 브라우저가 열립니다.

#스냅샷 고르기

입력	선택되는 스냅샷
`latest`	가장 최근 스냅샷
`maple-absurd-3f1c` 또는 `maple`만	그 ID의 스냅샷, 또는 ID가 입력한 내용으로 시작하는 유일한 스냅샷
`3 days ago`, `12h`, `2w`, `1 month ago`	그 시점이나 그 이전의 가장 최근 스냅샷
`yesterday`, `today`	그날이 끝날 때까지의 가장 최근 스냅샷
`2026-09-20`, `2026-09-20 14:30`	그날이나 그 분, 또는 그 이전의 가장 최근 스냅샷(현지 시각 기준)

상대적인 시간은 영어로 씁니다. 분(m), 시간(h), 일(d), 주(w), 개월(mo), 년(y)을 쓸 수 있고, 단어를 그대로 써도 됩니다. "3 days ago"처럼 공백이 있는 값은 따옴표로 감싸세요.

frost status로 스냅샷과 ID 목록을 볼 수 있습니다. 입력한 내용이 여러 ID와 일치하면 Frost가 더 길게 입력하라고 요청합니다.

#복원 위치

옵션	복원 위치
`--beside`	원본 옆에 만드는 새 `frost-restore-<id>` 폴더
`--to <dir>`	`<dir>` 안에 만드는 새 `frost-restore-<id>` 폴더. `<dir>`은 이미 있어야 합니다
`--overwrite`	원래 위치. 그곳에 있는 것을 대체합니다. Frost가 먼저 확인하며, `-y`를 쓰면 확인을 건너뜁니다

새 폴더에 복원할 때는 아무것도 덮어쓰지 않습니다. 새 폴더 안에서 복원한 항목은 원래 이름을 유지하며, 선택한 항목들이 공통으로 속한 폴더를 기준으로 배치됩니다.

복원하는 항목	`--beside`의 결과
`~/Documents/taxes`	`~/Documents/frost-restore-<id>/taxes/...`
`~/notes.txt`	`~/frost-restore-<id>/notes.txt`
`~/Documents/a`와 `~/Pictures/b`	`~/frost-restore-<id>/Documents/a`와 `~/frost-restore-<id>/Pictures/b`

새 폴더 이름에는 스냅샷의 짧은 ID가 쓰입니다. 그 이름이 이미 있으면 Frost가 -1, -2 같은 번호를 붙입니다.

선택한 항목들이 공통으로 속한 곳이 드라이브 최상위뿐인 경우, 그 폴더가 이 컴퓨터에 없는 경우(다른 컴퓨터의 스냅샷 등), 그곳에 쓰기 권한이 없는 경우에는 --beside를 쓸 수 없습니다. 예를 들어 홈 폴더 전체의 스냅샷을 원래 위치 옆에 복원하면 /Users나 /home에 새 폴더를 만들어야 합니다. 이럴 때는 --to를 쓰세요.

#원본 위에 복원하기

--overwrite는 파일을 원래 위치로 되돌리고 그곳에 있는 것을 대체합니다. Frost는 할 작업을 보여 주고 먼저 확인합니다.

┌  restore maple-absurd-3f1c  2026-10-07 03:17 (1d ago)
│
│  paths        /home/you/Documents/taxes
▲  into         original locations (existing files will be replaced)
│
│  Go ahead? [y/N]

이미 스냅샷과 같은 파일은 확인한 뒤 건너뛰므로, 다시 내려받지 않습니다.
스냅샷에 없는 파일은 그대로 둡니다.
각 파일은 먼저 바로 옆의 숨겨진 임시 파일에 쓴 다음 교체됩니다. 복원 중인 파일의 사본 두 개가 들어갈 공간이 필요합니다.
스냅샷은 같은 종류의 컴퓨터에서 만든 것이어야 합니다. macOS와 Linux의 스냅샷은 macOS나 Linux에, Windows의 스냅샷은 Windows에 덮어쓸 수 있습니다.
다른 사용자가 바꿀 수 있었던 폴더 링크를 거쳐야 한다면 Frost는 복원하지 않습니다. 이것이 문제라면 확인하기 전에 알려 주고, 브라우저에서는 "Overwrite original files"가 회색으로 표시됩니다.

#안전 점검

각 청크는 쓰기 전에 복호화하고 ID와 대조합니다. 각 파일은 완성된 뒤에야 원래 이름을 갖게 되므로, 복원이 실패해도 진짜 파일이 있던 자리에 쓰다 만 파일이 남지 않습니다.

복원한 심볼릭 링크는 원래 대상을 유지하며, 그 대상이 복원 폴더 밖을 가리킬 수도 있습니다.

#중단된 복원

연결이 끊기거나, Ctrl+C를 누르거나, 컴퓨터가 잠자기에 들어가서 복원이 멈추면, Frost는 이어서 진행하는 명령어를 출력합니다.

Completed files and unfinished restore data have been preserved. To resume, run:

  frost restore maple-absurd-3f1c9a0b2e7 /home/you/Documents/taxes --beside

같은 복원을 latest나 시각 대신 스냅샷의 전체 ID로 지정한 명령어입니다. 그래서 중간에 백업이 이루어져도 대상 스냅샷은 바뀌지 않습니다. 이미 복원한 파일은 확인한 뒤 건너뛰고, 쓰던 파일은 마지막으로 온전한 청크부터 이어서 씁니다. Windows에서는 일부 경로에 PowerShell 명령어가 필요합니다. 이때는 메시지에서 PowerShell로 실행하라고 안내합니다.

복원이 끝날 때까지 복원 폴더에는 .frost-restore 표시 파일과 .frost-partial-... 파일이 있습니다. 그대로 두세요. 끝나면 Frost가 지웁니다.

컴퓨터를 잃어버린 뒤 복원하는 방법은 새 컴퓨터에서 복구를 참고하세요.