rclone で 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 のトラブルシューティングをご覧ください。