한줄 요약
rclone copy는 목적지에만 있는 파일을 남기지만 같은 경로의 파일은 덮어쓸 수 있습니다. 작은 사본에서 dry-run → copy → check 순서로 확인하세요. 목적지 추가 파일을 허용할 때는 check --one-way를 사용하며, 크기만 같은 것으로 내용 일치를 판단하지 않습니다.
1. 기본 정보
- 대상
- rclone을 선택한 사용자의 작은 로컬 복사 시험
- 예제 환경
- Windows PowerShell · rclone 1.75.1 x64
- dry-run
- 작업 예고 · 실제 복사 아님
- copy
- 폴더 내용 복사 · 기존 파일 덮어쓰기 가능
- check
- 크기·지원 해시 비교 · 원본/사본 파일은 변경하지 않음
- 확인 범위
- 파일 경로·내용 · 시스템 백업/복원 보장과 구분
2. 복사와 확인 순서
-
1. 시험할 범위 정하기
작은 자체 TXT 파일과 새 원본·사본 폴더를 준비합니다. 프로그램 선택·공식 배포는 rclone 페이지에서 확인하세요.
-
2. dry-run 확인
복사 명령에 --dry-run을 붙여 source/destination 방향과 예정 작업을 읽습니다. 전후 파일이 실제로 바뀌지 않았는지도 확인합니다.
-
3. copy 실행
시험 경로가 맞으면 --dry-run을 뺀 copy로 복사하고 폴더 안 파일의 위치·내용을 대조합니다.
-
4. check로 검사
목적지 전용 파일을 허용하는지 정하고 기본 check 또는 --one-way로 검사합니다. 보고서와 명령 종료 결과를 함께 읽습니다.
-
5. 불일치 확인
내용 차이·누락·읽기 오류를 구분합니다. 원본이 올바른지 확인한 뒤 필요한 사본만 다시 복사하고 검사합니다.
3. 시험 준비
아래는 Windows PowerShell에서 새 로컬 폴더 두 개로 확인하는 예제입니다. rclone 공식 배포 선택을 마치고 rclone.exe가 있는 폴더에서 PowerShell을 엽니다. 이미 PATH로 실행하는 환경이라면 명령 앞의 .\rclone.exe 대신 rclone을 사용할 수 있습니다.
- 파일 탐색기에서 새 폴더 예제 원본과 예제 사본을 만듭니다. 두 폴더는 서로 안에 넣지 말고 나란히 둡니다.
- 원본 폴더에 alpha.txt·한글 메모.txt와 하위 폴더의 nested.txt처럼 짧은 자체 텍스트 파일을 넣습니다. 하위 폴더가 없어도 복사 시험은 가능합니다.
- 사본 폴더에만 목적지 전용.txt를 하나 만듭니다. 이 파일이 남는지와 검사 범위 차이를 확인하기 위한 예제입니다.
처음에는 자체 예제만 사용하세요
source가 원본, destination이 사본인지 확인하고 중요한 파일에는 별도 백업을 마련하세요. 이 예제는 클라우드 인증·sync/삭제·시스템 복구를 다루지 않습니다.
4. dry-run
경로에 공백이 있으므로 따옴표로 감쌉니다. 한 줄을 실행한 뒤 출력에 나온 원본·목적지 방향과 복사 예정 파일을 읽으세요.
.\rclone.exe copy ".\예제 원본" ".\예제 사본" --dry-run -v
dry-run은 실제 복사를 하지 않습니다. 예고된 목록이 맞는지 확인한 다음 사본 폴더가 이전과 같은지도 살펴보세요. 작업 예고나 종료 코드0을 복사 완료 증거로 판단하지 않습니다.
5. 복사
작은 시험 경로를 확인했다면 --dry-run을 뺍니다. copy는 폴더 이름을 한 겹 더 만드는 방식이 아니라 원본 폴더의 내용을 목적지에 넣습니다.
.\rclone.exe copy ".\예제 원본" ".\예제 사본" -v
예제 사본 안에 alpha.txt·한글 메모.txt·하위 폴더/nested.txt가 있는지 봅니다. 사본/예제 원본/alpha.txt처럼 원본 폴더 이름까지 중첩되는 결과를 기대하지 마세요. 목적지 전용.txt는 남아 있어야 합니다.
추가 파일 보존과 덮어쓰기는 다릅니다
copy가 목적지 전용 파일을 남긴다고 해서 같은 경로의 이전 내용도 보관하는 것은 아닙니다. 원본이 바뀌어 다시 복사되면 같은 경로의 사본이 바뀔 수 있습니다. 이것을 별도 버전 백업으로 판단하지 마세요.
6. 검사 범위
원본 파일이 사본에 같은 내용으로 있는지 확인하고, 목적지 전용 파일은 허용하려면 --one-way로 검사합니다. --combined는 결과 목록을 현재 작업 폴더의 check-one-way.txt에 기록합니다.
.\rclone.exe check ".\예제 원본" ".\예제 사본" --one-way --combined check-one-way.txt
명령이 끝난 직후 PowerShell에서 다음 값을 읽습니다. 0은 해당 명령의 검사 범위에서 성공한 종료 결과이며, 0이 아니면 로그와 보고서에서 차이·오류를 확인합니다. 다음 명령을 실행하기 전에 읽으세요.
$LASTEXITCODE
one-way는 목적지에만 있는 파일을 검사 대상에서 제외합니다. 양쪽의 파일 구성을 비교하려면 옵션을 빼고 다른 보고서 이름으로 실행합니다. 예제처럼 목적지 전용 파일이 있으면 기본 검사에 차이로 잡히는 것이 정상입니다.
.\rclone.exe check ".\예제 원본" ".\예제 사본" --combined check-default.txt
check는 원본·사본의 파일 내용을 바꾸지 않습니다. 다만 위 --combined로 지정한 보고서는 별도로 기록됩니다. 내용 비교에 사용되는 해시는 저장소의 지원 조건에 따라 달라집니다. --size-only는 크기만 비교하며, 해시를 제공하지 않는 저장소의 --download는 양쪽 데이터를 읽는 별도 방식입니다. 클라우드에서는 전송 비용·시간도 확인해야 합니다.
7. 보고서 읽기
check 보고서에는 상대 파일 경로 앞에 기호가 붙습니다. 같은 이름의 보고서를 다시 지정하면 그 파일을 덮어쓸 수 있으므로 이전 결과가 필요하면 새 이름을 사용하세요.
| 기호 | 의미 | 다음 확인 |
|---|---|---|
| = | 원본·사본에서 검사 기준상 일치 | 검사 옵션과 포함 범위 확인 |
| - | 목적지에만 있는 파일 | 추가 파일을 허용할지 판단 |
| + | 원본에 있고 목적지에는 없음 | 복사 범위와 누락 경로 확인 |
| * | 양쪽에 있으나 다름 | 크기·내용과 올바른 원본 확인 |
| ! | 읽기 또는 해시 계산 오류 | 권한·접근 상태와 오류 로그 확인 |
기호의 의미는 공식 check 문서에 근거합니다. 아래 직접 예제에서는 =, -, *를 확인했고 누락/+와 읽기 오류/!는 재현하지 않았습니다.
8. 자체 예제 결과
공식 rclone 1.75.1 Windows x64 ZIP의 SHA256을 공식 목록과 대조한 뒤, 한글·공백 경로의 자체 TXT3개와 목적지 전용 TXT1개로 시험했습니다. 클라우드 계정·전송이나 다른 OS의 결과는 아닙니다.
| 시험 | 관측 | 해석 |
|---|---|---|
| dry-run | 원본3개·목적지1개의 지문 그대로 | 작업 예고만 수행 |
| 첫 copy | 원본3개 일치·목적지 전용1개 유지 | 폴더 내용 복사·추가 파일 보존 |
| 기본 check | 목적지 전용 파일 검출·종료1 | 양쪽 구성의 차이 |
| check --one-way | 원본3개 일치·종료0 | 목적지 전용 파일 제외 |
| 수정 원본 재복사 | alpha.txt의 내용·지문 변경 | 같은 경로의 사본 덮어쓰기 |
| 같은 크기 불일치 | 23바이트 파일의 내용만 변경 | 크기 일치·내용 불일치 |
| size-only 검사 | 종료0 | 다른 내용을 크기만으로 검출 못함 |
| 해시·download 검사 | alpha.txt의 * 검출·종료1 | 같은 크기 내용 차이 확인 |
| checksum 재복사 후 검사 | 원본3개 일치·종료0 | 자체 불일치 사본 수정 확인 |
이 예제의 check 전후 원본·사본 지문도 같았습니다. 숫자 종료 코드는 해당 환경의 관측이며 모든 공급자의 오류 코드를 그대로 약속하지 않습니다. 자신의 보고서·경로·내용을 함께 확인하세요.
9. 불일치 확인
- 누락이면 source/destination 방향과 실제 상대 경로부터 확인합니다. 예상한 폴더 이름이 중첩됐는지도 살펴보세요.
- 목적지 전용 파일이면 그 파일을 남길 목적이었는지 판단합니다. one-way 성공이 목적지 전체에 추가 파일이 없다는 뜻은 아닙니다.
- 내용 차이면 원본이 올바른지 먼저 확인합니다. 사본에만 필요한 수정이 있다면 덮어쓰기 전에 별도로 보관하세요.
- 읽기/해시 오류이면 권한·저장소 접근과 오류 로그를 확인합니다. 오류를 옵션으로 숨기고 성공으로 판단하지 마세요.
자체 예제에서 같은 크기의 다른 내용을 다시 복사할 때는 --checksum으로 변화 비교에 지원 해시를 사용했습니다. 올바른 원본과 덮어쓸 사본을 확인한 작은 시험 범위에서만 실행하고, 이후 check를 다시 수행합니다. 해시가 없는 저장소에서는 이 옵션의 비교 방식도 달라질 수 있습니다.
.\rclone.exe copy ".\예제 원본" ".\예제 사본" --checksum -v
파일 내용을 화면으로 비교할 필요가 있으면 WinMerge를 비교하고, 프로그램·공식 다운로드 선택은 rclone 페이지로 돌아가세요. 이 과업의 확인은 파일 경로·내용에 한정되며 권한·메타데이터·빈 폴더·이전 버전이나 시스템 복구까지 검증한 것은 아닙니다.
copy 대신 sync를 검토한다면 동기화 전에 삭제 예정 파일·방향 확인으로 이어가세요. 실제 동기화에 앞서 예고를 읽고 중단 여부를 판단하는 별도 과업입니다.
10. 자주 묻는 질문
copy는 목적지 파일을 전부 보존하나요?
+
목적지에만 있는 파일은 남지만 같은 경로의 기존 파일은 비교 결과에 따라 덮어쓸 수 있습니다. 별도 버전 백업과 같은 동작으로 판단하지 마세요.
dry-run이 종료0이면 복사가 완료됐나요?
+
dry-run은 실제 복사를 수행하지 않습니다. 예정 작업을 확인한 뒤 copy와 결과 검사를 별도로 진행해야 합니다.
one-way가 성공하면 두 폴더가 완전히 같은가요?
+
원본 파일이 목적지에 검사 기준상 일치하는지 확인하는 범위입니다. 목적지에만 있는 추가 파일은 검사에서 제외하므로 양쪽 전체가 같은 구성이라는 뜻은 아닙니다.
크기가 같으면 내용도 같은가요?
+
같은 크기로 다른 내용을 만들 수 있습니다. 직접 예제에서도 크기 검사는 통과했지만 해시 검사에서는 차이를 검출했습니다. 지원 해시와 검사 옵션을 확인하세요.
check는 원본이나 사본을 수정하나요?
+
check는 비교하는 파일 내용을 변경하지 않습니다. --combined로 지정한 결과 보고서는 별도로 기록되므로 보고서 경로와 이름도 확인하세요.
이 예제로 클라우드 백업도 검증됐나요?
+
자체 로컬 파일의 복사·검사 결과만 확인했습니다. 클라우드 인증·공급자 해시·요금·권한과 전체 백업/복구 조건은 별도로 확인해야 합니다.
11. 참고 자료
관련 가이드
함께 보면 좋은
