rclone으로 TrekMail Drive 연결하기

rclone은 WebDAV와 함께 작동하는 명령줄 도구입니다. 스크립트로 업로드, 다운로드, 목록 조회, 예약 백업을 수행할 때 유용합니다. 큰 작업에 사용하기 전에 작은 파일로 업로드와 다운로드를 먼저 테스트하세요. TrekMail Drive는 최대 10 TB 파일을 허용하지만 사용 가능한 저장 공간, rclone 버전, 컴퓨터의 제한도 적용됩니다.

연결 정보

rclone 설정에 필요한 정보는 다음과 같습니다.

설정 파일에 비밀번호를 직접 입력할 때는 rclone obscure dsync_…를 사용하세요. rclone은 비밀번호를 난독화할 뿐 암호화하지 않으므로 파일에 접근할 수 있는 사람은 여전히 인증 정보를 사용할 수 있습니다.

기기 비밀번호를 아직 만들지 않았다면 Sync devices를 참고하여 먼저 생성하세요.

시작하기 전에

기기 비밀번호가 필요합니다. 동기화 앱마다 별도의 일회용 비밀번호를 사용하므로 대시보드 로그인에 영향을 주지 않고 rclone 접근만 취소할 수 있습니다.

1. TrekMail 대시보드에서 Sync devices를 엽니다.
2. + Add new device를 클릭합니다.
3. Laptop, rclone과 같은 이름을 지정합니다.
4. rclone이 파일을 업로드, 이동, 삭제해야 한다면 View files와 Edit files를 선택한 상태로 둡니다. 다운로드 전용 접근은 View files만 선택합니다.
5. Generate password를 클릭하고 비밀번호 (dsync_...)를 복사합니다.

Drive 로 백업하려면 Edit files가 필요합니다. Drive 에서 다운로드만 하는 복구에는 View files만 있으면 됩니다.

rclone 설치하기

• macOS: brew install rclone
• Linux: curl https://rclone.org/install.sh | sudo bash
• Windows: rclone.org/downloads에서 다운로드하고 PATH에 추가합니다.

원격 저장소 구성하기

대화형 구성 도구를 실행합니다.

rclone config

그런 다음 다음과 같이 설정합니다.

1. 새 원격 저장소를 만들려면 n을 입력합니다.
2. 이름을 trekmail-drive 또는 원하는 이름으로 지정합니다.
3. 목록에서 WebDAV를 선택합니다. 번호는 버전마다 다르므로 "Webdav"를 찾으세요.
4. URL: Sync devices 페이지의 Drive server URL을 붙여 넣고 마지막 슬래시를 유지합니다.
5. Vendor: other를 선택합니다.
6. User: 같은 페이지에 표시된 사용자 이름을 붙여 넣습니다.
7. Password: y (yes, type my own password)를 선택한 다음 dsync_... 기기 비밀번호를 붙여 넣습니다.
8. Bearer token: 비워 둡니다.
9. Edit advanced config: n을 입력합니다.
10. Confirm: y를 입력합니다.

설정 파일을 직접 작성할 수도 있습니다. ~/.config/rclone/rclone.conf를 열고 다음을 추가합니다.

[trekmail-drive]
type = webdav
url = <copy the Drive server URL from Sync devices>
vendor = other
user = you@example.com
pass = <obscured-password>

rclone obscure dsync_...로 난독화된 비밀번호를 생성합니다.

일상 명령

파일 목록 보기

rclone ls trekmail-drive:
rclone lsd trekmail-drive:        # directories only

파일 업로드하기

rclone copy ./backup.zip trekmail-drive:Backups/

이 엔드포인트는 rclone이 기존 Drive 파일을 같은 위치에서 교체하지 못하도록 의도적으로 제한합니다. 날짜별 백업 폴더처럼 새로운 대상 이름이나 폴더를 사용하세요. 명령으로 파일을 덮어써야 한다면 현재 사본을 먼저 다운로드하거나 Drive 화면에서 대체 파일을 업로드하세요.

진행률과 함께 폴더를 단방향 업로드하기

rclone copy ./Documents trekmail-drive:Documents \
  --progress --transfers 8

--transfers 8은 rclone에 최대 여덟 개 파일을 병렬로 업로드하도록 요청합니다. 작은 값으로 시작하고 테스트 실행이 성공한 뒤에만 늘리세요.

미러 명령은 특히 주의하기

rclone sync ./Documents trekmail-drive:Documents --progress

주의: sync는 로컬에 없는 원격 파일을 삭제하고 일반적으로 기존 파일을 업데이트하려 합니다. 일회용 폴더에서 정확한 동작을 테스트하기 전에는 운영 Drive 데이터에 사용하지 마세요. 일반적인 백업에는 새로운 날짜별 폴더로 copy하는 방식을 권장합니다.

폴더로 마운트하기

mkdir ~/trekmail
rclone mount trekmail-drive: ~/trekmail \
  --vfs-cache-mode writes --daemon

Drive가 ~/trekmail로 표시됩니다. Photos, Lightroom 등 WebDAV를 지원하지 않는 도구도 일반 로컬 폴더처럼 사용할 수 있습니다.

마운트 해제하기

fusermount -u ~/trekmail           # Linux
umount ~/trekmail                  # macOS

예약 백업

Linux 또는 macOS에서는 crontab (crontab -e)에 추가합니다.

# Back up ~/Documents nightly at 2 AM
0 2 * * * /usr/local/bin/rclone copy ~/Documents trekmail-drive:Documents --quiet

Windows에서는 Task Scheduler로 같은 rclone copy 명령을 실행합니다.

대용량 전송 조정하기

여러 GB 크기의 동영상이나 데이터 세트와 같은 큰 파일에는 다음을 사용할 수 있습니다.

rclone copy ./big.iso trekmail-drive:ISOs/ \
  --transfers 4 \
  --multi-thread-streams 4 \
  --buffer-size 64M \
  --progress

이는 rclone 클라이언트 옵션이며 TrekMail의 필수 설정이 아닙니다. 기본값으로 시작하고 명령 출력을 보관하며 큰 전송을 예약하기 전에 대표 파일을 테스트하세요.

문제 해결

• 401 Unauthorized: 비밀번호가 틀렸거나 취소되었습니다. Sync devices에서 새로 생성하세요.
• 403 또는 권한 오류: 파일을 업로드하거나 변경할 때 기기 비밀번호에 Edit files 권한이 있는지 확인하세요. 필요하다면 새 비밀번호를 만드세요.
• 429 Too Many Requests 또는 반복되는 연결 오류: --transfers를 낮추고 잠시 기다린 뒤 작은 명령을 다시 시도하고 작업을 재개하세요.
• 507 Insufficient Storage: Drive 풀이 가득 찼습니다. Add-on 크기를 조정하거나 Trash를 비우세요.
• 마운트 폴더에 오래된 파일이 표시됨: rclone mount 옵션 --vfs-cache-mode writes --dir-cache-time 1m으로 rclone 캐시를 지우세요.

더 광범위한 동기화 문제는 Drive Sync 문제 해결을 참조하세요.