기술 · 실용 가이드
Syncthing에 ‘folder marker missing’가 뜨나요? .stfolder를 다시 만들기 전에 경로부터 확인하세요
이 경고는 안전을 위한 중지이며 숨김 폴더를 무조건 다시 만들라는 뜻이 아닙니다. 마운트 누락, 경로 이동, 정리 도구 삭제, 권한 오류를 읽기 전용으로 구분한 뒤 동기화를 재개하세요.
`.stfolder`가 없을 때 동기화가 멈추는 이유는 Syncthing이 이 마커로 설정 폴더가 실제로 있고 읽을 수 있는지 확인하기 때문입니다. 그렇지 않으면 분리된 드라이브나 실패한 마운트가 모든 파일 삭제처럼 보일 수 있습니다.
따라서 첫 조치는 마커 생성이 아닙니다. 영향받은 장치에서 변경을 멈추고 정확한 장치와 설정 경로를 확인한 다음, 예상 디렉터리 트리가 존재한다는 사실을 입증하고 나서 쓰기 작업을 해야 합니다.
이 가이드는 공식 복구 분기를 원인 우선 점검표로 묶습니다. 이미 사라진 바이트를 복구할 수 없고, 동기화를 백업으로 바꾸지도 않습니다.
1. 중지가 무엇을 보호하는지 이해하기
공식 FAQ에 따르면 기본 마커는 `.stfolder`입니다. Syncthing은 마운트되지 않은 파일 시스템, 분리된 USB 드라이브, 기타 누락 저장장치를 전체 삭제로 오인하지 않도록 이를 확인하며, 마커가 사라지면 폴더 동기화를 중지합니다.
마커가 돌아오면 로컬 누락이 삭제로 동기화될 수 있습니다. 따라서 마커는 무해한 캐시가 아니며, 경고는 저장장치 경계를 검증하라는 신호입니다.
2. 위험 상태를 고정하고 오류 장치를 특정하기
여러 장치에서 공유 폴더를 제거하거나 `.stfolder`를 다시 만들거나 재검색하거나 새 공유를 수락하지 마세요. 조사 중에는 대상 트리를 편집하지 말고, 다른 장치의 완전한 사본을 기준으로 보존하며 중요한 데이터는 별도 백업합니다.
실제로 오류를 표시한 장치의 이름, 폴더 레이블과 Folder ID, 설정 경로, Send & Receive 같은 폴더 유형을 기록합니다. NAS나 컨테이너에서는 내부 경로와 호스트 매핑을 모두 기록해야 합니다.
3. 쓰지 않는 증거표 만들기
행마다 오류 장치, Folder ID, 설정 경로, 예상 디스크 또는 마운트, 현재 마운트 여부, 보이는 최상위 하위 폴더, 확인용 파일, `.stfolder`, 서비스 사용자, 부모 쓰기 권한, 최근 로그, 선택 분기를 기록합니다.
설정 경로가 의도한 저장장치를 가리키고 예상 트리가 있다는 사실을 입증하지 못하면 마커를 만들지 않습니다. 이전 마운트 지점에 새로 생긴 빈 디렉터리는 경로 문자열이 같아도 원래 데이터가 아닙니다.
4. 분기 A: 드라이브나 상위 마운트가 없음
예상 디스크, USB, 네트워크 공유, 상위 파일 시스템이 마운트되지 않았다면 먼저 복구합니다. 같은 이름의 디렉터리가 아니라 볼륨 정체성이나 마운트 대상을 확인하고 여러 예상 하위 폴더와 파일을 점검합니다.
빈 마운트 지점에 `.stfolder`를 만들지 마세요. 안전 확인을 무력화해 사라진 트리를 의도적 삭제로 보이게 할 수 있습니다. 마운트가 불안정하면 Syncthing 폴더를 중지한 채 저장장치나 마운트 서비스를 따로 고칩니다.
5. 분기 B: 전체 폴더를 이동하거나 이름을 바꿈
데이터 전체와 마커를 의도적으로 옮겼다면 공식 경로는 설정 위치로 되돌리거나 오류 장치의 Syncthing에서만 제거한 뒤 새 경로로 다시 추가하는 것입니다. 다른 곳의 동기화 사본과 새 위치의 완전한 트리를 먼저 확인해야 합니다.
Syncthing UI에서 폴더를 제거하는 것은 디스크 파일 삭제와 같지 않지만 현재 버전의 확인 문구를 읽어야 합니다. 동일 공유에 다시 연결할 때만 원래 Folder ID를 쓰고, 원격 공유를 수락하기 전에 로컬 경로를 확인해 감사되지 않은 기본 위치를 피합니다.
6. 분기 C: 예상 파일은 모두 있고 마커만 없음
정리 도구가 빈 `.stfolder`를 지울 수 있으며 모바일에서 특히 흔합니다. 설정 경로, 대상 마운트, 예상 하위 트리가 모두 맞는 좁은 경우에만 재생성이 적절합니다. 공식 FAQ는 `.stfolder` 안에 더미 파일을 두거나 정리 제외에 넣는 방법을 제시합니다.
먼저 정리 도구를 멈추고, 감사로 완전함을 확인한 오류 장치에서만 마커를 만든 뒤 다음 스캔을 관찰합니다. 트리가 비었거나 불완전하면 즉시 중지하고 불확실성을 마커로 우회하지 않습니다.
7. 분기 D: 경로는 있지만 서비스가 마커를 만들 수 없음
로그의 `Failed to create folder marker`, `permission denied`, 잘못된 대상 경로는 접근 문제를 가리킵니다. 실제 실행 계정이 모든 부모를 통과하고 정확한 대상에 쓸 수 있는지 확인합니다. 컨테이너 NAS는 내부 경로와 호스트 매핑을 대조합니다.
Windows의 제어된 폴더 액세스가 생성을 막을 수 있습니다. 포럼 사례는 신뢰하는 Syncthing 실행 파일 허용으로 해결됐지만, 먼저 로그의 보호 경로와 설치 파일의 정체를 확인해야 합니다. Linux나 NAS에서는 서비스 계정의 소유권·그룹·매핑을 고치고 앱 전체를 무제한 관리자로 실행하지 않습니다.
8. 원인이 불명확하면 오류 장치에서만 다시 추가
공식 FAQ의 불확실 경로는 오류 장치에서만 폴더를 제거하고 동일한 검증 경로에 다시 추가하는 것입니다. 해당 장치의 데이터베이스 상태를 초기화하고 로컬과 원격 파일을 병합하므로, 로컬 트리 검증과 중요 데이터 백업 뒤에만 통제된 복구가 됩니다.
모든 장치에서 동시에 제거하지 마세요. 정상 사본과 원래 Folder ID를 보존합니다. 다시 추가한 뒤 항목 수와 여러 확인용 파일을 비교하고, 제공된 공유가 기본 빈 경로에 놓이면 취소한 뒤 올바른 로컬 경로를 지정합니다.
9. 복구를 검증하되 동기화를 백업으로 여기지 않기
성공 조건은 원래 오류 장치에서 경고가 사라지고, 설정 경로와 Folder ID가 증거표와 맞으며, 스캔 뒤 대표 파일이 장치 간 일치하는 것입니다. 일반 편집을 재개하기 전에 예상치 못한 삭제를 확인합니다.
공식 문서는 수정과 삭제가 전파되므로 Syncthing이 훌륭한 백업 앱은 아니라고 설명합니다. 버전 관리도 독립 백업을 대신하지 못합니다. 위험한 경로·마운트·권한 변경 전에 별도 사본을 보존하고 날짜와 실제 복구 조치를 기록합니다.
