Nextcloud 데스크톱 동기화, "파일 처리 중" 문제 해결

Nextcloud 데스크톱 클라이언트가 "파일 처리 중" 상태에서 멈춰 있는 경우, 계정의 동기화 활동을 열어 특정 파일에서 반복적으로 오류가 발생하는지 또는 클라이언트가 여전히 대규모 폴더 트리를 스캔 중인지 확인하십시오. 먼저 해당 항목을 확인한 다음 무시된 파일 규칙과 서버 ​​연결 상태를 검토하십시오. 재시작하면 일시적인 멈춤 현상이 해결될 수 있지만, 동기화 데이터베이스를 삭제하거나 동기화 연결을 다시 생성하는 것은 선택적 동기화 설정이 초기화되거나 대규모 재검사가 발생할 수 있으므로 나중에 진행해야 합니다.

실제로 무엇이 막혔는지 알아보세요

Windows 또는 Linux에서는 시스템 트레이에서, macOS에서는 메뉴 막대에서 Nextcloud 메뉴를 열고 계정 상태를 확인하세요. 파일 이름이 반복되거나, 오류가 표시되거나, 대기열이 변경되는지 살펴보세요. 클라이언트는 동기화 중, 일시 중지됨, 오프라인, 경고 및 오류 상태를 구분합니다. 파란색 활동 아이콘만으로는 데이터 업로드가 진행 중임을 보장할 수 없습니다. 기존 동기화 모드에서는 파일 관리자 오버레이를 통해 상태를 확인할 수 있습니다. 파란색은 동기화 대기 중이거나 활성 상태임을, ​​녹색 체크 표시는 현재 진행 중임을, 빨간색 X 표시는 오류를 나타냅니다. 가상 파일/파일 공급자 모드에서는 운영 체제의 다른 상태 표시기를 사용하므로 기존 모드의 아이콘이 적용된다고 가정하기보다는 클라이언트 창과 Finder 또는 Explorer의 세부 정보를 확인하세요.

대기 중인 항목 수가 줄어들면 클라이언트를 계속 실행 상태로 두고 스캔이 완료될 때까지 기다리세요. 특히 대용량 폴더를 추가하거나 장치를 다시 연결한 후에는 더욱 그렇습니다. 만약 동일한 항목이 여전히 맨 위에 있다면 해당 항목의 오류 세부 정보를 열어보세요. 파일을 이동, 이름 변경 또는 편집하기 전에 로컬 경로와 정확한 메시지를 기록해 두세요. 대기열이 변경되는 동안 반복적으로 일시 중지했다가 다시 시작하는 것은 피하세요. 원인을 파악하는 데 도움이 되지 않을 뿐 아니라 진행 상황을 평가하기 어렵게 만들 수 있습니다.

파일 및 무시할 파일 규칙을 확인하세요

파일 하나가 진행을 방해하는 경우, 해당 파일의 이름, 경로 및 로컬 상태를 Nextcloud 웹 인터페이스의 서버 복사본과 비교하십시오. 해당 파일이 편집기에서 열려 있거나, 카메라 또는 백업 프로그램에서 쓰기 작업을 수행 중이거나, 다른 프로세스에 의해 잠겨 있지 않은지 확인하십시오. 애플리케이션이 파일을 활발하게 변경하고 있는 경우, 해당 애플리케이션을 완전히 종료하고 클라이언트가 다시 시도하도록 하십시오. 상태를 초기화하기 위해 두 복사본 중 어느 것도 삭제하지 마십시오.

일부 파일은 의도적으로 무시됩니다. Nextcloud는 다른 파일 시스템에서 표현할 수 없는 특정 시스템 파일 및 파일 이름을 제외합니다. 클라이언트 설정에서 고급 → 무시된 파일 편집 (레이블은 클라이언트 버전에 따라 다를 수 있음)을 열고 해당 이름 또는 상위 폴더에 대한 사용자 지정 패턴을 검토하십시오. 와일드카드(예: `\n`)는 *여러 문자와 일치하고, ?`\n`은 한 문자와 일치하며, 끝에 슬래시(/)가 있으면 패턴이 디렉터리로 제한됩니다. 파일이 동기화되어야 하는 경우에만 사용자 지정 규칙을 제거하거나 범위를 좁히십시오. 우선 해결 방법으로 애플리케이션과 함께 제공되는 전역 파일을 편집하지 마십시오. sync-exclude.lstNextcloud는 이 파일을 변경하면 의도치 않은 동작이 발생할 수 있다고 경고합니다.

클라이언트에서 무시되거나 동기화되지 않은 폴더 상태와 선택적 동기화 옵션도 확인하십시오. 의도적으로 제외한 폴더는 클라이언트를 다시 시작해도 동기화되지 않습니다. 문제가 특정 경로에만 영향을 미치는 경우, 간단한 폴더에 복사본을 임시로 저장하여 테스트하면 경로별 규칙과 일반적인 연결 문제를 구분하는 데 도움이 될 수 있습니다. 하지만 동일한 활성 동기화 디렉터리에 두 번째 클라우드 동기화 서비스를 사용하지 마십시오.

클라이언트 문제와 서버 연결 문제를 구분하세요

