rclone

rclone ファイル転送スキル

セットアップの確認（必ず最初に実行）

rclone の操作を行う前に、インストールと設定を確認してください。

# Check if rclone is installed
command -v rclone >/dev/null 2>&1 && echo "rclone installed: $(rclone version | head -1)" || echo "NOT INSTALLED"

# List configured remotes
rclone listremotes 2>/dev/null || echo "NO REMOTES CONFIGURED"

rclone がインストールされていない場合

ユーザーにインストールを案内してください。

# macOS
brew install rclone

# Linux (script install)
curl https://rclone.org/install.sh | sudo bash

# Or via package manager
sudo apt install rclone  # Debian/Ubuntu
sudo dnf install rclone  # Fedora

リモートが設定されていない場合

対話形式での設定をユーザーに案内してください。

rclone config

一般的なプロバイダーのセットアップ早見表：

プロバイダー	種類	主要な設定
AWS S3	s3	access_key_id、secret_access_key、region
Cloudflare R2	s3	access_key_id、secret_access_key、endpoint（account_id.r2.cloudflarestorage.com）
Backblaze B2	b2	account（keyID）、key（applicationKey）
DigitalOcean Spaces	s3	access_key_id、secret_access_key、endpoint（region.digitaloceanspaces.com）
Google Drive	drive	OAuth フロー（ブラウザーが開きます）
Dropbox	dropbox	OAuth フロー（ブラウザーが開きます）

例：Cloudflare R2 の設定

rclone config create r2 s3 \
  provider=Cloudflare \
  access_key_id=YOUR_ACCESS_KEY \
  secret_access_key=YOUR_SECRET_KEY \
  endpoint=ACCOUNT_ID.r2.cloudflarestorage.com \
  acl=private

例：AWS S3 の設定

rclone config create aws s3 \
  provider=AWS \
  access_key_id=YOUR_ACCESS_KEY \
  secret_access_key=YOUR_SECRET_KEY \
  region=us-east-1

一般的な操作

単一ファイルのアップロード

rclone copy /path/to/file.mp4 remote:bucket/path/ --progress

ディレクトリのアップロード

rclone copy /path/to/folder remote:bucket/folder/ --progress

ディレクトリの同期（ミラーリング、削除されたファイルを削除）

rclone sync /local/path remote:bucket/path/ --progress

リモートの内容を一覧表示

rclone ls remote:bucket/
rclone lsd remote:bucket/  # directories only

転送される内容を確認（ドライラン）

rclone copy /path remote:bucket/ --dry-run

便利なフラグ

フラグ	用途
--progress	転送の進行状況を表示
--dry-run	転送せずにプレビュー
-v	詳細な出力
--transfers=N	並列転送数（デフォルトは 4）
--bwlimit=RATE	帯域幅の上限（例：10M）
--checksum	サイズや時刻ではなく、チェックサムで比較
--exclude="*.tmp"	パターンに一致するファイルを除外
--include="*.mp4"	一致するファイルのみを含める
--min-size=SIZE	SIZE より小さいファイルをスキップ
--max-size=SIZE	SIZE より大きいファイルをスキップ

大容量ファイルのアップロード

動画や大容量ファイルには、チャンク分割アップロードを使用してください。

# S3 multipart upload (automatic for >200MB)
rclone copy large_video.mp4 remote:bucket/ --s3-chunk-size=64M --progress

# Resume interrupted transfers
rclone copy /path remote:bucket/ --progress --retries=5

アップロードの検証

# Check file exists and matches
rclone check /local/file remote:bucket/file

# Get file info
rclone lsl remote:bucket/path/to/file

トラブルシューティング

# Test connection
rclone lsd remote:

# Debug connection issues
rclone lsd remote: -vv

# Check config
rclone config show remote