Объектное хранилище Fatmetal совместимо с Amazon S3 API - подключается любым S3-клиентом, GUI, SDK или готовым приложением. Достаточно указать реквизиты и включить path-style адресацию.
После создания хранилища в панели вы получаете пять значений - держите их под рукой:
| Что | Пример | Где взять |
|---|---|---|
| Endpoint | https://ssd-1.s3.fatmetal.ru | панель → хранилище → Подключение |
| Bucket | my-storage | имя, которое вы задали |
| Region | см. панель | панель → хранилище → Подключение |
| Access Key ID | GK… | панель |
| Secret Access Key | … | показывается один раз при создании |
ssd-1.s3.fatmetal.ru во всех примерах ниже - лишь образец SSD-хранилища; подставляйте свой. Secret Access Key показывается один раз при создании и не хранится - сохраните сразу. Дополнительные ключи вы выпускаете сами в панели (раздел «Ключи доступа»), в том числе только на чтение - см. §10.Это единственная нестандартная настройка, но без неё подключение не заработает. S3-клиенты обращаются к объектам двумя способами:
my-storage.ssd-1.s3.fatmetal.ru/photo.jpgssd-1.s3.fatmetal.ru/my-storage/photo.jpgМы работаем в path-style. Если клиент по умолчанию использует virtual-hosted, он обратится к несуществующему хосту и выдаст ошибку вроде «не резолвится my-storage.ssd-1.s3.fatmetal.ru». В конфигурациях ниже path-style уже включён (force_path_style, addressing_style: path или галочка в GUI).
Проще всего начать работу с хранилищем - открыть его в панели. Встроенный файловый менеджер закрывает повседневные задачи без единой команды и без установки стороннего клиента: откройте хранилище, загружайте и качайте файлы мышью, наводите порядок в папках.
Перетащите файлы в окно браузера или выберите вручную - загрузка идёт очередью с прогрессом по каждому файлу. Большие файлы разбиваются на части автоматически (multipart). Создавайте папки, переименовывайте, удаляйте, скачивайте по одному или сразу несколько.
Изображения, видео, аудио, PDF и текстовые файлы открываются прямо в панели - не нужно скачивать, чтобы заглянуть в содержимое. Навигация по вложенным папкам через хлебные крошки.
Поделитесь файлом по временной ссылке с ограниченным сроком действия - удобно отдать коллеге или клиенту, не выдавая ключи доступа ко всему хранилищу.
Универсальный клиент. Настройка выполняется один раз:
Дальше работаете как с обычным S3, добавляя --endpoint-url (endpoint - из панели, в примере SSD):
--endpoint-url каждый раз, заведите alias: alias fms3='aws --endpoint-url https://ssd-1.s3.fatmetal.ru s3'.Удобен, когда S3 не единственное хранилище. В ~/.config/rclone/rclone.conf:
Лёгкий вариант для скриптов. ~/.s3cfg:
Если командная строка не ваш вариант - подойдёт любой S3-клиент. Настройки похожие: протокол Amazon S3, сервер (endpoint из панели, без схемы) и включённый path-style.
ssd-1.s3.fatmetal.ru, ключи из панели, в дополнительных настройках включить «Path-style requests».ssd-1.s3.fatmetal.ru порт 443, в «Дополнительно → S3» выбрать стиль URL «Path».ssd-1.s3.fatmetal.ru и ключи, включить path-style.Принцип везде одинаков: endpoint (свой из панели), ключи, регион rzn и path-style.
Python (boto3)
JavaScript / Node.js (AWS SDK v3)
PHP (AWS SDK)
Go (aws-sdk-go-v2)
Во всех примерах ниже ssd-1.s3.fatmetal.ru - образец; подставьте endpoint своего хранилища из панели.
restic (бэкапы)
Docker Registry (образы в S3) - config.yml
GitLab CI (артефакты и статика)
ssd-1.s3.fatmetal.ru, включить SSL и path-style, указать bucket и ключи.ssd-1.s3.fatmetal.ru, ключи, в опциях включить path-style.Хранилище построено на Garage. Он покрывает базовый S3 API, но не все расширенные возможности Amazon S3.
Не поддерживается (эти запросы вернут 501 Not Implemented):
У хранилища есть основной ключ - он выдаётся вместе с бакетом, через него бакет доступен по имени. Отозвать основной ключ нельзя; перевыпуск - через поддержку. Кроме него в панели (раздел «Ключи доступа») вы сами выпускаете дополнительные ключи.
a-z, 0-9, -), длина 3-63 символа, не начинается и не заканчивается дефисом. Регистр важен во всех обращениях.Хранилище тарифицируется за объём (квоту). Если баланс аккаунта уходит в минус, хранилище меняет статус:
Клиент использует virtual-hosted стиль. Включите path-style - у нас адрес строится как endpoint/bucket/key, а не bucket.endpoint.
Проверьте имя бакета (регистр важен: My-Bucket ≠ my-bucket) и что включён path-style. Имя в клиенте должно точно совпадать с именем в панели.
Проверьте пару ключей (Access Key ID + Secret) и что обращаетесь к своему бакету. Опечатка в secret или чужое имя бакета дают именно 403.
Вызвана неподдерживаемая операция - versioning, object-lock, bucket policy или tagging. Отключите её в настройках клиента (см. «Что поддерживается»).
Хранилище заполнено до квоты. Освободите место (удалите ненужное) или увеличьте объём в панели («Изменить объём») - применяется сразу.
Secret показывается один раз при создании и у нас не хранится. Для дополнительного ключа - выпустите в панели новый и отзовите старый. Основной ключ хранилища перевыпускает поддержка.
Удаление хранилища в панели удаляет бакет и отзывает все его ключи; данные теряются безвозвратно. Восстановления нет (versioning не поддерживается) - сохраните копию заранее.
Запустите команду с --debug (aws-cli) или -vv (rclone): в логе видно, какой хост и стиль адресации использует клиент. Проверьте endpoint со схемой https://, path-style, region rzn, пару ключей и регистр имени бакета.