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

Команды

Для работы с клиентом используются следующие команды:

• token — получить ключ авторизации (OAuth-токен) для вашего логина на Яндексе (USERNAME). При вводе команды вы можете указать ваш пароль на Яндексе (PASSWORD) и задать имя файла для хранения токена и путь к нему (FILE). Если дополнительные параметры не будут указаны, для хранения токена будет создан файл passwd в каталоге ~/.config/yandex-disk.

  $ yandex-disk token [-p, --password=PASSWORD] [OPTION] USERNAME [FILE]

• start — запустить демон и синхронизировать все папки, кроме указанных в списке исключений exclude-dirs.

  $ yandex-disk start [OPTION]

• status — отобразить статус работы демона (состояние синхронизации, ошибки синхронизации, список синхронизированных файлов, общее и свободное пространство на Диске).

  $ yandex-disk status [OPTION]

• stop — остановить работу демона.

  $ yandex-disk stop [OPTION]

• sync — синхронизировать все папки, кроме указанных в списке исключений exclude-dirs.

  $ yandex-disk sync [OPTION]

• publish — получить публичную ссылку на указанный файл или папку (FILE).

  $ yandex-disk publish [OPTION] FILE

• unpublish — отменить публикацию для указанного файла или папки (FILE).

  $ yandex-disk unpublish FILE

Дополнительные параметры [OPTION]

--config=FILE, -c FILE

Указать файл конфигурации. По умолчанию используется файл config.cfg в каталоге ~/.config/yandex-disk.

--dir=DIR, -d DIR

Указать каталог для хранения локальной копии Диска. Если его название не было задано при выполнении начальной настройки, по умолчанию будет использоваться каталог ~/Yandex.Disk.

--auth=FILE, -a FILE

Указать файл с данными авторизации. По умолчанию используется файл passwd, который создается с помощью команды token или мастера начальной настройки и хранится в каталоге ~/.config/yandex-disk.

--exclude-dirs=DIR1,DIR2,...

Не синхронизировать указанные каталоги. Чтобы настройка действовала всегда, каталоги необходимо добавить в список исключений exclude-dirs в файле config.cfg. Чтобы настройка действовала корректно, названия исключаемых директорий нужно перечислять через запятую, без пробелов.

--read-only

Запретить изменение файлов на сервере Диска и выполнить синхронизацию только в локальной копии. При возникновении конфликтов синхронизации локальные файлы будут переименованы. Если дополнительно указан параметр --overwrite, локальные файлы будут перезаписаны.

--overwrite

При синхронизации с сервером разрешить перезапись изменений, сделанных в локальной копии Диска. Используется вместе с параметром --read-only.

--no-daemon, -D

Запустить демон без возврата управления в консоль. Чтобы вернуть управление, демон необходимо остановить, запустив в другой консоли команду yandex-disk stop или закрыв текущую консоль.

--help, -h

Вывести справку.

--proxy=PARAM

Настроить прокси-сервер. Допустимые параметры:

• auto — использовать системные настройки прокси-сервера (используется по умолчанию);
• no — не использовать прокси-сервер;
• protocol,address,port,login,password — настроить вручную.

Примеры использования команд

$ yandex-disk start -c ~/ydconfig/newconfig.cfg # запустить демон и синхронизацию с указанным файлом конфигурации 
$ yandex-disk start --exclude-dirs=Foto # не синхронизировать папку Foto
$ yandex-disk sync --read-only # синхронизировать папки в режиме read-only
$ yandex-disk publish Foto # получить публичную ссылку на папку Foto

Пример файла config.cfg

# Путь к файлу с данными авторизации
auth="/home/user/ydconfig/my_passwd"

# Каталог для хранения локальной копии Диска.
dir="/home/user/myDisk"

# Не синхронизировать указанные каталоги.
#exclude-dirs="exclude/dir1,exclude/dir2,path/to/another/exclude/dir"

# Указать прокси-сервер. Примеры:
#proxy=https,127.0.0.1,80
#proxy=https,127.0.0.1,80,login,password
#proxy=https,127.0.0.1,443
#proxy=socks4,my.proxy.local,1080,login,password
#proxy=socks5,my.another.proxy.local,1081
#proxy=auto
#proxy=no

Какие возможности Диска доступны в консольном клиенте?

При работе с консольным клиентом вам доступны все основные возможности Диска: синхронизация и публикация файлов и папок, выборочная синхронизация папок.

Работает ли в консольном клиенте выборочная синхронизация папок?

Да. Вы можете запретить синхронизацию отдельных папок, указав их при вводе команды (параметр --exclude-dirs=DIR1,DIR2,...) или добавив в список исключений exclude-dirs в файле config.cfg.

Поддерживает ли консольный клиент работу с символическими ссылками?

Да, поддерживает.

Можно ли использовать консольный клиент для репликации данных?

Да. Репликация данных может быть реализована с помощью параметра --read-only.