설치 · 사용법

Syncthing 파일 버전 관리 — 이전 파일 보관·복원

먼저 확인

파일 버전 관리는 이전 사본을 남길 수신 기기의 폴더에 미리 켜야 합니다. 다른 기기에서 온 수정·삭제를 받기 전 파일을 보관하며, 실제 보관본이 있어야 시점을 골라 복원할 수 있습니다. 같은 기기의 로컬 수정이나 설정 전 손실까지 되돌리는 기능은 아닙니다.

기본 정보

대상
이미 공유한 Windows PC의 일반 Send & Receive 폴더
설정 위치
이전 파일을 보관할 수신 기기 · 폴더마다 설정
보관 대상
다른 기기에서 받은 변경 전 파일 · 기본 위치 .stversions
핵심 한계
보관본 없는 과거 손실·같은 기기의 로컬 수정은 소급 보호하지 않음
확인 범위
공식 문서·UI 소스 기반 안내 · 실제 복원 결과는 미검증

1. 보관·복원 확인 순서

  1. 1. 기기와 폴더 확인

    이전 파일을 남길 수신 PC의 Web GUI에서 실제 공유 폴더와 경로를 확인합니다. 중요한 파일 대신 시험 사본으로 시작하세요.

  2. 2. 미리 보관 설정

    해당 폴더의 편집 → File Versioning에서 Simple File Versioning과 보관 수·정리 기간을 정하고 저장합니다.

  3. 3. 보관본 확인

    다른 기기에서 변경을 받은 뒤 수신 PC의 버전 복원 목록에 해당 파일·보관 시점이 남는지 확인합니다.

  4. 4. 필요한 시점 복원

    현재 파일을 공유 폴더 밖에 따로 보관하고, 복원 목록에서 필요한 파일·시점과 선택 개수를 확인한 뒤 복원을 진행합니다.

  5. 5. 내용과 동기화 확인

    복원한 경로에서 파일을 열어 내용·시점을 확인하고, 기기 간 연결을 다시 사용할 때 변경이 어떻게 반영되는지 확인합니다.

2. 먼저 확인할 조건

이 글은 이미 연결된 두 기기의 일반 Send & Receive 폴더에서 이전 파일을 보관하고 복원 여부를 확인하는 절차입니다. 처음 설치·장치 ID 등록은 Syncthing 대표 페이지를 참고하세요. Receive Only의 로컬 변경 되돌리기나 모바일 앱별 복원은 다른 과업입니다.

공식 문서 기반 안내

아래 조건과 화면 문구는 공식 문서·공식 UI 소스에서 확인했습니다. 실제 파일 보관·복원 성공을 직접 확인한 예제는 아니므로 자신의 시험 사본에서 결과를 먼저 확인하세요.

설정할 기기를 먼저 구분
상황 보관되는 곳
A에서 수정·삭제, B가 변경을 받음 B의 해당 폴더에 버전 관리가 미리 켜져 있으면 B에서 이전 파일 보관
B에서 직접 파일 수정 B 자신의 버전 관리가 이 로컬 수정 전 파일까지 보관하는 것은 아님
손실 뒤에 버전 관리 켜기 기존 보관본이 없다면 과거 파일이 새로 생기지는 않음

3. 보관 방식 선택

내장 전략의 차이
방식 선택 기준
Simple 파일마다 정한 수의 이전 버전 보관. 여러 시점이 필요한 경우 검토
Trash Can 같은 이름의 직전 보관본을 교체하는 방식. 여러 변경 이력을 모두 유지하지 않음
Staggered 시간 간격·최대 기간에 따라 과거 버전을 정리. 모든 시점을 계속 남기는 방식은 아님

기본값은 버전 관리 사용 안 함입니다. 외부 명령 전략은 별도 프로그램·스크립트를 실행하는 구성이므로 여기서는 다루지 않습니다. 보관 수와 기간이 많을수록 추가 디스크 공간도 고려해야 합니다.

4. 수신 폴더에 설정

수신 PC의 Web GUI에서 대상 폴더를 펼쳐 편집 → File Versioning을 엽니다. Simple File Versioning을 선택하고 Keep Versions에 남길 이전 버전 수를 정합니다. 기간 정리 항목도 확인한 뒤 저장하세요. 언어·앱에 따라 번역과 배치가 다를 수 있습니다.

예를 들어 파일별 이전 버전3개를 남기도록 선택할 수 있지만, 이는 권장 보존량이나 직접 시험한 결과값이 아닙니다. 업무상 필요한 보관 기간과 폴더 크기에 맞춰 정해야 합니다. Simple의 기간 정리 조건도 함께 적용될 수 있습니다.

이 설정은 수신 기기와 해당 폴더의 설정입니다. 다른 기기·폴더까지 자동으로 같은 보관 정책이 켜지는 것은 아닙니다. 기본 위치는 공유 폴더 안의 .stversions이며 별도 경로를 지정했다면 실제 보관 위치도 확인하세요.

5. 남은 버전 확인

