Tencent Cloud COS を macOS にマウント — NetDrive

Tencent Cloud Object Storageに数ギガバイトのアセットがあり、それをFinderからアクセスしたいとします——Webコンソールでも、CLIツールでもなく、ファイルをドラッグ&ドロップできる実際のドライブとしてです。NetDriveはバージョン3.17.799でTencent Cloudのネイティブサポートを追加し、macOS 14 Sonoma以降と組み合わせることで、COSバケットを他のボリュームと同じように扱えるようになります。

Tencent Cloud COSをFinderに直接マウント

NetDrive を使えば Google Drive、OneDrive、S3、SFTP、WebDAV などが Windows と macOS でネイティブドライブとして表示されます — 同期も、まるごとダウンロードも不要です。

• COSバケットをローカルドライブとして閲覧・編集——同期は不要
• Google Drive、S3、Dropboxなどと並行して利用可能
• Apple Siliconにネイティブ対応、macOS 14 Sonoma以降

WindowsmacOS

NetDrive for macOSをダウンロード →

無料トライアル。永久ライセンスとサブスクリプションプランあり。

開始前に必要なもの

NetDriveを開く前に、Tencent Cloudコンソールから次の3つを用意してください。

• SecretId — API アクセスキーの識別子（TencentにおけるアクセスキーIDに相当）
• SecretKey — 対応するシークレット認証情報
• バケット名とリージョン — 例えば、リージョン ap-guangzhou の project-assets-1234567890

Tencent Cloud CAMコンソールにログインし、Access Management → API Keys の下でAPIキーペアを確認または作成してください。ルートアカウントの認証情報を使う代わりに、COS権限に絞ったサブアカウントを作成することを推奨します——読み取り専用アクセスには QcloudCOSReadOnlyAccess、特定バケットへの書き込みアクセスが必要な場合はカスタムポリシーを使用します。NetDriveは認証情報をmacOSのキーチェーンに保存しますが、いずれローテーションが必要になった場合に備えて、APIキーのスコープを制限しておく価値はあります。

macOSバージョンに関する注意: Tencent CloudサポートはNetDrive 3.17.799で導入されました。macOS 14 Sonoma以降を使用している場合、NetDrive 3.18以上が必要です（SonomaのサポートはNetDrive 3.18以降のみです）。macOS 13 Venturaのユーザーは、NetDriveバージョン3.17までを使用できます。

Tencent Cloudをドライブとして追加する

1. NetDriveを開き、ドライブマネージャーで +（ドライブ追加）ボタンをクリックします。
2. プロバイダー一覧から Tencent Cloud を選択します。
3. 認証情報フィールドに SecretId と SecretKey を入力します。
4. Region をバケットのホームリージョンに合わせて設定します——例えば、華南地域なら ap-guangzhou、シンガポールなら ap-singapore、北米なら na-ashburn です。これを間違えると、空のドライブが静かにマウントされるのではなく接続エラーになるため、Tencent Cloud COSコンソールでリージョンを再確認してください。
5. 任意で特定の Bucket name を入力すると、単一のバケットをドライブのルートとしてマウントできます。空欄のままにすると、アカウント配下の全バケットを閲覧できます。
6. ドライブ名を割り当てます（これがFinderの /Volumes/ 下でのボリューム名になります）。
7. Connect をクリックします。

接続が完了すると、バケットはFinderおよびサイドバーにマウントされたボリュームとして表示されます。画像はPreviewで、表計算ファイルはNumbersで、テキストファイルは任意のエディタで、ファイルを直接開くことができ、明示的なアップロード操作なしにCOSへ変更を保存できます。ファイルはオンデマンドで取得されます。NetDriveはバケット全体をMacにダウンロードすることはありません。

パフォーマンスと大容量ファイル

NetDriveはバケット全体をMacにダウンロードしません——マウントされたボリュームとしてコンテンツを閲覧し、明示的に開くかダウンロードしたファイルのみが転送されます。アップロードはバックグラウンドで自動的に実行され、アップロードパラメータの管理や大容量ファイルの手動分割は不要です。

大規模なバケットでは、初回のディレクトリ一覧表示に数秒かかることがあります。バケットのルートにフラットな構造で数万個のオブジェクトが含まれている場合、COS側でプレフィックス（疑似フォルダー）に整理すると閲覧速度が大幅に向上します——NetDriveはプレフィックスをフォルダーとして表示し、5万個のファイルがフラットに並んだディレクトリよりもはるかに高速に一覧表示します。

接続直後に 403 Access Denied が表示される場合、APIキーに必要なCOSの読み取りまたは書き込み権限が不足している可能性があります。ドライブはマウントされるがバケットにコンテンツがあるにもかかわらず空に見える場合、リージョン設定が最も一般的な原因です——COSコンソールに表示されているものと完全に一致しているか確認してください。

ログイン時の自動マウントを設定する

NetDriveでドライブの設定を開き、Mount Timing を On Login に設定します。これにより、macOSにログインするたびにCOSドライブが自動的にFinderに表示されます。共有Macやファイルリレーとして動作するヘッドレスMac miniなど、ユーザーがログインする前にドライブを利用可能にしたい場合は、代わりに On Boot に設定してください。

ドライブがマウントされ到達可能な状態になると、ドライブマネージャーには緑色のインジケーターが表示されます。切断状態と表示される場合は、マウントアイコンをクリックして手動で再接続するか、COSエンドポイントへのネットワークアクセスを確認してください。

まとめ

NetDriveでTencent Cloud COSをmacOSにマウントするのは、APIキーペアさえ手元にあれば約2分で完了します。結果として得られるのは、COSバケットを裏側に持つFinderボリュームです——別途の同期クライアントも、手動のアップロードキューも、Webコンソールへのコンテキストスイッチも不要です。

Windowsでの同等のセットアップについては、Alibaba CloudをWindowsにマウントする手順とほぼ同一で、同じNetDriveリリースで追加されました。Tencent COSと並行してS3互換ストレージを扱う場合は、WasabiをmacOSにマウントする方法が異なるエンドポイント設定で似た流れを使用します。CIパイプラインでオブジェクトストレージからフィクスチャを読み込むDevOpsチーム向けには、S3テストフィクスチャのユースケースがTencent COSにも直接応用できるパターンを扱っています。

— Morgan, NetDrive