Связаться с экспертомПопробовать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ООО «Яндекс.Облако»

s3fs

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

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, так как повторное получение значения ключа будет невозможно.

Авторизация статическими ключами необходима для обращения напрямую к HTTP API и поддерживается инструментами, перечисленными в разделе Поддерживаемые инструменты.

Примечание

Вы можете запретить доступ в бакет с помощью статических ключей. После запрета доступ будет прекращен для всех инструментов, которые их используют: AWS CLI, SDK и сторонние приложения. Это также отключит доступ с помощью эфемерных ключей, временных ключей доступа Security Token Service и подписанных (pre-signed) URL. Останется доступ только через IAM-токен или анонимный доступ (если он включен).

Статический ключ для доступа к Object Storage можно безопасно хранить в сервисе Yandex Lockbox. Подробнее см. Использование секрета Yandex Lockbox для хранения статического ключа доступа.

Примечание

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

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

Установка

  1. Проверьте, что в дистрибутиве установлены утилиты для работы с FUSE:

    apt list --installed | grep fuse

    Важно

    Во многих дистрибутивах Linux утилиты для работы с FUSE уже установлены по умолчанию. Их переустановка или удаление могут привести к нарушению работы операционной системы.

  2. Если утилиты для работы с FUSE не установлены, то выполните команду:

    sudo apt-get install fuse

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

  1. Проверьте, что в дистрибутиве установлены утилиты для работы с FUSE:

    dnf list installed | grep fuse

    Важно

    Во многих дистрибутивах Linux утилиты для работы с FUSE уже установлены по умолчанию. Их переустановка или удаление могут привести к нарушению работы операционной системы.

  2. Если утилиты для работы с FUSE не установлены, то выполните команду:

    sudo dnf install fuse

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

  1. Установите пакет macFUSE.

  2. Включите поддержку сторонних расширений ядра. Этот шаг необходим только при первом использовании MacFUSE на Apple Silicon Mac.

  3. Разрешите загрузку расширения ядра MacFUSE (Apple Silicon и Intel Mac).

    Подробнее об установке macFUSE см. в инструкции по установке в репозитории macFUSE на GitHub.

  4. Для установки 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