Cyberduck

Последнее изменение: 26 марта 2026

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

Настроить Cyberduck

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

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

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

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

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

Графический клиент

Windows

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

macOS

1. Установите Cyberduck.
2. Откройте Cyberduck.
3. Нажмите Новое подключение.
4. В верхнем поле откройте список и выберите More Options.
5. На вкладке Профили отметьте профиль Selectel S3 Cloud Storage. Для работы с профилем у бакета должна быть включена Virtual-Hosted адресация.
6. Перезапустите Cyberduck.
7. Нажмите Новое подключение.
8. В верхнем поле откройте список и выберите Selectel S3 Cloud Storage.
9. В поле Access Key вставьте значение поля Access key из S3-ключа пользователя, для которого вы настроили доступ на этапе 1.
10. В поле Secret Key вставьте значение поля Secret key из S3-ключа пользователя, для которого вы настроили доступ на этапе 1.
11. Нажмите Подключиться.

Консольный клиент

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

Windows

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

1. Откройте командную строку с правами администратора.

2. Установите менеджер пакетов Chocolatey.

3. Установите Cyberduck:

   choco install duck

4. Для установки всех пакетов введите A и нажмите Enter.

5. Скачайте файл профиля Selectel.

6. Загрузите файл профиля в папку %AppData%\Cyberduck\Profiles.

Linux

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

2. Добавьте репозиторий 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

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

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

4. Обновите репозиторий:

   sudo apt-get update

5. Установите Cyberduck CLI:

   sudo apt-get install duck

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

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

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

   mkdir -p ~/.duck/profiles

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

   mv 'selectel-storage.cyberduckprofile' ~/.duck/profiles/

macOS

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

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

2. Установите Cyberduck:

   brew install duck

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

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

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

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

5. Переместите скачанный профиль 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.

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