---
title: "Cyberduck — База знаний Timeweb Cloud"
description: "Документация Cyberduck — файловый менеджер, который поддерживает протоколы FTP, SFTP, OpenStack Swift и AmazonS3."
---

# Cyberduck

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

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

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

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

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

1.  [Скачайте Cyberduck](https://cyberduck.io/download/) с официального сайта и установите приложение.
    
2.  В панели управления откройте нужный S3-бакет и перейдите на вкладку «Дашборд».
    
3.  Скачайте профиль Cyberduck для подключения к Timeweb Cloud.
    

![Скачивание профиля в панели управления](https://content.timeweb.com/assets/3a767d59-0073-4bd7-9fdc-ea114bd20e2f.png?width=2142&height=1812)

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

Windows

![2026 08 17 18.04.46](https://content.timeweb.com/assets/f14b04fb-ea2b-4ef2-9c66-b2676bea07e2.jpg?width=1023&height=611)

_Панель закладок в Windows-версии [Cyberduck](https://cyberduck.io)_

macOS

![Scr 20260817 Pvpp](https://content.timeweb.com/assets/235d2a46-272e-43e5-92fa-72a5375e998f.png?width=2280&height=1080)

_Панель закладок в macOS-версии [Cyberduck](https://cyberduck.io)_

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

![Access и Secret Key](https://content.timeweb.com/assets/dfa7d913-e770-4050-9d6a-929f2a190b80.png?width=2150&height=1822)

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

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

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

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

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

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

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

### Установка

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

Windows

Установите `duck` с помощью [Chocolatey](https://chocolatey.org/):

```bash
choco install duck
```

Ubuntu

Добавьте репозиторий Cyberduck и установите `duck`:

```bash
echo -e "deb https://s3.amazonaws.com/repo.deb.cyberduck.io stable main" | sudo tee /etc/apt/sources.list.d/cyberduck.list > /dev/null
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys FE7097963FEFBE72
sudo apt-get update
sudo apt-get install duck
```

macOS

Установите `duck` с помощью [Homebrew](https://brew.sh/):

```bash
brew install duck
```

Актуальные способы установки для поддерживаемых операционных систем перечислены в [документации Cyberduck CLI](https://docs.cyberduck.io/cli/#installation).

### Подключение

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

Windows

Скачайте профиль `timeweb-cloud.cyberduckprofile` на вкладке «Дашборд» в панели управления бакетом. Затем выполните:

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

Ubuntu

Создайте директорию для профилей, скачайте профиль с помощью `wget` и подключитесь к хранилищу:

```bash
mkdir -p ~/.duck/profiles
wget -O ~/.duck/profiles/timeweb-cloud.cyberduckprofile https://st.timeweb.com/cloud-static/timeweb-cloud.cyberduckprofile
duck --profile ~/.duck/profiles/timeweb-cloud.cyberduckprofile \
  --username "<S3 Access Key>" \
  --list timeweb-cloud:/
```

macOS

Создайте директорию для профилей, скачайте профиль с помощью `wget` и подключитесь к хранилищу:

```bash
mkdir -p ~/.duck/profiles
wget -O ~/.duck/profiles/timeweb-cloud.cyberduckprofile https://st.timeweb.com/cloud-static/timeweb-cloud.cyberduckprofile
duck --profile ~/.duck/profiles/timeweb-cloud.cyberduckprofile \
  --username "<S3 Access Key>" \
  --list timeweb-cloud:/
```

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

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

![Scr 20260817 Pmlp](https://content.timeweb.com/assets/a8fea2b4-32a3-49b0-86bb-3ebaacdb6614.png?width=2152&height=966)

_Подключение к консольной версии [duck](https://duck.sh/)_

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

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

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

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

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

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

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

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

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

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

Полный список параметров можно получить с помощью команды `duck --help` или найти в [документации Cyberduck CLI](https://docs.cyberduck.io/cli/).
