rclone <command> <source> <destination> [flags]

# 列出远程存储中所有文件
rclone ls s3:my-bucket/

# 输出示例：
#     12345 documents/report.pdf
#       678 images/photo.jpg
#     90123 data/backup.tar.gz

# 只列出目录（不递归）
rclone lsd s3:my-bucket/

# 输出示例：
#          -1 2026-01-01 00:00:00        -1 documents
#          -1 2026-01-15 12:30:00        -1 images
#          -1 2026-02-01 08:00:00        -1 data

# 列出文件，显示大小和修改时间
rclone lsl s3:my-bucket/ --max-depth 1

# 输出示例：
#    12345 2026-01-01 00:00:00.000000000 report.pdf
#      678 2026-01-15 12:30:00.000000000 photo.jpg

# 输出 JSON 格式，便于程序处理
rclone lsjson s3:my-bucket/

# 输出示例：
# [{"Path":"documents/report.pdf","Name":"report.pdf","Size":12345,"MimeType":"application/pdf","ModTime":"2026-01-01T00:00:00Z","IsDir":false}]

# 本地 → 远程
rclone copy /data/documents/ s3:my-bucket/documents/ --progress

# 远程 → 远程（跨云复制）
rclone copy gdrive:Photos/ onedrive:Photos/ --progress

# 远程 → 本地
rclone copy s3:my-bucket/backups/ /local/backup/ --progress

# copy 不会删除目标端的文件
# 只传输源端有而目标端没有的文件，或源端更新的文件

# 示例：
# 源端: a.txt, b.txt, c.txt
# 目标端: a.txt, d.txt
# copy 后目标端: a.txt(被覆盖), b.txt(新增), c.txt(新增), d.txt(保留)

# 多线程传输
rclone copy src dst --transfers 16

# 显示进度
rclone copy src dst --progress

# 限制传输大小（只传输 1MB 以上的文件）
rclone copy src dst --min-size 1M

# 跳过已有文件（基于大小和修改时间）
rclone copy src dst --ignore-existing

# 使用检查级别
rclone copy src dst --checksum       # 基于校验和比较
rclone copy src dst --size-only      # 仅基于大小比较
rclone copy src dst --update         # 仅复制更新的文件

# 移动文件到另一个位置
rclone move s3:my-bucket/incoming/ s3:my-bucket/processed/ --progress

# 移动到另一个 Remote
rclone move gdrive:Temp/ s3:archive/temp/ --progress

# 本地移动
rclone move /data/incoming/ s3:my-bucket/data/ --progress

# move 会在成功传输后删除源文件
# ⚠️ 如果源端有大量文件，删除过程可能较慢

# 建议先用 --dry-run 预览
rclone move src dst --dry-run --progress

# 注意：源端空目录默认不会被删除
# 使用 --delete-empty-src-dirs 删除空目录
rclone move src dst --delete-empty-src-dirs --progress

# 同步本地目录到云端
rclone sync /data/important/ s3:my-bucket/backup/ --progress

# 同步两个远程存储
rclone sync gdrive:Documents/ onedrive:Documents/ --progress

# sync 会删除目标端不在源端的文件！
# 示例：
# 源端: a.txt, b.txt
# 目标端: a.txt, c.txt
# sync 后目标端: a.txt, b.txt（c.txt 被删除！）

# 🔴 务必先用 --dry-run 预览
rclone sync /data/ s3:my-bucket/ --dry-run --progress

# 🔴 确认方向正确后再执行
rclone sync /data/ s3:my-bucket/ --progress

# 删除远程存储中的所有文件
rclone delete s3:my-bucket/temp/

# 只删除特定扩展名的文件
rclone delete s3:my-bucket/logs/ --include "*.log"

# 删除超过 30 天的文件
rclone delete s3:my-bucket/logs/ --min-age 30d

# ⚠️ 先用 --dry-run 预览
rclone delete s3:my-bucket/temp/ --dry-run

