Руководство по S3cmd
S3cmd — это мощная консольная утилита для работы с объектными хранилищами, совместимыми с S3 API. Этот инструмент позволяет загружать и скачивать файлы, создавать бакеты, просматривать содержимое и синхронизировать каталоги. s3cmd
широко используется для резервного копирования, автоматизации задач и управления хранилищами из командной строки.
Установка S3cmd
S3cmd доступен для большинства ОС и может быть установлен через пакетные менеджеры или из исходников.
Debian/Ubuntu:
sudo apt update && sudo apt install s3cmd
CentOS/RHEL/Fedora:
sudo dnf install s3cmd
macOS:
brew install s3cmd
Из исходников:
git clone https://github.com/s3tools/s3cmd.git
cd s3cmd
sudo python3 setup.py install
Настройка подключения
Перед началом работы необходимо инициализировать конфигурацию, указав ключи доступа и endpoint.
s3cmd --configure
Во время настройки вы укажете:
Параметр | Значение |
---|---|
Access Key | <YOUR_ACCESS_KEY_ID> |
Secret Key | <YOUR_SECRET_ACCESS_KEY> |
Default Region | ru-1 |
S3 Endpoint | s3.buckets.ru |
DNS-style | %(bucket)s.s3.buckets.ru |
Все параметры будут сохранены в файле ~/.s3cfg
, который можно редактировать вручную при необходимости.
Вы можете указать альтернативный файл конфигурации с помощью параметра -c
или --config
. Это удобно при работе с несколькими хранилищами или профилями.
s3cmd --configure -c ~/.s3cfg.custom-profile
Работа с бакетами
Просмотр списка бакетов:
s3cmd ls
Просмотр содержимого конкретного бакета:
s3cmd ls s3://<bucket-name>
Создание нового бакета (контейнера):
s3cmd mb s3://<bucket-name>
Загрузка и скачивание файлов
Загрузить файл в бакет:
s3cmd put ./file.txt s3://<bucket-name>/
Скачать файл из бакета:
s3cmd get s3://<bucket-name>/file.txt ./
Синхронизация директорий
S3cmd позволяет синхронизировать локальную директорию с бакетом:
s3cmd sync ./<local-folder>/ s3://<bucket-name>/backup/
Удаление объектов и бакетов
Удалить объект:
s3cmd del s3://<bucket-name>/file.txt
Удалить пустой бакет:
s3cmd rb s3://<bucket-name>
Официальная документация
Для получения полной информации о возможностях S3cmd, параметрах команд и примерах использования, обратитесь к официальной документации.
Документация S3cmd (s3tools.org)