---
title: "s3fs — База знаний Timeweb Cloud"
description: "s3fs для облачного хранилища: упрощение работы с данными через FUSE. Timeweb Cloud: документация, IT и облачные тренды."
---

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

`s3fs` — утилита для Linux и macOS, с помощью которой можно монтировать бакеты облачного хранилища через FUSE.

> [!NOTE]
> Мы не рекомендуем использовать s3fs без крайней необходимости из-за проблем с производительностью, надежностью и совместимостью. Рассмотрите более надежные альтернативы, такие как AWS SDK или специализированные утилиты для работы с S3 — например, [s3cmd](https://timeweb.cloud/docs/s3-storage/tools/s3cmd), [AWS CLI](https://timeweb.cloud/docs/s3-storage/tools/aws-cli) или [S3 Browser](https://timeweb.cloud/docs/s3-storage/tools/s3-browser).

## Установка

Для установки `s3fs` на операционную систему **Ubuntu** используйте команду:

```shell
sudo apt install s3fs
```

Рекомендуем использовать `s3fs` не ниже версии 1.90. Актуальную версию утилиты для Ubuntu можно собрать их исходного кода с помощью следующих команд:

```shell
apt install build-essential automake libcurl4-openssl-dev libxml2-dev pkg-config libssl-dev libfuse-dev git
git clone https://github.com/s3fs-fuse/s3fs-fuse.git
cd s3fs-fuse
./autogen.sh
./configure
make
make install
```

Дополнительную информацию и инструкции по установке на другие ОС можно найти в [документации s3fs](https://github.com/s3fs-fuse/s3fs-fuse#installation).

## Настройка

Для настройки `s3fs` для работы с нашим объектным хранилищем S3 сохраните ключ доступа и секретный ключ в файле `~/.passwd-s3fs` с помощью команды:

```shell
echo <S3 Access Key>:<S3 Secret Access Key> >  ~/.passwd-s3fs
```

Значения S3 Access Key и S3 Secret Access Key можно найти во вкладке «Дашборд» в панели управления бакетом.

Ограничьте доступ к файлу `~/.passwd-s3fs`:

```shell
chmod 600  ~/.passwd-s3fs
```

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

Для монтирования бакета выберите директорию монтирования (в примере — `/mnt/s3/`) и выполните команду ниже, указав корректные имя бакета и путь к директории:

```shell
s3fs <имя бакета> /mnt/s3/ -o use_path_request_style -o url=https://s3.twcstorage.ru -o passwd_file=~/.passwd-s3fs
```

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

```shell
s3fs#<имя бакета> /mnt/s3 fuse _netdev,allow_other,use_path_request_style,url=https://s3.twcstorage.ru,passwd_file=/root/.passwd-s3fs 0 0
```

Дополнительную информацию по работе с `s3fs`, описание всех параметров, а также рекомендации по решению возникающих проблем можно найти в [документации проекта](https://github.com/s3fs-fuse/s3fs-fuse/wiki/Fuse-Over-Amazon), в том числе в разделе [FAQ](https://github.com/s3fs-fuse/s3fs-fuse/wiki/FAQ).