# 删除整个目录树
rclone purge s3:my-bucket/temp/

# ⚠️ 操作不可逆，务必先预览
rclone purge s3:my-bucket/temp/ --dry-run

# 递归删除空目录
rclone rmdirs s3:my-bucket/

# 创建目录
rclone mkdir s3:my-bucket/new-folder/

# 创建嵌套目录
rclone mkdir sftp-server:/data/2026/05/

# 比较本地和远程
rclone check /data/ s3:my-bucket/data/

# 输出示例：
# 2026/01/01 00:00:00 NOTICE: S3 bucket data: 0 differences found
# 2026/01/01 00:00:00 NOTICE: S3 bucket data: 100 matching files

# 如果有差异，会列出不匹配的文件：
# ERROR : file1.txt: md5 differ
# ERROR : file2.txt: file not found in source

# 基于哈希值校验（默认）
rclone check src dst

# 基于大小校验（哈希不可用时的备选）
rclone check src dst --size-only

# 只检查目标端是否有源端的文件（单向检查）
rclone check src dst --one-way

# 同时下载文件内容进行逐字节比较（最严格但最慢）
rclone check src dst --download

# 计算 SHA1
rclone sha1sum s3:my-bucket/

# 计算 MD5
rclone md5sum s3:my-bucket/

# 计算指定算法的哈希
rclone hashsum SHA256 s3:my-bucket/

# 输出到文件（可用于后续校验）
rclone md5sum s3:my-bucket/ > checksums.md5

# 使用已有的哈希文件校验
md5sum -c checksums.md5

# 查看某个 remote 支持的哈希算法
rclone backend features s3:my-bucket/ | grep Hashes

# 将远程文件输出到 stdout
rclone cat s3:my-bucket/config.json

# 输出部分内容
rclone cat s3:my-bucket/large-file.bin --offset 0 --count 1024

# 通过管道处理
rclone cat s3:my-bucket/data.csv | head -n 10

# 查看远程目录大小
rclone size s3:my-bucket/

# 输出示例：
# Total objects: 1,234
# Total size: 5.000 GiB (5368709120 Byte)

# JSON 格式输出
rclone size s3:my-bucket/ --json
# {"count":1234,"bytes":5368709120}

# 查看 Google Drive 配额
rclone about gdrive:

# 输出示例：
# Total:   15.000 GiB
# Used:    10.500 GiB
# Free:    4.500 GiB
# Trashed: 0.000 GiB

# JSON 格式
rclone about gdrive: --json

# 复制单个文件（保留文件名）
rclone copyto /data/report.pdf s3:my-bucket/reports/report.pdf

# 复制并重命名
rclone copyto /data/report.pdf s3:my-bucket/reports/report-2026.pdf

# 移动单个文件
rclone moveto /data/temp.txt s3:my-bucket/archive/temp.txt

# 生成 Bash 补全脚本
rclone genautocomplete bash

# 生成 Zsh 补全脚本
rclone genautocomplete zsh

# 生成 Fish 补全脚本
rclone genautocomplete fish

rclone sync /home/user/projects/ s3:my-backup/projects/ \
  --progress \
  --transfers 8 \
  --log-file /var/log/rclone-backup.log \
  --log-level INFO \
  --exclude ".git/**" \
  --exclude "node_modules/**" \
  --exclude "*.pyc"

# 第一步：预览
rclone move gdrive:OldAccount/ s3:archive/old-account/ \
  --dry-run --progress

# 第二步：确认后执行
rclone move gdrive:OldAccount/ s3:archive/old-account/ \
  --progress \
  --transfers 16 \
  --delete-empty-src-dirs \
  --log-file migration.log

#!/bin/bash
# verify-backup.sh
rclone check /data/important/ s3:my-backup/important/ \
  --one-way \
  --log-file /var/log/rclone-check.log \
  --log-level INFO

if [ $? -ne 0 ]; then
  echo "Backup verification failed!" | mail -s "Rclone Check Alert" admin@example.com
fi