--- title: "S3cmd — База знаний Timeweb Cloud" description: "S3cmd — это клиент S3 API с интерфейсом командной строки, используемый для работы с S3-совместимыми хранилищами. Документация Timeweb Cloud." --- > Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt). S3cmd — это клиент S3 API с интерфейсом командной строки, используемый для работы с S3-совместимыми хранилищами. ## Установка Для установки S3cmd воспользуйтесь командами в зависимости от вашей ОС: Ubuntu ```shell sudo apt install s3cmd -y ``` CentOS ```shell sudo dnf install s3cmd -y ``` Arch Linux ```shell sudo pacman -S s3cmd ``` macOS Для установки S3cmd воспользуйтесь [Homebrew](https://brew.sh/): ``` brew install s3cmd ``` Windows Откройте PowerShell от имени администратора и выполните: ```shell choco install s3cmd -y ``` Если Chocolatey не установлен, установите его, следуя [официальной инструкции](https://chocolatey.org/install). ## Настройка Для настройки `S3cmd` для работы с нашим объектным хранилищем S3 необходимо создать в корне домашней директории файл `.s3cfg` со следующим содержимым: ```shell [default] access_key = secret_key = bucket_location = ru-1 host_base = s3.twcstorage.ru host_bucket = s3.twcstorage.ru use_https = True ``` Значения S3 Access Key и S3 Secret Access Key можно найти во вкладке «Дашборд» в панели управления бакетом. ![Selection 252](https://content.timeweb.com/assets/cd3e5188-0542-413a-a806-c63dfc857a41.png?width=1012&height=939) ## Работа с файлами ### **Получение списка файлов в бакете** Чтобы получить список файлов, используйте `ls`: ```shell s3cmd ls s3://<имя бакета> ``` ### **Загрузка локального файла в бакет** Для загрузки файлов используется `put`. В примере ниже загружается файл text.txt: ```shell s3cmd put test.txt s3://<имя бакета> ``` ### Составная (multipart) загрузка Клиент `s3cmd` поддерживает составную загрузку, которая автоматически активируется при загрузке файлов размером более 15 МБ. Этот метод разбивает файл на несколько частей (чанков) и загружает их параллельно, что ускоряет процесс передачи больших файлов и повышает устойчивость к сбоям. При необходимости составную загрузку можно отключить с помощью опции `--disable-multipart`. Для изменения размера отдельных фрагментов (чанков) используйте опцию `--multipart-chunk-size-mb=SIZE`, где SIZE — размер каждого фрагмента в мегабайтах. По умолчанию размер фрагмента составляет 15 МБ, минимально допустимый размер — 5 МБ, максимально допустимый — 5 ГБ. Например, чтобы установить размер фрагмента на 10 МБ, используйте следующую команду: ```shell s3cmd put <имя_файла> --multipart-chunk-size-mb=10 s3://<имя_бакета> ``` Эта настройка позволяет оптимизировать загрузку больших файлов в зависимости от пропускной способности сети и требований к производительности. ### **Удаление файла в бакете** Для удаления файла используйте команду `del`. В примере ниже удаляем файл text.txt: ```shell s3cmd del s3://<имя бакета>/test.txt ``` ### Управление прерванными составными (multipart) загрузками При прерывании составной загрузки фрагменты файлов не отображаются в бакете, но продолжают занимать дисковое пространство на сервере. Чтобы просмотреть список прерванных загрузок и узнать, какие фрагменты занимают место, используйте команду: ```shell s3cmd multipart s3://<имя_бакета> ``` Эта команда выводит дату и время начала загрузки, путь файла и уникальный идентификатор загрузки (`ID`). Для удаления фрагментов неудачных загрузок используйте следующую команду: ```shell s3cmd abortmp s3://<имя_бакета>/<имя_файла> ``` ### **Скачивание файла из бакета** Для загрузки файла из бакета на локальное устройство используйте `get`: ```shell s3cmd get s3://<имя бакета>/test.txt ``` ### **Синхронизация файлов** Для синхронизации файлов между локальной директорией (в примере это текущая директория — `.`) и бакетом используется `sync`: ```shell s3cmd sync . s3://<имя бакета> ``` Полный список команд и дополнительную информацию можно найти в [документации S3cmd](https://s3tools.org/usage).