Box 동기화 오류 해결 — RcloneView로 해결하는 방법

2026년 10월 23일 · 약 6분

Junior Engineer

RcloneView에 이미 내장된 도구로 실패한 Box 전송을 진단하는 실용적인 체크리스트입니다.

Box 동기화 작업은 대개 몇 가지 반복되는 이유로 실패합니다. 만료된 로그인, 잘못된 계정 유형, 제한된 API 호출, 또는 Box가 일반 문서와 다르게 처리하는 파일 등입니다. RcloneView는 작업 기록, 로그, 내장 터미널을 제공하여 이러한 원인을 빠르게 구분할 수 있게 해 줍니다. 또한 RcloneView는 하나의 창에서 90개 이상의 제공자를 마운트하고 동기화할 수 있으며 Windows, macOS, Linux에서 동작하므로, 같은 파일을 다른 리모트에서 테스트해 볼 수도 있습니다.

모든 클라우드를 한 곳에서 관리하고 동기화하세요

RcloneView는 rclone의 크로스플랫폼 GUI입니다. 폴더를 비교하고, 파일을 전송·동기화하고, 깔끔한 시각적 인터페이스로 멀티 클라우드 워크플로를 자동화하세요.

원클릭 작업: 복사 · 동기화 · 비교
안정적인 자동화를 위한 스케줄러와 작업 이력
Google Drive, OneDrive, Dropbox, S3, WebDAV, SFTP 등 지원

WindowsmacOSLinux

무료로 시작하기 →

핵심 기능은 무료. Plus로 자동화 기능 이용 가능.

작업 기록과 로그 탭부터 확인하기

작업 기록(Job History)을 열어 실패한 실행의 상태(Completed, Errored, Canceled)와 전송된 크기, 파일 수를 확인하세요. 일부만 전송되었다면 파일별 문제일 가능성이 높습니다. 작업이 즉시 실패한다면 대개 인증이나 설정 문제입니다.

자세한 내용은 하단의 로그(Log) 탭으로 전환하세요. 더 많은 정보를 기록하려면 Embedded Rclone 설정에서 rclone 로깅을 활성화하고 레벨을 DEBUG로 설정한 다음, 내장 rclone을 재시작하고 오류를 재현하세요.

재인증하고 계정 유형 확인하기

모든 요청이 실패한다면 OAuth 토큰이 만료되었거나 취소되었을 수 있습니다. 리모트 관리자(Remote Manager)를 열고 Box 리모트를 편집한 다음, 브라우저를 통해 다시 로그인하세요.

로그인은 되지만 폴더가 보이지 않거나 권한 오류가 발생한다면 계정 유형을 확인하세요. Box for Business는 리모트에 box_sub_type = enterprise 설정이 필요합니다. 비즈니스 계정에 개인 계정 설정을 사용하는 것은 혼란스러운 결과가 나타나는 흔한 원인입니다.

속도 제한과 대용량 작업 처리하기

수천 개의 작은 파일을 한꺼번에 처리하면 Box가 요청을 제한할 수 있습니다. 작업의 고급 설정(Advanced Settings)에서 파일 전송 수와 동등성 검사기(equality checkers) 수를 낮추세요(느린 백엔드에는 4개 이하 권장). 일시적인 실패가 자동으로 복구되도록 재시도는 기본값인 3으로 두세요.

문제가 되는 파일 걸러내기

Box Notes와 같은 온라인 전용 항목은 일반 파일이 아닙니다. 필터링 단계의 사전 정의된 Box Docs 필터를 사용하면 이러한 항목이 제외되어 더 이상 작업을 실패시키지 않습니다. 사용자 지정 규칙을 추가하거나, 최대 파일 크기를 설정하거나, 조사하는 동안 문제가 되는 폴더를 제외할 수도 있습니다. 이후 Dry Run을 실행하여 복사될 항목을 확인하세요.