Mengatasi Error rclone dengan RcloneView: Perbaiki Batas API, Izin Akses, Timeout, dan Lainnya
Rclone memang andal, tetapi error seperti batas rate 403, timeout, atau "permission denied" bisa menghentikan proses migrasi. RcloneView menggabungkan visibilitas CLI dengan konteks GUI sehingga Anda bisa menemukan penyebabnya lebih cepat dan memperbaikinya dengan aman.
Jika Anda pernah menatap deretan output rclone sambil bertanya-tanya mengapa sebuah job gagal, RcloneView bisa mempersingkat proses tersebut. Terminal bawaan, log verbose, dan Job History membantu Anda mereproduksi masalah, mengisolasi file yang gagal, dan menyesuaikan pengaturan performa atau autentikasi tanpa perlu keluar dari aplikasi.

Kelola & Sinkronkan Semua Cloud di Satu Tempat
RcloneView adalah GUI lintas platform untuk rclone. Bandingkan folder, transfer atau sinkronkan file, dan otomatiskan alur kerja multi-cloud dengan antarmuka visual yang bersih.
- Pekerjaan sekali klik: Salin · Sinkronkan · Bandingkan
- Penjadwal & riwayat untuk otomatisasi yang andal
- Bekerja dengan Google Drive, OneDrive, Dropbox, S3, WebDAV, SFTP, dan lainnya
Fitur inti gratis. Otomatisasi Plus tersedia.
Mengapa error rclone terjadi
- Batas dan kuota API: respons 403 atau 429 dari Google Drive, OneDrive, Dropbox, dll.
- Masalah scope autentikasi: token kedaluwarsa atau izin yang hilang.
- Ketidakcocokan path dan izin akses: shared drive, folder eksternal, atau root path yang salah.
- Kondisi jaringan: timeout, throttling, atau koneksi tidak stabil.
- Pemeriksaan integritas: checksum yang tidak cocok saat provider mengubah unggahan.
Error umum dan artinya
| Error | Biasanya berarti | Langkah cepat berikutnya |
|---|---|---|
| 403: Rate Limit Exceeded / 429 Too Many Requests | Provider membatasi (throttle) permintaan | Turunkan --transfers, tambahkan --tpslimit, coba lagi dengan backoff |
| Failed to copy: permission denied | Tidak memiliki akses ke folder atau file | Periksa path, cek izin shared drive, autentikasi ulang dengan scope yang benar |
| Failed to refresh token | Token OAuth kedaluwarsa atau tidak valid | Sambungkan ulang remote melalui alur OAuth RcloneView |
| Directory not found | Path salah ketik atau root yang salah | Konfirmasi path menggunakan rclone lsf remote: |
| Timeout waiting for connection | Jaringan tidak stabil atau firewall | Kurangi paralelisme, coba lagi dengan --retries dan --low-level-retries |
| Upload failed: corrupted on transfer | Pemeriksaan integritas gagal | Jalankan ulang dengan --checksum atau rclone check |
Gunakan RcloneView Terminal untuk mereproduksi dan memeriksa error
Jalankan ulang perintah yang gagal di dalam Terminal bawaan untuk menghilangkan variabel seperti direktori kerja atau konfigurasi yang salah.
- Buka tab Terminal dan ketik
rcloneuntuk melihat semua perintah (autocomplete). Panduan - Tambahkan
-vvuntuk menangkap output verbose yang bisa Anda salin atau bagikan.
Contoh:
rclone about myremote: -vv
rclone lsf myremote:path -vv --dirs-only --recursive
rclone sync src: dst: -vv --transfers=8
Periksa Job Logs dan History untuk menemukan pola
Tampilan Job Monitor dan History menunjukkan file mana yang gagal dan seberapa sering.
- Job Monitor: tab Transfer langsung untuk job yang sedang berjalan, ditambah log Completed/API untuk job yang sudah selesai. Lihat langkahnya
- History: buka History dari job tertentu melalui Job Manager untuk meninjau hasil per file. Lihat langkahnya
Perbaiki error batas rate API dan kuota
- Turunkan konkurensi: kurangi
--transfersdan--checkersdi opsi job atau flag perintah. - Tambahkan throttling yang santun: gunakan
--tpslimitdan--tpslimit-burstuntuk provider dengan API yang ketat. - Pecah job besar: jalankan per folder atau jadwalkan saat jam sepi melalui Job Manager.
- Gunakan proses incremental: gabungkan Compare + Sync untuk hanya memindahkan file yang berubah dan mengurangi jumlah panggilan API.
Perbaiki masalah autentikasi dan OAuth
- Autentikasi ulang remote dengan scope yang benar menggunakan prompt OAuth RcloneView.
- Jika token kedaluwarsa atau dicabut, buat ulang remote atau refresh melalui Terminal dengan
rclone config reconnect remote:. - Untuk shared drive atau akun yang didelegasikan, pastikan remote diatur dengan drive ID atau tenant ID yang benar.
Perbaiki error permission denied
- Konfirmasi path tersebut ada dan Anda memiliki akses:
rclone lsf remote:folderdi Terminal. - Untuk Google shared drive atau folder bersama Dropbox, pastikan remote menggunakan root atau drive ID yang benar.
- Jika menyalin ke shared drive, pastikan Anda memiliki izin tulis; jika tidak, pilih tujuan yang Anda miliki sendiri.
Perbaiki timeout dan koneksi yang tidak stabil
- Kurangi paralelisme untuk koneksi yang rentan:
--transfers=2 --checkers=2. - Tingkatkan perilaku retry:
--retries=10 --retries-sleep=5s --low-level-retries=20. - Untuk file besar, aktifkan multi-thread streaming:
--multi-thread-streams=4 --multi-thread-cutoff=64M. - Uji keterjangkauan (reachability) dari Terminal dengan perintah ringan sebelum sinkronisasi besar:
rclone lsf remote: --max-depth 1 --fast-list -vv
Perbaiki error integritas data dan checksum
- Verifikasi sumber dan tujuan dengan dry run:
--dry-runpada job Sync atau Copy. - Gunakan
rclone checkuntuk membandingkan checksum antara dua remote:
rclone check source:folder dest:folder --one-way --size-only
- Aktifkan perbandingan checksum pada provider yang mendukungnya untuk mendeteksi kerusakan data yang tidak terlihat.
Kapan menggunakan GUI vs Terminal
- GUI: membuat job, menjadwalkan pencadangan berulang, Compare sebelum sinkronisasi, drag-and-drop antar cloud.
- Terminal: mendiagnosis error dengan cepat, menguji flag backend, atau menjalankan perintah ad-hoc dengan log
-vvlengkap. - Gunakan keduanya: buat prototipe di Terminal, lalu simpan perintah yang stabil sebagai job yang dapat digunakan kembali.
Daftar periksa troubleshooting cepat
- Reproduksi error di Terminal dengan
-vvdan salin log-nya. - Periksa Job Monitor dan History untuk file yang gagal dan frekuensinya.
- Terapkan kategori perbaikan: batas rate (turunkan konkurensi), auth (autentikasi ulang), izin akses (verifikasi path/root), jaringan (kurangi thread, tingkatkan retry), integritas (jalankan
check). - Jalankan ulang dengan
--dry-runsebelum membuat perubahan.
Kesimpulan
RcloneView mengubah debugging rclone menjadi alur kerja yang terpandu: autocomplete untuk menghindari kesalahan sintaks, log dalam aplikasi untuk melihat apa yang gagal, dan kontrol GUI untuk menyesuaikan konkurensi atau jadwal. Gunakan Terminal dan Job History bersama-sama untuk menyelesaikan error lebih cepat dan menjaga transfer tetap berjalan.