RcloneView에서 Rclone 설정 파일 손상 및 복구 문제 해결하기

2026년 4월 6일 · 약 10분

Senior Engineer

rclone 설정 파일이 손상되면 클라우드 리모트가 모두 사라질 수 있습니다. 이 가이드에서는 이런 문제가 발생하는 이유, 복구 방법, 재발 방지 방법을 설명합니다.

rclone 설정 파일(rclone.conf)에는 설정한 모든 리모트 — 클라우드 자격 증명, 토큰, 암호화 키, 연결 설정 — 이 저장됩니다. 이 파일이 손상되면 복구하거나 다시 만들기 전까지 구성된 모든 리모트에 접근할 수 없게 됩니다. RcloneView는 rclone CLI와 동일한 설정 파일을 읽고 씁니다. 따라서 손상은 두 도구 모두에 똑같이 영향을 줍니다. 문제를 진단하고 해결하는 방법을 알아보겠습니다.

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

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

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

WindowsmacOSLinux

무료로 시작하기 →

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

설정 파일 손상의 증상

다음 중 하나라도 겪고 있다면 설정 파일이 손상되었을 수 있습니다.

리모트가 사라짐 — RcloneView의 리모트 목록에서 사라지거나 rclone listremotes가 아무것도 반환하지 않습니다.
파싱 오류 발생 — 시작 시 Failed to load config file 또는 invalid character 같은 오류가 나타납니다.
인증 실패 — 이전에 정상적으로 작동하던 리모트에서 토큰 오류나 자격 증명 불일치가 발생합니다.
일부 리모트 항목만 로드됨 — 일부 리모트는 로드되지만 나머지는 누락되거나 설정이 불완전합니다.
텍스트가 깨짐 — 텍스트 편집기에서 rclone.conf를 열면 INI 형식의 섹션 대신 읽을 수 없는 문자가 보입니다.

Check RcloneView job history for config-related errors

일반적인 원인

설정 저장 중단

가장 흔한 원인은 쓰기 작업이 완료되기 전에 중단되는 것입니다. 다음과 같은 상황에서 발생할 수 있습니다.

rclone이 토큰 갱신을 저장하는 도중 시스템이 충돌하거나 전원이 끊긴 경우.
설정을 업데이트하는 도중 RcloneView나 rclone을 강제 종료한 경우.
디스크 공간 부족이나 파일 시스템 오류로 디스크 쓰기가 실패한 경우.

디스크 및 파일 시스템 오류

기본 저장 장치 문제는 설정 파일을 포함한 모든 파일을 조용히 손상시킬 수 있습니다.

하드 드라이브의 배드 섹터.
비정상 종료 이후 발생한 파일 시스템 손상.
네트워크 파일 시스템(NFS/SMB) 지연으로 인한 부분 쓰기.

암호화 키 문제

설정 파일이 RCLONE_CONFIG_PASS로 암호화된 경우 다음과 같은 상황에서 문제가 발생합니다.

비밀번호 환경 변수가 설정되지 않았거나 세션마다 변경되는 경우.
비밀번호가 저장된 키체인 항목이 삭제되거나 초기화된 경우.
비밀번호를 함께 옮기지 않고 설정 파일만 다른 컴퓨터로 복사한 경우.

수동 편집 실수

rclone.conf를 텍스트 편집기에서 열어 실수로 구문 오류를 만드는 경우 — 대괄호 누락, INI 섹션 헤더 손상, 줄 삭제 등 — 파서 입장에서는 설정 파일이 손상됩니다.

설정 파일 위치 찾기

복구하기 전에 설정 파일을 먼저 찾으세요.

OS	기본 위치
Windows	`%APPDATA%\rclone\rclone.conf`
macOS	`~/.config/rclone/rclone.conf`
Linux	`~/.config/rclone/rclone.conf`

터미널에서 rclone config file을 실행하면 현재 사용 중인 설정 파일 경로를 확인할 수 있습니다. RcloneView도 동일한 파일 경로를 사용합니다.

복구 단계

1단계: 백업 사본 확인

변경 작업을 시작하기 전에 자동 또는 수동 백업이 있는지 확인하세요.

일부 시스템은 같은 디렉터리에 .bak 파일을 생성합니다. rclone.conf.bak을 확인하세요.
홈 디렉터리에 백업 도구나 클라우드 동기화를 사용 중이라면 최근 스냅샷에서 파일을 복구하세요.
시스템의 휴지통을 확인하세요 — 일부 편집기는 임시 사본을 생성합니다.

2단계: 파일 구조 검증

일반 텍스트 편집기에서 rclone.conf를 열어보세요. 정상적인 설정 파일은 다음과 같은 모습입니다.

[my-gdrive]
type = drive
client_id = ...
client_secret = ...
token = {"access_token":"...","token_type":"Bearer",...}

[my-s3]
type = s3
provider = AWS
access_key_id = AKIA...
secret_access_key = ...
region = us-east-1

[section] 헤더 누락, 잘린 줄, 바이너리 문자, 불완전한 JSON 토큰 문자열이 있는지 확인하세요.

3단계: 부분 손상 복구

파일의 일부만 손상된 경우:

손상된 파일을 먼저 백업하세요 — rclone.conf.corrupt로 복사합니다.
손상된 섹션 제거 — 문제가 있는 리모트 항목을 완전히 삭제합니다.
리모트 다시 추가 — RcloneView의 새 리모트 마법사를 사용해 다시 추가합니다.

Re-add a cloud remote in RcloneView after config repair

4단계: 처음부터 다시 구성

파일을 전혀 읽을 수 없는 경우:

손상된 파일 이름을 rclone.conf.old로 변경하세요.
RcloneView를 실행하면 — 새로운 빈 설정 파일로 시작합니다.
설정 마법사를 사용해 각 리모트를 다시 추가하세요. OAuth 기반 리모트(Google Drive, OneDrive, Dropbox)는 다시 인증해야 합니다.
S3 호환 리모트의 경우 액세스 키와 시크릿 키가 필요합니다.

RcloneView explorer after rebuilding remotes

5단계: 암호화된 설정 복구

설정 파일이 암호화되어 있고 비밀번호를 알고 있다면:

환경 변수에 RCLONE_CONFIG_PASS를 설정하세요.
rclone config show를 실행해 복호화가 정상적으로 되는지 확인하세요.
정상적으로 복호화된다면 설정 파일은 손상된 것이 아니라 비밀번호가 누락된 것이 문제였습니다.

암호화 비밀번호를 잃어버렸다면 설정 파일을 복호화할 수 없습니다. 모든 리모트를 처음부터 다시 만들어야 합니다.

예방 팁

정기적으로 백업하세요 — 리모트를 추가하거나 변경한 후 rclone.conf를 안전한 위치에 복사하세요. cp ~/.config/rclone/rclone.conf ~/.config/rclone/rclone.conf.backup 같은 간단한 명령으로 충분합니다.
자격 증명을 별도로 보관하세요 — S3 키, SFTP 정보, RCLONE_CONFIG_PASS는 비밀번호 관리자에 보관하세요.
토큰 갱신이나 설정 저장 중에는 RcloneView나 rclone을 절대 강제 종료하지 마세요.
설정 파일이 저장된 드라이브에 충분한 디스크 공간을 확보하세요.
rclone.conf를 수동으로 편집하는 대신 GUI를 사용해 리모트를 관리하세요.