INTEGRITY Dokumentace

← Cloudflare R2 / r2 / get-started

CLI

Spravujte buckety R2 a objekty přímo z terminálu. Pomocí nástrojů CLI automatizujte úlohy a spravujte objekty.

Nástroj Vhodné pro
Wrangler Operace s jednotlivými objekty a správa nastavení bucketu s minimální konfigurací
rclone Hromadné operace s objekty, migrace a synchronizace adresářů
AWS CLI Existující pracovní postupy v AWS nebo znalost AWS CLI

1. Vytvořte bucket

Bucket ukládá vaše objekty v R2. Nový R2 bucket vytvoříte takto:

  1. Přihlaste se ke svému účtu Cloudflare:

    npx wrangler login

  2. Vytvořte bucket s názvem my-bucket:

    npx wrangler r2 bucket create my-bucket

    Pokud se zobrazí výzva, vyberte účet, ve kterém chcete bucket vytvořit.

  3. Ověřte, že byl bucket vytvořen:

    npx wrangler r2 bucket list

  1. V Cloudflare Dashboard přejděte na Objektové úložiště R2.

    Přejděte na Přehled ↗

  2. Vyberte Vytvořit bucket.

  3. Zadejte název svého bucketu.

  4. Vyberte umístění pro váš bucket a výchozí třída úložiště.

  5. Vyberte Vytvořit bucket.

2. Vygenerujte přihlašovací údaje API

Nástroje CLI, které používají S3 API (AWS CLI, rclone) vyžadují ID přístupového klíče a tajný přístupový klíč. Pokud používáte Wrangler, tento krok můžete přeskočit.

  1. V Cloudflare dashboardu přejděte na R2.
  2. Vyberte Správa tokenů R2 API.
  3. Vyberte Vytvoření API tokenu.
  4. Vyberte Object Read & Write oprávnění a vyberte buckety, ke kterým chcete mít přístup.
  5. Vyberte Create API Token.
  6. Zkopírujte Access Key ID a Secret Access Key. Uložte je bezpečně, tajný klíč už znovu neuvidíte.

3. Nastavte nástroj CLI

Wrangler je nástroj CLI pro Cloudflare Workers. Ověřuje se přímo vůči vašemu účtu Cloudflare, takže nejsou potřeba žádné přihlašovací údaje API.

  1. Nainstalujte Wrangler:

    npm i -D wrangler

  2. Přihlaste se ke svému účtu Cloudflare:

    wrangler login

rclone je ideální pro hromadné nahrávání, migrace a synchronizaci adresářů.

  1. Nainstalujte rclone ↗ (verze 1.59 nebo novější).

  2. Nakonfigurujte nové vzdálené úložiště:

    rclone config

  3. Vytvořte nové vzdálené úložiště výběrem n.

  4. Pojmenujte své vzdálené úložiště r2

  5. Vyberte Poskytovatelé úložiště kompatibilní s Amazon S3 jako typ úložiště.

  6. Vyberte Cloudflare R2 jako poskytovatele.

  7. Vyberte, zda chcete zadat přihlašovací údaje AWS ručně, nebo je získat z běhového prostředí.

  8. Po vyzvání zadejte svůj Access Key ID a Secret Access Key.

  9. Vyberte oblast, ke které se chcete připojit (volitelné).

  10. Zadejte svůj S3 API endpoint.

AWS CLI pracuje s R2 pomocí zadání vlastního koncového bodu.

  1. Nainstalujte AWS CLI ↗ pro váš operační systém.

  2. Nakonfigurujte přihlašovací údaje:

    aws configure

  3. Po zobrazení výzvy zadejte:

    • AWS Access Key ID: Váš R2 Access Key ID
    • AWS Secret Access Key: Váš R2 Secret Access Key
    • Výchozí název regionu: auto
    • Výchozí formát výstupu: json (nebo stiskněte klávesu Enter pro přeskočení)

4. Nahrávejte a stahujte objekty

(Volitelné) Vytvořte testovací soubor k nahrání. Tento příkaz spusťte v adresáři, ve kterém plánujete spouštět příkazy CLI:

echo 'Hello, R2!' > myfile.txt
# Upload myfile.txt to my-bucket
wrangler r2 object put my-bucket/myfile.txt --file ./myfile.txt

# Download myfile.txt and save it as downloaded.txt
wrangler r2 object get my-bucket/myfile.txt --file ./downloaded.txt

Viz Příkazy Wrangler pro R2 pro všechny dostupné operace.

# Upload myfile.txt to my-bucket
rclone copy myfile.txt r2:my-bucket/

# Download myfile.txt from my-bucket to the current directory
rclone copy r2:my-bucket/myfile.txt .

Viz dokumentace rclone pro další možnosti konfigurace.

# Upload myfile.txt to my-bucket
aws s3 cp myfile.txt s3://my-bucket/ --endpoint-url https://<ACCOUNT_ID>.r2.cloudflarestorage.com

# Download myfile.txt from my-bucket to current directory
aws s3 cp s3://my-bucket/myfile.txt ./ --endpoint-url https://<ACCOUNT_ID>.r2.cloudflarestorage.com

# List all objects in my-bucket
aws s3 ls s3://my-bucket/ --endpoint-url https://<ACCOUNT_ID>.r2.cloudflarestorage.com

Viz Dokumentace AWS CLI pro další příklady.

Další kroky

Presigned URLs

Generujte dočasné URL adresy pro soukromý přístup k objektům.

Veřejné buckety

Poskytujte soubory přímo přes HTTP pomocí veřejného bucketu.

CORS

Nakonfigurujte CORS pro nahrávání souborů z prohlížeče.

Životní cyklus objektů

Nastavte pravidla životního cyklu pro automatické mazání starých objektů.