Cyberduck

Cyberduck — это клиент для работы с файлами в удаленных хранилищах. Приложение поддерживает Amazon S3 и другие протоколы. Для подключения к хранилищу Timeweb Cloud используется профиль с протоколом Amazon S3.

Графический клиент доступен для Windows и macOS. Для Linux можно использовать консольный клиент duck.

Установка графической версии и подключение к S3

Процесс установки и подключения идентичен для Windows и macOS.

1. Скачайте Cyberduck с официального сайта и установите приложение.

2. В панели управления откройте нужный S3-бакет и перейдите на вкладку «Дашборд».

3. Скачайте профиль Cyberduck для подключения к Timeweb Cloud.

4. Дважды кликните по файлу timeweb-cloud.cyberduckprofile. Cyberduck запустится и добавит профиль s3.twcstorage.ru.

5. Откройте раздел «Закладки» и выберите s3.twcstorage.ru.

6. Укажите данные Access и Secret key. Их можно скопировать на вкладке «Дашборд» в панели управления бакетом.

7. Нажмите «Подключиться».

После успешного подключения Cyberduck отобразит бакеты, доступные для указанного пользователя.

Отображение скрытых файлов

По умолчанию Cyberduck не отображает скрытые файлы.

Чтобы показать их, выберите «Вид» → «Показать скрытые файлы».

Консольная версия Cyberduck

Консольный клиент duck стоит использовать, если графический интерфейс недоступен или операции с файлами нужно выполнять из скриптов. Для повседневной работы в Windows и macOS достаточно графического клиента.

Установка

Способ установки duck зависит от операционной системы.

    

      

    
    choco install duck
  

Актуальные способы установки для поддерживаемых операционных систем перечислены в документации Cyberduck CLI.

Подключение

Для подключения duck к S3-хранилищу используется профиль Timeweb Cloud.

    

      

    
    duck --profile "C:\путь\к\timeweb-cloud.cyberduckprofile" --username "<S3 Access Key>" --list timeweb-cloud:/
  

Где <S3 Access Key> — S3 Access Key пользователя хранилища. Ключ можно скопировать на вкладке «Дашборд» в панели управления бакетом. В команде укажите ключ без угловых скобок.

При первом подключении duck запросит Secret Key, который можно найти во вкладке «Дашборд» бакета. Чтобы секретный ключ не сохранился в настройках клиента, добавьте параметр --nokeychain. На Linux сохраненные учетные данные хранятся в незашифрованном виде.

Подключение к консольной версии duck

Основные команды

Получить список объектов в бакете:

    

      

    
    duck --profile "/путь/к/timeweb-cloud.cyberduckprofile" \
 --username "<S3 Access Key>" \
 --list timeweb-cloud:/<имя бакета>/

  

Загрузить локальный файл в бакет:

    

      

    
    duck --profile "/путь/к/timeweb-cloud.cyberduckprofile" \
 --username "<S3 Access Key>" \
 --upload timeweb-cloud:/<имя бакета>/<путь>/ "/путь/к/файлу"

  

Скачать объект в локальную директорию:

    

      

    
    duck --profile "/путь/к/timeweb-cloud.cyberduckprofile" \
 --username "<S3 Access Key>" \
 --download timeweb-cloud:/<имя бакета>/<путь к объекту> "/локальная/директория/"

  

Синхронизировать директорию в бакете с локальной директорией:

    

      

    
    duck --profile "/путь/к/timeweb-cloud.cyberduckprofile" \
 --username "<S3 Access Key>" \
 --synchronize timeweb-cloud:/<имя бакета>/<путь>/ "/локальная/директория/"

  

Во всех командах для авторизации используются S3 Access Key и S3 Secret Key.

Полный список параметров можно получить с помощью команды duck --help или найти в документации Cyberduck CLI.