작은 시험 파일을 다른 기기에서 수정한 뒤 수신 PC로 변경이 반영되는지 확인합니다. 해당 폴더의 버전 복원(Versions / Restore Versions) 화면에서 파일 경로·보관 시점·크기를 확인하세요. 일반 파일 목록에서 파일이 보인다는 것만으로 이전 버전이 보관됐다고 판단하지 마세요.

보관 시점과 원래 수정 시점은 다를 수 있습니다. 원하는 내용을 가진 버전이 실제로 있는지가 중요합니다. 목록이 비어 있으면 설정 기기·폴더·실제 보관 경로와 보관 기간·정리 조건을 확인합니다. 이미 보관 기간이 지나 정리된 버전은 이 설정만으로 되살아나지 않습니다.

6. 시점 선택과 복원

  • 현재 파일이 남아 있다면 공유 폴더 밖의 별도 위치에 사본을 보관합니다.
  • 필요하면 상대 기기와의 동기화를 잠시 중지해 복원 중 다른 변경이 섞이지 않게 합니다. 복원 작업을 하는 PC의 파일 경로와 폴더 상태도 확인합니다.
  • Restore Versions 목록에서 필요한 파일을 찾고 보관 시점을 선택합니다. 최신 버전을 일괄 선택하기보다 필요한 내용을 기준으로 고릅니다.
  • 복원 대상 파일과 선택 개수를 확인한 뒤 복원 확인을 진행합니다. 오류가 보이면 완료로 판단하지 않습니다.

복원은 공유 폴더의 현재 파일에 영향을 줄 수 있습니다. 목록에서 항목을 선택한 것과 복원이 완료된 것은 다릅니다. 공식 복원 동작은 실제 보관된 파일 경로·시점을 대상으로 하며 파일별 오류가 발생할 수도 있습니다.

7. 복원 후 내용 확인

  • 예상한 경로에 파일이 생겼는지 확인하고 직접 열어 필요한 내용이 맞는지 대조합니다.
  • 파일 이름·크기만 같다는 이유로 원하는 시점의 내용이라고 판단하지 않습니다.
  • 임시로 멈춘 상대 연결을 다시 사용할 때 복원한 변경이 다른 기기에 반영될 수 있음을 고려합니다. 양쪽 파일 내용과 동기화 상태를 확인하세요.
  • 확인이 끝날 때까지 별도로 남긴 현재 사본을 보존하고 독립 백업도 유지합니다.

복원 목록의 시점·완료 메시지와 실제 파일의 내용을 함께 확인해야 합니다. 이 글은 모든 폴더 유형에서 같은 복원·재전파 결과가 나온다고 보장하지 않습니다.

8. 복원되지 않을 때

먼저 구별할 상황
상황 판단
보관본이 없음 설정 전 손실·로컬 수정·보관 정책에 따른 정리 여부 확인. 설정을 다시 켜는 것으로 소급 복구되지 않음
다른 폴더·기기에서 찾음 이전 파일을 보관하도록 설정한 수신 기기의 실제 경로 확인
sync-conflict 파일이 있음 동시 편집에서 생긴 충돌 사본. 버전 보관 목록과 별개로 내용 비교
일부 파일 복원 오류 선택한 경로·시점과 오류를 확인. 일괄 성공으로 판단하지 않기

버전 관리는 동기화된 실수를 일부 되돌릴 수 있도록 이전 파일을 남기는 기능입니다. 기기 고장·보관 폴더 손상·보관본 없는 손실까지 해결하는 독립 백업은 아니므로 중요한 자료는 별도로 보관하세요.

9. 자주 묻는 질문

원본을 수정하는 PC에만 켜면 되나요?

+

보관하고 싶은 이전 파일이 있는 수신 기기의 해당 폴더에 설정해야 합니다. 같은 PC에서 직접 수정한 파일의 이전 상태를 그 PC의 버전 관리가 모두 보관하는 기능은 아닙니다.

삭제한 뒤 버전 관리를 켜면 복구되나요?

+

기존 보관본이 없다면 과거 파일이 새로 생기지 않습니다. 실제 남아 있는 버전이나 별도 백업이 있는지부터 확인해야 합니다.

.stversions가 보이면 백업이 완료된 건가요?

+

보관 폴더의 존재만으로 필요한 파일과 시점이 남았다고 판단하지 마세요. 실제 보관 목록과 내용을 확인해야 하며 독립 백업도 별도로 유지해야 합니다.

파일 충돌 사본도 버전 관리의 일부인가요?

+

동시 변경으로 생긴 sync-conflict 파일은 별개의 일반 파일입니다. 보관 전략으로 남은 이전 버전과 같은 목록·보호 범위로 취급하지 마세요.

복원하면 다른 기기에도 바뀐 내용이 전달되나요?

+

공유 폴더 안의 변경은 다시 동기화될 수 있습니다. 복원 전 현재 사본을 따로 남기고 연결을 다시 사용할 때 양쪽 내용과 상태를 확인하세요. 폴더 유형별 동작을 일반화하지 않습니다.

출처: 공식 파일 버전 관리, 보관 파일·시점 목록, 버전 복원 동작·오류

함께 보면 좋은