• Руководство по настройке
  • Около 5 мин

Как загружать файлы в Cloudflare R2 и делиться ссылками

Подключите Cloudflare R2 к Aktar примерно за минуту: вставьте один API-токен, и Aktar сам создаст бакет, включит публичные ссылки и сохранит место назначения.

Cloudflare R2 отлично подходит для Aktar: здесь нет платы за исходящий трафик, бесплатный тариф включает 10 ГБ, а собственные домены раздаются через сеть Cloudflare. Копировать из панели ID аккаунта, имя бакета и два ключа не нужно: Настроить Cloudflare R2… достаточно одного API-токена, который создается по ссылке с уже заполненными правами, а остальное Aktar сделает сам. Предпочитаете настроить все вручную? Об этом последний шаг.

Что понадобится

  • Аккаунт Cloudflare (бесплатный тариф R2 включает 10 ГБ)
  • Домен в Cloudflare, если вы хотите ссылки на собственном домене (необязательно)
  • Aktar для Mac, Windows, iPhone, iPad или Android

Пошагово

  1. Откройте «Настроить Cloudflare R2»

    В настройках Aktar откройте Места назначения и выберите Настроить Cloudflare R2…. Пока мест назначения нет, это главная кнопка. Затем нажмите Открыть Cloudflare.

  2. Создайте API-токен

    Откроется страница токенов Cloudflare, где уже заданы имя Aktar и два права: R2 Storage: Edit, чтобы создать бакет и загружать в него файлы, и Zone: Read, чтобы получить список ваших доменов для публичных ссылок. Нажмите Continue to summary, затем Create Token и скопируйте токен.

  3. Вставьте токен и сделайте выбор

    Вставьте токен в Aktar. Выберите аккаунт, если их несколько, затем бакет: новый (Aktar предлагает aktar) или уже существующий. И наконец, куда ведут публичные ссылки:

    • Адрес r2.dev у бакета работает сразу. Cloudflare ограничивает частоту запросов к нему, поэтому он лучше всего подходит для проверки.
    • Поддомен домена из вашего аккаунта Cloudflare, например files.example.com, подходит для реальной работы. Cloudflare добавит DNS-запись и сертификат, на это уходит несколько минут.
  4. Настроить

    Нажмите Настроить. Aktar создаст бакет, включит публичные ссылки, сохранит место назначения и сам запустит Проверить подключение. На собственном домене ссылки получают чистые пути вроде files.example.com/A7kdP2x.png (см. короткие ссылки). Нажмите Готово или Изменить, чтобы что-то поменять, и перетащите первый файл на Aktar.

  5. Хотите настроить вручную?

    Если вам больше подходит токен R2, ограниченный одним бакетом: в панели Cloudflare откройте R2 Object Storage и создайте бакет. В его Settings подключите собственный домен в разделе Custom Domains или включите Public Development URL. Затем в Manage API tokens создайте токен с правами Object Read & Write для этого бакета и скопируйте Access Key ID и Secret Access Key (секретный ключ показывается только один раз). В Aktar выберите Добавить место назначения, затем Cloudflare R2 и заполните поля по таблице ниже.

Настройки в Aktar

Введите эти значения в разделе Настройки → Места назначения → Добавить место назначения. Названия полей совпадают с приложением.

ПолеПример значенияПримечание
ПровайдерCloudflare R2
Имя профиляPersonalЛюбое имя на ваш выбор.
ID аккаунта3f9a71c0e2b8…Со страницы обзора R2.
РегионautoОставьте значение по умолчанию.
Access Key IDa1b2c3d4…Из API-токена R2.
Secret Access Key••••••••Хранится в Связке ключей или Диспетчере учетных данных.
Бакетscreenshots
Публичный базовый URLfiles.example.comВаш собственный домен или URL r2.dev.
Путь к объекту{short}.{ext}Необязательно, см. имена файлов и папки.

Советы

  • Aktar не хранит токен. Он превращает его в S3-ключи (ID токена служит ключом доступа, а хэш его значения секретом), хранит их так же, как ключи любого другого места назначения, и забывает токен. Удалите токен в Cloudflare, когда захотите закрыть Aktar доступ.
  • Собственный домен кэшируется Cloudflare, поэтому популярные ссылки быстро открываются по всему миру без дополнительной платы.
  • Настройте место назначения на одном устройстве, а затем с помощью «Перенести на другое устройство» перенесите его вместе с ключами на остальные компьютеры и телефоны.
  • Хотите, чтобы загрузки удалялись сами через 1-30 дней? Aktar сам добавит правила жизненного цикла в бакет, если его ключи могут ими управлять, как ключи из «Настроить Cloudflare R2» или токен Admin Read & Write. С токеном Object Read & Write добавьте их вручную в разделе Object Lifecycle Rules в Settings бакета. См. загрузки с ограниченным сроком.

Решение проблем

«Настроить» сообщает, что публичная ссылка пока не работает

Сразу после подключения собственного домена Cloudflare еще добавляет DNS-запись и сертификат. Подождите несколько минут и снова запустите «Проверить подключение» из меню места назначения.

«Настроить» не находит аккаунт для токена

Токен создан без доступа к аккаунту. Создайте его заново через «Открыть Cloudflare» и оставьте в разделе Account Resources предложенный аккаунт (или All accounts).

Ссылка возвращает Access Denied или 403

Убедитесь, что публичный базовый URL - это ваш собственный домен или URL r2.dev. Эндпоинт …r2.cloudflarestorage.com предназначен только для API и никогда не раздает публичные файлы. Подробнее в разделе ошибки Access Denied.

«Проверить подключение» сообщает, что учетные данные недействительны

Если вы настраивали вручную, используйте Access Key ID и Secret Access Key из API-токена R2, а не обычный API-токен Cloudflare и не Global API Key. Проверьте, что в ID аккаунта нет лишних пробелов.

Загрузка работает, но ссылки открываются медленно или упираются в лимит запросов

Скорее всего, вы используете URL для разработки r2.dev. Для рабочего использования подключите собственный домен.