Około 5 min
Jak przesyłać pliki do Cloudflare R2 i udostępniać linki
Cloudflare R2 świetnie pasuje do Aktara: nie ma opłat za transfer wychodzący, darmowy limit wystarcza do większości zrzutów ekranu, a własne domeny są serwowane przez sieć Cloudflare. Aktar ma osobne ustawienie dla R2, więc potrzebujesz tylko ID konta, tokenu API i bucketu.
Czego potrzebujesz
- Konto Cloudflare z włączonym R2
- Domena w Cloudflare, jeśli chcesz linki we własnej domenie (opcjonalnie)
- Aktar zainstalowany na Macu
Krok po kroku
- 1
Utwórz bucket
W panelu Cloudflare otwórz R2 Object Storage i kliknij Create bucket. Wybierz krótką nazwę, np.
screenshots, i zostaw automatyczną lokalizację. - 2
Nadaj bucketowi publiczny adres
Otwórz Settings bucketu. W sekcji Custom Domains podłącz domenę lub subdomenę, którą zarządzasz w Cloudflare, np.
files.example.com. To najlepsza opcja do codziennego użytku.Do szybkiego testu możesz zamiast tego włączyć Public Development URL (
pub-….r2.dev). Cloudflare ogranicza liczbę żądań do tego adresu i nie zaleca go do użytku produkcyjnego. - 3
Utwórz token API
Wróć na stronę przeglądu R2, otwórz Manage API tokens i utwórz token z uprawnieniem Object Read & Write, ograniczony do Twojego bucketu. Skopiuj Access Key ID i Secret Access Key: klucz tajny jest wyświetlany tylko raz.
Twoje Account ID jest widoczne na tej samej stronie i stanowi też pierwszą część endpointu S3
https://<ACCOUNT_ID>.r2.cloudflarestorage.com. - 4
Dodaj miejsce docelowe w Aktarze
Otwórz w Aktarze Ustawienia → Miejsca docelowe → Dodaj miejsce docelowe, wybierz Cloudflare R2 i wypełnij pola według tabeli poniżej. Aktar ustali endpoint na podstawie ID konta.
- 5
Przetestuj i zachowaj
Kliknij Testuj połączenie. Aktar prześle malutki plik testowy, sprawdzi, czy jest osiągalny pod publicznym adresem, i znowu go usunie. Gdy wszystko świeci na zielono, kliknij Zachowaj i upuść pierwszy plik na ikonę na pasku menu.
Ustawienia w Aktarze
Wpisz te wartości w Ustawienia → Miejsca docelowe → Dodaj miejsce docelowe. Nazwy pól odpowiadają tym w aplikacji.
| Pole | Przykładowa wartość |
|---|---|
| Dostawca | Cloudflare R2 |
| Nazwa profilu | PersonalDowolna nazwa. |
| ID konta | 3f9a71c0e2b8…Ze strony przeglądu R2. |
| Region | autoZostaw wartość domyślną. |
| Access Key ID | a1b2c3d4…Z tokenu API R2. |
| Secret Access Key | ••••••••Przechowywany w pęku kluczy macOS. |
| Bucket | screenshots |
| Publiczny bazowy URL | files.example.comTwoja własna domena lub adres r2.dev. |
| Ścieżka obiektu | {year}/{month}/{uuid}.{ext}Opcjonalnie, zobacz nazwy plików i foldery. |
Wskazówki
- Ogranicz token API do jednego bucketu, którego używa Aktar. Jeśli token kiedykolwiek wycieknie, nic więcej nie zostanie odsłonięte.
- Własna domena jest buforowana przez Cloudflare, więc popularne linki ładują się szybko na całym świecie bez dodatkowych kosztów.
- Chcesz porządku w folderach? Zmień ścieżkę obiektu, np. na
shots/{date}/{filename}-{random}.{ext}. Zobacz nazwy plików i foldery. - Chcesz, by przesłane pliki same się usuwały po 1 do 30 dniach? Z tokenem Admin Read & Write Aktar sam doda reguły cyklu życia do bucketu. Z tokenem Object Read & Write dodaj je samodzielnie w Object Lifecycle Rules w Settings bucketu. Zobacz pliki, które same się usuwają.
Rozwiązywanie problemów
Link zwraca Access Denied lub 403
Upewnij się, że Publiczny bazowy URL to Twoja własna domena lub adres r2.dev. Endpoint …r2.cloudflarestorage.com służy tylko do API i nigdy nie serwuje publicznych plików. Więcej w błędach Access Denied.
Testuj połączenie zgłasza nieprawidłowe dane uwierzytelniające
Użyj Access Key ID i Secret Access Key z tokenu API R2, a nie zwykłego tokenu API Cloudflare ani Global API Key. Sprawdź, czy w ID konta nie ma zbędnych spacji.
Przesyłanie działa, ale linki są wolne lub mają limit żądań
Prawdopodobnie używasz deweloperskiego adresu r2.dev. Do użytku produkcyjnego podłącz własną domenę.
Nadal coś nie działa?Przejrzyj FAQ albo zapytaj na GitHubie.