웹 브라우저에서 동일한 Nextcloud 계정에 로그인하여 파일과 폴더가 제대로 로드되는지 확인하십시오. 웹 인터페이스는 작동하지만 모든 데스크톱 장치에서 문제가 발생하는 경우, 서버의 WebDAV 엔드포인트 또는 해당 구성에 문제가 있을 수 있습니다. Nextcloud 클라이언트는 WebDAV를 사용하여 서버 파일에 액세스합니다. 서버에 설치된 경로가 인 경우 https://cloud.example.com, DAV 엔드포인트는 일반적으로 입니다 https://cloud.example.com/remote.php/dav. 실제 설치 경로를 사용하십시오. 브라우저에서 해당 주소를 열면 최소한 인증 요청 메시지가 표시되거나 엔드포인트에서 응답이 표시되어야 합니다. 인증 실패, 인증서 경고 또는 서버 오류가 발생하는 경우 로컬 클라이언트를 재설정하기보다는 관리자에게 문의하거나 서버 로그를 확인해야 합니다.

다른 동기화 프로그램, 백업 유틸리티 또는 오프라인 파일 기능이 동일한 디렉터리를 관리하고 있는지 확인하십시오. Nextcloud 문제 해결 설명서에 따르면 여러 동기화 애플리케이션으로 하나의 디렉터리를 동기화하는 것은 지원되지 않으며 데이터 손실 위험이 있습니다. 어떤 애플리케이션이 해당 폴더를 소유하고 있는지 확인하고 로컬 변경 사항을 보존한 후에만 중복된 부분을 제거하십시오. 한 대의 컴퓨터에서만 문제가 발생하는 경우 로컬 디스크 공간, 폴더 권한, 바이러스 백신 또는 액세스 시 검사, 그리고 클라이언트가 동기화 디렉터리의 파일을 읽고 이름을 변경할 수 있는지 확인하십시오.

재시작한 다음 유용한 진단 정보를 수집하세요.

1. 진행 중인 파일 작업이 모두 완료될 때까지 기다린 다음, 트레이 또는 메뉴 막대 메뉴를 통해 데스크톱 클라이언트를 종료하십시오. 그런 다음 다시 실행하고 대기 중인 작업 수가 변경되는지 확인하십시오.
2. 클라이언트가 여전히 멈추는 경우, 설정에서 고급 → 디버그 아카이브 생성…을 선택하여 진단 아카이브를 저장하십시오. 이 컨트롤의 정확한 위치는 버전 및 플랫폼에 따라 다를 수 있습니다.
3. 상태 변화가 멈춘 시점 주변의 로그를 검토하십시오. 영향을 받은 경로와 액세스 거부, 연결 실패 또는 파일 이름 제한과 같은 반복적인 오류를 찾으십시오.

디버그 아카이브에는 로그 및 데이터베이스 정보가 포함되어 있으며, 파일 이름, 계정 정보 또는 서버 주소와 같은 민감한 정보가 포함될 수 있습니다. 지원팀에 공유하기 전에 아카이브 내용을 검토하고 필요한 부분을 삭제하십시오. Nextcloud 문제 해결 문서에서 디버그 아카이브 및 클라이언트 로그를 캡처하는 다른 방법을 확인할 수 있습니다.

일치 오류가 발생한 경우에만 데이터베이스를 재설정하십시오.

"파일 처리 중"이라는 일반적인 상태 오류를 해결하기 위해 클라이언트의 동기화 데이터베이스를 임의로 삭제하지 마십시오. Nextcloud는 "CSync 알 수 없는 오류" 에 대한 보다 구체적인 해결 방법을 제시합니다 . 클라이언트를 중지하고, .sync_xxxxxxx.db클라이언트가 설정한 계정 폴더 내의 숨겨진 파일을 찾아 해당 데이터베이스를 삭제한 후 다시 시작하십시오. 단, 이 과정에서 다운로드할 파일 관련 설정도 일부 삭제될 수 있다는 점에 유의해야 합니다. 따라서 로컬 동기화 폴더를 백업하고 선택적 동기화 설정을 기록해 두십시오. 클라이언트가 실행 중인 동안에는 절대로 데이터베이스를 삭제하지 마십시오. 정확한 오류 메시지가 없는 경우, 이 복구 방법을 시도하기 전에 디버그 아카이브를 검사하거나 지원팀에 문의하십시오.

동기화가 복구되었는지 확인하십시오.

변경 후에는 스피너가 사라진 것 외에도 다른 사항들을 확인하십시오. 대기 중인 큐가 비워지고, 클라이언트가 최신 상태로 연결된 것을 표시해야 하며, 작은 테스트 파일이 로컬 환경과 웹 인터페이스 모두에서 예상 위치에 나타나는지 확인해야 합니다. 원래 문제가 발생했던 파일에 의도한 내용이 있는지, 선택적 동기화 폴더가 구성된 대로 유지되는지 확인하십시오. 동일한 파일에서 오류가 다시 발생하는 경우, 정확한 오류 메시지와 일부 내용이 삭제된 디버그 아카이브를 저장해 두십시오. 권한, 파일 이름, WebDAV 또는 클라이언트 버전 관련 문제가 반복적으로 발생하는 경우, 해당 문제를 해결하기 위한 조치가 필요합니다.

최신 클라이언트 제어 및 문제 해결 단계는 Nextcloud 데스크톱 클라이언트 사용자 설명서 및 Nextcloud 데스크톱 문제 해결 문서를 참조하십시오 . 현재 온라인 사용자 설명서는 Nextcloud 36 버전을 기준으로 작성되었으며, 클라이언트 레이블 및 사용 가능한 가상 파일 기능은 데스크톱 클라이언트 버전 및 운영 체제에 따라 다를 수 있습니다.