Cyberduck

Cyberduck — это файловый менеджер, который поддерживает протоколы FTP, OpenStack Swift и Amazon S3. С Cyberduck можно работать через графический или консольный клиент. Графический клиент доступен на ОС Windows и macOS. Консольный клиент доступен на ОС Windows, Linux и macOS.

Настроить Cyberduck

Настройте доступ к S3.
Настройте клиент.

1. Настроить доступ к S3

Настроить доступ может Владелец аккаунта или пользователь с ролью iam_admin.

Создайте сервисного пользователя с ролью с доступом в S3. Если вы создали сервисного пользователя с ролью object_storage_user или s3.bucket.user, в бакете должна быть настроена политика доступа и ее правила должны разрешать доступ этому пользователю.
Выдайте пользователю S3-ключ.

2. Настроить клиент

Графический клиент
Консольный клиент

Windows
macOS

Установите Cyberduck.
Откройте Cyberduck.
Нажмите Новое подключение.
В верхнем поле откройте список и выберите Еще опции.
В разделе Profiles отметьте профиль Selectel S3 Cloud Storage. Для работы с профилем у бакета должна быть включена Virtual-Hosted адресация.
Перезапустите Cyberduck.
Нажмите Новое подключение.
В верхнем поле откройте список и выберите Selectel S3 Cloud Storage.
В поле Access Key вставьте значение поля Access key из S3-ключа пользователя, для которого вы настроили доступ на этапе 1.
В поле Secret Key вставьте значение поля Secret key из S3-ключа пользователя, для которого вы настроили доступ на этапе 1.
Нажмите Подключиться.

Подробнее о работе с консольным клиентом в инструкции Command Line Interface (CLI) документации Cyberduck.

Windows
Linux
macOS

Консольная версия Cyberduck для Windows устанавливается с помощью менеджера пакетов Chocolatey.

Откройте командную строку с правами администратора.
Установите менеджер пакетов Chocolatey.
Установите Cyberduck:
```
choco install duck
```
Для установки всех пакетов введите A и нажмите Enter.
Скачайте файл профиля Selectel.
Загрузите файл профиля в папку %AppData%\Cyberduck\Profiles.

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

Добавьте репозиторий duck:

sudo echo 'deb https://s3.amazonaws.com/repo.deb.cyberduck.io nightly main' >> /etc/apt/sources.list.d/cyberduck.list
sudo echo 'deb https://s3.amazonaws.com/repo.deb.cyberduck.io stable main' >> /etc/apt/sources.list.d/cyberduck.list

Добавьте GPG-ключ:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys FE7097963FEFBE72

Обновите репозиторий:
```
sudo apt-get update
```
Установите Cyberduck CLI:
```
sudo apt-get install duck
```

Скачайте профиль Selectel:

wget https://static.selectel.ru/kb/selectel-s3-cloud-storage.cyberduckprofile

Создайте директорию с профилями:
```
mkdir -p ~/.duck/profiles
```
Переместите скачанный профиль Selectel в директорию с профилями:
```
mv 'selectel-storage.cyberduckprofile' ~/.duck/profiles/
```

Консольная версия Cyberduck для macOS устанавливается с помощью менеджера пакетов Homebrew.

Откройте терминал.
Установите Cyberduck:
```
brew install duck
```

Скачайте профиль Selectel:

wget https://static.selectel.ru/kb/selectel-s3-cloud-storage.cyberduckprofile

Создайте директорию с профилями:

mkdir -p ~/Library/Group Containers/G69SCX94XU.duck/Library/Application Support/duck/Profiles

Переместите скачанный профиль Selectel в директорию с профилями:

mv 'selectel-storage.cyberduckprofile' ~/Library/Group Containers/G69SCX94XU.duck/Library/Application Support/duck/Profiles

Формат команд для консольного клиента

Для работы через консольный клиент используйте команды вида (при Path-Style адресации):

duck --region <pool> --username <access_key> --password <secret_key> --<command> s3://<s3_domain>/<bucket_name>

Укажите:

<pool> — пул, в котором находится S3;
<access_key> — значение поля Access key из S3-ключа;
<secret_key> — значение поля Secret key из S3-ключа;
<command> — команда Cyberduck, некоторые команды можно посмотреть в документации CLI;
<s3_domain> — домен S3 API. Домен зависит от пула, в котором находится S3;
<bucket_name> — имя бакета.

Получить ссылку на объект

Вы можете получить ссылку на объект в публичном или приватном бакете через подписанный URL (Presigned URL). Подробнее о Presigned URLs в инструкции Sharing objects with presigned URLs документации AWS.

Откройте графический клиент Cyberduck.
В списке объектов бакета нажмите правой кнопкой мыши на объект и выберите Копировать URL.
Выберите один из пунктов Предподписанный URL в зависимости от желаемого срока работы ссылки — час, день или неделя.