---
title: 'S3cmd'
sidebar_label: 'S3cmd'
sidebar_position: 4
description: 'Как настроить S3cmd и работать с хранилищем через интерфейс командной строки S3cmd'
---

import Formbricks from '@theme/MDXComponents/Formbricks'
import GrantAccess from '@site/docs/_partials/s3/grant-access.mdx'

# S3cmd

[S3cmd](https://s3tools.org/s3cmd) — это интерфейс командной строки для работы с сервисами, поддерживающими HTTP API Amazon S3 ([S3 API](/api/object-storage-s3/)).

## Настроить S3cmd \{#configure-s3cmd}

1. [Настройте доступ к S3](#configure-s3-access).
2. [Установите клиент](#install-client).
3. [Создайте конфигурацию S3cmd](#create-configuration).

### 1. Настроить доступ к S3 \{#configure-s3-access}

<GrantAccess />

### 2. Установить клиент \{#install-client}

С [GitHub S3cmd](https://github.com/s3tools/s3cmd/blob/master/INSTALL.md) скачайте и установите клиент.

### 3. Создать конфигурацию s3cmd \{#create-configuration}

1. Откройте терминал.

2. Откройте режим конфигурирования:

   ```bash
   s3cmd --configure
   ```

3. Введите `Access Key` — значение поля **Access key** из [S3-ключа](#configure-s3-access).

4. Введите `Secret Key` — значение поля **Secret key** из S3-ключа.

5. Введите `Default Region` — [пул](/infrastructure/locations.mdx#pool).

6. Введите `S3 Endpoint` — [домен S3 API](/s3/manage/domains.mdx#s3-api-domains). Домен зависит от [пула](/infrastructure/locations.mdx#pool), в котором находится S3.

7. Введите DNS-style `bucket+hostname:port template for accessing a bucket` — [домен S3 API](/s3/manage/domains.mdx#s3-api-domains). Домен зависит от [пула](/infrastructure/locations.mdx#pool), в котором находится S3. Настройки будут сохранены в файле `~/.s3cfg`:

   ```bash
   [default]
      access_key = <access_key>
      secret_key = <secret_key>
      bucket_location = <pool>
      host_base = <s3_domain>
      host_bucket = <s3_domain>
   ```

## Работа с S3cmd \{#working-with-s3cmd}

Посмотреть все команды можно в инструкции [Usage](https://s3tools.org/usage) документации S3cmd.

### Создать бакет \{#create-bucket}

1. Откройте терминал.
2. Создайте бакет:

   ```bash
   s3cmd mb s3://<bucket_name>
   ```

   Укажите `<bucket_name>` — имя нового бакета.

### Посмотреть список объектов \{#view-object-list}

1. Откройте терминал.
2. Посмотрите список объектов:

   ```bash
   s3cmd ls s3://<bucket_name>
   ```

   Укажите `<bucket_name>` — имя бакета.

### Загрузить объект \{#upload-object}

1. Откройте терминал.
2. Загрузите объект:

   ```bash
   s3cmd put <path> s3://<bucket_name>/<prefix>
   ```

   Укажите:

   * `<path>` — путь до файла в локальной директории;
   * `<bucket_name>` — имя бакета;
   * `<prefix>` — опционально: [префикс](/s3/objects/manage-folder.mdx), по которому будет загружен объект.

### Удалить объект \{#delete-object}

1. Откройте терминал.
2. Удалите объект:

   ```bash
   s3cmd rm s3://<bucket_name>/<object_name>
   ```

   Укажите:

   * `<bucket_name>` — имя бакета;
   * `<object_name>` — имя объекта.

<Formbricks />