Команды и параметры
Команды
Для работы с клиентом используются следующие команды:
-
token
— получить ключ авторизации (OAuth-токен) для вашего логина на Яндексе.
При вводе команды вы можете задать имя файла для хранения токена и путь к нему (FILE). Если дополнительные параметры не будут указаны, для хранения токена будет создан файлpasswd
в каталоге~/.config/yandex-disk
.$ yandex-disk token [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
или закрыв текущую консоль.Если используется этот параметр, приложение не читает файл конфигурации. Поэтому все необходимые настройки нужно вводить через командную строку. Так, параметру
exclude-dirs
соответствует аргумент--exclude-dirs
.$ yandex-disk --no-daemon --dir=/root/Yandex.Disk --exclude-dirs=DO_NOT_SYNC,temp
Примечание
При использовании
--no-daemon
не нужно указывать командуstart
: в этом режиме все команды игнорируются.
--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