Связаться с намиПодключиться

s3fs

Статья создана
Улучшена
Обновлена 7 марта 2025 г.

s3fs — программа для Linux и macOS, позволяющая монтировать бакеты Object Storage через FUSE.

Примечание

Рекомендуется использовать s3fs версии не ниже 1.84.

Если у вас возникнут вопросы, обратитесь к официальной документации проекта, в частности к разделу FAQ, который содержит решения для многих проблем, возникающих при использовании s3fs.

Производительность s3fs зависит от производительности локального диска. Используйте высокопроизводительные диски, особенно если вы храните много маленьких (сотни килобайт и меньше) файлов. Производительность s3fs можно увеличить, включив кэширование (ключ --use_cache <directory>). Кэш s3fs растет неограниченно и вам необходимо позаботиться о его регулярной очистке. Подробности читайте в документации s3fs.

Подготовка к работе

  1. Создайте сервисный аккаунт.

  2. Назначьте сервисному аккаунту роли, которые нужны для вашего проекта, например storage.editor на бакет — для работы с конкретным бакетом, или на каталог — для работы со всеми бакетами в каталоге. Подробнее о ролях см. на странице Управление доступом с помощью Yandex Identity and Access Management.

    Чтобы работать с объектами в зашифрованном бакете, у пользователя или сервисного аккаунта вместе с ролью storage.configurer должны быть следующие роли на ключ шифрования:

    • kms.keys.encrypter — для чтения ключа, шифрования и загрузки объектов;
    • kms.keys.decrypter — для чтения ключа, расшифровки и скачивания объектов;
    • kms.keys.encrypterDecrypter — включает разрешения, предоставляемые ролями kms.keys.encrypter и kms.keys.decrypter.

    Подробнее см. Сервисные роли Key Management Service.

  3. Создайте статический ключ доступа.

    В результате вы получите данные статического ключа доступа. Для аутентификации в Object Storage вам понадобятся:

    • key_id — идентификатор статического ключа доступа;
    • secret — секретный ключ.

    Сохраните key_id и secret, так как повторное получение значения ключа будет невозможно.

Примечание

Сервисный аккаунт может просматривать список бакетов только в том каталоге, в котором он был создан.

Сервисный аккаунт может выполнять действия с объектами в бакетах, которые созданы в каталогах, отличных от каталога сервисного аккаунта. Для этого назначьте сервисному аккаунту роли на нужный каталог или бакет в нем.

Установка

Для установки s3fs воспользуйтесь инструкцией в репозитории проекта.

Настройка

Для настройки s3fs сохраните идентификатор ключа и секретный ключ, полученные ранее, в файле ~/.passwd-s3fs в формате <идентификатор_ключа>:<секретный_ключ>, а также ограничьте доступ к файлу ~/.passwd-s3fs следующим образом:

echo <идентификатор_ключа>:<секретный_ключ> > ~/.passwd-s3fs
chmod 600 ~/.passwd-s3fs

Монтирование бакета

  1. Выберите папку, в которую вы будете монтировать бакет, и убедитесь, что у вас достаточно прав для операции монтирования.

  2. Выполните команду:

    s3fs <имя_бакета> /mount/<путь_к_папке> -o passwd_file=$HOME/.passwd-s3fs \
    -o url=https://storage.yandexcloud.net -o use_path_request_style

    Чтобы выдать доступ к этой папке другим пользователям компьютера, укажите опцию -o allow_other.

    Чтобы задать права доступа к папке, в которую будет смонтирован бакет, при монтировании укажите опцию -o mp_umask=<нужные_права>.

Можно настроить монтирование бакета при запуске системы, для этого добавьте в файл /etc/fstab строку вида:

s3fs#<имя_бакета> /mount/<путь_к_папке> fuse _netdev,allow_other,use_path_request_style,url=https://storage.yandexcloud.net,passwd_file=/home/<имя_пользователя>/.passwd-s3fs 0 0

Описание всех параметров s3fs смотрите в вики проекта на GitHub.

Предыдущая
GeeseFS
Следующая
goofys